@codazen/harmonica-mcp 4.1.0 → 4.3.0

package/dist/index.js

@@ -26623,6 +26623,7 @@ var CHECK_TARGET_TYPES = [
   "revision",
   "beat_version",
   "project",
+  "system",
   "drop",
   "organization"
 ];
@@ -26937,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({
@@ -28168,9 +28171,9 @@ ${trimmed}` : `# ${title}`;
 }
 
 // ../../libs/harmonica-services/src/mcp/tools/notebook-tools.ts
-var SCOPE_TYPE_VALUES = ["org", "teamspace", "project", "account"];
+var SCOPE_TYPE_VALUES = ["org", "teamspace", "system", "account", "project"];
 var scopeRefSchema = external_exports.object({
-  scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Scope type \u2014 org, teamspace, project, or account"),
+  scopeType: external_exports.enum(SCOPE_TYPE_VALUES).describe("Scope type \u2014 org, teamspace, system, or account"),
   scopeId: external_exports.string().min(1).describe("ID of the scope entity")
 });
 function formatNotebook(nb) {
@@ -28395,7 +28398,7 @@ ${formatTree(tree.root)}` }] };
       if (!scopeProjectId) {
         try {
           const bindings = await client.getNotebookScopeBindings(notebookId);
-          scopeProjectId = bindings?.find((b) => b.scopeType === "project")?.scopeId;
+          scopeProjectId = bindings?.find((b) => b.scopeType === "system" || b.scopeType === "project")?.scopeId;
         } catch {
         }
       }
@@ -28561,7 +28564,7 @@ ${formatNotebook(updated)}` }] };
   );
   server.tool(
     "set_notebook_scopes",
-    "Replace all scope bindings for a Notebook. Pass an empty array to remove all bindings. Bindable scope types: org, teamspace, project. (projectContainer is reserved.)",
+    "Replace all scope bindings for a Notebook. Pass an empty array to remove all bindings. Bindable scope types: org, teamspace, system. (systemContainer is reserved.)",
     {
       notebookId: external_exports.string().describe("The Notebook ID"),
       scopes: external_exports.array(scopeRefSchema).max(45).describe("New complete set of scope bindings (max 45)")
@@ -29983,9 +29986,10 @@ Accepts the full PR metadata (number, url, branch, state, optional mergeSha). Fi
       revisionId: external_exports.string().describe("The Revision ID whose PR to review (e.g., rev-abc123)"),
       autoMerge: external_exports.boolean().optional().describe("Merge automatically once converged. Default false \u2192 stop at ready-for-review."),
       maxIterations: external_exports.number().int().min(1).max(3).optional().describe("Review rounds (default and hard cap: 3)."),
-      confirm: external_exports.boolean().optional().describe("Set true to start the review. Omitted/false performs a dry-run \u2014 no session, scan, or task is created.")
+      confirm: external_exports.boolean().optional().describe("Set true to start the review. Omitted/false performs a dry-run \u2014 no session, scan, or task is created."),
+      requestingSessionId: external_exports.string().min(1).optional().describe("Your current Session ID (sess-<uuid>). Pass it so the review Session nests under yours and reports its outcome back to you when it finishes \u2014 otherwise you have no way to learn how the review turned out.")
     },
-    async ({ revisionId, autoMerge, maxIterations, confirm }) => {
+    async ({ revisionId, autoMerge, maxIterations, confirm, requestingSessionId }) => {
       try {
         const revision = await client.getRevision(revisionId);
         if (!revision) {
@@ -29996,7 +30000,7 @@ Accepts the full PR metadata (number, url, branch, state, optional mergeSha). Fi
         if ("refusal" in latitude) {
           return { content: [{ type: "text", text: latitude.refusal }], isError: true };
         }
-        const result = await client.requestCodeReview({ revisionId, autoMerge, maxIterations, confirm });
+        const result = await client.requestCodeReview({ revisionId, autoMerge, maxIterations, confirm, requestingSessionId });
         if (!result.success) {
           return { content: [{ type: "text", text: `Failed to request code review (${result.error.code}): ${result.error.message}` }], isError: true };
         }
@@ -30758,13 +30762,17 @@ function assertSnapshotShape(val, sourceHint) {
 }
 
 // ../../libs/harmonica-services/src/mcp/tools/subscription-tools.ts
-var ENTITY_TYPES = ["project", "beat", "revision"];
+var ENTITY_TYPES = ["system", "beat", "revision"];
+var entityTypeField = external_exports.preprocess(
+  (v) => v === "project" ? "system" : v,
+  external_exports.enum(ENTITY_TYPES)
+);
 function registerSubscriptionTools(server, ctx, client) {
   server.tool(
     "subscribe_to_entity",
-    "Follow a Project, Beat, or Revision to receive notifications when it changes. You are auto-subscribed to things you own \u2014 use this to follow additional entities.",
+    "Follow a System, Beat, or Revision to receive notifications when it changes. You are auto-subscribed to things you own \u2014 use this to follow additional entities.",
     {
-      entityType: external_exports.enum(ENTITY_TYPES).describe("Type of entity to follow"),
+      entityType: entityTypeField.describe("Type of entity to follow"),
       entityId: external_exports.string().describe("The entity ID (system ID, beat ID, or revision ID)"),
       systemId: external_exports.string().describe("The system ID (for access control)")
     },
@@ -30786,9 +30794,9 @@ function registerSubscriptionTools(server, ctx, client) {
   );
   server.tool(
     "unsubscribe_from_entity",
-    "Stop following a Project, Beat, or Revision. Use durable=true to prevent auto-resubscribe if you are later re-assigned.",
+    "Stop following a System, Beat, or Revision. Use durable=true to prevent auto-resubscribe if you are later re-assigned.",
     {
-      entityType: external_exports.enum(ENTITY_TYPES).describe("Type of entity to unfollow"),
+      entityType: entityTypeField.describe("Type of entity to unfollow"),
       entityId: external_exports.string().describe("The entity ID"),
       durable: external_exports.boolean().optional().default(false).describe("If true, prevents auto-resubscribe on reassignment")
     },
@@ -32310,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: [{
@@ -33911,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() };
@@ -35024,7 +35043,7 @@ function loadConfig() {
   };
 }
 async function main() {
-  console.error(`[harmonica-mcp] v${"4.1.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.1.0",
+  "version": "4.3.0",
   "description": "MCP server for Harmonica — connect any MCP-compatible AI assistant to Harmonica",
   "license": "MIT",
   "bin": {