@codazen/harmonica-mcp 4.2.0 → 4.3.0

package/dist/index.js

@@ -26938,6 +26938,8 @@ var StartSessionRequestBodySchema = external_exports.object({
   systemId: external_exports.string().min(1),
   message: external_exports.string().min(1),
   revisionId: external_exports.string().min(1).optional(),
+  /** Caller's own Session id — nests the new Session under it (B-231). */
+  parentSessionId: external_exports.string().min(1).optional(),
   enableWebSearch: external_exports.boolean().optional()
 });
 var StartSessionResponseSchema = external_exports.object({
@@ -32316,16 +32318,20 @@ ${JSON.stringify(task.result, null, 2)}
     {
       systemId: external_exports.string().min(1).describe("The system 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"),
-      revisionId: external_exports.string().min(1).optional().describe("Optional Revision ID (rev-<uuid>). When provided, the Worker routes to the typed implementation session path (prepareRevisionImplementationSession), enabling file hint generation and richer session context. Omit for investigation, planning, or freeform sessions.")
+      revisionId: external_exports.string().min(1).optional().describe("Optional Revision ID (rev-<uuid>). When provided, the Worker routes to the typed implementation session path (prepareRevisionImplementationSession), enabling file hint generation and richer session context. Omit for investigation, planning, or freeform sessions."),
+      parentSessionId: external_exports.string().min(1).optional().describe("Your current Session ID (sess-<uuid>). Pass it when you are kicking off this session as part of your own work \u2014 the new session then nests under yours in the session tree and can report back to you. Omit for a standalone session.")
     },
-    async ({ systemId, message, revisionId }) => {
+    async ({ systemId, message, revisionId, parentSessionId }) => {
       try {
         await assertSystemInOrg(client, systemId, ctx.orgId);
         const task = await client.startSession(
           systemId,
           message,
           { name: ctx.user.name, email: ctx.user.email },
-          revisionId?.trim() ? { revisionId: revisionId.trim() } : void 0
+          revisionId?.trim() || parentSessionId?.trim() ? {
+            ...revisionId?.trim() && { revisionId: revisionId.trim() },
+            ...parentSessionId?.trim() && { parentSessionId: parentSessionId.trim() }
+          } : void 0
         );
         return {
           content: [{
@@ -33917,10 +33923,17 @@ function createHttpClient(config2) {
     // Agent sessions
     startSession: async (systemId, message, triggeredBy, options) => {
       const trimmedRevisionId = options?.revisionId?.trim();
+      const trimmedParentSessionId = options?.parentSessionId?.trim();
       const result = await request(
         "POST",
         `/api/sessions`,
-        { systemId, message, ...triggeredBy && { triggeredBy }, ...trimmedRevisionId && { revisionId: trimmedRevisionId } }
+        {
+          systemId,
+          message,
+          ...triggeredBy && { triggeredBy },
+          ...trimmedRevisionId && { revisionId: trimmedRevisionId },
+          ...trimmedParentSessionId && { parentSessionId: trimmedParentSessionId }
+        }
       );
       if (!result?.taskId) throw new Error("Start session enqueue failed: no taskId returned");
       return { taskId: result.taskId, taskType: "generic_session", status: result.status ?? "pending", systemId, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
@@ -35030,7 +35043,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"4.2.0"} starting\u2026`);
+  console.error(`[harmonica-mcp] v${"4.3.0"} starting\u2026`);
   const config2 = loadConfig();
   const client = createHttpClient({
     apiBaseUrl: config2.apiBaseUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codazen/harmonica-mcp",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "MCP server for Harmonica — connect any MCP-compatible AI assistant to Harmonica",
   "license": "MIT",
   "bin": {