@jait/gateway 0.1.84 → 0.1.85

package/dist/services/workspace-sync.js

@@ -0,0 +1,266 @@
+/**
+ * Workspace Sync — pulls a remote workspace to a local temp directory
+ * and pushes changed files back after a CLI provider (Codex/Claude) turn.
+ *
+ * This solves the fundamental problem: CLI providers operate directly on
+ * the filesystem (not through Jait tools), so the workspace must exist
+ * locally on the gateway. This service transparently mirrors a remote
+ * node's workspace so CLI providers see a real local directory.
+ *
+ * Flow:
+ *   1. pull()   — enumerate & download files from the remote node
+ *   2. Codex/Claude runs against the local mirror
+ *   3. push()   — detect changed files and upload them back
+ *   4. cleanup() — remove the local mirror when done
+ */
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { mkdirSync, writeFileSync, readFileSync, readdirSync, statSync, existsSync, rmSync, } from "node:fs";
+import { createHash } from "node:crypto";
+/** Directories/files to skip during sync to keep it fast */
+const EXCLUDE_PATTERNS = [
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    ".next",
+    ".nuxt",
+    ".output",
+    "__pycache__",
+    ".venv",
+    "venv",
+    ".tox",
+    "target", // Rust/Java
+    "vendor", // Go/PHP
+    ".gradle",
+    ".idea",
+    ".vs",
+    "*.pyc",
+    "*.pyo",
+    ".DS_Store",
+    "Thumbs.db",
+];
+/** Max file size to sync (skip large binaries) */
+const MAX_FILE_SIZE = 2 * 1024 * 1024; // 2 MB
+/** Max total files to sync (safety limit) */
+const MAX_FILES = 5000;
+export class WorkspaceSync {
+    ws;
+    nodeId;
+    remotePath;
+    localPath;
+    snapshot = new Map();
+    pulled = false;
+    constructor(options) {
+        this.ws = options.ws;
+        this.nodeId = options.nodeId;
+        this.remotePath = options.remotePath;
+        // Create a deterministic local path under ~/.jait/workspaces/
+        const hash = createHash("sha256")
+            .update(`${options.nodeId}:${options.remotePath}`)
+            .digest("hex")
+            .slice(0, 12);
+        const dirName = options.remotePath
+            .replace(/^[A-Za-z]:/, "")
+            .replace(/[\\\/]/g, "_")
+            .replace(/[^a-zA-Z0-9_.-]/g, "")
+            .slice(0, 40);
+        this.localPath = join(homedir(), ".jait", "workspaces", `${dirName}-${hash}`);
+    }
+    /** The local directory path CLI providers should use as cwd */
+    get localDir() {
+        return this.localPath;
+    }
+    /** Whether the workspace has been pulled yet */
+    get isPulled() {
+        return this.pulled;
+    }
+    /**
+     * Pull the workspace files from the remote node to the local mirror.
+     * Recursively enumerates and downloads files, skipping excluded patterns.
+     */
+    async pull() {
+        mkdirSync(this.localPath, { recursive: true });
+        let fileCount = 0;
+        let totalSize = 0;
+        this.snapshot.clear();
+        const enumerate = async (remoteDirPath, localDirPath) => {
+            if (fileCount >= MAX_FILES)
+                return;
+            let entries;
+            try {
+                entries = await this.ws.proxyFsOp(this.nodeId, "list", { path: remoteDirPath }, 15_000);
+            }
+            catch (err) {
+                console.warn(`[workspace-sync] Failed to list ${remoteDirPath}: ${err}`);
+                return;
+            }
+            for (const entry of entries) {
+                if (fileCount >= MAX_FILES)
+                    break;
+                const name = entry.endsWith("/") ? entry.slice(0, -1) : entry;
+                const isDir = entry.endsWith("/");
+                // Check excludes
+                if (shouldExclude(name))
+                    continue;
+                const fullRemotePath = joinPath(remoteDirPath, name);
+                const fullLocalPath = join(localDirPath, name);
+                if (isDir) {
+                    mkdirSync(fullLocalPath, { recursive: true });
+                    await enumerate(fullRemotePath, fullLocalPath);
+                }
+                else {
+                    // Check file size before downloading
+                    try {
+                        const stat = await this.ws.proxyFsOp(this.nodeId, "stat", { path: fullRemotePath }, 10_000);
+                        if (stat.size > MAX_FILE_SIZE)
+                            continue;
+                    }
+                    catch {
+                        continue;
+                    }
+                    // Download file content
+                    try {
+                        const result = await this.ws.proxyFsOp(this.nodeId, "read", { path: fullRemotePath }, 15_000);
+                        mkdirSync(localDirPath, { recursive: true });
+                        writeFileSync(fullLocalPath, result.content, "utf-8");
+                        const hash = hashContent(result.content);
+                        const relPath = fullRemotePath.slice(this.remotePath.length).replace(/^[\\\/]/, "");
+                        this.snapshot.set(relPath, {
+                            path: relPath,
+                            hash,
+                            size: result.content.length,
+                        });
+                        fileCount++;
+                        totalSize += result.content.length;
+                    }
+                    catch (err) {
+                        // Skip files that can't be read (binary, permission errors, etc.)
+                        console.warn(`[workspace-sync] Skip ${fullRemotePath}: ${err}`);
+                    }
+                }
+            }
+        };
+        console.log(`[workspace-sync] Pulling ${this.remotePath} from node ${this.nodeId}...`);
+        await enumerate(this.remotePath, this.localPath);
+        this.pulled = true;
+        console.log(`[workspace-sync] Pulled ${fileCount} files (${(totalSize / 1024).toFixed(1)} KB)`);
+        return { fileCount, totalSize };
+    }
+    /**
+     * Detect which files changed locally and push them back to the remote node.
+     * Also handles new files and deleted files.
+     */
+    async push() {
+        if (!this.pulled)
+            return { pushed: 0, deleted: 0 };
+        let pushed = 0;
+        let deleted = 0;
+        const seenRelPaths = new Set();
+        // Walk local directory for new/changed files
+        const walkLocal = async (localDir, relDir) => {
+            let entries;
+            try {
+                entries = readdirSync(localDir);
+            }
+            catch {
+                return;
+            }
+            for (const name of entries) {
+                if (shouldExclude(name))
+                    continue;
+                const fullLocal = join(localDir, name);
+                const relPath = relDir ? `${relDir}/${name}` : name;
+                let stat;
+                try {
+                    stat = statSync(fullLocal);
+                }
+                catch {
+                    continue;
+                }
+                if (stat.isDirectory()) {
+                    await walkLocal(fullLocal, relPath);
+                }
+                else if (stat.isFile()) {
+                    seenRelPaths.add(relPath);
+                    if (stat.size > MAX_FILE_SIZE)
+                        continue;
+                    try {
+                        const content = readFileSync(fullLocal, "utf-8");
+                        const hash = hashContent(content);
+                        const prev = this.snapshot.get(relPath);
+                        if (!prev || prev.hash !== hash) {
+                            // File is new or changed — push to remote
+                            const remotePath = joinPath(this.remotePath, relPath.replace(/\//g, getSep()));
+                            await this.ws.proxyFsOp(this.nodeId, "write", { path: remotePath, content }, 15_000);
+                            pushed++;
+                            // Update snapshot
+                            this.snapshot.set(relPath, { path: relPath, hash, size: content.length });
+                        }
+                    }
+                    catch {
+                        // Skip files that can't be read (binary)
+                    }
+                }
+            }
+        };
+        await walkLocal(this.localPath, "");
+        // Check for deleted files (in original snapshot but no longer on disk)
+        for (const [relPath] of this.snapshot) {
+            if (!seenRelPaths.has(relPath)) {
+                // File was deleted locally — could delete on remote too, but for
+                // safety we leave remote files intact. The CLI provider might have
+                // intentionally deleted them and the user should verify.
+                deleted++;
+            }
+        }
+        if (pushed > 0 || deleted > 0) {
+            console.log(`[workspace-sync] Pushed ${pushed} changed files, ${deleted} deleted`);
+        }
+        return { pushed, deleted };
+    }
+    /**
+     * Clean up the local mirror directory.
+     */
+    async cleanup() {
+        try {
+            if (existsSync(this.localPath)) {
+                rmSync(this.localPath, { recursive: true, force: true });
+                console.log(`[workspace-sync] Cleaned up ${this.localPath}`);
+            }
+        }
+        catch (err) {
+            console.warn(`[workspace-sync] Cleanup failed: ${err}`);
+        }
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────────────
+function shouldExclude(name) {
+    for (const pattern of EXCLUDE_PATTERNS) {
+        if (pattern.startsWith("*.")) {
+            if (name.endsWith(pattern.slice(1)))
+                return true;
+        }
+        else {
+            if (name === pattern)
+                return true;
+        }
+    }
+    return false;
+}
+function hashContent(content) {
+    return createHash("sha256").update(content).digest("hex").slice(0, 16);
+}
+/** Join two path segments using the remote's separator */
+function joinPath(dir, name) {
+    const sep = dir.includes("\\") ? "\\" : "/";
+    const trimmed = dir.endsWith(sep) ? dir.slice(0, -1) : dir;
+    return `${trimmed}${sep}${name}`;
+}
+/** Get the path separator from the remote path style */
+function getSep() {
+    // Default to forward slash — the joinPath function in push()
+    // converts back to remote style when constructing the remote path
+    return "/";
+}
+//# sourceMappingURL=workspace-sync.js.map

package/dist/services/workspace-sync.js.map

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

package/dist/tools/remote-executor.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Remote Tool Executor — delegates tool execution to remote nodes.
+ *
+ * When a session's workspace is bound to a remote node (i.e. the
+ * workspace path doesn't exist on the gateway), tool calls are proxied
+ * to the remote node via the `tool.op-request` / `tool.op-response`
+ * WS protocol instead of executing locally on the gateway.
+ *
+ * This solves the fundamental problem where CLI providers (Codex, Claude)
+ * and built-in tools (terminal.run, file.write, etc.) need to operate
+ * on the same machine where the workspace lives.
+ *
+ * Tools that are gateway-local by nature (e.g. surfaces.list, cron.*,
+ * gateway.status) are always executed locally regardless of the workspace
+ * binding.
+ */
+import type { ToolResult, ToolContext } from "./contracts.js";
+import type { WsControlPlane } from "../ws.js";
+export interface RemoteToolExecutorOptions {
+    ws: WsControlPlane;
+    /** Local executor — called when the tool should run on the gateway */
+    localExecutor: (toolName: string, input: unknown, context: ToolContext, options?: {
+        dryRun?: boolean;
+        consentTimeoutMs?: number;
+    }) => Promise<ToolResult>;
+}
+/**
+ * Resolve which node ID (if any) should execute tools for a given session.
+ *
+ * Returns `null` if the workspace is local to the gateway or no matching
+ * remote node is connected.
+ */
+export declare function resolveRemoteNodeForSession(ws: WsControlPlane, workspacePath: string | undefined): string | null;
+/**
+ * Create a tool executor that transparently delegates to a remote node
+ * when the session's workspace is on that node.
+ *
+ * If `remoteNodeId` is null, all calls go to the local executor.
+ */
+export declare function createRemoteToolExecutor(options: RemoteToolExecutorOptions, remoteNodeId: string | null): (toolName: string, input: unknown, context: ToolContext, execOptions?: {
+    dryRun?: boolean;
+    consentTimeoutMs?: number;
+}) => Promise<ToolResult>;
+//# sourceMappingURL=remote-executor.d.ts.map

package/dist/tools/remote-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-executor.d.ts","sourceRoot":"","sources":["../../src/tools/remote-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAyB/C,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,cAAc,CAAC;IACnB,sEAAsE;IACtE,aAAa,EAAE,CACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,KACtD,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,cAAc,EAClB,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,MAAM,GAAG,IAAI,CAwBf;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,EAClC,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,CACD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,EACpB,WAAW,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,KAC1D,OAAO,CAAC,UAAU,CAAC,CAoCvB"}

package/dist/tools/remote-executor.js

@@ -0,0 +1,107 @@
+/**
+ * Remote Tool Executor — delegates tool execution to remote nodes.
+ *
+ * When a session's workspace is bound to a remote node (i.e. the
+ * workspace path doesn't exist on the gateway), tool calls are proxied
+ * to the remote node via the `tool.op-request` / `tool.op-response`
+ * WS protocol instead of executing locally on the gateway.
+ *
+ * This solves the fundamental problem where CLI providers (Codex, Claude)
+ * and built-in tools (terminal.run, file.write, etc.) need to operate
+ * on the same machine where the workspace lives.
+ *
+ * Tools that are gateway-local by nature (e.g. surfaces.list, cron.*,
+ * gateway.status) are always executed locally regardless of the workspace
+ * binding.
+ */
+/** Tools that always run on the gateway regardless of workspace location */
+const GATEWAY_LOCAL_TOOLS = new Set([
+    "surfaces.list",
+    "surfaces.start",
+    "surfaces.stop",
+    "cron.add",
+    "cron.list",
+    "cron.update",
+    "cron.remove",
+    "gateway.status",
+    "tools.search",
+    "tools.list",
+    "memory.read",
+    "memory.write",
+    "memory.list",
+    "memory.search",
+    "voice.say",
+    "voice.listen",
+    "screen.share",
+    "screen.stop",
+    "notification.send",
+]);
+/**
+ * Resolve which node ID (if any) should execute tools for a given session.
+ *
+ * Returns `null` if the workspace is local to the gateway or no matching
+ * remote node is connected.
+ */
+export function resolveRemoteNodeForSession(ws, workspacePath) {
+    if (!workspacePath)
+        return null;
+    // Check if the workspace path exists on the gateway
+    // We use a lightweight sync check — existsSync is fine here since this
+    // is called once per chat request, not in a hot loop.
+    try {
+        const { existsSync } = require("node:fs");
+        if (existsSync(workspacePath))
+            return null;
+    }
+    catch {
+        return null;
+    }
+    // Path doesn't exist locally — find a matching remote node
+    const isWindowsPath = /^[A-Za-z]:[\\\/]/.test(workspacePath);
+    const expectedPlatform = isWindowsPath ? "windows" : null;
+    for (const node of ws.getFsNodes()) {
+        if (node.isGateway)
+            continue;
+        if (expectedPlatform && node.platform !== expectedPlatform)
+            continue;
+        return node.id;
+    }
+    return null;
+}
+/**
+ * Create a tool executor that transparently delegates to a remote node
+ * when the session's workspace is on that node.
+ *
+ * If `remoteNodeId` is null, all calls go to the local executor.
+ */
+export function createRemoteToolExecutor(options, remoteNodeId) {
+    const { ws, localExecutor } = options;
+    return async (toolName, input, context, execOptions) => {
+        // Always execute gateway-local tools locally
+        if (!remoteNodeId || GATEWAY_LOCAL_TOOLS.has(toolName)) {
+            return localExecutor(toolName, input, context, execOptions);
+        }
+        // Check that the remote node is still connected
+        const node = ws.findNodeByDeviceId(remoteNodeId);
+        if (!node) {
+            console.warn(`[remote-executor] Node ${remoteNodeId} disconnected, falling back to local execution`);
+            return localExecutor(toolName, input, context, execOptions);
+        }
+        // Delegate to the remote node
+        try {
+            const result = await ws.proxyToolOp(remoteNodeId, toolName, input, {
+                timeoutMs: 120_000,
+                sessionId: context.sessionId,
+                workspaceRoot: context.workspaceRoot,
+                onOutputChunk: context.onOutputChunk,
+            });
+            return result;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`[remote-executor] Remote tool '${toolName}' failed on node ${remoteNodeId}: ${message}`);
+            return { ok: false, message: `Remote execution failed: ${message}` };
+        }
+    };
+}
+//# sourceMappingURL=remote-executor.js.map

package/dist/tools/remote-executor.js.map

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

package/dist/ws.d.ts

@@ -16,6 +16,8 @@ export declare class WsControlPlane {
     private pendingFsOps;
     /** Pending remote provider operation requests */
     private pendingProviderOps;
+    /** Pending remote tool execution requests */
+    private pendingToolOps;
     constructor(config: AppConfig);
     /**
      * Attach the WebSocket server to an existing HTTP server (shares port).
@@ -106,6 +108,16 @@ export declare class WsControlPlane {
      * Returns undefined if the path belongs to the gateway or no matching node is found.
      */
     findNodeByDeviceId(deviceId: string): FsNode | undefined;
+    /**
+     * Send a tool execution request to a remote node and wait for the result.
+     * Used to delegate Jait tool calls (terminal.run, file.write, etc.) to nodes.
+     */
+    proxyToolOp<T = unknown>(nodeId: string, tool: string, args: Record<string, unknown>, options?: {
+        timeoutMs?: number;
+        sessionId?: string;
+        workspaceRoot?: string;
+        onOutputChunk?: (chunk: string) => void;
+    }): Promise<T>;
     /**
      * Send a provider operation request to a remote node and wait for the response.
      * Used by RemoteCliProvider to proxy session lifecycle and turn operations.

package/dist/ws.d.ts.map

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

package/dist/ws.js

@@ -16,6 +16,9 @@ export class WsControlPlane {
     /** Pending remote provider operation requests */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     pendingProviderOps = new Map();
+    /** Pending remote tool execution requests */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    pendingToolOps = new Map();
     constructor(config) {
         this.config = config;
         // Use the configured JWT secret, or a dev-mode fallback
@@ -404,6 +407,34 @@ export class WsControlPlane {
                 }
                 break;
             }
+            // ── Remote tool execution responses ─────────────────────────
+            case "tool.op-response": {
+                const resp = msg.payload;
+                if (resp?.requestId) {
+                    const pending = this.pendingToolOps.get(resp.requestId);
+                    if (pending) {
+                        this.pendingToolOps.delete(resp.requestId);
+                        clearTimeout(pending.timer);
+                        if (resp.error) {
+                            pending.reject(new Error(resp.error));
+                        }
+                        else {
+                            pending.resolve(resp.result);
+                        }
+                    }
+                }
+                break;
+            }
+            case "tool.op-output": {
+                const outPayload = msg.payload;
+                if (outPayload?.requestId && outPayload.chunk) {
+                    const pending = this.pendingToolOps.get(outPayload.requestId);
+                    if (pending?.onOutputChunk) {
+                        pending.onOutputChunk(outPayload.chunk);
+                    }
+                }
+                break;
+            }
             // ── Generic fs operation responses (stat, read, write, list) ──
             case "fs.op-response": {
                 const resp = msg.payload;
@@ -732,6 +763,36 @@ export class WsControlPlane {
         }
         return undefined;
     }
+    /**
+     * Send a tool execution request to a remote node and wait for the result.
+     * Used to delegate Jait tool calls (terminal.run, file.write, etc.) to nodes.
+     */
+    proxyToolOp(nodeId, tool, args, options = {}) {
+        const { timeoutMs = 120_000, sessionId, workspaceRoot, onOutputChunk } = options;
+        const node = this.fsNodes.get(nodeId);
+        if (!node)
+            return Promise.reject(new Error(`Unknown node: ${nodeId}`));
+        if (node.isGateway)
+            return Promise.reject(new Error("Use local execution for gateway node"));
+        const client = this.clients.get(node.clientId);
+        if (!client || client.ws.readyState !== 1) {
+            return Promise.reject(new Error(`Node ${nodeId} is not connected`));
+        }
+        const requestId = nanoid();
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingToolOps.delete(requestId);
+                reject(new Error(`Tool '${tool}' timed out on node ${nodeId}`));
+            }, timeoutMs);
+            this.pendingToolOps.set(requestId, { resolve: resolve, reject, timer, onOutputChunk });
+            this.send(client.ws, {
+                type: "tool.op-request",
+                sessionId: sessionId ?? "",
+                timestamp: new Date().toISOString(),
+                payload: { requestId, tool, args, sessionId, workspaceRoot },
+            });
+        });
+    }
     /**
      * Send a provider operation request to a remote node and wait for the response.
      * Used by RemoteCliProvider to proxy session lifecycle and turn operations.