jetty-mcp-server 1.0.0 → 1.1.0

package/dist/tools.js

@@ -1,114 +1,13 @@
-import { z } from "zod";
-function jsonResult(data) {
-    return {
-        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
-    };
-}
+import { JETTY_TOOLS, jsonResult } from "./tool-definitions.js";
+export { JETTY_TOOLS, JETTY_WEBMCP_TOOLS, getJettyTool, jsonResult } from "./tool-definitions.js";
 export function registerTools(server, client) {
-    // ── Collections ──────────────────────────────────────────────
-    server.tool("list-collections", "List all collections", {}, async () => {
-        return jsonResult(await client.listCollections());
-    });
-    server.tool("get-collection", "Get collection details including environment variable keys", { collection: z.string().describe("Collection name") }, async ({ collection }) => {
-        return jsonResult(await client.getCollection(collection));
-    });
-    // ── Tasks ────────────────────────────────────────────────────
-    server.tool("list-tasks", "List tasks in a collection", { collection: z.string().describe("Collection name") }, async ({ collection }) => {
-        return jsonResult(await client.listTasks(collection));
-    });
-    server.tool("get-task", "Get task details including workflow definition", {
-        collection: z.string().describe("Collection name"),
-        task: z.string().describe("Task name"),
-    }, async ({ collection, task }) => {
-        return jsonResult(await client.getTask(collection, task));
-    });
-    server.tool("create-task", "Create a new task with a workflow definition", {
-        collection: z.string().describe("Collection name"),
-        name: z.string().describe("Task name"),
-        description: z.string().optional().describe("Task description"),
-        workflow: z
-            .record(z.unknown())
-            .describe("Workflow JSON with init_params, step_configs, and steps"),
-    }, async ({ collection, name, description, workflow }) => {
-        return jsonResult(await client.createTask(collection, name, workflow, description));
-    });
-    server.tool("update-task", "Update a task's workflow or description", {
-        collection: z.string().describe("Collection name"),
-        task: z.string().describe("Task name"),
-        workflow: z
-            .record(z.unknown())
-            .optional()
-            .describe("Updated workflow JSON"),
-        description: z.string().optional().describe("Updated description"),
-    }, async ({ collection, task, workflow, description }) => {
-        const updates = {};
-        if (workflow)
-            updates.workflow = workflow;
-        if (description)
-            updates.description = description;
-        return jsonResult(await client.updateTask(collection, task, updates));
-    });
-    // ── Run Workflows ────────────────────────────────────────────
-    server.tool("run-workflow", "Run a workflow asynchronously (returns immediately with workflow_id)", {
-        collection: z.string().describe("Collection name"),
-        task: z.string().describe("Task name"),
-        init_params: z
-            .record(z.unknown())
-            .optional()
-            .describe("Input parameters for the workflow"),
-    }, async ({ collection, task, init_params }) => {
-        return jsonResult(await client.runWorkflow(collection, task, init_params));
-    });
-    server.tool("run-workflow-sync", "Run a workflow synchronously (blocks until completion, may take 30-60s)", {
-        collection: z.string().describe("Collection name"),
-        task: z.string().describe("Task name"),
-        init_params: z
-            .record(z.unknown())
-            .optional()
-            .describe("Input parameters for the workflow"),
-    }, async ({ collection, task, init_params }) => {
-        return jsonResult(await client.runWorkflowSync(collection, task, init_params));
-    });
-    // ── Trajectories ─────────────────────────────────────────────
-    server.tool("list-trajectories", "List recent workflow runs (trajectories) for a task", {
-        collection: z.string().describe("Collection name"),
-        task: z.string().describe("Task name"),
-        limit: z.number().optional().default(10).describe("Max results"),
-        page: z.number().optional().default(1).describe("Page number"),
-    }, async ({ collection, task, limit, page }) => {
-        return jsonResult(await client.listTrajectories(collection, task, limit, page));
-    });
-    server.tool("get-trajectory", "Get full details of a specific workflow run", {
-        collection: z.string().describe("Collection name"),
-        task: z.string().describe("Task name"),
-        trajectory_id: z.string().describe("Trajectory ID"),
-    }, async ({ collection, task, trajectory_id }) => {
-        return jsonResult(await client.getTrajectory(collection, task, trajectory_id));
-    });
-    // ── Stats ────────────────────────────────────────────────────
-    server.tool("get-stats", "Get execution statistics for a task", {
-        collection: z.string().describe("Collection name"),
-        task: z.string().describe("Task name"),
-    }, async ({ collection, task }) => {
-        return jsonResult(await client.getStats(collection, task));
-    });
-    // ── Labels ───────────────────────────────────────────────────
-    server.tool("add-label", "Add a label to a trajectory (e.g., quality=high)", {
-        collection: z.string().describe("Collection name"),
-        task: z.string().describe("Task name"),
-        trajectory_id: z.string().describe("Trajectory ID"),
-        key: z.string().describe("Label key (e.g., 'quality', 'status')"),
-        value: z.string().describe("Label value (e.g., 'high', 'approved')"),
-        author: z.string().describe("Author email"),
-    }, async ({ collection, task, trajectory_id, key, value, author }) => {
-        return jsonResult(await client.addLabel(collection, task, trajectory_id, key, value, author));
-    });
-    // ── Step Templates ───────────────────────────────────────────
-    server.tool("list-step-templates", "List all available workflow step templates", {}, async () => {
-        return jsonResult(await client.listStepTemplates());
-    });
-    server.tool("get-step-template", "Get details and schema for a step template", { name: z.string().describe("Step template activity name") }, async ({ name }) => {
-        return jsonResult(await client.getStepTemplate(name));
-    });
+    for (const tool of JETTY_TOOLS) {
+        server.registerTool(tool.name, {
+            title: tool.title,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            annotations: tool.annotations,
+        }, async (args) => jsonResult(await tool.handler(client, args)));
+    }
 }
 //# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGlG,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,MAAsB;IACrE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAC7D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/webmcp.d.ts

@@ -0,0 +1,61 @@
+import type { JettyApiClient } from "./api-client.js";
+import { type JettyToolDefinition, type ToolAnnotations, type ToolResult } from "./tool-definitions.js";
+export interface WebMcpTool {
+    name: string;
+    description: string;
+    /** JSON Schema (draft-07) for the tool's input. */
+    inputSchema: Record<string, unknown>;
+    annotations: ToolAnnotations;
+    execute: (input?: Record<string, unknown>) => Promise<ToolResult>;
+}
+/** The subset of `ModelContext` this module touches, in either API shape. */
+export interface ModelContextLike {
+    registerTool?: (tool: WebMcpTool, options?: {
+        signal?: AbortSignal;
+    }) => unknown;
+    provideContext?: (context: {
+        tools: WebMcpTool[];
+    }) => unknown;
+    clearContext?: () => unknown;
+}
+export interface JettyWebMcpOptions {
+    /** Only these tool names (default: every tool). */
+    include?: string[];
+    /** Never these tool names. */
+    exclude?: string[];
+    /** Only tools whose annotations say readOnlyHint (list/get). */
+    readOnly?: boolean;
+    /** Prefix added to every tool name, e.g. "jetty_". Default: none. */
+    namePrefix?: string;
+}
+/** JSON Schema for a definition's zod input shape. */
+export declare function toolInputJsonSchema(tool: JettyToolDefinition): Record<string, unknown>;
+/** One WebMCP tool descriptor for a definition, executing through `client`. */
+export declare function toWebMcpTool(tool: JettyToolDefinition, client: JettyApiClient, namePrefix?: string): WebMcpTool;
+/**
+ * The catalog as WebMCP tool descriptors, filtered per `options`. Tools the
+ * catalog marks `webmcp: false` (trial-key management) are never exposed,
+ * even when `include` names them.
+ */
+export declare function jettyWebMcpTools(client: JettyApiClient, options?: JettyWebMcpOptions): WebMcpTool[];
+/** `document.modelContext` first (current spec), then `navigator.modelContext`. */
+export declare function findModelContext(globals?: {
+    document?: unknown;
+    navigator?: unknown;
+}): ModelContextLike | null;
+export interface RegisterJettyWebMcpResult {
+    /** Which API shape was used, or null when the context offers neither. */
+    via: "registerTool" | "provideContext" | null;
+    /** Names of the tools registered. */
+    tools: string[];
+}
+/**
+ * Register the (filtered) catalog on `modelContext`. With `registerTool`,
+ * `signal` unregisters the tools when aborted; with `provideContext`, abort
+ * calls `clearContext()` when the context has one. A signal that is already
+ * aborted registers nothing (`via: null`).
+ */
+export declare function registerJettyWebMcpTools(modelContext: ModelContextLike, client: JettyApiClient, options?: JettyWebMcpOptions & {
+    signal?: AbortSignal;
+}): RegisterJettyWebMcpResult;
+//# sourceMappingURL=webmcp.d.ts.map

package/dist/webmcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.d.ts","sourceRoot":"","sources":["../src/webmcp.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,EAAE,eAAe,CAAC;IAC7B,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACnE;AAED,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC;IACjF,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;IAC/D,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOtF;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAC1B,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,cAAc,EACtB,UAAU,SAAK,GACd,UAAU,CAiBZ;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,kBAAuB,GAC/B,UAAU,EAAE,CASd;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAGjD,GACA,gBAAgB,GAAG,IAAI,CAYzB;AAED,MAAM,WAAW,yBAAyB;IACxC,yEAAyE;IACzE,GAAG,EAAE,cAAc,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAC9C,qCAAqC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,gBAAgB,EAC9B,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,kBAAkB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAC1D,yBAAyB,CAoB3B"}

package/dist/webmcp.js

@@ -0,0 +1,98 @@
+/**
+ * WebMCP adapter: the Jetty tool catalog on a page's `modelContext`
+ * (https://webmachinelearning.github.io/webmcp/). Browser-safe.
+ *
+ * A site that already authenticates the visitor registers the same tools the
+ * stdio MCP server offers, executed with the visitor's own session:
+ *
+ *   const client = new JettyApiClient({ token: () => session.getToken(), ... });
+ *   registerJettyWebMcpTools(navigator.modelContext, client, { signal });
+ *
+ * Both API shapes are handled: the current `registerTool(tool, { signal })`
+ * and the earlier `provideContext({ tools })`.
+ */
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { JETTY_WEBMCP_TOOLS, jsonResult, } from "./tool-definitions.js";
+/** JSON Schema for a definition's zod input shape. */
+export function toolInputJsonSchema(tool) {
+    const schema = zodToJsonSchema(z.object(tool.inputSchema), {
+        target: "jsonSchema7",
+        $refStrategy: "none",
+    });
+    delete schema.$schema;
+    return schema;
+}
+/** One WebMCP tool descriptor for a definition, executing through `client`. */
+export function toWebMcpTool(tool, client, namePrefix = "") {
+    const parser = z.object(tool.inputSchema);
+    return {
+        name: `${namePrefix}${tool.name}`,
+        description: tool.description,
+        inputSchema: toolInputJsonSchema(tool),
+        annotations: tool.annotations,
+        execute: async (input) => {
+            try {
+                const args = parser.parse(input ?? {});
+                return jsonResult(await tool.handler(client, args));
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+            }
+        },
+    };
+}
+/**
+ * The catalog as WebMCP tool descriptors, filtered per `options`. Tools the
+ * catalog marks `webmcp: false` (trial-key management) are never exposed,
+ * even when `include` names them.
+ */
+export function jettyWebMcpTools(client, options = {}) {
+    const include = options.include ? new Set(options.include) : null;
+    const exclude = new Set(options.exclude ?? []);
+    return JETTY_WEBMCP_TOOLS.filter((tool) => (!include || include.has(tool.name)) &&
+        !exclude.has(tool.name) &&
+        (!options.readOnly || tool.annotations.readOnlyHint)).map((tool) => toWebMcpTool(tool, client, options.namePrefix));
+}
+/** `document.modelContext` first (current spec), then `navigator.modelContext`. */
+export function findModelContext(globals = globalThis) {
+    for (const host of [globals.document, globals.navigator]) {
+        const candidate = host?.modelContext;
+        if (candidate &&
+            (typeof candidate.registerTool === "function" ||
+                typeof candidate.provideContext === "function")) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Register the (filtered) catalog on `modelContext`. With `registerTool`,
+ * `signal` unregisters the tools when aborted; with `provideContext`, abort
+ * calls `clearContext()` when the context has one. A signal that is already
+ * aborted registers nothing (`via: null`).
+ */
+export function registerJettyWebMcpTools(modelContext, client, options = {}) {
+    // An AbortSignal never replays an earlier abort, so a signal that is
+    // already aborted would register tools nothing ever unregisters.
+    if (options.signal?.aborted)
+        return { via: null, tools: [] };
+    const tools = jettyWebMcpTools(client, options);
+    const names = tools.map((tool) => tool.name);
+    if (typeof modelContext.registerTool === "function") {
+        for (const tool of tools) {
+            modelContext.registerTool(tool, options.signal ? { signal: options.signal } : undefined);
+        }
+        return { via: "registerTool", tools: names };
+    }
+    if (typeof modelContext.provideContext === "function") {
+        modelContext.provideContext({ tools });
+        if (options.signal && typeof modelContext.clearContext === "function") {
+            options.signal.addEventListener("abort", () => modelContext.clearContext?.(), { once: true });
+        }
+        return { via: "provideContext", tools: names };
+    }
+    return { via: null, tools: [] };
+}
+//# sourceMappingURL=webmcp.js.map

package/dist/webmcp.js.map

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

package/package.json

@@ -1,23 +1,68 @@
 {
   "name": "jetty-mcp-server",
-  "version": "1.0.0",
-  "description": "MCP server for Jetty AI/ML workflow platform",
+  "version": "1.1.0",
+  "description": "MCP server for the Jetty agent workload platform, plus the same tools for WebMCP in the browser",
   "type": "module",
   "bin": {
     "jetty-mcp-server": "dist/index.js"
   },
-  "main": "dist/index.js",
+  "main": "dist/lib.js",
+  "types": "dist/lib.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/lib.d.ts",
+      "default": "./dist/lib.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./api-client": {
+      "types": "./dist/api-client.d.ts",
+      "default": "./dist/api-client.js"
+    },
+    "./tool-definitions": {
+      "types": "./dist/tool-definitions.d.ts",
+      "default": "./dist/tool-definitions.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "default": "./dist/tools.js"
+    },
+    "./webmcp": {
+      "types": "./dist/webmcp.d.ts",
+      "default": "./dist/webmcp.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": [
+    "./dist/index.js"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
+    "pretest": "npm run build",
+    "test": "node --test 'tests/**/*.test.mjs'",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["mcp", "jetty", "ai", "ml", "workflows"],
+  "keywords": [
+    "mcp",
+    "webmcp",
+    "jetty",
+    "ai",
+    "agents",
+    "runbooks"
+  ],
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "zod": "^3.24.4"
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "zod": "^3.24.4",
+    "zod-to-json-schema": "^3.24.1"
   },
   "devDependencies": {
     "@types/node": "^22.15.3",

package/src/client.ts

@@ -1,206 +0,0 @@
-const DOCK_URL = process.env.JETTY_DOCK_URL || "https://dock.jetty.io";
-const FLOWS_URL = process.env.JETTY_FLOWS_URL || "https://flows-api.jetty.io";
-
-export class JettyClient {
-  private token: string;
-  private dockUrl: string;
-  private flowsUrl: string;
-
-  constructor() {
-    const token = process.env.JETTY_API_TOKEN;
-    if (!token) {
-      throw new Error(
-        "JETTY_API_TOKEN environment variable is required. " +
-          "Get your token at https://flows.jetty.io → Settings → API Tokens"
-      );
-    }
-    this.token = token;
-    this.dockUrl = DOCK_URL;
-    this.flowsUrl = FLOWS_URL;
-  }
-
-  private async request(
-    baseUrl: string,
-    path: string,
-    options: RequestInit = {}
-  ): Promise<unknown> {
-    const url = `${baseUrl}${path}`;
-    const headers: Record<string, string> = {
-      Authorization: `Bearer ${this.token}`,
-      ...((options.headers as Record<string, string>) || {}),
-    };
-
-    const res = await fetch(url, { ...options, headers });
-
-    if (!res.ok) {
-      const body = await res.text();
-      throw new Error(`Jetty API error ${res.status}: ${body}`);
-    }
-
-    const contentType = res.headers.get("content-type") || "";
-    if (contentType.includes("application/json")) {
-      return res.json();
-    }
-    return res.text();
-  }
-
-  private dock(path: string, options?: RequestInit) {
-    return this.request(this.dockUrl, path, options);
-  }
-
-  private flows(path: string, options?: RequestInit) {
-    return this.request(this.flowsUrl, path, options);
-  }
-
-  // Collections
-  async listCollections() {
-    return this.dock("/api/v1/collections/");
-  }
-
-  async getCollection(collection: string) {
-    return this.dock(`/api/v1/collections/${collection}`);
-  }
-
-  // Tasks
-  async listTasks(collection: string) {
-    return this.dock(`/api/v1/tasks/${collection}/`);
-  }
-
-  async getTask(collection: string, task: string) {
-    return this.dock(`/api/v1/tasks/${collection}/${task}`);
-  }
-
-  async createTask(
-    collection: string,
-    name: string,
-    workflow: unknown,
-    description?: string
-  ) {
-    return this.dock(`/api/v1/tasks/${collection}`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ name, description: description || "", workflow }),
-    });
-  }
-
-  async updateTask(
-    collection: string,
-    task: string,
-    updates: { workflow?: unknown; description?: string }
-  ) {
-    return this.dock(`/api/v1/tasks/${collection}/${task}`, {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(updates),
-    });
-  }
-
-  async deleteTask(collection: string, task: string) {
-    return this.dock(`/api/v1/tasks/${collection}/${task}`, {
-      method: "DELETE",
-    });
-  }
-
-  // Run workflows
-  async runWorkflow(
-    collection: string,
-    task: string,
-    initParams?: Record<string, unknown>
-  ) {
-    const formData = new FormData();
-    formData.append("bakery_host", this.dockUrl);
-    formData.append("init_params", JSON.stringify(initParams || {}));
-
-    return this.flows(`/api/v1/run/${collection}/${task}`, {
-      method: "POST",
-      body: formData,
-    });
-  }
-
-  async runWorkflowSync(
-    collection: string,
-    task: string,
-    initParams?: Record<string, unknown>
-  ) {
-    const formData = new FormData();
-    formData.append("bakery_host", this.dockUrl);
-    formData.append("init_params", JSON.stringify(initParams || {}));
-
-    return this.flows(`/api/v1/run-sync/${collection}/${task}`, {
-      method: "POST",
-      body: formData,
-    });
-  }
-
-  // Trajectories
-  async listTrajectories(
-    collection: string,
-    task: string,
-    limit = 10,
-    page = 1
-  ) {
-    return this.flows(
-      `/api/v1/db/trajectories/${collection}/${task}?limit=${limit}&page=${page}`
-    );
-  }
-
-  async getTrajectory(
-    collection: string,
-    task: string,
-    trajectoryId: string
-  ) {
-    return this.flows(
-      `/api/v1/db/trajectory/${collection}/${task}/${trajectoryId}`
-    );
-  }
-
-  // Stats
-  async getStats(collection: string, task: string) {
-    return this.flows(`/api/v1/db/stats/${collection}/${task}`);
-  }
-
-  // Labels
-  async addLabel(
-    collection: string,
-    task: string,
-    trajectoryId: string,
-    key: string,
-    value: string,
-    author: string
-  ) {
-    return this.flows(
-      `/api/v1/trajectory/${collection}/${task}/${trajectoryId}/labels`,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ key, value, author }),
-      }
-    );
-  }
-
-  // Workflow logs
-  async getWorkflowLogs(workflowId: string) {
-    return this.flows(`/api/v1/workflows-logs/${workflowId}`);
-  }
-
-  // Step templates
-  async listStepTemplates() {
-    return this.request(this.flowsUrl, "/api/v1/step-templates");
-  }
-
-  async getStepTemplate(name: string) {
-    return this.request(this.flowsUrl, `/api/v1/step-templates/${name}`);
-  }
-
-  // Environment variables
-  async setEnvironmentVars(
-    collection: string,
-    vars: Record<string, string>
-  ) {
-    return this.dock(`/api/v1/collections/${collection}/environment`, {
-      method: "PATCH",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ environment_variables: vars }),
-    });
-  }
-}

package/src/index.ts

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { JettyClient } from "./client.js";
-import { registerTools } from "./tools.js";
-
-const server = new McpServer({
-  name: "jetty",
-  version: "1.0.0",
-});
-
-const client = new JettyClient();
-registerTools(server, client);
-
-const transport = new StdioServerTransport();
-await server.connect(transport);