@theronap/agnoclast-mcp 0.9.267 → 0.9.269

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', 'import_document_as_page', '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,66 @@ 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).` }] }
+    },
+  )
+
+  // TEXT-FIRST TEST, slice B (2026-10-26): a stored Word document becomes a page; the .docx moves onto it, pinned.
+  server.registerTool(
+    'import_document_as_page',
+    {
+      title: 'Turn a stored Word document into a page',
+      description: 'Convert a stored .docx into an editable wiki page — headings become sections, lists/tables/bold/links survive, images are left out (the original keeps them). The new page is created at the same visibility as the file\'s current page, the .docx moves onto it pinned as the original, and the old page gets one line linking to it. Needs edit access to the file\'s page. After this the PAGE is the master: edit the page, and export it with export_page when someone needs a Word copy.',
+      inputSchema: {
+        file_id: z.string().describe('the stored file\'s id (from list_documents or read_page\'s 📌/📎 lines)'),
+        title: z.string().optional().describe('the new page\'s name; default the file\'s title'),
+      },
+    },
+    async ({ file_id, title }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/stored-files/${encodeURIComponent(file_id)}/import-page`, {
+          method: 'POST', headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify(title ? { title } : {}),
+        })
+      } catch (e) { return toolError(`Could not import: ${e.message}`) }
+      if (!res.ok) return docFail('import the document', res)
+      const o = await res.json()
+      const lines = [`Made the page "${o.title}" (ref ${o.ref}, ${o.tier}) with ${o.sections} section${o.sections === 1 ? '' : 's'}; the .docx is pinned on it as the original.`]
+      if (o.images) lines.push(`${o.images} image${o.images === 1 ? ' was' : 's were'} left out — the original file keeps ${o.images === 1 ? 'it' : 'them'}.`)
+      if (o.shortenedHeadings) lines.push(`${o.shortenedHeadings} heading${o.shortenedHeadings === 1 ? ' was' : 's were'} over 80 characters and shortened.`)
+      if (o.splitSections) lines.push(`${o.splitSections} very long section${o.splitSections === 1 ? ' was' : 's were'} split into parts.`)
+      lines.push(o.linkedFromOldPage ? 'The old page now links to it.' : 'The old page could not be given a link line; add one with edit_page if it matters.')
+      lines.push(`Read it with read_page "${o.title}".`)
+      return { content: [{ type: 'text', text: lines.join('\n') }] }
+    },
+  )
+
   // 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.269",
   "description": "Connect your AI assistant to Cortex — your org's projects, activity, gaps, and directives, scoped to you.",
   "type": "module",
   "bin": {