@episoda/mcp 0.1.11 → 0.1.12

package/dist/workflow-server.js

@@ -20,7 +20,8 @@ var readEnvConfig = () => ({
   apiUrl: normalizeEnv(process.env.EPISODA_API_URL),
   sessionToken: normalizeEnv(process.env.EPISODA_SESSION_TOKEN),
   projectId: normalizeEnv(process.env.EPISODA_PROJECT_ID),
-  workspaceId: normalizeEnv(process.env.EPISODA_WORKSPACE_ID)
+  workspaceId: normalizeEnv(process.env.EPISODA_WORKSPACE_ID),
+  machineUuid: normalizeEnv(process.env.EPISODA_MACHINE_UUID)
 });
 var buildMissingMessage = (missing, apiUrl) => {
   return [
@@ -52,14 +53,15 @@ var loadLocalConfig = () => {
 async function resolveRuntimeConfig() {
   const envConfig = readEnvConfig();
   let fileConfig = null;
-  if (!envConfig.sessionToken || !envConfig.projectId || !envConfig.workspaceId || !envConfig.apiUrl) {
+  if (!envConfig.sessionToken || !envConfig.projectId || !envConfig.workspaceId || !envConfig.apiUrl || !envConfig.machineUuid) {
     fileConfig = loadLocalConfig();
   }
   const resolved = {
     apiUrl: envConfig.apiUrl || fileConfig?.api_url || DEFAULT_API_URL,
     sessionToken: envConfig.sessionToken || fileConfig?.access_token || "",
     projectId: envConfig.projectId || fileConfig?.project_id || "",
-    workspaceId: envConfig.workspaceId || fileConfig?.workspace_id || ""
+    workspaceId: envConfig.workspaceId || fileConfig?.workspace_id || "",
+    machineUuid: envConfig.machineUuid || fileConfig?.machine_uuid || fileConfig?.device_id || void 0
   };
   const missing = [];
   if (!resolved.sessionToken) missing.push("EPISODA_SESSION_TOKEN");
@@ -84,39 +86,84 @@ async function hydrateRuntimeConfig() {
   if (!normalizeEnv(process.env.EPISODA_WORKSPACE_ID)) {
     process.env.EPISODA_WORKSPACE_ID = resolved.workspaceId;
   }
+  if (resolved.machineUuid && !normalizeEnv(process.env.EPISODA_MACHINE_UUID)) {
+    process.env.EPISODA_MACHINE_UUID = resolved.machineUuid;
+  }
   return resolved;
 }
 
-// src/workflow-server.ts
-var EPISODA_API_URL = process.env.EPISODA_API_URL || "https://episoda.dev";
-var EPISODA_SESSION_TOKEN = process.env.EPISODA_SESSION_TOKEN || "";
-var EPISODA_PROJECT_ID = process.env.EPISODA_PROJECT_ID || "";
-var EPISODA_WORKSPACE_ID = process.env.EPISODA_WORKSPACE_ID || "";
-async function apiRequest(method, path2, body) {
-  const url = `${EPISODA_API_URL}${path2}`;
+// src/request-executors.ts
+function buildMcpHeaders(runtime) {
+  const headers = {
+    "Content-Type": "application/json",
+    "Authorization": `Bearer ${runtime.sessionToken}`
+  };
+  if (runtime.projectId) {
+    headers["x-project-id"] = runtime.projectId;
+  }
+  if (runtime.workspaceId) {
+    headers["x-workspace-id"] = runtime.workspaceId;
+  }
+  if (runtime.machineUuid) {
+    headers["x-machine-uuid"] = runtime.machineUuid;
+  }
+  return headers;
+}
+async function apiRequest(runtime, method, path2, body, fetchImpl = fetch) {
+  const url = `${runtime.apiUrl}${path2}`;
   const options = {
     method,
-    headers: {
-      "Content-Type": "application/json",
-      "Authorization": `Bearer ${EPISODA_SESSION_TOKEN}`
-    }
+    headers: buildMcpHeaders(runtime)
   };
   if (body && method !== "GET") {
     options.body = JSON.stringify(body);
   }
-  if (EPISODA_PROJECT_ID) {
-    options.headers["x-project-id"] = EPISODA_PROJECT_ID;
-  }
-  if (EPISODA_WORKSPACE_ID) {
-    options.headers["x-workspace-id"] = EPISODA_WORKSPACE_ID;
-  }
-  const response = await fetch(url, options);
+  const response = await fetchImpl(url, options);
   if (!response.ok) {
     const text = await response.text();
     throw new Error(`API error ${response.status}: ${text}`);
   }
   return response.json();
 }
+async function executeTransitionModule(runtime, args, fetchImpl = fetch) {
+  const result = await apiRequest(
+    runtime,
+    "POST",
+    `/api/modules/${args.module_uid}/transition`,
+    { targetState: args.target_state },
+    fetchImpl
+  );
+  if (!result.success) {
+    return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
+  }
+  return {
+    content: [{
+      type: "text",
+      text: `Module ${args.module_uid} transitioned to ${args.target_state}`
+    }]
+  };
+}
+
+// src/workflow-server.ts
+var EPISODA_API_URL = process.env.EPISODA_API_URL || "https://episoda.dev";
+var EPISODA_SESSION_TOKEN = process.env.EPISODA_SESSION_TOKEN || "";
+var EPISODA_PROJECT_ID = process.env.EPISODA_PROJECT_ID || "";
+var EPISODA_WORKSPACE_ID = process.env.EPISODA_WORKSPACE_ID || "";
+var EPISODA_MACHINE_UUID = process.env.EPISODA_MACHINE_UUID || "";
+async function apiRequest2(method, path2, body) {
+  return apiRequest(
+    {
+      apiUrl: EPISODA_API_URL,
+      sessionToken: EPISODA_SESSION_TOKEN,
+      projectId: EPISODA_PROJECT_ID,
+      workspaceId: EPISODA_WORKSPACE_ID,
+      machineUuid: EPISODA_MACHINE_UUID
+    },
+    method,
+    path2,
+    body
+  );
+}
 var server = new McpServer({
   name: "episoda-workflow",
   version: "1.0.0"
@@ -147,7 +194,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("POST", "/api/tasks", {
+    const result = await apiRequest2("POST", "/api/tasks", {
       module_id: args.module_uid,
       // API expects module_id (accepts both UUID and UID)
       title: args.title,
@@ -175,7 +222,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("PATCH", `/api/tasks/${args.task_uid}`, {
+    const result = await apiRequest2("PATCH", `/api/tasks/${args.task_uid}`, {
       state: args.state
     });
     if (!result.success) {
@@ -203,7 +250,7 @@ server.registerTool(
     const updates = {};
     if (args.title) updates.title = args.title;
     if (args.description) updates.description_md = args.description;
-    const result = await apiRequest("PATCH", `/api/tasks/${args.task_uid}`, updates);
+    const result = await apiRequest2("PATCH", `/api/tasks/${args.task_uid}`, updates);
     if (!result.success) {
       return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
     }
@@ -224,7 +271,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("GET", `/api/tasks/${args.task_uid}`);
+    const result = await apiRequest2("GET", `/api/tasks/${args.task_uid}`);
     if (!result.success || !result.task) {
       return { content: [{ type: "text", text: `Error: ${result.error || "Task not found"}` }], isError: true };
     }
@@ -252,7 +299,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("GET", `/api/tasks?module_id=${args.module_uid}`);
+    const result = await apiRequest2("GET", `/api/tasks?module_id=${args.module_uid}`);
     if (!result.success || !result.tasks) {
       return { content: [{ type: "text", text: `Error: ${result.error || "Failed to fetch tasks"}` }], isError: true };
     }
@@ -283,7 +330,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("DELETE", `/api/tasks/${args.task_uid}`);
+    const result = await apiRequest2("DELETE", `/api/tasks/${args.task_uid}`);
     if (!result.success) {
       return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
     }
@@ -315,7 +362,7 @@ Reduces latency from ~1.5s (6 calls) to ~300ms (1 call).`,
   async (args) => {
     try {
       const lookupPromises = args.task_uids.map(
-        (uid) => apiRequest("GET", `/api/tasks/${uid}`).then((r) => r.success && r.task ? { uid, id: r.task.id } : null).catch(() => null)
+        (uid) => apiRequest2("GET", `/api/tasks/${uid}`).then((r) => r.success && r.task ? { uid, id: r.task.id } : null).catch(() => null)
       );
       const lookupResults = await Promise.all(lookupPromises);
       const validTasks = lookupResults.filter((t) => t !== null);
@@ -334,7 +381,7 @@ Not found: ${args.task_uids.join(", ")}`
         id: t.id,
         state: args.state
       }));
-      const result = await apiRequest("PATCH", "/api/tasks/batch", {
+      const result = await apiRequest2("PATCH", "/api/tasks/batch", {
         updates
       });
       if (!result.success) {
@@ -394,7 +441,7 @@ EFFICIENCY: Single call instead of multiple create_task calls.`,
   },
   async (args) => {
     try {
-      const result = await apiRequest("POST", "/api/tasks/bulk", {
+      const result = await apiRequest2("POST", "/api/tasks/bulk", {
         module_id: args.module_uid,
         tasks: args.tasks.map((t) => ({
           title: t.title,
@@ -451,7 +498,7 @@ EFFICIENCY: Single MCP call instead of multiple get_task_details calls.`,
   async (args) => {
     try {
       const fetchPromises = args.task_uids.map(
-        (uid) => apiRequest("GET", `/api/tasks/${uid}`).then((r) => r.success && r.task ? { found: true, task: r.task } : { found: false, uid }).catch(() => ({ found: false, uid }))
+        (uid) => apiRequest2("GET", `/api/tasks/${uid}`).then((r) => r.success && r.task ? { found: true, task: r.task } : { found: false, uid }).catch(() => ({ found: false, uid }))
       );
       const results = await Promise.all(fetchPromises);
       const foundTasks = [];
@@ -510,7 +557,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("POST", "/api/modules", {
+    const result = await apiRequest2("POST", "/api/modules", {
       title: args.title,
       description_md: args.description
     });
@@ -539,7 +586,7 @@ server.registerTool(
     const updates = {};
     if (args.title) updates.title = args.title;
     if (args.description) updates.description_md = args.description;
-    const result = await apiRequest("PATCH", `/api/modules/${args.module_uid}`, updates);
+    const result = await apiRequest2("PATCH", `/api/modules/${args.module_uid}`, updates);
     if (!result.success) {
       return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
     }
@@ -560,7 +607,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("PATCH", `/api/modules/${args.module_uid}`, {
+    const result = await apiRequest2("PATCH", `/api/modules/${args.module_uid}`, {
       state: "review"
     });
     if (!result.success) {
@@ -583,7 +630,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("PATCH", `/api/modules/${args.module_uid}`, {
+    const result = await apiRequest2("PATCH", `/api/modules/${args.module_uid}`, {
       state: "done"
     });
     if (!result.success) {
@@ -606,7 +653,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("GET", `/api/modules/${args.module_uid}`);
+    const result = await apiRequest2("GET", `/api/modules/${args.module_uid}`);
     if (!result.success || !result.module) {
       return { content: [{ type: "text", text: `Error: ${result.error || "Module not found"}` }], isError: true };
     }
@@ -633,7 +680,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("DELETE", `/api/modules/${args.module_uid}`);
+    const result = await apiRequest2("DELETE", `/api/modules/${args.module_uid}`);
     if (!result.success) {
       return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
     }
@@ -666,7 +713,7 @@ USE THIS WHEN:
     if (args.limit) params.set("limit", String(args.limit));
     if (args.include_task_counts) params.set("includeTaskCounts", "true");
     const query = params.toString();
-    const result = await apiRequest("GET", `/api/modules${query ? `?${query}` : ""}`);
+    const result = await apiRequest2("GET", `/api/modules${query ? `?${query}` : ""}`);
     if (!result.success || !result.modules) {
       return { content: [{ type: "text", text: `Error: ${result.error || "Failed to fetch modules"}` }], isError: true };
     }
@@ -699,22 +746,7 @@ Use this instead of request_review or mark_done for full control.`,
       target_state: z.enum(["ready", "doing", "review", "done"]).describe("Target state for the module")
     }
   },
-  async (args) => {
-    const result = await apiRequest(
-      "POST",
-      `/api/modules/${args.module_uid}/transition`,
-      { targetState: args.target_state }
-    );
-    if (!result.success) {
-      return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
-    }
-    return {
-      content: [{
-        type: "text",
-        text: `Module ${args.module_uid} transitioned to ${args.target_state}`
-      }]
-    };
-  }
+  handleTransitionModule
 );
 server.registerTool(
   "archive_module",
@@ -725,7 +757,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest(
+    const result = await apiRequest2(
       "POST",
       `/api/modules/${args.module_uid}/archive`,
       {}
@@ -750,7 +782,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("GET", `/api/knowledge/${args.knowledge_id}`);
+    const result = await apiRequest2("GET", `/api/knowledge/${args.knowledge_id}`);
     if (!result.success || !result.knowledge) {
       return { content: [{ type: "text", text: `Error: ${result.error || "Knowledge not found"}` }], isError: true };
     }
@@ -793,7 +825,7 @@ DO NOT USE WHEN:
     }
   },
   async (args) => {
-    const result = await apiRequest(
+    const result = await apiRequest2(
       "POST",
       "/api/search/semantic",
       {
@@ -854,7 +886,7 @@ DO NOT USE WHEN:
     }
   },
   async (args) => {
-    const result = await apiRequest(
+    const result = await apiRequest2(
       "POST",
       "/api/search/text",
       {
@@ -914,13 +946,13 @@ This is the recommended default search for most queries.`,
   },
   async (args) => {
     const [semanticResult, textResult] = await Promise.all([
-      apiRequest("POST", "/api/search/semantic", {
+      apiRequest2("POST", "/api/search/semantic", {
         query: args.query,
         types: ["knowledge"],
         limit: 50,
         threshold: 0.4
       }),
-      apiRequest("POST", "/api/search/text", {
+      apiRequest2("POST", "/api/search/text", {
         query: args.query,
         types: ["knowledge"],
         limit: 50
@@ -993,7 +1025,7 @@ USE THIS WHEN:
     }
   },
   async (args) => {
-    const result = await apiRequest(
+    const result = await apiRequest2(
       "POST",
       "/api/search/conversations",
       {
@@ -1038,7 +1070,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest(
+    const result = await apiRequest2(
       "GET",
       `/api/modules/${args.module_uid}/knowledge`
     );
@@ -1069,7 +1101,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest(
+    const result = await apiRequest2(
       "POST",
       `/api/modules/${args.module_uid}/knowledge/link`,
       { knowledge_id: args.knowledge_id }
@@ -1105,7 +1137,7 @@ All documentation MUST be created in the knowledge base, not as markdown files.`
     }
   },
   async (args) => {
-    const result = await apiRequest("POST", "/api/knowledge", {
+    const result = await apiRequest2("POST", "/api/knowledge", {
       title: args.title,
       domain: args.domain,
       doc_type: args.doc_type,
@@ -1144,7 +1176,7 @@ server.registerTool(
     if (args.domain) updates.domain = args.domain;
     if (args.doc_type) updates.doc_type = args.doc_type;
     if (args.significance !== void 0) updates.significance = args.significance;
-    const result = await apiRequest("PATCH", `/api/knowledge/${args.knowledge_id}`, updates);
+    const result = await apiRequest2("PATCH", `/api/knowledge/${args.knowledge_id}`, updates);
     if (!result.success) {
       return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
     }
@@ -1165,7 +1197,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest("DELETE", `/api/knowledge/${args.knowledge_id}`);
+    const result = await apiRequest2("DELETE", `/api/knowledge/${args.knowledge_id}`);
     if (!result.success) {
       return { content: [{ type: "text", text: `Error: ${result.error}` }], isError: true };
     }
@@ -1186,7 +1218,7 @@ server.registerTool(
     }
   },
   async (args) => {
-    const result = await apiRequest(
+    const result = await apiRequest2(
       "GET",
       `/api/agent/context/module/${args.module_uid}`
     );
@@ -1208,7 +1240,7 @@ server.registerTool(
     inputSchema: {}
   },
   async () => {
-    const result = await apiRequest(
+    const result = await apiRequest2(
       "GET",
       "/api/agent/context/system"
     );
@@ -1223,20 +1255,39 @@ server.registerTool(
     };
   }
 );
-async function main() {
+async function handleTransitionModule(args) {
+  return executeTransitionModule(
+    {
+      apiUrl: EPISODA_API_URL,
+      sessionToken: EPISODA_SESSION_TOKEN,
+      projectId: EPISODA_PROJECT_ID,
+      workspaceId: EPISODA_WORKSPACE_ID,
+      machineUuid: EPISODA_MACHINE_UUID
+    },
+    args
+  );
+}
+async function startServer() {
   const runtimeConfig = await hydrateRuntimeConfig();
   EPISODA_API_URL = runtimeConfig.apiUrl;
   EPISODA_SESSION_TOKEN = runtimeConfig.sessionToken;
   EPISODA_PROJECT_ID = runtimeConfig.projectId;
   EPISODA_WORKSPACE_ID = runtimeConfig.workspaceId;
+  EPISODA_MACHINE_UUID = runtimeConfig.machineUuid || "";
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error("[episoda-workflow] MCP server started");
   console.error(`[episoda-workflow] API URL: ${EPISODA_API_URL}`);
   console.error(`[episoda-workflow] Token: ${EPISODA_SESSION_TOKEN ? "****" : "NOT SET"}`);
 }
-main().catch((error) => {
-  console.error("[episoda-workflow] Fatal error:", error);
-  process.exit(1);
-});
+if (process.env.EPISODA_MCP_NO_AUTOSTART !== "1") {
+  startServer().catch((error) => {
+    console.error("[episoda-workflow] Fatal error:", error);
+    process.exit(1);
+  });
+}
+export {
+  handleTransitionModule,
+  startServer
+};
 //# sourceMappingURL=workflow-server.js.map