@theronap/agnoclast-mcp 0.9.267 → 0.9.268

package/lib/release_gate.mjs

@@ -5,7 +5,7 @@
 // that web/lib/engine/release.test.ts pins to the server's registry.
 
 /** Tools any release flag gates — hidden when the server cannot be asked. Mirror of allGatedTools(). */
-export const GATED_FALLBACK = ['attach_document', 'document_diff', 'get_document', 'intake_shadow', 'list_documents', 'my_messages', 'pin_document', 'read_conversation', 'read_document', 'send_message', 'set_manager', 'upload_document_version']
+export const GATED_FALLBACK = ['attach_document', 'document_diff', 'export_page', 'get_document', 'intake_shadow', 'list_documents', 'my_messages', 'pin_document', 'read_conversation', 'read_document', 'send_message', 'set_manager', 'upload_document_version']
 
 export const RELEASE_FETCH_TIMEOUT_MS = 2500
 

package/lib/server.mjs

@@ -7416,6 +7416,35 @@ function renderNudge(payload) {
     },
   )
 
+  // TEXT-FIRST TEST, slice A (2026-10-26): a page rendered as a styled Word doc, in its brain's style.
+  server.registerTool(
+    'export_page',
+    {
+      title: 'Export a page as a styled Word document',
+      description: 'Render a wiki page as a .docx in its brain\'s document style (set by the brain\'s owner or admins in the console) and save it to ~/Downloads/cortex/. Use it when someone needs to SEND or print a page: the page stays the master; the Word file is a copy of it. For PDF, the person uses Export ▸ PDF on the page in Agnoclast.',
+      inputSchema: {
+        page: z.string().describe('the page: its exact title, its `ref:` from read_page, or a document id'),
+        tier: z.string().optional().describe('which copy of a two-copy page (e.g. "scoped"); default the most recently written'),
+      },
+    },
+    async ({ page, tier }) => {
+      const q = new URLSearchParams({ page })
+      if (tier) q.set('tier', tier)
+      let res
+      try { res = await fetchCortex(`${BASE}/api/brain/page/export?${q}`, { headers: { Authorization: `Bearer ${TOKEN}` } }) }
+      catch (e) { return toolError(`Could not export: ${e.message}`) }
+      if (!res.ok) return docFail('export the page', res)
+      const buf = Buffer.from(await res.arrayBuffer())
+      const m = /filename="([^"]+)"/.exec(res.headers.get('content-disposition') ?? '')
+      const name = (m ? m[1] : 'page.docx').replace(/[^\w.\- ]/g, '_')
+      const dir = join(homedir(), 'Downloads', 'cortex')
+      mkdirSync(dir, { recursive: true })
+      const path = join(dir, name)
+      writeFileSync(path, buf)
+      return { content: [{ type: 'text', text: `Saved "${page}" as a styled Word document: ${path} (${Math.round(buf.length / 1024)} KB).` }] }
+    },
+  )
+
   // UPLOADS (slice 4). The server refuses an assistant unless the person turned on "Let assistants upload
   // files" in Agnoclast → Settings — a switch only the console can flip. These tools never ask for it.
   // Bytes go straight to storage on the signed URL the server hands out, then the server reads them back.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theronap/agnoclast-mcp",
-  "version": "0.9.267",
+  "version": "0.9.268",
   "description": "Connect your AI assistant to Cortex — your org's projects, activity, gaps, and directives, scoped to you.",
   "type": "module",
   "bin": {