@de-otio/epimethian-mcp 6.6.0 → 6.6.2

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.0"}`;
+  const epimethianTag = `Epimethian v${"6.6.2"}`;
   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.0"}`;
+  const epimethianTag = `Epimethian v${"6.6.2"}`;
   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.0";
+  const currentVersion = "6.6.2";
   console.log(`epimethian-mcp upgrade: current version v${currentVersion}`);
   let pending = await getPendingUpdate();
   if (!pending) {
@@ -60928,8 +60941,37 @@ function renderDeletionSummary(s) {
   return `This update will remove ${list2}.`;
 }
 var bypassMisconfigWarningFired = false;
-async function gateOperation(server, context) {
-  const supported = clientSupportsElicitation(server);
+var FAST_DECLINE_THRESHOLD_MS = 50;
+var FAST_DECLINE_THRESHOLD_OVERRIDE_ENV = "EPIMETHIAN_FAST_DECLINE_THRESHOLD_MS";
+var DISABLE_FAST_DECLINE_DETECTION_ENV = "EPIMETHIAN_DISABLE_FAST_DECLINE_DETECTION";
+var TREAT_ELICITATION_AS_UNSUPPORTED_ENV = "EPIMETHIAN_TREAT_ELICITATION_AS_UNSUPPORTED";
+var fakingElicitationFlags = /* @__PURE__ */ new WeakMap();
+function isClientFakingElicitation(server) {
+  return fakingElicitationFlags.get(server) === true;
+}
+function _markClientAsFakingElicitation(server) {
+  fakingElicitationFlags.set(server, true);
+}
+function readFastDeclineThresholdMs() {
+  const raw = process.env[FAST_DECLINE_THRESHOLD_OVERRIDE_ENV];
+  if (raw === void 0 || raw === "") return FAST_DECLINE_THRESHOLD_MS;
+  const parsed = Number.parseInt(raw, 10);
+  if (!Number.isFinite(parsed)) return FAST_DECLINE_THRESHOLD_MS;
+  if (parsed < 10) return 10;
+  if (parsed > 5e3) return 5e3;
+  return parsed;
+}
+function effectiveSupportsElicitation(server) {
+  if (process.env[TREAT_ELICITATION_AS_UNSUPPORTED_ENV] === "true") {
+    return false;
+  }
+  if (isClientFakingElicitation(server)) {
+    return false;
+  }
+  return clientSupportsElicitation(server);
+}
+async function evaluateUnsupportedBranch(server, context) {
+  const supported = effectiveSupportsElicitation(server);
   if (process.env.EPIMETHIAN_BYPASS_ELICITATION === "true") {
     if (!supported && !bypassMisconfigWarningFired) {
       bypassMisconfigWarningFired = true;
@@ -60940,13 +60982,13 @@ async function gateOperation(server, context) {
     console.error(
       `epimethian-mcp: [UNGATED] tool=${context.tool} \u2014 bypassing elicitation gate; proceeding because EPIMETHIAN_BYPASS_ELICITATION=true.`
     );
-    return;
+    return "handled";
   }
   if (!supported && process.env.EPIMETHIAN_ALLOW_UNGATED_WRITES === "true") {
     console.error(
       `epimethian-mcp: [UNGATED] tool=${context.tool} \u2014 client does not support elicitation; proceeding because EPIMETHIAN_ALLOW_UNGATED_WRITES=true.`
     );
-    return;
+    return "handled";
   }
   if (!supported && process.env.EPIMETHIAN_DISABLE_SOFT_CONFIRM === "true") {
     throw new GatedOperationError(
@@ -60989,6 +61031,11 @@ async function gateOperation(server, context) {
       `This tool requires interactive confirmation but your MCP client does not expose elicitation. Use \`update_page_section\` instead, or switch to a client that supports MCP elicitation (Claude Code \u2265 2.x, Claude Desktop \u2265 0.10).`
     );
   }
+  return "fall_through";
+}
+async function gateOperation(server, context) {
+  const initial = await evaluateUnsupportedBranch(server, context);
+  if (initial === "handled") return;
   const lines = [context.summary];
   if (context.details) {
     for (const [k, v] of Object.entries(context.details)) {
@@ -61007,6 +61054,7 @@ async function gateOperation(server, context) {
   }
   const message = lines.join("\n");
   let result;
+  const startedAt = performance.now();
   try {
     result = await server.server.elicitInput({
       message,
@@ -61028,6 +61076,19 @@ async function gateOperation(server, context) {
       `Elicitation for ${context.tool} failed (${err instanceof Error ? err.message : String(err)}) \u2014 refusing the operation.`
     );
   }
+  const elapsedMs = performance.now() - startedAt;
+  const fastDeclineDisabled = process.env[DISABLE_FAST_DECLINE_DETECTION_ENV] === "true";
+  if (!fastDeclineDisabled && result.action === "decline" && elapsedMs < readFastDeclineThresholdMs()) {
+    _markClientAsFakingElicitation(server);
+    const retry = await evaluateUnsupportedBranch(server, context);
+    if (retry === "fall_through") {
+      throw new GatedOperationError(
+        NO_USER_RESPONSE,
+        `${context.tool} could not be confirmed: fast-decline retry unexpectedly fell through to row 6.`
+      );
+    }
+    return;
+  }
   if (result.action === "accept" && result.content?.confirm === true) {
     return;
   }
@@ -61051,6 +61112,59 @@ async function gateOperation(server, context) {
 
 // src/server/index.ts
 init_confirmation_tokens();
+
+// src/server/version-schema.ts
+init_zod();
+var versionField = external_exports.union([
+  external_exports.preprocess(
+    (v) => typeof v === "string" && /^\d+$/.test(v) ? Number(v) : v,
+    external_exports.number().int().positive()
+  ),
+  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.discriminatedUnion("kind", [
+  writeSuccessArm,
+  confirmationRequiredArm
+]);
+var deleteOutputSchema = external_exports.discriminatedUnion("kind", [
+  deleteSuccessArm,
+  confirmationRequiredArm
+]);
+
+// src/server/index.ts
 init_update_orchestrator();
 init_tokeniser();
 
@@ -61798,7 +61912,7 @@ ${truncated}${truncationNote(origLen)}`
       inputSchema: {
         page_id: external_exports.string().describe("The Confluence page ID"),
         title: external_exports.string().describe("Page title (use the title from get_page if unchanged)"),
-        version: external_exports.union([external_exports.number().int().positive(), external_exports.literal("current")]).describe(
+        version: versionField.describe(
           `The page version number from your most recent get_page call. Pass the literal string "current" to skip the read and apply this update on top of whatever the latest version is right now. WARNING: "current" deliberately bypasses optimistic concurrency \u2014 it is NOT a conflict-resolution strategy. If a coworker (or another agent) writes between our read and submit, the API will still 409 and we propagate the conflict. Use a numeric version when you want the "don't overwrite my coworker's changes" guard. Use "current" only as a shortcut to skip the get_page round-trip when concurrent writes are not a concern (e.g. immediately after create_page).`
         ),
         body: external_exports.string().optional().describe("New body content \u2014 GFM markdown or Confluence storage format (XHTML). Markdown is auto-detected and converted via the token-aware write path. Do not mix the two: inlining <ac:.../> macros inside a markdown body is rejected. For a TOC use YAML frontmatter (toc: { maxLevel, minLevel }); for other macros use directive syntax (:info[...], :mention[...]{...})."),
@@ -61816,6 +61930,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 }) => {
@@ -61912,14 +62031,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 });
@@ -61945,6 +62084,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 }) => {
@@ -62010,7 +62153,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 });
@@ -62047,13 +62198,16 @@ ${truncated}${truncationNote(origLen)}`
         ).min(1).optional().describe(
           "Alternative to `body`: apply literal string substitutions inside the section's storage XML instead of replacing the whole section. Each entry's `find` is searched for and replaced with `replace`. Pairs are applied in input order; each subsequent `find` searches the partially-substituted body, so chained substitutions work as expected. If a `find` string is not found, the call fails with FIND_REPLACE_MATCH_FAILED \u2014 no silent no-op. Substitutions are ONLY applied to text outside macro boundaries (attribute values and CDATA bodies are protected). Exactly one of `body` or `find_replace` must be provided."
         ),
-        version: external_exports.union([external_exports.number().int().positive(), external_exports.literal("current")]).describe(
+        version: versionField.describe(
           `The page version number from your most recent get_page call. Pass the literal string "current" to skip the read and apply this update on top of whatever the latest version is right now. WARNING: "current" deliberately bypasses optimistic concurrency \u2014 it is NOT a conflict-resolution strategy. If a coworker (or another agent) writes between our read and submit, the API will still 409. Use a numeric version when you want the "don't overwrite my coworker's changes" guard.`
         ),
         version_message: external_exports.string().optional().describe("Optional version comment"),
         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 }) => {
@@ -62127,12 +62281,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);
@@ -62201,9 +62366,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 });
@@ -62223,7 +62399,7 @@ ${truncated}${truncationNote(origLen)}`
       ),
       inputSchema: {
         page_id: external_exports.string().describe("The Confluence page ID"),
-        version: external_exports.union([external_exports.number().int().positive(), external_exports.literal("current")]).describe(
+        version: versionField.describe(
           'The page version number from your most recent get_page call. Pass the literal string "current" to skip the read and apply this update on top of whatever the latest version is right now. WARNING: "current" deliberately bypasses optimistic concurrency.'
         ),
         version_message: external_exports.string().optional().describe("Optional version comment for the single resulting revision"),
@@ -62381,7 +62557,7 @@ ${truncated}${truncationNote(origLen)}`
       ),
       inputSchema: {
         page_id: external_exports.string().describe("The Confluence page ID"),
-        version: external_exports.union([external_exports.number().int().positive(), external_exports.literal("current")]).describe(
+        version: versionField.describe(
           'Page version from your most recent get_page call. Pass the literal string "current" to skip the read and apply on top of whatever the latest version is right now. WARNING: "current" bypasses optimistic concurrency \u2014 it does not protect against concurrent writes; the API can still 409 between our read and submit.'
         ),
         content: external_exports.string().describe("Content to insert before the existing body. GFM markdown or storage format (auto-detected)."),
@@ -62391,6 +62567,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 }) => {
@@ -62411,7 +62590,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 });
@@ -62431,7 +62621,7 @@ ${truncated}${truncationNote(origLen)}`
       ),
       inputSchema: {
         page_id: external_exports.string().describe("The Confluence page ID"),
-        version: external_exports.union([external_exports.number().int().positive(), external_exports.literal("current")]).describe(
+        version: versionField.describe(
           'Page version from your most recent get_page call. Pass the literal string "current" to skip the read and apply on top of whatever the latest version is right now. WARNING: "current" bypasses optimistic concurrency \u2014 it does not protect against concurrent writes; the API can still 409 between our read and submit.'
         ),
         content: external_exports.string().describe("Content to insert after the existing body. GFM markdown or storage format (auto-detected)."),
@@ -62441,6 +62631,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 }) => {
@@ -62461,7 +62654,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 });
@@ -63620,7 +63824,7 @@ ${titleFenced}${echo2}`
       inputSchema: {}
     },
     async () => {
-      let text2 = `epimethian-mcp v${"6.6.0"}`;
+      let text2 = `epimethian-mcp v${"6.6.2"}`;
       try {
         const pending = await getPendingUpdate();
         if (pending) {
@@ -63651,7 +63855,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.0"} is already up to date.`
+            `epimethian-mcp v${"6.6.2"} is already up to date.`
           );
         }
         const output = await performUpgrade(pending.latest);
@@ -63673,7 +63877,7 @@ async function startRecoveryServer(profile) {
   const server = new McpServer(
     {
       name: `confluence-${profile}-setup-needed`,
-      version: "6.6.0"
+      version: "6.6.2"
     },
     {
       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.`
@@ -63724,21 +63928,21 @@ async function main() {
   const serverName = config3.profile ? `confluence-${config3.profile}` : "confluence";
   const server = new McpServer({
     name: serverName,
-    version: "6.6.0"
+    version: "6.6.2"
   });
   await registerTools(server, config3);
   const transport = new StdioServerTransport();
   await server.connect(transport);
   try {
     const pending = await getPendingUpdate();
-    if (pending && pending.current === "6.6.0") {
+    if (pending && pending.current === "6.6.2") {
       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.0").catch(() => {
+  checkForUpdates("6.6.2").catch(() => {
   });
 }