farseer-cli 1.0.0

package/dist/mcp/tools/runTools.js

@@ -0,0 +1,231 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var runTools_exports = {};
+__export(runTools_exports, {
+  registerRunTools: () => registerRunTools
+});
+module.exports = __toCommonJS(runTools_exports);
+var import_zod = require("zod");
+var import_child_process = require("child_process");
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_farseerFactory = require("../../services/farseerFactory");
+var import_configService = require("../../services/configService");
+var import_farseerService = require("../../services/farseerService");
+var import_helpers = require("../../utils/helpers");
+var import_helpers2 = require("../utils/helpers");
+async function getRunCredentials(tenant, tenantId) {
+  const credential = (0, import_configService.getCredential)(tenant);
+  if (credential) {
+    return {
+      tenantId: credential.tenantId,
+      apiKey: credential.apiKey,
+      basePath: credential.basePath
+    };
+  }
+  const auth = (0, import_configService.getUserAuth)();
+  if (!auth) {
+    return null;
+  }
+  if (!(0, import_configService.isUserAuthValid)()) {
+    const refreshed = await (0, import_farseerService.refreshAccessToken)(auth.refreshToken, auth.realm || "master");
+    if (!refreshed) {
+      return null;
+    }
+    (0, import_configService.setUserAuth)({
+      accessToken: refreshed.accessToken,
+      refreshToken: refreshed.refreshToken,
+      expiresAt: new Date(Date.now() + refreshed.expiresIn * 1e3).toISOString(),
+      realm: auth.realm
+    });
+  }
+  const updatedAuth = (0, import_configService.getUserAuth)();
+  if (!updatedAuth) return null;
+  return {
+    tenantId: tenantId || tenant,
+    accessToken: updatedAuth.accessToken,
+    basePath: (0, import_configService.generateBasePath)(tenant)
+  };
+}
+const runAppSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name"),
+  appName: import_zod.z.string().describe("Name of the app to run"),
+  argumentOverrides: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).optional().describe("Override argument values (Name: Value pairs)")
+};
+function registerRunTools(server) {
+  server.tool(
+    "farseer_run_app",
+    `Run a Farseer app locally using tsx (TypeScript executor).
+
+How it works:
+1. Looks up app configuration to find the entrypoint script
+2. Injects credentials via environment variables:
+   - TENANT_ID: The tenant identifier
+   - FARSEER_URL: Base API URL
+   - FARSEER_API_KEY or FARSEER_ACCESS_TOKEN: Authentication
+3. Passes app arguments via command line (in order defined by app config)
+4. Executes the script using npx tsx
+
+Requirements:
+- Scripts must be pulled locally first (farseer_pull)
+- Dependencies must be installed (run "farseer install" in terminal)
+
+Arguments can be overridden using the argumentOverrides parameter.
+Arguments not overridden use their default values from app config.
+
+If no tenant is specified, uses the currently checked-out tenant.`,
+    runAppSchema,
+    async (params) => {
+      const { tenant: tenantArg, appName, argumentOverrides } = params;
+      const checkout = (0, import_configService.getCurrentCheckout)();
+      const tenant = tenantArg || checkout?.tenant;
+      const organisation = tenantArg || checkout?.organisation;
+      if (!tenant || !organisation) {
+        return (0, import_helpers2.tenantRequiredResponse)();
+      }
+      const clientResult = await (0, import_farseerFactory.getFarseerClientWithFallback)(organisation, tenant);
+      if (!clientResult) {
+        return (0, import_helpers2.authRequiredResponse)(tenant);
+      }
+      try {
+        const app = await clientResult.client.getAppByName(appName);
+        if (!app) {
+          return (0, import_helpers2.errorResponse)(`App "${appName}" not found`, "NOT_FOUND");
+        }
+        if (!app.mainScriptFileId || app.scriptFiles.length === 0) {
+          return (0, import_helpers2.errorResponse)(
+            `App "${appName}" has no scripts configured. Configure it with farseer_configure_app.`,
+            "VALIDATION_ERROR"
+          );
+        }
+        const mainScript = app.scriptFiles.find((s) => s.id === app.mainScriptFileId);
+        if (!mainScript) {
+          return (0, import_helpers2.errorResponse)(`Entrypoint script not found for app "${appName}"`, "NOT_FOUND");
+        }
+        const credentials = await getRunCredentials(organisation, tenant);
+        if (!credentials) {
+          return (0, import_helpers2.authRequiredResponse)(tenant);
+        }
+        const tenantDir = (0, import_helpers.getTenantDir)(organisation);
+        const srcDir = (0, import_helpers.getTenantSrcDir)(organisation);
+        const scriptPath = path.resolve(srcDir, mainScript.name);
+        if (!fs.existsSync(scriptPath)) {
+          return (0, import_helpers2.errorResponse)(
+            `Script not found locally: ${mainScript.name}. Run farseer_pull first.`,
+            "NOT_FOUND"
+          );
+        }
+        const nodeModulesPath = path.join(tenantDir, "node_modules");
+        if (!fs.existsSync(nodeModulesPath)) {
+          return (0, import_helpers2.errorResponse)(
+            `Dependencies not installed. Run "farseer install ${organisation}" in terminal first.`,
+            "VALIDATION_ERROR"
+          );
+        }
+        const appArgs = {};
+        for (const arg of app.expectedArguments) {
+          appArgs[arg.name] = arg.defaultValue;
+        }
+        if (argumentOverrides) {
+          for (const [name, value] of Object.entries(argumentOverrides)) {
+            appArgs[name] = value;
+          }
+        }
+        const envVars = {
+          ...process.env,
+          TENANT_ID: credentials.tenantId,
+          FARSEER_URL: credentials.basePath
+        };
+        if (credentials.apiKey) {
+          envVars.FARSEER_API_KEY = credentials.apiKey;
+        }
+        if (credentials.accessToken) {
+          envVars.FARSEER_ACCESS_TOKEN = credentials.accessToken;
+        }
+        const cmdArgs = [];
+        for (const arg of app.expectedArguments) {
+          cmdArgs.push(appArgs[arg.name] ?? arg.defaultValue);
+        }
+        return new Promise((resolve) => {
+          let stdout = "";
+          let stderr = "";
+          const child = (0, import_child_process.spawn)("npx", ["tsx", `files/Scripts/${mainScript.name}`, ...cmdArgs], {
+            cwd: tenantDir,
+            shell: true,
+            env: envVars
+          });
+          child.stdout?.on("data", (data) => {
+            stdout += data.toString();
+          });
+          child.stderr?.on("data", (data) => {
+            stderr += data.toString();
+          });
+          child.on("close", (code) => {
+            resolve(
+              (0, import_helpers2.successResponse)({
+                tenant,
+                app: appName,
+                script: mainScript.name,
+                arguments: appArgs,
+                exitCode: code ?? 0,
+                stdout: stdout.slice(0, 1e4),
+                // Limit output size
+                stderr: stderr.slice(0, 5e3),
+                truncated: stdout.length > 1e4 || stderr.length > 5e3
+              })
+            );
+          });
+          child.on("error", (err) => {
+            resolve(
+              (0, import_helpers2.errorResponse)(
+                `Failed to run script: ${err.message}. Make sure tsx is installed: npm install -g tsx`,
+                "UNKNOWN"
+              )
+            );
+          });
+          setTimeout(() => {
+            child.kill();
+            resolve(
+              (0, import_helpers2.errorResponse)("Script execution timed out after 5 minutes", "UNKNOWN")
+            );
+          }, 5 * 60 * 1e3);
+        });
+      } catch (error) {
+        return (0, import_helpers2.errorResponse)(
+          `Run app failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  registerRunTools
+});
+//# sourceMappingURL=runTools.js.map

package/dist/mcp/tools/runTools.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/tools/runTools.ts"],
+  "sourcesContent": ["/**\n * App Execution Tools\n *\n * Tools for running Farseer apps locally.\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { z } from 'zod';\nimport { spawn } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { getFarseerClientWithFallback } from '../../services/farseerFactory';\nimport {\n    getCredential,\n    getUserAuth,\n    isUserAuthValid,\n    setUserAuth,\n    generateBasePath,\n    getCurrentCheckout,\n} from '../../services/configService';\nimport { refreshAccessToken } from '../../services/farseerService';\nimport { getTenantDir, getTenantSrcDir } from '../../utils/helpers';\nimport {\n    successResponse,\n    errorResponse,\n    authRequiredResponse,\n    tenantRequiredResponse,\n} from '../utils/helpers';\n\ninterface RunCredentials {\n    tenantId: string;\n    apiKey?: string;\n    accessToken?: string;\n    basePath: string;\n}\n\nasync function getRunCredentials(tenant: string, tenantId?: string): Promise<RunCredentials | null> {\n    // First try API key config\n    const credential = getCredential(tenant);\n    if (credential) {\n        return {\n            tenantId: credential.tenantId,\n            apiKey: credential.apiKey,\n            basePath: credential.basePath,\n        };\n    }\n\n    // Try user auth (browser login)\n    const auth = getUserAuth();\n    if (!auth) {\n        return null;\n    }\n\n    // Check if token needs refresh\n    if (!isUserAuthValid()) {\n        const refreshed = await refreshAccessToken(auth.refreshToken, auth.realm || 'master');\n        if (!refreshed) {\n            return null;\n        }\n        // Save refreshed token\n        setUserAuth({\n            accessToken: refreshed.accessToken,\n            refreshToken: refreshed.refreshToken,\n            expiresAt: new Date(Date.now() + refreshed.expiresIn * 1000).toISOString(),\n            realm: auth.realm,\n        });\n    }\n\n    const updatedAuth = getUserAuth();\n    if (!updatedAuth) return null;\n\n    return {\n        tenantId: tenantId || tenant,\n        accessToken: updatedAuth.accessToken,\n        basePath: generateBasePath(tenant),\n    };\n}\n\n// Define schemas outside of tool registration to avoid deep type instantiation\nconst runAppSchema = {\n    tenant: z.string().optional().describe('Tenant name'),\n    appName: z.string().describe('Name of the app to run'),\n    argumentOverrides: z\n        .record(z.string(), z.string())\n        .optional()\n        .describe('Override argument values (Name: Value pairs)'),\n};\n\nexport function registerRunTools(server: McpServer): void {\n    // farseer_run_app - Run an app locally\n    server.tool(\n        'farseer_run_app',\n        `Run a Farseer app locally using tsx (TypeScript executor).\n\nHow it works:\n1. Looks up app configuration to find the entrypoint script\n2. Injects credentials via environment variables:\n   - TENANT_ID: The tenant identifier\n   - FARSEER_URL: Base API URL\n   - FARSEER_API_KEY or FARSEER_ACCESS_TOKEN: Authentication\n3. Passes app arguments via command line (in order defined by app config)\n4. Executes the script using npx tsx\n\nRequirements:\n- Scripts must be pulled locally first (farseer_pull)\n- Dependencies must be installed (run \"farseer install\" in terminal)\n\nArguments can be overridden using the argumentOverrides parameter.\nArguments not overridden use their default values from app config.\n\nIf no tenant is specified, uses the currently checked-out tenant.`,\n        runAppSchema,\n        async (params: { tenant?: string; appName: string; argumentOverrides?: Record<string, string> }) => {\n            const { tenant: tenantArg, appName, argumentOverrides } = params;\n            const checkout = getCurrentCheckout();\n            const tenant = tenantArg || checkout?.tenant;\n            const organisation = tenantArg || checkout?.organisation;\n\n            if (!tenant || !organisation) {\n                return tenantRequiredResponse();\n            }\n\n            const clientResult = await getFarseerClientWithFallback(organisation, tenant);\n            if (!clientResult) {\n                return authRequiredResponse(tenant);\n            }\n\n            try {\n                // Get app details\n                const app = await clientResult.client.getAppByName(appName);\n                if (!app) {\n                    return errorResponse(`App \"${appName}\" not found`, 'NOT_FOUND');\n                }\n\n                if (!app.mainScriptFileId || app.scriptFiles.length === 0) {\n                    return errorResponse(\n                        `App \"${appName}\" has no scripts configured. Configure it with farseer_configure_app.`,\n                        'VALIDATION_ERROR'\n                    );\n                }\n\n                // Find entrypoint script\n                const mainScript = app.scriptFiles.find((s) => s.id === app.mainScriptFileId);\n                if (!mainScript) {\n                    return errorResponse(`Entrypoint script not found for app \"${appName}\"`, 'NOT_FOUND');\n                }\n\n                // Get run credentials\n                const credentials = await getRunCredentials(organisation, tenant);\n                if (!credentials) {\n                    return authRequiredResponse(tenant);\n                }\n\n                const tenantDir = getTenantDir(organisation);\n                const srcDir = getTenantSrcDir(organisation);\n                const scriptPath = path.resolve(srcDir, mainScript.name);\n\n                // Check if script exists locally\n                if (!fs.existsSync(scriptPath)) {\n                    return errorResponse(\n                        `Script not found locally: ${mainScript.name}. Run farseer_pull first.`,\n                        'NOT_FOUND'\n                    );\n                }\n\n                // Check if node_modules exists\n                const nodeModulesPath = path.join(tenantDir, 'node_modules');\n                if (!fs.existsSync(nodeModulesPath)) {\n                    return errorResponse(\n                        `Dependencies not installed. Run \"farseer install ${organisation}\" in terminal first.`,\n                        'VALIDATION_ERROR'\n                    );\n                }\n\n                // Build arguments\n                const appArgs: Record<string, string> = {};\n\n                // Start with defaults\n                for (const arg of app.expectedArguments) {\n                    appArgs[arg.name] = arg.defaultValue;\n                }\n\n                // Apply overrides\n                if (argumentOverrides) {\n                    for (const [name, value] of Object.entries(argumentOverrides)) {\n                        appArgs[name] = value;\n                    }\n                }\n\n                // Build environment\n                const envVars: Record<string, string> = {\n                    ...(process.env as Record<string, string>),\n                    TENANT_ID: credentials.tenantId,\n                    FARSEER_URL: credentials.basePath,\n                };\n\n                if (credentials.apiKey) {\n                    envVars.FARSEER_API_KEY = credentials.apiKey;\n                }\n                if (credentials.accessToken) {\n                    envVars.FARSEER_ACCESS_TOKEN = credentials.accessToken;\n                }\n\n                // Build command line arguments (in order)\n                const cmdArgs: string[] = [];\n                for (const arg of app.expectedArguments) {\n                    cmdArgs.push(appArgs[arg.name] ?? arg.defaultValue);\n                }\n\n                // Run the script\n                return new Promise((resolve) => {\n                    let stdout = '';\n                    let stderr = '';\n\n                    const child = spawn('npx', ['tsx', `files/Scripts/${mainScript.name}`, ...cmdArgs], {\n                        cwd: tenantDir,\n                        shell: true,\n                        env: envVars,\n                    });\n\n                    child.stdout?.on('data', (data: Buffer) => {\n                        stdout += data.toString();\n                    });\n\n                    child.stderr?.on('data', (data: Buffer) => {\n                        stderr += data.toString();\n                    });\n\n                    child.on('close', (code) => {\n                        resolve(\n                            successResponse({\n                                tenant,\n                                app: appName,\n                                script: mainScript.name,\n                                arguments: appArgs,\n                                exitCode: code ?? 0,\n                                stdout: stdout.slice(0, 10000), // Limit output size\n                                stderr: stderr.slice(0, 5000),\n                                truncated: stdout.length > 10000 || stderr.length > 5000,\n                            })\n                        );\n                    });\n\n                    child.on('error', (err) => {\n                        resolve(\n                            errorResponse(\n                                `Failed to run script: ${err.message}. Make sure tsx is installed: npm install -g tsx`,\n                                'UNKNOWN'\n                            )\n                        );\n                    });\n\n                    // Timeout after 5 minutes\n                    setTimeout(() => {\n                        child.kill();\n                        resolve(\n                            errorResponse('Script execution timed out after 5 minutes', 'UNKNOWN')\n                        );\n                    }, 5 * 60 * 1000);\n                });\n            } catch (error) {\n                return errorResponse(\n                    `Run app failed: ${error instanceof Error ? error.message : 'Unknown error'}`,\n                    'NETWORK_ERROR'\n                );\n            }\n        }\n    );\n}\n"],
+  "mappings": "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",
+  "names": ["import_helpers"]
+}

package/dist/mcp/tools/syncTools.d.ts

@@ -0,0 +1,7 @@
+/**
+ * File Synchronization Tools
+ *
+ * Tools for syncing files between local repository and Farseer instance.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSyncTools(server: McpServer): void;

package/dist/mcp/tools/syncTools.js

@@ -0,0 +1,382 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var syncTools_exports = {};
+__export(syncTools_exports, {
+  registerSyncTools: () => registerSyncTools
+});
+module.exports = __toCommonJS(syncTools_exports);
+var import_zod = require("zod");
+var import_diff = require("diff");
+var import_syncService = require("../../services/syncService");
+var import_appSyncService = require("../../services/appSyncService");
+var import_farseerFactory = require("../../services/farseerFactory");
+var import_configService = require("../../services/configService");
+var import_helpers = require("../utils/helpers");
+const pullSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name. Uses checked-out tenant if omitted."),
+  tenantId: import_zod.z.string().optional().describe("Override X-TENANT-ID header if different from tenant name"),
+  all: import_zod.z.boolean().optional().describe("Download all files, not just scripts (.ts, .js)")
+};
+const pushSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name. Uses checked-out tenant if omitted."),
+  tenantId: import_zod.z.string().optional().describe("Override X-TENANT-ID header if different from tenant name"),
+  force: import_zod.z.boolean().optional().describe("Skip remote changes check (may overwrite remote changes)")
+};
+const statusSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name. Uses checked-out tenant if omitted."),
+  tenantId: import_zod.z.string().optional().describe("Override X-TENANT-ID header"),
+  all: import_zod.z.boolean().optional().describe("Show all files, not just scripts")
+};
+const diffSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name"),
+  file: import_zod.z.string().optional().describe("Specific file path to diff. If omitted, shows all differences."),
+  showRemote: import_zod.z.boolean().optional().describe("Show only the remote content instead of diff")
+};
+const listFilesSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name"),
+  all: import_zod.z.boolean().optional().describe("Show all files, not just scripts")
+};
+function registerSyncTools(server) {
+  server.tool(
+    "farseer_pull",
+    `Pull (download) files and app configurations from a Farseer instance to the local repository.
+
+What gets pulled:
+- TypeScript/JavaScript scripts from Files/ folder (searched recursively)
+- App configurations (saved as JSON in apps/ folder)
+
+Files are saved to: apps/<tenant>/files/
+Apps are saved to: apps/<tenant>/apps/
+
+By default only script files (.ts, .js, .mjs, .cjs) are pulled.
+Use all=true to pull all files including images, data files, etc.
+
+If no tenant is specified, uses the currently checked-out tenant.`,
+    pullSchema,
+    async (params) => {
+      const { tenant: tenantArg, tenantId, all } = params;
+      const checkout = (0, import_configService.getCurrentCheckout)();
+      const tenant = tenantArg || checkout?.tenant;
+      const organisation = tenantArg || checkout?.organisation;
+      if (!tenant || !organisation) {
+        return (0, import_helpers.tenantRequiredResponse)();
+      }
+      const clientResult = await (0, import_farseerFactory.getFarseerClientWithFallback)(organisation, tenantId || tenant);
+      if (!clientResult) {
+        return (0, import_helpers.authRequiredResponse)(tenant);
+      }
+      try {
+        const syncService = new import_syncService.SyncService(organisation, clientResult.client);
+        const fileResult = await syncService.pull({ all });
+        let appResult = null;
+        if (clientResult.authType === "jwt") {
+          const appSyncService = new import_appSyncService.AppSyncService(organisation, clientResult.client);
+          appResult = await appSyncService.pull();
+        }
+        return (0, import_helpers.successResponse)({
+          tenant,
+          files: {
+            downloaded: fileResult.downloaded,
+            deleted: fileResult.deleted,
+            unchanged: fileResult.unchanged.length
+          },
+          apps: appResult ? {
+            created: appResult.created,
+            updated: appResult.updated,
+            deleted: appResult.deleted,
+            unchanged: appResult.unchanged.length
+          } : { note: "App sync requires browser login (JWT)" },
+          message: `Pulled ${fileResult.downloaded.length} files${appResult ? ` and ${appResult.created.length + appResult.updated.length} apps` : ""}`
+        });
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `Pull failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+  server.tool(
+    "farseer_push",
+    `Push (upload) local file and app changes to a Farseer instance.
+
+What gets pushed:
+- New/modified scripts from apps/<tenant>/files/
+- New/modified app configurations from apps/<tenant>/apps/
+- Deleted files (if they were previously synced)
+
+Important:
+- Checks for unpulled remote changes first to prevent conflicts
+- Use force=true to skip this check (may overwrite remote changes)
+
+If no tenant is specified, uses the currently checked-out tenant.`,
+    pushSchema,
+    async (params) => {
+      const { tenant: tenantArg, tenantId, force } = params;
+      const checkout = (0, import_configService.getCurrentCheckout)();
+      const tenant = tenantArg || checkout?.tenant;
+      const organisation = tenantArg || checkout?.organisation;
+      if (!tenant || !organisation) {
+        return (0, import_helpers.tenantRequiredResponse)();
+      }
+      const clientResult = await (0, import_farseerFactory.getFarseerClientWithFallback)(organisation, tenantId || tenant);
+      if (!clientResult) {
+        return (0, import_helpers.authRequiredResponse)(tenant);
+      }
+      try {
+        const syncService = new import_syncService.SyncService(organisation, clientResult.client);
+        if (!force) {
+          const hasRemoteChanges = await syncService.checkRemoteChanges();
+          if (hasRemoteChanges) {
+            return (0, import_helpers.errorResponse)(
+              "Remote has unpulled changes. Pull first or use force=true to overwrite.",
+              "VALIDATION_ERROR"
+            );
+          }
+        }
+        const fileResult = await syncService.push();
+        let appResult = null;
+        if (clientResult.authType === "jwt") {
+          const appSyncService = new import_appSyncService.AppSyncService(organisation, clientResult.client);
+          appResult = await appSyncService.push();
+        }
+        return (0, import_helpers.successResponse)({
+          tenant,
+          files: {
+            uploaded: fileResult.uploaded,
+            updated: fileResult.updated,
+            deleted: fileResult.deleted,
+            unchanged: fileResult.unchanged.length
+          },
+          apps: appResult ? {
+            created: appResult.created,
+            updated: appResult.updated,
+            unchanged: appResult.unchanged.length
+          } : { note: "App sync requires browser login (JWT)" },
+          summary: `Pushed ${fileResult.uploaded.length + fileResult.updated.length} files${appResult ? ` and ${appResult.created.length + appResult.updated.length} apps` : ""}`
+        });
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `Push failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+  server.tool(
+    "farseer_status",
+    `Check the synchronization status between local files and the remote Farseer instance.
+
+Shows which files are:
+- Modified locally (changed since last sync)
+- Modified remotely (changed on server since last sync)
+- Only local (new files not yet pushed)
+- Only remote (files not yet pulled)
+- In sync (no changes)
+
+Also shows app sync status if using JWT authentication.
+
+If no tenant is specified, uses the currently checked-out tenant.`,
+    statusSchema,
+    async (params) => {
+      const { tenant: tenantArg, tenantId, all } = params;
+      const checkout = (0, import_configService.getCurrentCheckout)();
+      const tenant = tenantArg || checkout?.tenant;
+      const organisation = tenantArg || checkout?.organisation;
+      if (!tenant || !organisation) {
+        return (0, import_helpers.tenantRequiredResponse)();
+      }
+      const clientResult = await (0, import_farseerFactory.getFarseerClientWithFallback)(organisation, tenantId || tenant);
+      if (!clientResult) {
+        return (0, import_helpers.authRequiredResponse)(tenant);
+      }
+      try {
+        const syncService = new import_syncService.SyncService(organisation, clientResult.client);
+        const fileStatus = await syncService.getStatus({ all });
+        let appStatus = null;
+        if (clientResult.authType === "jwt") {
+          const appSyncService = new import_appSyncService.AppSyncService(organisation, clientResult.client);
+          appStatus = await appSyncService.getStatus();
+        }
+        const hasChanges = fileStatus.modifiedLocally.length > 0 || fileStatus.modifiedRemotely.length > 0 || fileStatus.onlyLocal.length > 0 || fileStatus.onlyRemote.length > 0;
+        return (0, import_helpers.successResponse)({
+          tenant,
+          files: {
+            modifiedLocally: fileStatus.modifiedLocally,
+            modifiedRemotely: fileStatus.modifiedRemotely,
+            onlyLocal: fileStatus.onlyLocal,
+            onlyRemote: fileStatus.onlyRemote,
+            inSync: fileStatus.inSync.length
+          },
+          apps: appStatus ? {
+            newLocal: appStatus.newLocal,
+            newRemote: appStatus.newRemote,
+            modified: appStatus.modified,
+            synced: appStatus.synced.length
+          } : { note: "App sync requires browser login (JWT)" },
+          summary: hasChanges ? "Changes detected" : "Everything is in sync"
+        });
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `Status check failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+  server.tool(
+    "farseer_diff",
+    `Show the differences between local and remote versions of files.
+
+Can show:
+- Unified diff format (default)
+- Just the remote content (showRemote=true)
+
+Useful for reviewing changes before pull or push.
+
+If no file is specified, shows diffs for all changed files.`,
+    diffSchema,
+    async (params) => {
+      const { tenant: tenantArg, file, showRemote } = params;
+      const checkout = (0, import_configService.getCurrentCheckout)();
+      const tenant = tenantArg || checkout?.tenant;
+      const organisation = tenantArg || checkout?.organisation;
+      if (!tenant || !organisation) {
+        return (0, import_helpers.tenantRequiredResponse)();
+      }
+      const clientResult = await (0, import_farseerFactory.getFarseerClientWithFallback)(organisation, tenant);
+      if (!clientResult) {
+        return (0, import_helpers.authRequiredResponse)(tenant);
+      }
+      try {
+        const syncService = new import_syncService.SyncService(organisation, clientResult.client);
+        if (file) {
+          const { localContent, remoteContent } = await syncService.getFileDiff(file);
+          if (showRemote) {
+            return (0, import_helpers.successResponse)({
+              file,
+              remoteContent: remoteContent || "(file does not exist on remote)"
+            });
+          }
+          const diff = (0, import_diff.createPatch)(
+            file,
+            remoteContent || "",
+            localContent || "",
+            "remote",
+            "local"
+          );
+          return (0, import_helpers.successResponse)({
+            file,
+            localExists: localContent !== null,
+            remoteExists: remoteContent !== null,
+            diff
+          });
+        } else {
+          const status = await syncService.getStatus();
+          const changedFiles = [
+            ...status.modifiedLocally,
+            ...status.modifiedRemotely,
+            ...status.onlyLocal,
+            ...status.onlyRemote
+          ];
+          const diffs = [];
+          for (const f of changedFiles.slice(0, 10)) {
+            const { localContent, remoteContent } = await syncService.getFileDiff(f);
+            const diff = (0, import_diff.createPatch)(f, remoteContent || "", localContent || "", "remote", "local");
+            diffs.push({
+              file: f,
+              localExists: localContent !== null,
+              remoteExists: remoteContent !== null,
+              diff
+            });
+          }
+          return (0, import_helpers.successResponse)({
+            totalChangedFiles: changedFiles.length,
+            diffs,
+            note: changedFiles.length > 10 ? `Showing first 10 of ${changedFiles.length} changed files` : void 0
+          });
+        }
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `Diff failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+  server.tool(
+    "farseer_list_files",
+    `List all files stored on the remote Farseer instance in the Files/ folder.
+
+By default shows only script files (.ts, .js, .mjs, .cjs).
+Use all=true to show all files including images, data files, etc.
+
+Returns file paths relative to the Files/ folder.`,
+    listFilesSchema,
+    async (params) => {
+      const { tenant: tenantArg, all } = params;
+      const checkout = (0, import_configService.getCurrentCheckout)();
+      const tenant = tenantArg || checkout?.tenant;
+      const organisation = tenantArg || checkout?.organisation;
+      if (!tenant || !organisation) {
+        return (0, import_helpers.tenantRequiredResponse)();
+      }
+      const clientResult = await (0, import_farseerFactory.getFarseerClientWithFallback)(organisation, tenant);
+      if (!clientResult) {
+        return (0, import_helpers.authRequiredResponse)(tenant);
+      }
+      try {
+        let files = await clientResult.client.listFiles();
+        if (!all) {
+          const scriptExtensions = [".ts", ".js", ".mjs", ".cjs"];
+          files = files.filter(
+            (f) => scriptExtensions.some((ext) => f.name.toLowerCase().endsWith(ext))
+          );
+        }
+        const byDirectory = {};
+        for (const file of files) {
+          const dir = file.path.includes("/") ? file.path.split("/").slice(0, -1).join("/") : ".";
+          if (!byDirectory[dir]) {
+            byDirectory[dir] = [];
+          }
+          byDirectory[dir].push(file.name);
+        }
+        return (0, import_helpers.successResponse)({
+          tenant,
+          totalFiles: files.length,
+          files: files.map((f) => ({
+            name: f.name,
+            path: f.path,
+            reference: f.reference
+          })),
+          byDirectory
+        });
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `List files failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  registerSyncTools
+});
+//# sourceMappingURL=syncTools.js.map