@de-otio/epimethian-mcp 6.6.1 → 6.6.3

package/dist/cli/index.js

@@ -35481,7 +35481,7 @@ async function getPage(pageId, includeBody) {
 async function _rawCreatePage(spaceId, title, body, parentId, clientLabel) {
   const cfg = await getConfig();
   const pageBody = normalizeBodyForSubmit(body);
-  const epimethianTag = `Epimethian v${"6.6.1"}`;
+  const epimethianTag = `Epimethian v${"6.6.3"}`;
   const versionMsg = cfg.attribution && clientLabel ? `Created by ${clientLabel} (via ${epimethianTag})` : `Created by ${epimethianTag}`;
   const payload = {
     title,
@@ -35502,7 +35502,7 @@ async function _rawCreatePage(spaceId, title, body, parentId, clientLabel) {
 async function _rawUpdatePage(pageId, opts) {
   const cfg = await getConfig();
   const newVersion = opts.version + 1;
-  const epimethianTag = `Epimethian v${"6.6.1"}`;
+  const epimethianTag = `Epimethian v${"6.6.3"}`;
   const effectiveClient = cfg.attribution ? opts.clientLabel : void 0;
   let versionMessage;
   if (opts.versionMessage && effectiveClient)
@@ -47896,17 +47896,30 @@ Token tail: ...${last8}    Expires: ${isoExpires}    Audit ID: ${err.auditId}
 The token is single-use, bound to this exact diff and page version,
 and invalidated by any competing write to this page. If validation
 fails, mint a new one by re-calling without \`confirm_token\`.`;
+  const tokenInText = process.env.EPIMETHIAN_TOKEN_IN_TEXT === "true";
+  const finalText = tokenInText ? text2 + `
+
+[FALLBACK] Full token (EPIMETHIAN_TOKEN_IN_TEXT=true): ${err.token}` : text2;
   const structuredContent = {
+    kind: "confirmation_required",
     confirm_token: err.token,
     audit_id: err.auditId,
     expires_at: isoExpires,
-    page_id: params.pageId
+    page_id: params.pageId,
+    human_summary: err.humanSummary
   };
   if (params.deletionSummary) {
-    structuredContent.deletion_summary = params.deletionSummary;
+    structuredContent.deletion_summary = {
+      tocs: params.deletionSummary.tocs,
+      links: params.deletionSummary.links,
+      structured_macros: params.deletionSummary.structuredMacros,
+      code_macros: params.deletionSummary.codeMacros,
+      plain_elements: params.deletionSummary.plainElements,
+      other: params.deletionSummary.other
+    };
   }
   return {
-    content: [{ type: "text", text: text2 }],
+    content: [{ type: "text", text: finalText }],
     isError: true,
     structuredContent
   };
@@ -48986,7 +48999,7 @@ var init_client_configs = __esm({
           null,
           2
         ),
-        warning: "VS Code extension \u2264 2.1.123 does not honour elicitation requests; if write tools fail with NO_USER_RESPONSE, set `EPIMETHIAN_BYPASS_ELICITATION=true`."
+        warning: "VS Code extension \u2264 2.1.123 does not honour elicitation requests; if write tools fail with NO_USER_RESPONSE, set `EPIMETHIAN_BYPASS_ELICITATION=true`.\n\nv6.6.2 declares an `outputSchema` on every write tool, so a spec-compliant client should now surface the soft-confirm `structuredContent` to the agent. If your version of Claude Code drops content blocks when structuredContent is present (issue #15412), set `EPIMETHIAN_TOKEN_IN_TEXT=true` as a fallback \u2014 this restores the human-readable explanation by also putting the full token in the text block."
       },
       {
         id: "cursor",
@@ -49937,7 +49950,7 @@ __export(upgrade_exports, {
   runUpgrade: () => runUpgrade
 });
 async function runUpgrade() {
-  const currentVersion = "6.6.1";
+  const currentVersion = "6.6.3";
   console.log(`epimethian-mcp upgrade: current version v${currentVersion}`);
   let pending = await getPendingUpdate();
   if (!pending) {
@@ -61110,6 +61123,67 @@ var versionField = external_exports.union([
   external_exports.literal("current")
 ]);
 
+// src/server/output-schema.ts
+init_zod();
+var deletionSummarySchema = external_exports.object({
+  tocs: external_exports.number().int().nonnegative(),
+  links: external_exports.number().int().nonnegative(),
+  structured_macros: external_exports.number().int().nonnegative(),
+  code_macros: external_exports.number().int().nonnegative(),
+  plain_elements: external_exports.number().int().nonnegative(),
+  other: external_exports.number().int().nonnegative()
+});
+var confirmationRequiredArm = external_exports.object({
+  kind: external_exports.literal("confirmation_required"),
+  confirm_token: external_exports.string().min(1),
+  audit_id: external_exports.string().min(1),
+  expires_at: external_exports.string().min(1),
+  page_id: external_exports.string().min(1),
+  human_summary: external_exports.string(),
+  deletion_summary: deletionSummarySchema.optional()
+});
+var writeSuccessArm = external_exports.object({
+  kind: external_exports.literal("written"),
+  page_id: external_exports.string().min(1),
+  new_version: external_exports.number().int().positive(),
+  body_bytes_before: external_exports.number().int().nonnegative().optional(),
+  body_bytes_after: external_exports.number().int().nonnegative().optional(),
+  title: external_exports.string().optional()
+});
+var deleteSuccessArm = external_exports.object({
+  kind: external_exports.literal("deleted"),
+  page_id: external_exports.string().min(1),
+  last_version: external_exports.number().int().positive().optional()
+});
+var writeOutputSchema = external_exports.object({
+  kind: external_exports.enum(["written", "confirmation_required"]),
+  page_id: external_exports.string().min(1),
+  // success arm fields (all optional — present only on `written`)
+  new_version: external_exports.number().int().positive().optional(),
+  body_bytes_before: external_exports.number().int().nonnegative().optional(),
+  body_bytes_after: external_exports.number().int().nonnegative().optional(),
+  title: external_exports.string().optional(),
+  // confirmation_required arm fields (all optional — present only
+  // when `kind: "confirmation_required"`)
+  confirm_token: external_exports.string().min(1).optional(),
+  audit_id: external_exports.string().min(1).optional(),
+  expires_at: external_exports.string().min(1).optional(),
+  human_summary: external_exports.string().optional(),
+  deletion_summary: deletionSummarySchema.optional()
+});
+var deleteOutputSchema = external_exports.object({
+  kind: external_exports.enum(["deleted", "confirmation_required"]),
+  page_id: external_exports.string().min(1),
+  // success arm fields
+  last_version: external_exports.number().int().positive().optional(),
+  // confirmation_required arm fields
+  confirm_token: external_exports.string().min(1).optional(),
+  audit_id: external_exports.string().min(1).optional(),
+  expires_at: external_exports.string().min(1).optional(),
+  human_summary: external_exports.string().optional(),
+  deletion_summary: deletionSummarySchema.optional()
+});
+
 // src/server/index.ts
 init_update_orchestrator();
 init_tokeniser();
@@ -61876,6 +61950,11 @@ ${truncated}${truncationNote(origLen)}`
         source: sourceSchema,
         confirm_token: external_exports.string().optional().describe("Soft-confirmation token from a prior SOFT_CONFIRMATION_REQUIRED response. Single-use; bound to this exact diff and page version.")
       },
+      // v6.6.2 §3.1 — declared so spec-compliant clients forward our
+      // structuredContent payload to the agent (the soft-confirmation
+      // round-trip relied on this from the start; v6.6.0/6.6.1 emitted
+      // structuredContent without a schema so most clients dropped it).
+      outputSchema: writeOutputSchema,
       annotations: { destructiveHint: false, idempotentHint: false }
     },
     async ({ page_id, title, version: version2, body, version_message, confirm_deletions, replace_body, confirm_shrinkage, confirm_structure_loss, allow_raw_html, confluence_base_url, source, confirm_token }) => {
@@ -61972,14 +62051,34 @@ ${truncated}${truncationNote(origLen)}`
         const badgeResult = await markPageUnverified(submitted.page.id, cfg);
         if (badgeResult.warning) warnings.push(badgeResult.warning);
         if (isTitleOnly) {
-          return toolResult(
+          const titleOnlyResult = toolResult(
             appendWarnings(`Updated: ${submitted.page.title} (ID: ${submitted.page.id}, version: ${submitted.newVersion}, title only, body unchanged)`, warnings) + echo
           );
+          return {
+            ...titleOnlyResult,
+            structuredContent: {
+              kind: "written",
+              page_id,
+              new_version: submitted.newVersion,
+              title: submitted.page.title
+            }
+          };
         }
         const removalNote = submitted.deletedTokens.length > 0 ? `; removed ${submitted.deletedTokens.length} preserved macro${submitted.deletedTokens.length === 1 ? "" : "s"}: ${submitted.deletedTokens.map((t) => t.fingerprint).join(", ")}` : "";
-        return toolResult(
+        const bodyUpdateResult = toolResult(
           appendWarnings(`Updated: ${submitted.page.title} (ID: ${submitted.page.id}, version: ${submitted.newVersion}, body: ${submitted.oldLen}\u2192${submitted.newLen} chars${removalNote})`, warnings) + echo
         );
+        return {
+          ...bodyUpdateResult,
+          structuredContent: {
+            kind: "written",
+            page_id,
+            new_version: submitted.newVersion,
+            body_bytes_before: submitted.oldLen,
+            body_bytes_after: submitted.newLen,
+            title: submitted.page.title
+          }
+        };
       } catch (err) {
         if (err instanceof SoftConfirmationRequiredError) {
           return formatSoftConfirmationResult(err, { pageId: page_id });
@@ -62005,6 +62104,10 @@ ${truncated}${truncationNote(origLen)}`
         source: sourceSchema,
         confirm_token: external_exports.string().optional().describe("Soft-confirmation token from a prior SOFT_CONFIRMATION_REQUIRED response. Single-use; bound to this exact page version.")
       },
+      // v6.6.2 §3.1 — declared so spec-compliant clients forward our
+      // structuredContent payload (especially the soft-confirm token)
+      // to the agent.
+      outputSchema: deleteOutputSchema,
       annotations: { destructiveHint: true, idempotentHint: true }
     },
     async ({ page_id, version: version2, source, confirm_token }) => {
@@ -62070,7 +62173,15 @@ ${truncated}${truncationNote(origLen)}`
           ...version2 !== void 0 ? { oldVersion: version2 } : {},
           source: effectiveSource
         });
-        return toolResult(`Deleted page ${page_id}` + echo);
+        const deletedResult = toolResult(`Deleted page ${page_id}` + echo);
+        return {
+          ...deletedResult,
+          structuredContent: {
+            kind: "deleted",
+            page_id,
+            ...version2 !== void 0 ? { last_version: version2 } : {}
+          }
+        };
       } catch (err) {
         if (err instanceof SoftConfirmationRequiredError) {
           return formatSoftConfirmationResult(err, { pageId: page_id });
@@ -62114,6 +62225,9 @@ ${truncated}${truncationNote(origLen)}`
         confirm_deletions: external_exports.boolean().default(false).describe("Set to true to acknowledge that your markdown removes preserved macros, emoticons, or rich elements from this section. Required when any preserved element would be deleted."),
         confirm_token: external_exports.string().optional().describe("Soft-confirmation token from a prior SOFT_CONFIRMATION_REQUIRED response. Single-use; bound to this exact diff and page version.")
       },
+      // v6.6.2 §3.1 — declared so spec-compliant clients forward our
+      // structuredContent payload to the agent.
+      outputSchema: writeOutputSchema,
       annotations: { destructiveHint: false, idempotentHint: false }
     },
     async ({ page_id, section, body, find_replace, version: version2, version_message, confirm_deletions, confirm_token }) => {
@@ -62187,12 +62301,23 @@ ${truncated}${truncationNote(origLen)}`
           const badgeResult2 = await markPageUnverified(submitted2.page.id, cfg);
           if (badgeResult2.warning) warnings2.push(badgeResult2.warning);
           const pairCount = find_replace.length;
-          return toolResult(
+          const findReplaceResult = toolResult(
             appendWarnings(
               `Updated section "${section}" in: ${submitted2.page.title} (ID: ${submitted2.page.id}, version: ${submitted2.newVersion}; applied ${pairCount} find/replace substitution${pairCount === 1 ? "" : "s"})`,
               warnings2
             ) + echo
           );
+          return {
+            ...findReplaceResult,
+            structuredContent: {
+              kind: "written",
+              page_id,
+              new_version: submitted2.newVersion,
+              body_bytes_before: submitted2.oldLen,
+              body_bytes_after: submitted2.newLen,
+              title: submitted2.page.title
+            }
+          };
         }
         if (confirm_deletions) {
           const deletionSummary = tryForecastDeletions(currentSectionBody, body, cfg.url);
@@ -62261,9 +62386,20 @@ ${truncated}${truncationNote(origLen)}`
         const badgeResult = await markPageUnverified(submitted.page.id, cfg);
         if (badgeResult.warning) warnings.push(badgeResult.warning);
         const removalNote = submitted.deletedTokens.length > 0 ? `; removed ${submitted.deletedTokens.length} preserved macro${submitted.deletedTokens.length === 1 ? "" : "s"}: ${submitted.deletedTokens.map((t) => t.fingerprint).join(", ")}` : "";
-        return toolResult(
+        const sectionBodyResult = toolResult(
           appendWarnings(`Updated section "${section}" in: ${submitted.page.title} (ID: ${submitted.page.id}, version: ${submitted.newVersion}${removalNote})`, warnings) + echo
         );
+        return {
+          ...sectionBodyResult,
+          structuredContent: {
+            kind: "written",
+            page_id,
+            new_version: submitted.newVersion,
+            body_bytes_before: submitted.oldLen,
+            body_bytes_after: submitted.newLen,
+            title: submitted.page.title
+          }
+        };
       } catch (err) {
         if (err instanceof SoftConfirmationRequiredError) {
           return formatSoftConfirmationResult(err, { pageId: page_id });
@@ -62451,6 +62587,9 @@ ${truncated}${truncationNote(origLen)}`
         confluence_base_url: external_exports.string().url().optional().describe("Override the Confluence base URL used by the link rewriter."),
         confirm_token: external_exports.string().optional().describe("Soft-confirmation token from a prior SOFT_CONFIRMATION_REQUIRED response. Single-use; bound to this exact diff and page version.")
       },
+      // v6.6.2 \u00a73.1 \u2014 declared so spec-compliant clients forward our
+      // structuredContent payload to the agent.
+      outputSchema: writeOutputSchema,
       annotations: { destructiveHint: false, idempotentHint: false }
     },
     async ({ page_id, version: version2, content, separator, version_message, allow_raw_html, confluence_base_url }) => {
@@ -62471,7 +62610,18 @@ ${truncated}${truncationNote(origLen)}`
         if (labelResult.warning) warnings.push(labelResult.warning);
         const badgeResult = await markPageUnverified(page.id, cfg);
         if (badgeResult.warning) warnings.push(badgeResult.warning);
-        return toolResult(appendWarnings(`Prepended to: ${page.title} (ID: ${page.id}, version: ${newVersion}, body: ${oldLen}\u2192${newLen} chars)`, warnings) + echo);
+        const prependResult = toolResult(appendWarnings(`Prepended to: ${page.title} (ID: ${page.id}, version: ${newVersion}, body: ${oldLen}\u2192${newLen} chars)`, warnings) + echo);
+        return {
+          ...prependResult,
+          structuredContent: {
+            kind: "written",
+            page_id,
+            new_version: newVersion,
+            body_bytes_before: oldLen,
+            body_bytes_after: newLen,
+            title: page.title
+          }
+        };
       } catch (err) {
         if (err instanceof SoftConfirmationRequiredError) {
           return formatSoftConfirmationResult(err, { pageId: page_id });
@@ -62501,6 +62651,9 @@ ${truncated}${truncationNote(origLen)}`
         confluence_base_url: external_exports.string().url().optional().describe("Override the Confluence base URL used by the link rewriter."),
         confirm_token: external_exports.string().optional().describe("Soft-confirmation token from a prior SOFT_CONFIRMATION_REQUIRED response. Single-use; bound to this exact diff and page version.")
       },
+      // v6.6.2 \u00a73.1 \u2014 declared so spec-compliant clients forward our
+      // structuredContent payload to the agent.
+      outputSchema: writeOutputSchema,
       annotations: { destructiveHint: false, idempotentHint: false }
     },
     async ({ page_id, version: version2, content, separator, version_message, allow_raw_html, confluence_base_url }) => {
@@ -62521,7 +62674,18 @@ ${truncated}${truncationNote(origLen)}`
         if (labelResult.warning) warnings.push(labelResult.warning);
         const badgeResult = await markPageUnverified(page.id, cfg);
         if (badgeResult.warning) warnings.push(badgeResult.warning);
-        return toolResult(appendWarnings(`Appended to: ${page.title} (ID: ${page.id}, version: ${newVersion}, body: ${oldLen}\u2192${newLen} chars)`, warnings) + echo);
+        const appendResult = toolResult(appendWarnings(`Appended to: ${page.title} (ID: ${page.id}, version: ${newVersion}, body: ${oldLen}\u2192${newLen} chars)`, warnings) + echo);
+        return {
+          ...appendResult,
+          structuredContent: {
+            kind: "written",
+            page_id,
+            new_version: newVersion,
+            body_bytes_before: oldLen,
+            body_bytes_after: newLen,
+            title: page.title
+          }
+        };
       } catch (err) {
         if (err instanceof SoftConfirmationRequiredError) {
           return formatSoftConfirmationResult(err, { pageId: page_id });
@@ -63680,7 +63844,7 @@ ${titleFenced}${echo2}`
       inputSchema: {}
     },
     async () => {
-      let text2 = `epimethian-mcp v${"6.6.1"}`;
+      let text2 = `epimethian-mcp v${"6.6.3"}`;
       try {
         const pending = await getPendingUpdate();
         if (pending) {
@@ -63711,7 +63875,7 @@ ${label} update available: v${pending.current} \u2192 v${pending.latest}. Run \`
         const pending = await getPendingUpdate();
         if (!pending) {
           return toolResult(
-            `epimethian-mcp v${"6.6.1"} is already up to date.`
+            `epimethian-mcp v${"6.6.3"} is already up to date.`
           );
         }
         const output = await performUpgrade(pending.latest);
@@ -63733,7 +63897,7 @@ async function startRecoveryServer(profile) {
   const server = new McpServer(
     {
       name: `confluence-${profile}-setup-needed`,
-      version: "6.6.1"
+      version: "6.6.3"
     },
     {
       instructions: `The Confluence profile "${profile}" referenced by CONFLUENCE_PROFILE has no keychain entry, so no Confluence tools are available. Call the setup_profile tool for instructions to create it.`
@@ -63784,21 +63948,21 @@ async function main() {
   const serverName = config3.profile ? `confluence-${config3.profile}` : "confluence";
   const server = new McpServer({
     name: serverName,
-    version: "6.6.1"
+    version: "6.6.3"
   });
   await registerTools(server, config3);
   const transport = new StdioServerTransport();
   await server.connect(transport);
   try {
     const pending = await getPendingUpdate();
-    if (pending && pending.current === "6.6.1") {
+    if (pending && pending.current === "6.6.3") {
       console.error(
         `epimethian-mcp: update available: v${pending.current} \u2192 v${pending.latest} (${pending.type}). Run \`epimethian-mcp upgrade\` to install.`
       );
     }
   } catch {
   }
-  checkForUpdates("6.6.1").catch(() => {
+  checkForUpdates("6.6.3").catch(() => {
   });
 }