farseer-cli 1.0.0

package/dist/mcp/resources/documentation.js

@@ -0,0 +1,167 @@
+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 documentation_exports = {};
+__export(documentation_exports, {
+  registerDocumentationResources: () => registerDocumentationResources
+});
+module.exports = __toCommonJS(documentation_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+const DOCS = [
+  {
+    name: "how-farseer-works",
+    uri: "farseer://docs/how-farseer-works",
+    title: "How Farseer Works",
+    description: "Core Farseer concepts: Dimensions, Variables, Formulas, Versions. ESSENTIAL reading for understanding the data model.",
+    filePath: "../../../docs/how-farseer-works.md"
+  },
+  {
+    name: "cli-guide",
+    uri: "farseer://docs/cli-guide",
+    title: "CLI Guide",
+    description: "Complete guide to Farseer CLI commands: pull, push, apps, run, model, checkout.",
+    filePath: "../../../docs/cli-guide.md"
+  },
+  {
+    name: "api-reference",
+    uri: "farseer://docs/api-reference",
+    title: "farseer-client API Reference",
+    description: "Full API documentation for farseer-client: FarseerClient, queries, imports, dimensions, variables.",
+    filePath: "../../../docs/api-reference.md"
+  },
+  {
+    name: "new-app-template",
+    uri: "farseer://docs/new-app-template",
+    title: "New App Template",
+    description: "Template and structure for creating new Farseer apps (Remote Jobs).",
+    filePath: "../../../docs/new-app-template.md"
+  },
+  {
+    name: "troubleshooting",
+    uri: "farseer://docs/troubleshooting",
+    title: "Troubleshooting Guide",
+    description: "Common issues and solutions: auth errors, sync conflicts, API errors, performance.",
+    filePath: "../../../docs/troubleshooting.md"
+  },
+  {
+    name: "import-workflows",
+    uri: "farseer://docs/import-workflows",
+    title: "Import Workflows",
+    description: "Patterns for data imports: CSV, Excel, API, batch processing, error handling.",
+    filePath: "../../../docs/import-workflows.md"
+  },
+  {
+    name: "arquero-patterns",
+    uri: "farseer://docs/arquero-patterns",
+    title: "Arquero Data Processing",
+    description: "Using Arquero for data transformation: filtering, grouping, pivoting, joins.",
+    filePath: "../../../docs/arquero-patterns.md"
+  },
+  {
+    name: "query-formulas",
+    uri: "farseer://docs/query-formulas",
+    title: "Query and Formula Guide",
+    description: "Querying data and understanding formulas: filters, aggregations, formula syntax.",
+    filePath: "../../../docs/query-formulas.md"
+  },
+  {
+    name: "model-export",
+    uri: "farseer://docs/model-export",
+    title: "Model Export Guide",
+    description: "Understanding model exports: tables, variables, relationships, folder structure.",
+    filePath: "../../../docs/model-export.md"
+  }
+];
+function loadDocContent(doc) {
+  try {
+    const fullPath = path.resolve(__dirname, doc.filePath);
+    return fs.readFileSync(fullPath, "utf-8");
+  } catch (error) {
+    return `# ${doc.title}
+
+[Documentation file not found: ${doc.filePath}]
+
+This may happen if the CLI was installed globally and documentation files were not included in the package.`;
+  }
+}
+function registerDocumentationResources(server) {
+  server.resource(
+    "farseer-docs-list",
+    "farseer://docs",
+    {
+      description: "List of all available Farseer documentation",
+      mimeType: "application/json"
+    },
+    () => {
+      return {
+        contents: [
+          {
+            uri: "farseer://docs",
+            mimeType: "application/json",
+            text: JSON.stringify(
+              DOCS.map((doc) => ({
+                name: doc.name,
+                uri: doc.uri,
+                title: doc.title,
+                description: doc.description
+              })),
+              null,
+              2
+            )
+          }
+        ]
+      };
+    }
+  );
+  for (const doc of DOCS) {
+    server.resource(
+      doc.name,
+      doc.uri,
+      {
+        description: doc.description,
+        mimeType: "text/markdown"
+      },
+      () => {
+        return {
+          contents: [
+            {
+              uri: doc.uri,
+              mimeType: "text/markdown",
+              text: loadDocContent(doc)
+            }
+          ]
+        };
+      }
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  registerDocumentationResources
+});
+//# sourceMappingURL=documentation.js.map

package/dist/mcp/resources/documentation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/resources/documentation.ts"],
+  "sourcesContent": ["/**\n * Documentation Resources\n *\n * Exposes Farseer documentation as MCP resources for AI assistants.\n * Documentation is read from files at runtime (bundled with npm package).\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport * as fs from 'fs';\nimport * as path from 'path';\n\ninterface DocResource {\n    name: string;\n    uri: string;\n    title: string;\n    description: string;\n    filePath: string;\n}\n\n// Documentation metadata - actual content loaded on demand\nconst DOCS: DocResource[] = [\n    {\n        name: 'how-farseer-works',\n        uri: 'farseer://docs/how-farseer-works',\n        title: 'How Farseer Works',\n        description:\n            'Core Farseer concepts: Dimensions, Variables, Formulas, Versions. ESSENTIAL reading for understanding the data model.',\n        filePath: '../../../docs/how-farseer-works.md',\n    },\n    {\n        name: 'cli-guide',\n        uri: 'farseer://docs/cli-guide',\n        title: 'CLI Guide',\n        description: 'Complete guide to Farseer CLI commands: pull, push, apps, run, model, checkout.',\n        filePath: '../../../docs/cli-guide.md',\n    },\n    {\n        name: 'api-reference',\n        uri: 'farseer://docs/api-reference',\n        title: 'farseer-client API Reference',\n        description:\n            'Full API documentation for farseer-client: FarseerClient, queries, imports, dimensions, variables.',\n        filePath: '../../../docs/api-reference.md',\n    },\n    {\n        name: 'new-app-template',\n        uri: 'farseer://docs/new-app-template',\n        title: 'New App Template',\n        description: 'Template and structure for creating new Farseer apps (Remote Jobs).',\n        filePath: '../../../docs/new-app-template.md',\n    },\n    {\n        name: 'troubleshooting',\n        uri: 'farseer://docs/troubleshooting',\n        title: 'Troubleshooting Guide',\n        description: 'Common issues and solutions: auth errors, sync conflicts, API errors, performance.',\n        filePath: '../../../docs/troubleshooting.md',\n    },\n    {\n        name: 'import-workflows',\n        uri: 'farseer://docs/import-workflows',\n        title: 'Import Workflows',\n        description: 'Patterns for data imports: CSV, Excel, API, batch processing, error handling.',\n        filePath: '../../../docs/import-workflows.md',\n    },\n    {\n        name: 'arquero-patterns',\n        uri: 'farseer://docs/arquero-patterns',\n        title: 'Arquero Data Processing',\n        description: 'Using Arquero for data transformation: filtering, grouping, pivoting, joins.',\n        filePath: '../../../docs/arquero-patterns.md',\n    },\n    {\n        name: 'query-formulas',\n        uri: 'farseer://docs/query-formulas',\n        title: 'Query and Formula Guide',\n        description: 'Querying data and understanding formulas: filters, aggregations, formula syntax.',\n        filePath: '../../../docs/query-formulas.md',\n    },\n    {\n        name: 'model-export',\n        uri: 'farseer://docs/model-export',\n        title: 'Model Export Guide',\n        description: 'Understanding model exports: tables, variables, relationships, folder structure.',\n        filePath: '../../../docs/model-export.md',\n    },\n];\n\nfunction loadDocContent(doc: DocResource): string {\n    try {\n        const fullPath = path.resolve(__dirname, doc.filePath);\n        return fs.readFileSync(fullPath, 'utf-8');\n    } catch (error) {\n        return `# ${doc.title}\\n\\n[Documentation file not found: ${doc.filePath}]\\n\\nThis may happen if the CLI was installed globally and documentation files were not included in the package.`;\n    }\n}\n\nexport function registerDocumentationResources(server: McpServer): void {\n    // Register list of all docs\n    server.resource(\n        'farseer-docs-list',\n        'farseer://docs',\n        {\n            description: 'List of all available Farseer documentation',\n            mimeType: 'application/json',\n        },\n        () => {\n            return {\n                contents: [\n                    {\n                        uri: 'farseer://docs',\n                        mimeType: 'application/json',\n                        text: JSON.stringify(\n                            DOCS.map((doc) => ({\n                                name: doc.name,\n                                uri: doc.uri,\n                                title: doc.title,\n                                description: doc.description,\n                            })),\n                            null,\n                            2\n                        ),\n                    },\n                ],\n            };\n        }\n    );\n\n    // Register each doc individually\n    for (const doc of DOCS) {\n        server.resource(\n            doc.name,\n            doc.uri,\n            {\n                description: doc.description,\n                mimeType: 'text/markdown',\n            },\n            () => {\n                return {\n                    contents: [\n                        {\n                            uri: doc.uri,\n                            mimeType: 'text/markdown',\n                            text: loadDocContent(doc),\n                        },\n                    ],\n                };\n            }\n        );\n    }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAoB;AACpB,WAAsB;AAWtB,MAAM,OAAsB;AAAA,EACxB;AAAA,IACI,MAAM;AAAA,IACN,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aACI;AAAA,IACJ,UAAU;AAAA,EACd;AAAA,EACA;AAAA,IACI,MAAM;AAAA,IACN,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,UAAU;AAAA,EACd;AAAA,EACA;AAAA,IACI,MAAM;AAAA,IACN,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aACI;AAAA,IACJ,UAAU;AAAA,EACd;AAAA,EACA;AAAA,IACI,MAAM;AAAA,IACN,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,UAAU;AAAA,EACd;AAAA,EACA;AAAA,IACI,MAAM;AAAA,IACN,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,UAAU;AAAA,EACd;AAAA,EACA;AAAA,IACI,MAAM;AAAA,IACN,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,UAAU;AAAA,EACd;AAAA,EACA;AAAA,IACI,MAAM;AAAA,IACN,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,UAAU;AAAA,EACd;AAAA,EACA;AAAA,IACI,MAAM;AAAA,IACN,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,UAAU;AAAA,EACd;AAAA,EACA;AAAA,IACI,MAAM;AAAA,IACN,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,UAAU;AAAA,EACd;AACJ;AAEA,SAAS,eAAe,KAA0B;AAC9C,MAAI;AACA,UAAM,WAAW,KAAK,QAAQ,WAAW,IAAI,QAAQ;AACrD,WAAO,GAAG,aAAa,UAAU,OAAO;AAAA,EAC5C,SAAS,OAAO;AACZ,WAAO,KAAK,IAAI,KAAK;AAAA;AAAA,iCAAsC,IAAI,QAAQ;AAAA;AAAA;AAAA,EAC3E;AACJ;AAEO,SAAS,+BAA+B,QAAyB;AAEpE,SAAO;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,MACI,aAAa;AAAA,MACb,UAAU;AAAA,IACd;AAAA,IACA,MAAM;AACF,aAAO;AAAA,QACH,UAAU;AAAA,UACN;AAAA,YACI,KAAK;AAAA,YACL,UAAU;AAAA,YACV,MAAM,KAAK;AAAA,cACP,KAAK,IAAI,CAAC,SAAS;AAAA,gBACf,MAAM,IAAI;AAAA,gBACV,KAAK,IAAI;AAAA,gBACT,OAAO,IAAI;AAAA,gBACX,aAAa,IAAI;AAAA,cACrB,EAAE;AAAA,cACF;AAAA,cACA;AAAA,YACJ;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAGA,aAAW,OAAO,MAAM;AACpB,WAAO;AAAA,MACH,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ;AAAA,QACI,aAAa,IAAI;AAAA,QACjB,UAAU;AAAA,MACd;AAAA,MACA,MAAM;AACF,eAAO;AAAA,UACH,UAAU;AAAA,YACN;AAAA,cACI,KAAK,IAAI;AAAA,cACT,UAAU;AAAA,cACV,MAAM,eAAe,GAAG;AAAA,YAC5B;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AACJ;",
+  "names": []
+}

package/dist/mcp/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP Server Configuration
+ *
+ * Creates and configures the Farseer MCP server with all tools, resources, and prompts.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createMcpServer(): McpServer;

package/dist/mcp/server.js

@@ -0,0 +1,49 @@
+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 server_exports = {};
+__export(server_exports, {
+  createMcpServer: () => createMcpServer
+});
+module.exports = __toCommonJS(server_exports);
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var import_authTools = require("./tools/authTools");
+var import_syncTools = require("./tools/syncTools");
+var import_appTools = require("./tools/appTools");
+var import_modelTools = require("./tools/modelTools");
+var import_runTools = require("./tools/runTools");
+var import_documentation = require("./resources/documentation");
+var import_workflows = require("./prompts/workflows");
+function createMcpServer() {
+  const server = new import_mcp.McpServer({
+    name: "farseer-cli",
+    version: "1.0.0"
+  });
+  (0, import_authTools.registerAuthTools)(server);
+  (0, import_syncTools.registerSyncTools)(server);
+  (0, import_appTools.registerAppTools)(server);
+  (0, import_modelTools.registerModelTools)(server);
+  (0, import_runTools.registerRunTools)(server);
+  (0, import_documentation.registerDocumentationResources)(server);
+  (0, import_workflows.registerWorkflowPrompts)(server);
+  return server;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMcpServer
+});
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/mcp/server.ts"],
+  "sourcesContent": ["/**\n * MCP Server Configuration\n *\n * Creates and configures the Farseer MCP server with all tools, resources, and prompts.\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { registerAuthTools } from './tools/authTools';\nimport { registerSyncTools } from './tools/syncTools';\nimport { registerAppTools } from './tools/appTools';\nimport { registerModelTools } from './tools/modelTools';\nimport { registerRunTools } from './tools/runTools';\nimport { registerDocumentationResources } from './resources/documentation';\nimport { registerWorkflowPrompts } from './prompts/workflows';\n\nexport function createMcpServer(): McpServer {\n    const server = new McpServer({\n        name: 'farseer-cli',\n        version: '1.0.0',\n    });\n\n    // Register all tools\n    registerAuthTools(server);\n    registerSyncTools(server);\n    registerAppTools(server);\n    registerModelTools(server);\n    registerRunTools(server);\n\n    // Register resources (documentation)\n    registerDocumentationResources(server);\n\n    // Register prompts (workflow templates)\n    registerWorkflowPrompts(server);\n\n    return server;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,iBAA0B;AAC1B,uBAAkC;AAClC,uBAAkC;AAClC,sBAAiC;AACjC,wBAAmC;AACnC,sBAAiC;AACjC,2BAA+C;AAC/C,uBAAwC;AAEjC,SAAS,kBAA6B;AACzC,QAAM,SAAS,IAAI,qBAAU;AAAA,IACzB,MAAM;AAAA,IACN,SAAS;AAAA,EACb,CAAC;AAGD,0CAAkB,MAAM;AACxB,0CAAkB,MAAM;AACxB,wCAAiB,MAAM;AACvB,4CAAmB,MAAM;AACzB,wCAAiB,MAAM;AAGvB,2DAA+B,MAAM;AAGrC,gDAAwB,MAAM;AAE9B,SAAO;AACX;",
+  "names": []
+}

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

@@ -0,0 +1,7 @@
+/**
+ * App Management Tools
+ *
+ * Tools for managing Farseer apps (Remote Jobs).
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAppTools(server: McpServer): void;

package/dist/mcp/tools/appTools.js

@@ -0,0 +1,377 @@
+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 appTools_exports = {};
+__export(appTools_exports, {
+  registerAppTools: () => registerAppTools
+});
+module.exports = __toCommonJS(appTools_exports);
+var import_zod = require("zod");
+var import_farseerFactory = require("../../services/farseerFactory");
+var import_configService = require("../../services/configService");
+var import_helpers = require("../utils/helpers");
+const listAppsSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name"),
+  details: import_zod.z.boolean().optional().describe("Include full details for each app")
+};
+const getAppSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name"),
+  appName: import_zod.z.string().describe("Name of the app (can include spaces)")
+};
+const createAppSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name"),
+  appName: import_zod.z.string().describe("Name for the new app")
+};
+const argumentSchema = import_zod.z.object({
+  name: import_zod.z.string(),
+  defaultValue: import_zod.z.string()
+});
+const configureAppSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name"),
+  appName: import_zod.z.string().describe("Name of the app to configure"),
+  entrypoint: import_zod.z.string().optional().describe('Main script filename (e.g., "index.ts")'),
+  scripts: import_zod.z.array(import_zod.z.string()).optional().describe("List of script filenames to include"),
+  description: import_zod.z.string().optional().describe("App description"),
+  arguments: import_zod.z.array(argumentSchema).optional().describe("App arguments with default values"),
+  newName: import_zod.z.string().optional().describe("Rename the app")
+};
+const deleteAppSchema = {
+  tenant: import_zod.z.string().optional().describe("Tenant name"),
+  appName: import_zod.z.string().describe("Name of the app to delete")
+};
+function registerAppTools(server) {
+  server.tool(
+    "farseer_list_apps",
+    `List all apps (Remote Jobs) configured on a Farseer tenant.
+
+Apps are executable script configurations that include:
+- Entry point script
+- List of included scripts
+- Expected arguments with default values
+
+Use details=true to include full information for each app.
+
+If no tenant is specified, uses the currently checked-out tenant.`,
+    listAppsSchema,
+    async (params) => {
+      const { tenant: tenantArg, details } = 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 appList = await clientResult.client.listApps();
+        if (!details) {
+          return (0, import_helpers.successResponse)({
+            tenant,
+            totalApps: appList.length,
+            apps: appList.map((a) => ({
+              name: a.name,
+              id: a.id,
+              reference: a.reference
+            }))
+          });
+        }
+        const appsWithDetails = [];
+        for (const item of appList) {
+          const app = await clientResult.client.getApp(item.reference);
+          if (app) {
+            const mainScript = app.scriptFiles.find((s) => s.id === app.mainScriptFileId);
+            appsWithDetails.push({
+              name: app.name,
+              id: app.id,
+              description: app.description || "",
+              entrypoint: mainScript?.name || null,
+              scripts: app.scriptFiles.map((s) => s.name),
+              arguments: app.expectedArguments.map((a) => ({
+                name: a.name,
+                defaultValue: a.defaultValue
+              }))
+            });
+          }
+        }
+        return (0, import_helpers.successResponse)({
+          tenant,
+          totalApps: appsWithDetails.length,
+          apps: appsWithDetails
+        });
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `List apps failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+  server.tool(
+    "farseer_get_app",
+    `Get detailed information about a specific Farseer app.
+
+Returns:
+- App name and description
+- Entry point script (main script that runs)
+- List of all included scripts
+- Expected arguments with their default values
+
+If no tenant is specified, uses the currently checked-out tenant.`,
+    getAppSchema,
+    async (params) => {
+      const { tenant: tenantArg, appName } = 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 app = await clientResult.client.getAppByName(appName);
+        if (!app) {
+          return (0, import_helpers.errorResponse)(`App "${appName}" not found`, "NOT_FOUND");
+        }
+        const mainScript = app.scriptFiles.find((s) => s.id === app.mainScriptFileId);
+        return (0, import_helpers.successResponse)({
+          tenant,
+          app: {
+            id: app.id,
+            name: app.name,
+            description: app.description || "",
+            entrypoint: mainScript?.name || null,
+            scripts: app.scriptFiles.map((s) => ({
+              id: s.id,
+              name: s.name,
+              isEntrypoint: s.id === app.mainScriptFileId
+            })),
+            arguments: app.expectedArguments.map((a) => ({
+              name: a.name,
+              type: a.type,
+              defaultValue: a.defaultValue
+            })),
+            status: app.status,
+            lastHeartbeat: app.lastHeartbeat
+          }
+        });
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `Get app failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+  server.tool(
+    "farseer_create_app",
+    `Create a new app (Remote Job) on a Farseer tenant.
+
+This creates an empty app shell. After creation, use farseer_configure_app to:
+- Set the entry point script
+- Add scripts to the app
+- Configure arguments
+
+Scripts must exist on the remote (push them first if they're new).
+
+If no tenant is specified, uses the currently checked-out tenant.`,
+    createAppSchema,
+    async (params) => {
+      const { tenant: tenantArg, appName } = 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 existing = await clientResult.client.getAppByName(appName);
+        if (existing) {
+          return (0, import_helpers.errorResponse)(`App "${appName}" already exists`, "VALIDATION_ERROR");
+        }
+        const app = await clientResult.client.createApp(appName);
+        return (0, import_helpers.successResponse)({
+          tenant,
+          app: {
+            id: app.id,
+            name: app.name
+          },
+          message: `App "${appName}" created. Use farseer_configure_app to set entrypoint, scripts, and arguments.`
+        });
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `Create app failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+  server.tool(
+    "farseer_configure_app",
+    `Configure an existing Farseer app.
+
+You can set:
+- entrypoint: Main script to execute (e.g., "index.ts")
+- scripts: List of scripts to include in the app
+- description: App description
+- arguments: List of expected arguments with default values
+- newName: Rename the app
+
+Important:
+- Scripts must exist on the remote (push them first)
+- If you set scripts but not entrypoint, the first script becomes entrypoint
+- Arguments are passed to the script via command line
+
+If no tenant is specified, uses the currently checked-out tenant.`,
+    configureAppSchema,
+    async (params) => {
+      const { tenant: tenantArg, appName, entrypoint, scripts, description, arguments: args, newName } = 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 app = await clientResult.client.getAppByName(appName);
+        if (!app) {
+          return (0, import_helpers.errorResponse)(`App "${appName}" not found`, "NOT_FOUND");
+        }
+        const availableScripts = await clientResult.client.getScriptFiles();
+        const scriptIdMap = new Map(availableScripts.map((s) => [s.name.toLowerCase(), s.id]));
+        const update = {};
+        if (newName) {
+          update.name = newName;
+        }
+        if (description !== void 0) {
+          update.description = description;
+        }
+        if (args) {
+          update.expectedArguments = args.map((a) => ({
+            name: a.name,
+            type: "variable",
+            defaultValue: a.defaultValue
+          }));
+        }
+        if (scripts && scripts.length > 0) {
+          const scriptIds = [];
+          const notFound = [];
+          for (const scriptName of scripts) {
+            const id = scriptIdMap.get(scriptName.toLowerCase());
+            if (id) {
+              scriptIds.push(id);
+            } else {
+              notFound.push(scriptName);
+            }
+          }
+          if (notFound.length > 0) {
+            return (0, import_helpers.errorResponse)(
+              `Scripts not found on remote: ${notFound.join(", ")}. Push them first.`,
+              "VALIDATION_ERROR"
+            );
+          }
+          update.scriptFileIds = scriptIds;
+          if (!entrypoint && scriptIds.length > 0) {
+            update.mainScriptFileId = scriptIds[0];
+          }
+        }
+        if (entrypoint) {
+          const entrypointId = scriptIdMap.get(entrypoint.toLowerCase());
+          if (!entrypointId) {
+            return (0, import_helpers.errorResponse)(
+              `Entrypoint script "${entrypoint}" not found on remote. Push it first.`,
+              "VALIDATION_ERROR"
+            );
+          }
+          update.mainScriptFileId = entrypointId;
+        }
+        const reference = app.id.toString();
+        await clientResult.client.updateApp(reference, update);
+        return (0, import_helpers.successResponse)({
+          tenant,
+          appName: newName || appName,
+          updated: Object.keys(update),
+          message: `App "${appName}" configured successfully`
+        });
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `Configure app failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+  server.tool(
+    "farseer_delete_app",
+    `Delete an app from a Farseer tenant.
+
+WARNING: This is irreversible - the app will be permanently removed from the remote instance.
+
+This does NOT delete the script files, only the app configuration.
+
+If no tenant is specified, uses the currently checked-out tenant.`,
+    deleteAppSchema,
+    async (params) => {
+      const { tenant: tenantArg, appName } = 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 app = await clientResult.client.getAppByName(appName);
+        if (!app) {
+          return (0, import_helpers.errorResponse)(`App "${appName}" not found`, "NOT_FOUND");
+        }
+        await clientResult.client.deleteApp(app.id.toString());
+        return (0, import_helpers.successResponse)({
+          tenant,
+          deletedApp: appName,
+          message: `App "${appName}" has been deleted`
+        });
+      } catch (error) {
+        return (0, import_helpers.errorResponse)(
+          `Delete app failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+          "NETWORK_ERROR"
+        );
+      }
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  registerAppTools
+});
+//# sourceMappingURL=appTools.js.map