@codazen/harmonica-mcp 0.32.0 → 1.0.0

package/dist/index.js

@@ -26286,16 +26286,16 @@ ${JSON.stringify(task.result, null, 2)}
     }
   );
   server.tool(
-    "implement_revision",
-    "Trigger an agent session to implement a Revision. The agent reads the Revision spec and beat-level Notes, writes code, commits, pushes a branch named agent/rev-{id}-{title}, and creates a draft PR with the Revision ID pre-populated in the PR body. Returns a job ID \u2014 use get_job_status to track progress. Requires agentCapabilities.implementation enabled on the project.",
+    "start_session",
+    'Start an agent session from a free-form message \u2014 like opening a Claude Code conversation pointed at your project. The message is the only instruction: describe what you want ("investigate why login fails", "implement revision rev-abc123", "what does the auth flow do?") and the agent resolves any entity references itself and does whatever the work needs \u2014 investigate and report findings, or change code and open a PR. A findings-only result with no PR is a valid outcome. Returns a job ID \u2014 use get_job_status to track progress. Requires agent sessions enabled on the project.',
     {
-      revisionId: external_exports.string().min(1).describe("The Revision ID to implement (e.g., rev-abc123)"),
-      projectId: external_exports.string().min(1).describe("The project ID")
+      projectId: external_exports.string().min(1).describe("The project ID \u2014 the trusted scope the session is rooted at"),
+      message: external_exports.string().min(1).describe("Free-form first message describing what the session should do")
     },
-    async ({ revisionId, projectId }) => {
+    async ({ projectId, message }) => {
       try {
         await assertProjectInOrg(client, projectId, ctx.orgId);
-        const task = await client.implementRevision(revisionId, projectId, {
+        const task = await client.startSession(projectId, message, {
           name: ctx.user.name,
           email: ctx.user.email
         });
@@ -26303,20 +26303,20 @@ ${JSON.stringify(task.result, null, 2)}
           content: [{
             type: "text",
             text: [
-              "Revision implementation session queued.",
+              "Agent session queued.",
               "",
-              `**Revision:** ${revisionId}`,
+              `**Project:** ${projectId}`,
               `**Task ID:** ${task.taskId}`,
               `**Status:** ${task.status}`,
               "",
-              "The agent will read the Revision spec and beat-level Notes, implement the code, and create a draft PR.",
-              "Use `get_job_status` with the job ID to check progress and see the result (branch, PR URL, tool count, duration)."
+              "The agent runs as a single thread: it resolves any entity references in your message and produces whatever the work needs \u2014 findings, file changes, and/or a PR.",
+              "Use `get_job_status` with the job ID to check progress and see what it produced."
             ].join("\n")
           }]
         };
       } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { content: [{ type: "text", text: `Failed to start revision implementation: ${message}` }], isError: true };
+        const errMessage = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Failed to start session: ${errMessage}` }], isError: true };
       }
     }
   );
@@ -27416,14 +27416,14 @@ function createHttpClient(config2) {
       return pollTaskResult(enqueued.taskId);
     },
     // Agent sessions
-    implementRevision: async (revisionId, projectId, triggeredBy) => {
+    startSession: async (projectId, message, triggeredBy) => {
       const result = await request(
         "POST",
-        `/api/projects/${encodeURIComponent(projectId)}/revisions/${encodeURIComponent(revisionId)}/implement`,
-        triggeredBy ? { triggeredBy } : {}
+        `/api/sessions`,
+        { projectId, message, ...triggeredBy && { triggeredBy } }
       );
-      if (!result?.taskId) throw new Error("Revision implementation enqueue failed: no taskId returned");
-      return { taskId: result.taskId, taskType: "revision_implementation", status: result.status ?? "pending", projectId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
+      if (!result?.taskId) throw new Error("Start session enqueue failed: no taskId returned");
+      return { taskId: result.taskId, taskType: "generic_session", status: result.status ?? "pending", projectId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
     },
     planRevisionBatch: async (projectId, revisionIds) => {
       const result = await request(
@@ -27859,7 +27859,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"0.32.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"1.0.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codazen/harmonica-mcp",
-  "version": "0.32.0",
-  "description": "MCP server for Harmonica — connect Claude to your Harmonica projects",
+  "version": "1.0.0",
+  "description": "MCP server for Harmonica — connect any MCP-compatible AI assistant to Harmonica",
   "license": "MIT",
   "bin": {
     "harmonica-mcp": "./dist/index.js"