brainllm 10.5.0 → 10.5.2

package/dist/index.js

@@ -28322,258 +28322,12 @@ section="<heading>" reads one section instead of the whole log.`, {
   server.tool("insights_recall", "Skim recent change logs (days + previews).", { limit: exports_external.number().optional() }, async ({ limit }) => txt(await skim(trilium, b().insights.logs, { kind: "log", limit: limit ?? 14 })));
 }
 
-// src/tools-advanced.ts
-var txt3 = (obj) => ({
-  content: [{ type: "text", text: typeof obj === "string" ? obj : JSON.stringify(obj, null, 2) }]
-});
-var noteStub = (n) => ({
-  id: n.noteId,
-  title: n.title,
-  ...n.type ? { type: n.type } : {}
-});
-var attrStub = (a) => ({
-  id: a.attributeId,
-  noteId: a.noteId,
-  type: a.type,
-  name: a.name,
-  value: a.value
-});
-function registerAdvancedTools(server, trilium, brainRef) {
-  const b = () => brainRef.config;
-  server.tool("search_notes", `Raw Trilium query search. Native query language: #label=value, note.title =* "x",
-note.dateModified >= 'YYYY-MM-DD', AND/OR. Unscoped unless ancestorNoteId is given.`, {
-    query: exports_external.string().describe("Trilium search query"),
-    ancestorNoteId: exports_external.string().optional().describe("Limit to this subtree"),
-    limit: exports_external.number().optional(),
-    orderBy: exports_external.string().optional().describe("title | dateModified | dateCreated"),
-    orderDirection: exports_external.enum(["asc", "desc"]).optional(),
-    fastSearch: exports_external.boolean().optional().describe("Skip content body scan"),
-    includeArchived: exports_external.boolean().optional(),
-    debug: exports_external.boolean().optional().describe("Return query parse debug info")
-  }, async ({ query, ancestorNoteId, limit, orderBy, orderDirection, fastSearch, includeArchived, debug }) => {
-    const result = await trilium.searchNotes(query, {
-      ancestorNoteId,
-      limit,
-      orderBy,
-      orderDirection,
-      fastSearch,
-      includeArchivedNotes: includeArchived,
-      debug
-    });
-    const out = { results: result.results.map(noteStub) };
-    if (result.debugInfo !== undefined)
-      out.debugInfo = result.debugInfo;
-    return txt3(out);
-  });
-  server.tool("get_note", "Full note metadata: title, type, mime, attributes (labels + relations), parent/child ids, dates.", { noteId: exports_external.string() }, async ({ noteId }) => {
-    const n = await trilium.getNote(noteId);
-    return txt3({
-      id: n.noteId,
-      title: n.title,
-      type: n.type,
-      mime: n.mime,
-      attributes: n.attributes.map((a) => ({ id: a.attributeId, type: a.type, name: a.name, value: a.value })),
-      parents: n.parentNoteIds,
-      children: n.childNoteIds,
-      created: n.dateCreated,
-      modified: n.dateModified
-    });
-  });
-  server.tool("get_note_content", "Raw note content (HTML / text / code).", { noteId: exports_external.string() }, async ({ noteId }) => txt3(await trilium.getNoteContent(noteId)));
-  server.tool("create_note", "Create a note at an explicit parent. Types: text/code/book/canvas/mermaid/relationMap/render/search/file/image.", {
-    parentNoteId: exports_external.string(),
-    title: exports_external.string(),
-    content: exports_external.string(),
-    type: exports_external.enum(["text", "code", "book", "canvas", "mermaid", "relationMap", "render", "search", "file", "image"]).optional(),
-    mime: exports_external.string().optional()
-  }, async ({ parentNoteId, title, content, type, mime }) => {
-    const r = await trilium.createNote(parentNoteId, title, content, type ?? "text", mime);
-    return txt3({ noteId: r.note.noteId, branchId: r.branch.branchId, title: r.note.title });
-  });
-  server.tool("update_note_content", "Replace a note's full content.", { noteId: exports_external.string(), content: exports_external.string() }, async ({ noteId, content }) => {
-    await trilium.updateNoteContent(noteId, content);
-    return txt3({ ok: true, noteId });
-  });
-  server.tool("patch_note", "Mutate note metadata: title, type, or mime.", { noteId: exports_external.string(), title: exports_external.string().optional(), type: exports_external.string().optional(), mime: exports_external.string().optional() }, async ({ noteId, title, type, mime }) => {
-    const fields = {};
-    if (title != null)
-      fields.title = title;
-    if (type != null)
-      fields.type = type;
-    if (mime != null)
-      fields.mime = mime;
-    const note = await trilium.patchNote(noteId, fields);
-    return txt3({ noteId: note.noteId, title: note.title, type: note.type });
-  });
-  server.tool("delete_note", "Hard-delete a note (and its subtree if this is its last branch). Irreversible.", { noteId: exports_external.string() }, async ({ noteId }) => {
-    await trilium.deleteNote(noteId);
-    return txt3({ ok: true, deleted: noteId });
-  });
-  server.tool("undelete_note", "Recover a recently Trilium-deleted note from Trilium's trash. canBeUndeleted must be true (check note_history). Distinct from recover() which restores BrainLLM-archived notes. Re-applies the BrainLLM label set for the container it lands in \u2014 the restore itself does not bring attributes back, and a note without #noteType is invisible to every read path.", { noteId: exports_external.string() }, async ({ noteId }) => {
-    await trilium.undeleteNote(noteId);
-    const cfg = b();
-    const note = await trilium.getNote(noteId).catch(() => null);
-    const restored = [];
-    let inferredKind;
-    if (note) {
-      const already = ownedLabel(note, "noteType");
-      if (already) {
-        inferredKind = already;
-      } else {
-        const parents = note.parentNoteIds ?? [];
-        const byContainer = [
-          [cfg.memory.sessions, "session"],
-          [cfg.memory.threads, "thread"],
-          [cfg.llm.diary, "diary"],
-          [cfg.insights.logs, "log"],
-          [cfg.knowledge.master, "user"],
-          [cfg.knowledge.domains, "domain"]
-        ];
-        for (const [containerId, kind] of byContainer) {
-          if (containerId && parents.includes(containerId)) {
-            inferredKind = kind;
-            break;
-          }
-        }
-        if (!inferredKind && parents.length) {
-          const parent = await trilium.getNote(parents[0]).catch(() => null);
-          if (parent && ownedLabel(parent, "noteType") === "thread")
-            inferredKind = "threadEntry";
-          else if (parent && ownedLabel(parent, "noteType") === "domain")
-            inferredKind = "information";
-        }
-        if (inferredKind) {
-          for (const l of labelPlan(inferredKind, {}, localToday())) {
-            if (!ownedLabel(note, l.name)) {
-              await trilium.addLabel(noteId, l.name, l.value, l.inheritable ?? false).catch(() => null);
-              restored.push(l.value ? `${l.name}=${l.value}` : l.name);
-            }
-          }
-        }
-      }
-    }
-    return txt3({
-      ok: true,
-      undeleted: noteId,
-      ...inferredKind ? { kind: inferredKind } : {},
-      ...restored.length ? { labelsRestored: restored } : {},
-      ...note && !inferredKind ? {
-        warning: "Could not infer this note's kind from its placement, so no #noteType was applied \u2014 it is currently INVISIBLE to brain(), recall() and every surface read. " + "Move it under its proper container and re-run, or set the label with add_label."
-      } : {}
-    });
-  });
-  server.tool("note_history", "Recent changes feed (creations / modifications / deletions), newest first.", { ancestorNoteId: exports_external.string().optional() }, async ({ ancestorNoteId }) => {
-    const changes = await trilium.getNoteHistory(ancestorNoteId);
-    return txt3(changes.map((c) => ({ id: c.noteId, title: c.current_title, deleted: c.current_isDeleted, date: c.date })));
-  });
-  server.tool("get_attribute", "Fetch a single attribute by id.", { attributeId: exports_external.string() }, async ({ attributeId }) => txt3(attrStub(await trilium.getAttribute(attributeId))));
-  server.tool("add_label", "Add a #label to a note (empty value = boolean flag). Adds a new attribute; does not dedupe.", { noteId: exports_external.string(), name: exports_external.string().describe("Label name (no # prefix)"), value: exports_external.string().optional(), isInheritable: exports_external.boolean().optional() }, async ({ noteId, name, value, isInheritable }) => {
-    const attr = await trilium.addLabel(noteId, name, value ?? "", isInheritable ?? false);
-    return txt3(attrStub(attr));
-  });
-  server.tool("add_relation", "Add a ~relation with any name (the core connect() enforces the canonical vocabulary).", { fromNoteId: exports_external.string(), relationName: exports_external.string(), toNoteId: exports_external.string(), isInheritable: exports_external.boolean().optional() }, async ({ fromNoteId, relationName, toNoteId, isInheritable }) => {
-    const attr = await trilium.addRelation(fromNoteId, relationName, toNoteId, isInheritable ?? false);
-    return txt3(attrStub(attr));
-  });
-  server.tool("update_attribute", "Update an attribute's value (labels) and/or position by id.", { attributeId: exports_external.string(), value: exports_external.string().optional(), position: exports_external.number().optional() }, async ({ attributeId, value, position }) => {
-    const fields = {};
-    if (value != null)
-      fields.value = value;
-    if (position != null)
-      fields.position = position;
-    return txt3(attrStub(await trilium.updateAttribute(attributeId, fields)));
-  });
-  server.tool("delete_attribute", "Delete any label or relation by attributeId.", { attributeId: exports_external.string() }, async ({ attributeId }) => {
-    await trilium.deleteAttribute(attributeId);
-    return txt3({ ok: true, deleted: attributeId });
-  });
-  server.tool("get_branch", "Fetch a branch (a note's placement under one parent).", { branchId: exports_external.string() }, async ({ branchId }) => txt3(await trilium.getBranch(branchId)));
-  server.tool("clone_note", "Place a note under an additional parent (multi-parent branch; shared content, no copy).", { noteId: exports_external.string(), parentNoteId: exports_external.string(), prefix: exports_external.string().optional() }, async ({ noteId, parentNoteId, prefix }) => {
-    const branch = await trilium.cloneNote(noteId, parentNoteId, prefix);
-    return txt3({ id: branch.branchId, noteId: branch.noteId, parentNoteId: branch.parentNoteId });
-  });
-  server.tool("move_note", "Move a note to a new parent (clone to the new parent, then remove the old branch).", { noteId: exports_external.string(), fromParentNoteId: exports_external.string(), toParentNoteId: exports_external.string() }, async ({ noteId, fromParentNoteId, toParentNoteId }) => {
-    const newBranch = await trilium.cloneNote(noteId, toParentNoteId);
-    const fresh = await trilium.getNote(noteId);
-    for (const bid of fresh.parentBranchIds) {
-      if (bid === newBranch.branchId)
-        continue;
-      const branch = await trilium.getBranch(bid);
-      if (branch.parentNoteId === fromParentNoteId) {
-        await trilium.deleteBranch(bid);
-        break;
-      }
-    }
-    return txt3({ ok: true, noteId, movedTo: toParentNoteId, newBranchId: newBranch.branchId });
-  });
-  server.tool("delete_branch", "Remove one placement of a note (deletes the note if it was the last branch).", { branchId: exports_external.string() }, async ({ branchId }) => {
-    await trilium.deleteBranch(branchId);
-    return txt3({ ok: true, deleted: branchId });
-  });
-  server.tool("create_revision", "Snapshot a note's current content as a revision.", { noteId: exports_external.string() }, async ({ noteId }) => {
-    await trilium.createRevision(noteId);
-    return txt3({ ok: true, noteId });
-  });
-  server.tool("get_revisions", "List a note's revisions, newest first.", { noteId: exports_external.string() }, async ({ noteId }) => {
-    const revs = await trilium.getNoteRevisions(noteId);
-    return txt3(revs.map((r) => ({ id: r.revisionId, title: r.title, date: r.utcDateCreated, size: r.contentLength })));
-  });
-  server.tool("get_revision_content", "Content of a historical revision snapshot.", { revisionId: exports_external.string() }, async ({ revisionId }) => txt3(await trilium.getRevisionContent(revisionId)));
-  server.tool("get_attachments", "List attachments on a note (id + title + mime + size).", { noteId: exports_external.string() }, async ({ noteId }) => {
-    const attachments = await trilium.getNoteAttachments(noteId);
-    return txt3(attachments.map((a) => ({ id: a.attachmentId, title: a.title, mime: a.mime, size: a.contentLength })));
-  });
-  server.tool("get_attachment_content", "Read the content of a text/code attachment.", { attachmentId: exports_external.string() }, async ({ attachmentId }) => txt3(await trilium.getAttachmentContent(attachmentId)));
-  server.tool("create_attachment", "Attach a file or text blob to a note (role: file | image).", { ownerId: exports_external.string(), title: exports_external.string(), mime: exports_external.string(), content: exports_external.string().describe("Text content (base64 for binary)"), role: exports_external.enum(["file", "image"]).optional() }, async ({ ownerId, title, mime, content, role }) => {
-    const att = await trilium.createAttachment(ownerId, title, mime, content, role ?? "file");
-    return txt3({ id: att.attachmentId, title: att.title, mime: att.mime, size: att.contentLength });
-  });
-  server.tool("update_attachment", "Update an attachment's content and/or metadata (title, mime). Pass content to replace the binary/text data in place; pass title/mime to update metadata only.", {
-    attachmentId: exports_external.string(),
-    title: exports_external.string().optional(),
-    mime: exports_external.string().optional().describe("MIME type \u2014 also used as Content-Type when writing content"),
-    content: exports_external.string().optional().describe("New content (replaces existing; text or base64 for binary)")
-  }, async ({ attachmentId, title, mime, content }) => {
-    if (content != null) {
-      await trilium.updateAttachmentContent(attachmentId, content, mime ?? "text/plain");
-    }
-    if (title != null || mime != null) {
-      const fields = {};
-      if (title != null)
-        fields.title = title;
-      if (mime != null)
-        fields.mime = mime;
-      const att = await trilium.updateAttachment(attachmentId, fields);
-      return txt3({ id: att.attachmentId, title: att.title, mime: att.mime, contentUpdated: content != null });
-    }
-    return txt3({ ok: true, attachmentId, contentUpdated: content != null });
-  });
-  server.tool("delete_attachment", "Permanently delete an attachment. Irreversible.", { attachmentId: exports_external.string() }, async ({ attachmentId }) => {
-    await trilium.deleteAttachment(attachmentId);
-    return txt3({ ok: true, deleted: attachmentId });
-  });
-  server.tool("get_day_note", "Get (or auto-create) the journal day note. Format: YYYY-MM-DD (default: today).", { date: exports_external.string().optional() }, async ({ date: date4 }) => txt3(await trilium.getDayNote(date4 ?? localToday())));
-  server.tool("get_week_note", "Get (or auto-create) the journal week note. Format: YYYY-Www.", { week: exports_external.string() }, async ({ week }) => txt3(await trilium.getWeekNote(week)));
-  server.tool("get_month_note", "Get (or auto-create) the journal month note. Format: YYYY-MM.", { month: exports_external.string() }, async ({ month }) => txt3(await trilium.getMonthNote(month)));
-  server.tool("get_year_note", "Get (or auto-create) the journal year note. Format: YYYY.", { year: exports_external.string() }, async ({ year }) => txt3(await trilium.getYearNote(year)));
-  server.tool("get_inbox_note", "Get the Trilium inbox note for a date (fixed #inbox note, or the day note). Format: YYYY-MM-DD.", { date: exports_external.string().optional() }, async ({ date: date4 }) => txt3(await trilium.getInboxNote(date4 ?? localToday())));
-  server.tool("get_app_info", "Trilium server version, DB version, runtime metadata.", {}, async () => txt3(await trilium.getAppInfo()));
-  server.tool("create_backup", "Trigger a named Trilium database backup. The backup file is written to Trilium's backup directory as <name>.db (default name: brainllm-{date}). Use a descriptive name for milestone snapshots (e.g. 'before-migration').", {
-    name: exports_external.string().optional().describe("Backup file name without .db extension (default: brainllm-{today})"),
-    date: exports_external.string().optional().describe("ISO date used in the default name when name is omitted (default: today)")
-  }, async ({ name, date: date4 }) => {
-    const backupName = name ?? `brainllm-${date4 ?? localToday()}`;
-    await trilium.createBackup(backupName);
-    return txt3({ ok: true, backup: `${backupName}.db` });
-  });
-}
-
 // src/tools.ts
-var txt4 = (obj) => ({
+var txt3 = (obj) => ({
   content: [{ type: "text", text: typeof obj === "string" ? obj : JSON.stringify(obj, null, 2) }]
 });
 var today = () => localToday();
-var err = (code, detail, hint) => txt4({ error: code, detail, ...hint ? { hint } : {} });
+var err = (code, detail, hint) => txt3({ error: code, detail, ...hint ? { hint } : {} });
 var labelOf2 = (n, name) => n.attributes.find((a) => a.type === "label" && a.name === name)?.value;
 var hasLabel = (n, name) => n.attributes.some((a) => a.type === "label" && a.name === name);
 function insertBeforeResolution(html, section) {
@@ -28602,7 +28356,7 @@ function isDuplicateAppend(current, incomingHtml) {
   const block = nextH === -1 ? afterHeader : afterHeader.slice(0, nextH);
   return norm(block) === norm(incomingHtml);
 }
-function registerTools(server, trilium, brainRef, mode = "core") {
+function registerTools(server, trilium, brainRef) {
   const b = () => brainRef.config;
   const preCloseSteps = new Map;
   let preCloseSeq = 0;
@@ -28744,7 +28498,7 @@ sessions need one section, not five documents.`, {
   }, async ({ depth }) => {
     const cfg = b();
     if (!cfg.root) {
-      return txt4({ status: "uninitialized", action: "Run bootstrap to create the BrainLLM structure." });
+      return txt3({ status: "uninitialized", action: "Run bootstrap to create the BrainLLM structure." });
     }
     const [hygiene, digest] = await Promise.all([
       sweep(trilium, cfg, { deep: false, dryRun: false }).catch((e) => ({
@@ -28818,7 +28572,7 @@ sessions need one section, not five documents.`, {
         }));
       } catch {}
     }
-    return txt4({
+    return txt3({
       status: "ready",
       today: todayStr,
       weekday,
@@ -28925,7 +28679,7 @@ rather than listing them unconditionally for every caller to work around.`, {
       singletonsWrittenToday: touchedToday.length ? touchedToday : "none"
     };
     const scoped = scope === "agent";
-    return txt4({
+    return txt3({
       date: d,
       ...scoped ? { scope: "agent" } : {},
       ...!full ? { mode: "light", note: "Singleton content and the diary body are omitted (default) \u2014 fetch via master()/llm() only where lastModified indicates a revision is needed; start() already served all singletons in full, and diary() needs only the id." } : {},
@@ -28967,9 +28721,9 @@ This tool writes nothing \u2014 answer the cues as prose in today's diary via di
 outright rather than padding it; two honest paragraphs beat eight forced ones.`, {}, async () => {
     const cfg = b();
     if (!cfg.root)
-      return txt4({ status: "uninitialized", action: "Run bootstrap first." });
+      return txt3({ status: "uninitialized", action: "Run bootstrap first." });
     await markStep("remarks");
-    return txt4({
+    return txt3({
       cues: {
         experience: [
           "1. Experience \u2014 what was this session actually like from the inside? The work, the flow, what happened and how it went.",
@@ -29101,7 +28855,7 @@ ${contentBlock}` }));
     if (backup !== false)
       backedUp = await trilium.createBackup(d).then(() => true).catch(() => false);
     await clearGate(d);
-    return txt4({
+    return txt3({
       action,
       noteId,
       date: d,
@@ -29121,7 +28875,7 @@ close() already triggers a backup automatically \u2014 use this for on-demand mi
     const d = today();
     const backupName = name ?? `brainllm-${d}`;
     await trilium.createBackup(backupName);
-    return txt4({ ok: true, backup: `${backupName}.db`, date: d });
+    return txt3({ ok: true, backup: `${backupName}.db`, date: d });
   });
   server.tool("diary", `Write to today's LLM diary \u2014 your daily maintained, unfiltered first-person record: your
 experience, opinions, and remarks on your own existence during this session in this
@@ -29161,13 +28915,13 @@ ${sanitized.html}` : sanitized.html;
       const incoming = norm(html);
       const blocks = current.split(/<h2>Addendum \u2014 \d{2}:\d{2}<\/h2>\n?/i).slice(1);
       if (incoming && blocks.some((b2) => norm(b2) === incoming)) {
-        return txt4({ action: "already_written", noteId: noteId2, date: d });
+        return txt3({ action: "already_written", noteId: noteId2, date: d });
       }
       await trilium.createRevision(noteId2).catch(() => null);
       await trilium.updateNoteContent(noteId2, safeAppend(current, `<h2>Addendum \u2014 ${time4}</h2>`, html));
       await trilium.updateLabelValue(noteId2, "updated", d);
       const iconSet2 = await applyIcon(noteId2, icon);
-      return txt4({ action: "appended", noteId: noteId2, date: d, ...iconSet2 ? { icon: iconSet2 } : {}, ...warnings.length ? { sanitized: warnings } : {} });
+      return txt3({ action: "appended", noteId: noteId2, date: d, ...iconSet2 ? { icon: iconSet2 } : {}, ...warnings.length ? { sanitized: warnings } : {} });
     }
     const time3 = localNowTime();
     const created = await trilium.createNote(parentId, `[${d}]`, contentFor("diary", { date: d, body: `<h2>Addendum \u2014 ${time3}</h2>
@@ -29176,7 +28930,7 @@ ${html}` }));
     await trilium.addLabel(noteId, "noteType", "diary");
     await trilium.addLabel(noteId, "created", d);
     const iconSet = await applyIcon(noteId, icon);
-    return txt4({ action: "created", noteId, date: d, location: locationLabel("diary"), ...iconSet ? { icon: iconSet } : {}, ...warnings.length ? { sanitized: warnings } : {} });
+    return txt3({ action: "created", noteId, date: d, location: locationLabel("diary"), ...iconSet ? { icon: iconSet } : {}, ...warnings.length ? { sanitized: warnings } : {} });
   });
   server.tool("remember", `Store something the moment it matters. The server owns placement, naming, labels and dedup.
 
@@ -29262,7 +29016,7 @@ For diary entries use the dedicated diary() tool \u2014 remember(kind="diary") i
       const connected2 = await wireRequested(id);
       const iconSet2 = await applyIcon(id, icon);
       const relations2 = relationSnippet(await trilium.getNote(id));
-      return txt4({ action: wrote ? "maintained" : "already_written", noteId: id, kind, location: locationLabel(kind), ...connected2.length ? { connected: connected2 } : {}, ...iconSet2 ? { icon: iconSet2 } : {}, ...relations2 ? { relations: relations2 } : {}, ...sanitizeWarnings.length ? { sanitized: sanitizeWarnings } : {} });
+      return txt3({ action: wrote ? "maintained" : "already_written", noteId: id, kind, location: locationLabel(kind), ...connected2.length ? { connected: connected2 } : {}, ...iconSet2 ? { icon: iconSet2 } : {}, ...relations2 ? { relations: relations2 } : {}, ...sanitizeWarnings.length ? { sanitized: sanitizeWarnings } : {} });
     }
     if (kind === "sources") {
       if (!domain)
@@ -29320,7 +29074,7 @@ For diary entries use the dedicated diary() tool \u2014 remember(kind="diary") i
       const placeholderLeft = hasPlaceholderRow(finalHtml, "Revision");
       const bodyWritten = !!html && !!toText(html, 50);
       const looseProse = bodyWritten && !createdDomain && !/<(?:ul|ol|li|h[34]|table)\b/i.test(html);
-      return txt4({
+      return txt3({
         action: wrote ? "maintained" : "already_written",
         noteId: sid,
         kind,
@@ -29352,7 +29106,7 @@ For diary entries use the dedicated diary() tool \u2014 remember(kind="diary") i
       if (existing2) {
         const current = await trilium.getNoteContent(existing2.noteId).catch(() => "");
         if (isDuplicateAppend(current, html))
-          return txt4({ action: "already_written", noteId: existing2.noteId, kind, title: existing2.title, domainId });
+          return txt3({ action: "already_written", noteId: existing2.noteId, kind, title: existing2.title, domainId });
         await trilium.createRevision(existing2.noteId).catch(() => null);
         const appended = bumpLastUpdated(safeAppend(current, `<h2>Addendum \u2014 ${d}</h2>`, html), d);
         await trilium.updateNoteContent(existing2.noteId, appended.html);
@@ -29360,7 +29114,7 @@ For diary entries use the dedicated diary() tool \u2014 remember(kind="diary") i
         const connected3 = await wireRequested(existing2.noteId);
         const iconSet3 = await applyIcon(existing2.noteId, icon);
         const relations2 = relationSnippet(existing2);
-        return txt4({ action: "updated", noteId: existing2.noteId, kind, title: existing2.title, domainId, ...connected3.length ? { connected: connected3 } : {}, ...iconSet3 ? { icon: iconSet3 } : {}, ...relations2 ? { relations: relations2 } : {}, ...sanitizeWarnings.length ? { sanitized: sanitizeWarnings } : {} });
+        return txt3({ action: "updated", noteId: existing2.noteId, kind, title: existing2.title, domainId, ...connected3.length ? { connected: connected3 } : {}, ...iconSet3 ? { icon: iconSet3 } : {}, ...relations2 ? { relations: relations2 } : {}, ...sanitizeWarnings.length ? { sanitized: sanitizeWarnings } : {} });
       }
       const created2 = await trilium.createNote(domainId, subTitle, contentFor("information", { date: d, body: html, domain: domainTitle }));
       const nid2 = created2.note.noteId;
@@ -29369,7 +29123,7 @@ For diary entries use the dedicated diary() tool \u2014 remember(kind="diary") i
       }
       const connected2 = await wireRequested(nid2);
       const iconSet2 = await applyIcon(nid2, icon);
-      return txt4({
+      return txt3({
         action: "created",
         noteId: nid2,
         kind,
@@ -29409,7 +29163,7 @@ ${html}` : html;
       if (kind === "thread") {
         const entry = await appendThreadEntry(existing.noteId, block, d);
         if (entry.action === "already_written") {
-          return txt4({ action: "already_written", noteId: existing.noteId, entryId: entry.noteId, kind, title: existing.title });
+          return txt3({ action: "already_written", noteId: existing.noteId, entryId: entry.noteId, kind, title: existing.title });
         }
         await trilium.updateLabelValue(existing.noteId, "updated", d);
         for (const t of topics ?? []) {
@@ -29421,11 +29175,11 @@ ${html}` : html;
         const connected3 = await wireRequested(existing.noteId);
         const iconSet3 = await applyIcon(existing.noteId, icon);
         const relations3 = relationSnippet(existing);
-        return txt4({ action: "updated", noteId: existing.noteId, entryId: entry.noteId, entryAction: entry.action, kind, title: existing.title, ...connected3.length ? { connected: connected3 } : {}, ...iconSet3 ? { icon: iconSet3 } : {}, ...relations3 ? { relations: relations3 } : {}, ...sanitizeWarnings.length ? { sanitized: sanitizeWarnings } : {} });
+        return txt3({ action: "updated", noteId: existing.noteId, entryId: entry.noteId, entryAction: entry.action, kind, title: existing.title, ...connected3.length ? { connected: connected3 } : {}, ...iconSet3 ? { icon: iconSet3 } : {}, ...relations3 ? { relations: relations3 } : {}, ...sanitizeWarnings.length ? { sanitized: sanitizeWarnings } : {} });
       }
       const current = await trilium.getNoteContent(existing.noteId).catch(() => "");
       if (isDuplicateAppend(current, block))
-        return txt4({ action: "already_written", noteId: existing.noteId, kind, title: existing.title });
+        return txt3({ action: "already_written", noteId: existing.noteId, kind, title: existing.title });
       await trilium.createRevision(existing.noteId).catch(() => null);
       const updatedContent = bumpLastUpdated(insertBeforeResolution(closeDangling(current), `<h2>Addendum \u2014 ${d}</h2>
 ${block}`), d);
@@ -29441,7 +29195,7 @@ ${block}`), d);
       const iconSet2 = await applyIcon(existing.noteId, icon);
       const relations2 = relationSnippet(existing);
       const dupes = duplicateHeadings(updatedContent.html);
-      return txt4({ action: "updated", noteId: existing.noteId, kind, title: existing.title, ...connected2.length ? { connected: connected2 } : {}, ...iconSet2 ? { icon: iconSet2 } : {}, ...relations2 ? { relations: relations2 } : {}, ...dupes.length ? { duplicateHeadings: dupes, structureHint: "The note now carries duplicated section headings \u2014 merge them with revise(section=\u2026, mode=replace)." } : {}, ...sanitizeWarnings.length ? { sanitized: sanitizeWarnings } : {} });
+      return txt3({ action: "updated", noteId: existing.noteId, kind, title: existing.title, ...connected2.length ? { connected: connected2 } : {}, ...iconSet2 ? { icon: iconSet2 } : {}, ...relations2 ? { relations: relations2 } : {}, ...dupes.length ? { duplicateHeadings: dupes, structureHint: "The note now carries duplicated section headings \u2014 merge them with revise(section=\u2026, mode=replace)." } : {}, ...sanitizeWarnings.length ? { sanitized: sanitizeWarnings } : {} });
     }
     if (kind === "thread" && !goal && !/<h2(?:\s[^>]*)?>\s*Context\s*<\/h2>/i.test(html)) {
       return err("missing_goal", "A new thread requires a goal \u2014 the Context \u2192 Goal section is queried from the user at creation.", `Ask the user what this thread's goal is, then re-call remember(kind="thread", title, goal="<the goal statement>", body?).`);
@@ -29470,7 +29224,7 @@ ${block}`), d);
     extraRelations.push(...connected);
     const iconSet = await applyIcon(nid, icon);
     const relations = [...relationSnippet(created.note) ?? [], ...extraRelations];
-    return txt4({
+    return txt3({
       action: "created",
       noteId: nid,
       kind,
@@ -29589,7 +29343,7 @@ a doubly-escaped tag", "which cite a 2026 date"). Backslashes must be escaped.`,
         tagSpanning ? `${tagSpanning} match(es) were found only after stripping markup \u2014 the phrase is split by an inline tag there.` : null,
         results2.length === 0 ? "No bodies matched that pattern, searched both as stored HTML and tag-stripped. Note that Trilium's %= pre-filter reads a striptags'd copy, so a pattern anchored ON tags may never reach verification \u2014 consistency() scans exhaustively if you need certainty." : null
       ].filter(Boolean);
-      return txt4({
+      return txt3({
         mode: "regex",
         pattern: regex,
         results: results2,
@@ -29602,7 +29356,7 @@ a doubly-escaped tag", "which cite a 2026 date"). Backslashes must be escaped.`,
       const notes = await run(q, fast, ord);
       const filtered = notes.filter(filterNote).slice(0, max);
       const results2 = await Promise.all(filtered.map(buildResult));
-      return txt4({ results: results2, ...results2.length === 0 ? noMatch : {} });
+      return txt3({ results: results2, ...results2.length === 0 ? noMatch : {} });
     }
     const scores = new Map;
     const add = (notes, weight) => {
@@ -29652,7 +29406,7 @@ a doubly-escaped tag", "which cite a 2026 date"). Backslashes must be escaped.`,
       return fuzzyIds.has(note.noteId) ? { ...row, fuzzy: true } : row;
     }));
     const fuzzyCount = results.filter((r) => ("fuzzy" in r)).length;
-    return txt4({
+    return txt3({
       results,
       ...fuzzyCount ? { fuzzyMatches: `${fuzzyCount} result(s) came from the fuzzy pass (marked fuzzy: true) \u2014 treat them as leads to verify, not as answers.` } : {},
       ...results.length === 0 ? noMatch : {}
@@ -29715,7 +29469,7 @@ Use recall() for keyword or full-text search instead.`, {
       const k = ownedLabel(n, "noteType");
       return k && k !== "domain";
     }).length;
-    return txt4({
+    return txt3({
       domain: name,
       slug,
       knowledgeDomain,
@@ -29767,7 +29521,7 @@ find=; to add content next to a heading without touching its body, use mode="bef
     identity: exports_external.string().optional().describe(`append mode: the addendum's identification line \u2014 "LLM \xB7 environment \xB7 agent/mode [\xB7 Run N]"; REQUIRED when appending to a thread (unless the body already leads with the h3)`),
     icon: exports_external.string().optional().describe('Display icon \u2014 a boxicons class ("bx bx-brain") or a bare name; normalized server-side'),
     date: exports_external.string().optional().describe("ISO date (default: today)")
-  }, async ({ noteId, body, title, section, occurrence, mode: mode2, find, nth, edits, identity, icon, date: date4 }) => {
+  }, async ({ noteId, body, title, section, occurrence, mode, find, nth, edits, identity, icon, date: date4 }) => {
     if (isContainer(b(), noteId))
       return err("protected_note", `Note ${noteId} is a container \u2014 its content cannot be edited directly.`, "Use remember() to write to singletons, or specify a content note id.");
     const d = date4 ?? today();
@@ -29880,7 +29634,7 @@ find=; to add content next to a heading without touching its body, use mode="bef
         results.push({ find: e.find, replaced: applied.count, matchMode: applied.matchMode });
       }
       if (total === 0) {
-        return txt4({
+        return txt3({
           ok: true,
           noteId,
           mode: edits ? "edits" : "find-replace",
@@ -29905,7 +29659,7 @@ find=; to add content next to a heading without touching its body, use mode="bef
       const rels = relationSnippet(note);
       const missed = results.filter((r) => r.replaced === 0);
       const structure = structuralFindings(noteKind, stamped.html);
-      return txt4({
+      return txt3({
         ok: true,
         noteId,
         mode: edits ? "edits" : "find-replace",
@@ -29921,15 +29675,15 @@ find=; to add content next to a heading without touching its body, use mode="bef
         ...replacedResult.warnings.length ? { sanitized: replacedResult.warnings } : {}
       });
     }
-    if ((mode2 === "before" || mode2 === "after") && !section)
-      return err("missing_param", `mode="${mode2}" inserts relative to a heading and needs one.`, 'Pass section="<heading text>" alongside it, or use mode="append" for a whole-note addendum.');
-    if (mode2 === "remove" && !section)
+    if ((mode === "before" || mode === "after") && !section)
+      return err("missing_param", `mode="${mode}" inserts relative to a heading and needs one.`, 'Pass section="<heading text>" alongside it, or use mode="append" for a whole-note addendum.');
+    if (mode === "remove" && !section)
       return err("missing_param", 'mode="remove" deletes a section and needs one.', 'Pass section="<heading text>". To delete the whole note use forget(noteId).');
-    if (mode2 === "remove" && section) {
+    if (mode === "remove" && section) {
       const current = await trilium.getNoteContent(noteId).catch(() => "");
       const result = setSection(current, section, "", "remove", occurrence ?? 1);
       if (!result.matched) {
-        return txt4({
+        return txt3({
           ok: true,
           noteId,
           mode: `section:remove:${section}`,
@@ -29948,7 +29702,7 @@ find=; to add content next to a heading without touching its body, use mode="bef
       if (labelOf2(note, "status") === "dormant")
         await trilium.updateLabelValue(noteId, "status", "active");
       const relsOnRemove = relationSnippet(note);
-      return txt4({
+      return txt3({
         ok: true,
         noteId,
         mode: `section:remove:${section}`,
@@ -29969,13 +29723,13 @@ find=; to add content next to a heading without touching its body, use mode="bef
       const sanitized = renderBody(body);
       const html = sanitized.html;
       warnings.push(...sanitized.warnings);
-      if (noteKind === "thread" && mode2 !== "replace" && /<h[2-4](?:\s[^>]*)?>\s*Resolution\s*<\/h[2-4]>/i.test(html) && !isOpenResolutionOnly(html)) {
+      if (noteKind === "thread" && mode !== "replace" && /<h[2-4](?:\s[^>]*)?>\s*Resolution\s*<\/h[2-4]>/i.test(html) && !isOpenResolutionOnly(html)) {
         return err("structure_violation", "Thread bodies must not carry a FILLED or duplicate Resolution \u2014 a thread has exactly one Resolution, at the bottom, owned by resolve(). A single empty '\u2014 open \u2014' placeholder is the canonical skeleton and is accepted.", "Remove the Resolution content from the body; close the thread with resolve(noteId, outcome) when the work completes.");
       }
       const current = await trilium.getNoteContent(noteId).catch(() => "");
       if (section) {
         await trilium.createRevision(noteId).catch(() => null);
-        const sectionMode = mode2 === "append" || mode2 === "before" || mode2 === "after" ? mode2 : "replace";
+        const sectionMode = mode === "append" || mode === "before" || mode === "after" ? mode : "replace";
         const result = setSection(current, section, html, sectionMode, occurrence ?? 1);
         finalContent = bumpLastUpdated(result.html, d).html;
         await trilium.updateNoteContent(noteId, finalContent);
@@ -29988,7 +29742,7 @@ find=; to add content next to a heading without touching its body, use mode="bef
           ...result.appendedAtLevel ? { appendedAtLevel: result.appendedAtLevel } : {},
           ...result.available?.length ? { available: result.available } : {}
         };
-      } else if (mode2 === "replace") {
+      } else if (mode === "replace") {
         await trilium.createRevision(noteId).catch(() => null);
         finalContent = bumpLastUpdated(html, d).html;
         await trilium.updateNoteContent(noteId, finalContent);
@@ -30000,13 +29754,13 @@ find=; to add content next to a heading without touching its body, use mode="bef
 ${html}` : html;
         threadEntryResult = await appendThreadEntry(noteId, block, d);
         if (threadEntryResult.action === "already_written") {
-          return txt4({ ok: true, noteId, mode: "already_written", entryId: threadEntryResult.noteId, date: d });
+          return txt3({ ok: true, noteId, mode: "already_written", entryId: threadEntryResult.noteId, date: d });
         }
       } else {
         const block = identity && !leadingIdentification(html) ? `<h3>${escapeHtml(identity)}</h3>
 ${html}` : html;
         if (isDuplicateAppend(current, block))
-          return txt4({ ok: true, noteId, mode: "already_written", date: d });
+          return txt3({ ok: true, noteId, mode: "already_written", date: d });
         await trilium.createRevision(noteId).catch(() => null);
         finalContent = bumpLastUpdated(insertBeforeResolution(closeDangling(current), `<h2>Addendum \u2014 ${d}</h2>
 ${block}`), d).html;
@@ -30020,12 +29774,12 @@ ${block}`), d).html;
       await trilium.updateLabelValue(noteId, "status", "active");
     const relations = relationSnippet(note);
     const targeted = occurrence && occurrence > 1 ? ` occurrence ${occurrence} of` : "";
-    const verb = mode2 === "append" ? "appended to" : mode2 === "before" || mode2 === "after" ? `inserted ${mode2}` : "replaced";
+    const verb = mode === "append" ? "appended to" : mode === "before" || mode === "after" ? `inserted ${mode}` : "replaced";
     const sectionHint = !sectionResult ? undefined : !sectionResult.matched ? `No existing "${section}" heading found at h2/h3/h4 \u2014 wrote a NEW h${sectionMiss.appendedAtLevel ?? 2} section instead of replacing anything. Check available= for the note's real heading texts, then re-target.` : sectionResult.headingCount > 1 && !occurrence ? `${sectionResult.headingCount} headings match "${section}" \u2014 the FIRST was ${verb}. Pass occurrence= (1-${sectionResult.headingCount}) to reach a different one; outline(noteId) lists them.` : sectionResult.headingCount > 1 ? `${sectionResult.headingCount} headings match "${section}" \u2014${targeted} that one was ${verb}.` : undefined;
-    return txt4({
+    return txt3({
       ok: true,
       noteId,
-      mode: body ? section ? `section:${mode2 === "before" || mode2 === "after" ? `insert-${mode2}` : mode2 === "append" ? "append-within" : "replace"}:${section}` : mode2 ?? "append" : titled.retitled ? "rename" : iconSet ? "icon" : "no-op",
+      mode: body ? section ? `section:${mode === "before" || mode === "after" ? `insert-${mode}` : mode === "append" ? "append-within" : "replace"}:${section}` : mode ?? "append" : titled.retitled ? "rename" : iconSet ? "icon" : "no-op",
       date: d,
       ...sectionResult ? { matched: sectionResult.matched, headingCount: sectionResult.headingCount } : {},
       ...sectionResult?.replacedSubsections?.length ? {
@@ -30070,7 +29824,7 @@ status, and archive it in place (it stays where it is, excluded from default rec
       followUps.push(`superseded by ${supersededBy}`);
     }
     const relations = relationSnippet(note);
-    return txt4({
+    return txt3({
       ok: true,
       noteId,
       kind: labelOf2(note, "noteType") ?? "note",
@@ -30110,7 +29864,7 @@ Use when a resolved or dormant thread resurfaces as live work.`, {
       await trilium.updateLabelValue(noteId, "updated", d);
     }
     const relations = relationSnippet(note);
-    return txt4({
+    return txt3({
       ok: true,
       noteId,
       kind: labelOf2(note, "noteType") ?? "note",
@@ -30153,7 +29907,7 @@ setting updated itself.`, {
         await trilium.addLabel(noteId, l.name, l.value, l.inheritable ?? false).catch(() => null);
         applied.push(l.value ? `${l.name}=${l.value}` : l.name);
       }
-      return txt4({
+      return txt3({
         ok: true,
         noteId,
         name,
@@ -30167,11 +29921,11 @@ setting updated itself.`, {
     if (remove) {
       const attr = note.attributes.find((a) => a.type === "label" && a.name === name);
       if (!attr)
-        return txt4({ ok: true, noteId, name, action: "not_found" });
+        return txt3({ ok: true, noteId, name, action: "not_found" });
       await trilium.deleteAttribute(attr.attributeId);
       if (name !== "updated")
         await trilium.updateLabelValue(noteId, "updated", today()).catch(() => null);
-      return txt4({ ok: true, noteId, name, action: "removed" });
+      return txt3({ ok: true, noteId, name, action: "removed" });
     }
     if (value === undefined)
       return err("missing_param", "label() requires value unless remove=true.", 'Add value="..." or set remove=true.');
@@ -30181,7 +29935,7 @@ setting updated itself.`, {
     await trilium.updateLabelValue(noteId, name, finalValue);
     if (name !== "updated")
       await trilium.updateLabelValue(noteId, "updated", today()).catch(() => null);
-    return txt4({ ok: true, noteId, name, value: finalValue, action: "set" });
+    return txt3({ ok: true, noteId, name, value: finalValue, action: "set" });
   });
   server.tool("connect", `Wire a typed relation between two notes when you notice a real connection.
 Vocabulary (closed): ${RelationTypes.join(" | ")}.
@@ -30197,7 +29951,7 @@ calling twice is safe. Use remove=true to delete an edge.`, {
       await trilium.removeRelation(fromNoteId, relation, toNoteId).catch(() => null);
       if (symmetric)
         await trilium.removeRelation(toNoteId, relation, fromNoteId).catch(() => null);
-      return txt4({ ok: true, removed: `${fromNoteId} ~${relation}\u2192 ${toNoteId}` });
+      return txt3({ ok: true, removed: `${fromNoteId} ~${relation}\u2192 ${toNoteId}` });
     }
     const from = await trilium.getNote(fromNoteId);
     const exists = from.attributes.some((a) => a.type === "relation" && a.name === relation && a.value === toNoteId);
@@ -30209,7 +29963,7 @@ calling twice is safe. Use remove=true to delete an edge.`, {
       if (!reverseExists)
         await trilium.addRelation(toNoteId, relation, fromNoteId);
     }
-    return txt4({ ok: true, action: exists ? "already-existed" : "created", edge: `${fromNoteId} ~${relation}${symmetric ? "\u2194" : "\u2192"} ${toNoteId}` });
+    return txt3({ ok: true, action: exists ? "already-existed" : "created", edge: `${fromNoteId} ~${relation}${symmetric ? "\u2194" : "\u2192"} ${toNoteId}` });
   });
   server.tool("explore", `Walk the relation graph around a note.
   mode=links         what this note points to (one hop)
@@ -30222,8 +29976,8 @@ calling twice is safe. Use remove=true to delete an edge.`, {
     toNoteId: exports_external.string().optional().describe("Target note (mode=path)"),
     depth: exports_external.number().optional().describe("Hops for neighborhood (default: 2)"),
     relation: exports_external.string().optional().describe("Restrict to one relation type")
-  }, async ({ noteId, mode: mode2, toNoteId, depth, relation }) => {
-    switch (mode2) {
+  }, async ({ noteId, mode, toNoteId, depth, relation }) => {
+    switch (mode) {
       case "links": {
         const note = await trilium.getNote(noteId);
         const rels = note.attributes.filter((a) => a.type === "relation" && a.name !== "template" && (!relation || a.name === relation));
@@ -30231,25 +29985,25 @@ calling twice is safe. Use remove=true to delete an edge.`, {
           const n = await trilium.getNote(r.value).catch(() => null);
           return n ? { id: n.noteId, title: n.title, via: r.name } : null;
         }));
-        return txt4({ mode: mode2, links: linked.filter(Boolean) });
+        return txt3({ mode, links: linked.filter(Boolean) });
       }
       case "backlinks": {
         const backlinks = await trilium.getBacklinks(noteId);
-        return txt4({ mode: mode2, backlinks: relation ? backlinks.filter((b2) => b2.relationName === relation) : backlinks });
+        return txt3({ mode, backlinks: relation ? backlinks.filter((b2) => b2.relationName === relation) : backlinks });
       }
       case "neighborhood": {
         const nodes = await trilium.getNeighborhood(noteId, depth ?? 2, relation);
-        return txt4({ mode: mode2, nodeCount: nodes.length, nodes });
+        return txt3({ mode, nodeCount: nodes.length, nodes });
       }
       case "path": {
         if (!toNoteId)
           throw new Error("mode=path requires toNoteId");
         if (noteId === toNoteId) {
           const self = await trilium.getNote(noteId);
-          return txt4({ mode: mode2, found: true, hops: 0, path: [{ noteId, title: self.title, depth: 0 }] });
+          return txt3({ mode, found: true, hops: 0, path: [{ noteId, title: self.title, depth: 0 }] });
         }
         const path = await trilium.findNeuralPath(noteId, toNoteId, depth ?? 6);
-        return txt4(path ? { mode: mode2, found: true, hops: path.length - 1, path } : { mode: mode2, found: false });
+        return txt3(path ? { mode, found: true, hops: path.length - 1, path } : { mode, found: false });
       }
     }
   });
@@ -30343,7 +30097,7 @@ anyway when scope is wide and speed matters more than completeness.`, {
         noCapture.push(stub);
     }
     if (!hasCaptureGroup) {
-      return txt4({
+      return txt3({
         mode: "presence",
         pattern,
         scan: fast ? "fast (%= pre-filter)" : "exhaustive",
@@ -30355,7 +30109,7 @@ anyway when scope is wide and speed matters more than completeness.`, {
     }
     const groups = [...byValue.entries()].map(([value, notes2]) => ({ value, count: notes2.length, notes: notes2 })).sort((a, b2) => b2.count - a.count);
     const agrees = groups.length <= 1;
-    return txt4({
+    return txt3({
       mode: "consistency",
       pattern,
       scan: fast ? "fast (%= pre-filter)" : "exhaustive",
@@ -30390,7 +30144,7 @@ remember(revision=) matches on exactly) without reading the note.`, {
     const report = structureReport(content);
     const tables = headings.map((h) => ({ section: h.text, keys: tableRows(content, h.text).map((c) => c[0]).filter(Boolean) })).filter((t) => t.keys.length);
     const sizeWarning = report.size >= LARGE_NOTE_CHARS ? `${Math.round(report.size / 1000)}k characters \u2014 approaching the tool output ceiling. Prefer section=/find= edits and targeted reads over whole-note reads.` : undefined;
-    return txt4({
+    return txt3({
       noteId,
       title: note.title,
       kind: labelOf2(note, "noteType"),
@@ -30481,7 +30235,7 @@ miss is diagnosed in the same call rather than in three more.`, {
     }
     const labels = note.attributes.filter((a) => a.type === "label").map((a) => ({ name: a.name, value: a.value, ...a.isInheritable ? { inheritable: true } : {} }));
     const relations = relationSnippet(note, 50);
-    return txt4({
+    return txt3({
       id: note.noteId,
       title: note.title,
       kind: labelOf2(note, "noteType"),
@@ -30542,7 +30296,7 @@ broken ones, so staleness arrives as a maintenance finding instead of a surprise
   }, async ({ assertion, check: check2, noteId, intervalDays, claimId, holds, evidence, status, retire }) => {
     const cfg = b();
     if (!cfg.root)
-      return txt4({ status: "uninitialized", action: "Run bootstrap first." });
+      return txt3({ status: "uninitialized", action: "Run bootstrap first." });
     const d = today();
     const container = await resolveClaimsContainer();
     const lapsed = (n) => {
@@ -30566,11 +30320,11 @@ broken ones, so staleness arrives as a maintenance finding instead of a surprise
         return err("not_found", `${claimId} is not a claim.`, "List them with claim() and no arguments.");
       if (retire) {
         await trilium.addLabel(claimId, "archived", "").catch(() => null);
-        return txt4({ ok: true, claimId, action: "retired", assertion: note.title });
+        return txt3({ ok: true, claimId, action: "retired", assertion: note.title });
       }
       if (holds === undefined) {
         const content2 = await trilium.getNoteContent(claimId).catch(() => "");
-        return txt4({ ...row(note), check: getSection(content2, "Check").content, history: getSection(content2, "Verifications").content, relations: relationSnippet(note) });
+        return txt3({ ...row(note), check: getSection(content2, "Check").content, history: getSection(content2, "Verifications").content, relations: relationSnippet(note) });
       }
       if (!evidence)
         return err("missing_param", "A verification needs evidence.", 'Pass evidence="<what you actually observed>" \u2014 the output, the count, the response. Recording a verdict without it makes the register a record of opinions.');
@@ -30583,7 +30337,7 @@ broken ones, so staleness arrives as a maintenance finding instead of a surprise
       await trilium.updateLabelValue(claimId, "claimState", holds ? "holding" : "broken").catch(() => null);
       await trilium.updateLabelValue(claimId, "updated", d).catch(() => null);
       const refreshed = await trilium.getNote(claimId).catch(() => note);
-      return txt4({
+      return txt3({
         ok: true,
         action: holds ? "verified" : "marked-broken",
         ...row(refreshed),
@@ -30608,7 +30362,7 @@ broken ones, so staleness arrives as a maintenance finding instead of a surprise
         await trilium.updateNoteContent(existing.noteId, setSection(current, "Check", `<p>${escapeHtml(check2)}</p>`, "replace").html);
         if (intervalDays)
           await trilium.updateLabelValue(existing.noteId, "interval", String(intervalDays)).catch(() => null);
-        return txt4({ ok: true, action: "updated", ...row(existing), note: "A claim with this assertion already existed \u2014 its check was updated and its verification history kept." });
+        return txt3({ ok: true, action: "updated", ...row(existing), note: "A claim with this assertion already existed \u2014 its check was updated and its verification history kept." });
       }
       const created = await trilium.createNote(container, title, body);
       const id = created.note.noteId;
@@ -30619,7 +30373,7 @@ broken ones, so staleness arrives as a maintenance finding instead of a surprise
       await trilium.addLabel(id, "iconClass", "bx bx-check-shield").catch(() => null);
       if (noteId)
         await trilium.addRelation(id, "derivedFrom", noteId).catch(() => null);
-      return txt4({
+      return txt3({
         ok: true,
         action: "registered",
         claimId: id,
@@ -30633,7 +30387,7 @@ broken ones, so staleness arrives as a maintenance finding instead of a surprise
     const rows = all.map(row).filter((r) => !status || status === "all" || r.state === status);
     const broken = rows.filter((r) => r.state === "broken").length;
     const stale = rows.filter((r) => r.state === "lapsed").length;
-    return txt4({
+    return txt3({
       total: rows.length,
       ...broken ? { broken } : {},
       ...stale ? { needingReverification: stale } : {},
@@ -30661,7 +30415,7 @@ HTML, so a formatting-only change is a real difference and shows as one.`, {
   }, async ({ noteId, revisionId, context }) => {
     const revisions = await trilium.getNoteRevisions(noteId).catch(() => []);
     if (!revisions.length)
-      return txt4({ noteId, note: "No revisions \u2014 this note has not been written through a content-mutating tool yet, or its revisions have been pruned.", revisions: [] });
+      return txt3({ noteId, note: "No revisions \u2014 this note has not been written through a content-mutating tool yet, or its revisions have been pruned.", revisions: [] });
     const target = revisionId ? revisions.find((r) => r.revisionId === revisionId) : revisions[0];
     if (!target)
       return err("not_found", `Revision ${revisionId} does not belong to note ${noteId}.`, `Available: ${revisions.slice(0, 10).map((r) => r.revisionId).join(", ")}`);
@@ -30676,7 +30430,7 @@ HTML, so a formatting-only change is a real difference and shows as one.`, {
       ...r.revisionId === target.revisionId ? { compared: true } : {}
     }));
     if (before === after) {
-      return txt4({
+      return txt3({
         noteId,
         comparedTo: target.revisionId,
         identical: true,
@@ -30699,7 +30453,7 @@ HTML, so a formatting-only change is a real difference and shows as one.`, {
     const removed = a.slice(head, a.length - tail);
     const added = bLines.slice(head, bLines.length - tail);
     const cap = (arr) => arr.length > 40 ? [...arr.slice(0, 40), `\u2026 ${arr.length - 40} more line(s)`] : arr;
-    return txt4({
+    return txt3({
       noteId,
       comparedTo: target.revisionId,
       revisionDate: target.dateCreated?.slice(0, 16),
@@ -30734,16 +30488,16 @@ inspect(noteId); remove with detach().`, {
       if (!existing)
         return err("not_found", `No attachment titled "${title}" on note ${noteId}.`, "inspect(noteId) lists its attachments; provide content to create this one.");
       const data = await trilium.getAttachmentContent(existing.attachmentId).catch(() => "");
-      return txt4({ id: existing.attachmentId, noteId, title, mime: existing.mime, role: existing.role, size: existing.contentLength, content: data });
+      return txt3({ id: existing.attachmentId, noteId, title, mime: existing.mime, role: existing.role, size: existing.contentLength, content: data });
     }
     if (existing) {
       await trilium.updateAttachmentContent(existing.attachmentId, content, mime ?? existing.mime);
       if (mime && mime !== existing.mime)
         await trilium.updateAttachment(existing.attachmentId, { mime }).catch(() => null);
-      return txt4({ action: "updated", id: existing.attachmentId, noteId, title, mime: mime ?? existing.mime });
+      return txt3({ action: "updated", id: existing.attachmentId, noteId, title, mime: mime ?? existing.mime });
     }
     const created = await trilium.createAttachment(noteId, title, mime ?? "text/plain", content, role ?? "file");
-    return txt4({ action: "created", id: created.attachmentId, noteId, title, mime: created.mime, role: created.role });
+    return txt3({ action: "created", id: created.attachmentId, noteId, title, mime: created.mime, role: created.role });
   });
   server.tool("detach", `Remove an attachment from a note \u2014 by attachmentId directly, or by (noteId + title).
 Permanent: attachments have no archive tier; re-attach() from source to undo. Retry-safe \u2014
@@ -30758,7 +30512,7 @@ an already-removed target returns cleanly instead of erroring.`, {
         return err("missing_param", "detach() needs attachmentId, or noteId + title.", "inspect(noteId) lists attachments with their ids.");
       const found = (await trilium.getNoteAttachments(noteId).catch(() => [])).find((a) => a.title === title);
       if (!found)
-        return txt4({ ok: true, action: "already_removed", noteId, title });
+        return txt3({ ok: true, action: "already_removed", noteId, title });
       id = found.attachmentId;
     }
     try {
@@ -30766,10 +30520,10 @@ an already-removed target returns cleanly instead of erroring.`, {
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       if (msg.includes("404"))
-        return txt4({ ok: true, action: "already_removed", attachmentId: id });
+        return txt3({ ok: true, action: "already_removed", attachmentId: id });
       throw e;
     }
-    return txt4({ ok: true, removed: id, ...noteId ? { noteId, title } : {} });
+    return txt3({ ok: true, removed: id, ...noteId ? { noteId, title } : {} });
   });
   server.tool("addendum", `Search Master, LLM singletons (responsibilities + protocols only, not diary), and Knowledge
 for notes containing pending addendum blocks that need to be folded into the main content.
@@ -30783,7 +30537,7 @@ entries, and logs \u2014 records by nature whose history has value. Everywhere e
 Returns note IDs, titles, kinds, and content snippets so you can identify what to fold in.`, {}, async () => {
     const cfg = b();
     if (!cfg.root)
-      return txt4({ error: "BrainLLM not bootstrapped \u2014 run bootstrap." });
+      return txt3({ error: "BrainLLM not bootstrapped \u2014 run bootstrap." });
     await markStep("addendum");
     const searchIn = (ancestorNoteId) => trilium.searchNotes("Addendum", { ancestorNoteId, limit: 50 }).catch(() => ({ results: [] }));
     const [masterRes, llmRes, knowledgeRes] = await Promise.all([
@@ -30821,7 +30575,7 @@ Returns note IDs, titles, kinds, and content snippets so you can identify what t
       };
     }));
     const found = notes.filter(Boolean);
-    return txt4({
+    return txt3({
       found: found.length,
       notes: found,
       ...found.length === 0 ? { note: "No notes with pending addendums." } : { hint: "Fold each addendum into its note: read the block, then revise(noteId, section='<heading>', body='<merged content>', mode='replace') to absorb it into the right section. These notes must be left clean \u2014 no addendum markers. Addendum-style history belongs only in sessions, diary, and logs. Scoped/autonomous agents: fold only what's in your lane \u2014 leaving personal or out-of-scope addendums for the next interactive session is correct, and calling this tool is what satisfies the pre-close gate." }
@@ -30868,7 +30622,7 @@ coverage names any pass that hit a cap, so a short list is never mistaken for a
       ...ack?.length ? { ack } : {},
       ...repair?.length ? { repair } : {}
     });
-    return txt4(report);
+    return txt3(report);
   });
   server.tool("forget", `Archive a note (default) or hard-delete it (hard=true). Archiving keeps it in place,
 hidden from default recall \u2014 the safe choice and the only one for anything with history.
@@ -30884,7 +30638,7 @@ re-wire with connect() first). To undo an archive, use recover().`, {
     if (hard) {
       const backlinks = await trilium.getBacklinks(noteId).catch(() => []);
       if (backlinks.length > 0) {
-        return txt4({
+        return txt3({
           blocked: true,
           why: "Other notes still link here. Re-wire or remove these relations first (connect with remove=true), or archive instead.",
           backlinks
@@ -30894,7 +30648,7 @@ re-wire with connect() first). To undo an archive, use recover().`, {
       const parents = note.parentNoteIds ?? [];
       if (children.length > 0 || parents.length > 1) {
         const childTitles = await Promise.all(children.slice(0, 25).map((id) => trilium.getNote(id).then((c) => `${c.title} [${id}]`).catch(() => id)));
-        return txt4({
+        return txt3({
           blocked: true,
           why: children.length > 0 ? `Hard delete takes the whole subtree \u2014 ${children.length} child note(s) would be destroyed with it.` : `This note is cloned into ${parents.length} containers; deleting it removes it from all of them, not just the one you have in mind.`,
           children: childTitles,
@@ -30903,7 +30657,7 @@ re-wire with connect() first). To undo an archive, use recover().`, {
         });
       }
       await trilium.deleteNote(noteId);
-      return txt4({ ok: true, deleted: noteId, title: note.title, hardDeleted: true });
+      return txt3({ ok: true, deleted: noteId, title: note.title, hardDeleted: true });
     }
     if (reason) {
       const current = await trilium.getNoteContent(noteId).catch(() => "");
@@ -30912,7 +30666,7 @@ re-wire with connect() first). To undo an archive, use recover().`, {
     await trilium.updateLabelValue(noteId, "closed", today());
     await ensureArchivedFlag(trilium, note);
     const relations = relationSnippet(note);
-    return txt4({ ok: true, archived: noteId, title: note.title, ...relations ? { relations } : {} });
+    return txt3({ ok: true, archived: noteId, title: note.title, ...relations ? { relations } : {} });
   });
   server.tool("recover", `Restore an archived or resolved note: removes #archived, clears #closed, resets status
 to active. Use to undo forget() or reconsider a resolved thread / note. Does not restore
@@ -30942,7 +30696,7 @@ prior snapshot. For notes deleted from Trilium entirely (not just archived), use
       await trilium.updateLabelValue(noteId, "updated", d);
     }
     const relations = relationSnippet(note);
-    return txt4({
+    return txt3({
       ok: true,
       noteId,
       kind: labelOf2(note, "noteType") ?? "note",
@@ -30972,7 +30726,7 @@ its siblings, and a note that satisfies the skeleton can still be the odd one ou
       domain: kind === "sources" || kind === "information" ? "<Domain>" : undefined,
       goal: kind === "thread" ? "<goal statement \u2014 queried from the user>" : undefined
     });
-    return txt4({
+    return txt3({
       kind,
       ...rule ? { structure: rule.structure, rules: rule.rules } : { note: "No bespoke structure for this kind \u2014 server meta line + body." },
       skeleton,
@@ -30999,7 +30753,7 @@ whole-brain view.`, {
   }, async ({ noteId, depth, includeArchived }) => {
     const cfg = b();
     if (!cfg.root)
-      return txt4({ status: "uninitialized", action: "Run bootstrap first." });
+      return txt3({ status: "uninitialized", action: "Run bootstrap first." });
     let notes;
     if (noteId) {
       const hood = await trilium.getNeighborhood(noteId, depth ?? 2);
@@ -31070,7 +30824,7 @@ whole-brain view.`, {
         await trilium.addLabel(graphNoteId, "iconClass", "bx bx-network-chart");
       }
     } catch {}
-    return txt4({
+    return txt3({
       scope: noteId ? { noteId, depth: depth ?? 2 } : "brain",
       nodes: notes.length,
       edges: edgeCount,
@@ -31096,7 +30850,7 @@ exception.`, {
   }, async ({ date: date4, recap }) => {
     const cfg = b();
     if (!cfg.root)
-      return txt4({ status: "uninitialized", action: "Run bootstrap first." });
+      return txt3({ status: "uninitialized", action: "Run bootstrap first." });
     const todayStr = date4 ?? today();
     if (recap) {
       const BLOCK = /<h2(?:\s[^>]*)?>\s*Addendum\s*[\u2014\u2013-]\s*([^<]*)<\/h2>([\s\S]*?)(?=<h2(?:\s[^>]*)?>\s*Addendum\s*[\u2014\u2013-]|$)/gi;
@@ -31129,7 +30883,7 @@ exception.`, {
         harvest(surface === "thread" ? `thread: ${(await trilium.getNote(n.parentNoteIds[0]).catch(() => null))?.title ?? n.title}` : surface, n.noteId, content);
       }
       entries.sort((a, b2) => a.time.localeCompare(b2.time));
-      return txt4({
+      return txt3({
         date: todayStr,
         mode: "recap",
         instances: new Set(entries.map((e) => e.identity ?? "unattributed")).size,
@@ -31185,7 +30939,7 @@ exception.`, {
     if (monthNote) {
       deliverables = { id: monthNote.noteId, title: monthNote.title, content: await trilium.getNoteContent(monthNote.noteId).catch(() => "") };
     }
-    return txt4({
+    return txt3({
       date: todayStr,
       newDay,
       month: monthName,
@@ -31208,7 +30962,7 @@ Structural containers are excluded; only content notes appear.`, {
   }, async ({ includeArchived }) => {
     const cfg = b();
     if (!cfg.root)
-      return txt4({ status: "uninitialized", action: "Run bootstrap first." });
+      return txt3({ status: "uninitialized", action: "Run bootstrap first." });
     const fetchFrom = async (id) => {
       if (!id)
         return [];
@@ -31273,7 +31027,7 @@ Structural containers are excluded; only content notes appear.`, {
       Insights: insights.map(row)
     };
     const total = masterAll.length + llmSingletons.length + llmDiary.length + sessions.length + threads.length + kMaster.length + kDomains.length + insights.length;
-    return txt4({ total, areas });
+    return txt3({ total, areas });
   });
   server.tool("assembly", `What the brain HOLDS \u2014 every note by title, grouped under the surface it lives in, with each
 surface's own purpose alongside it. The awareness read: "what do I already know here", answered
@@ -31299,7 +31053,7 @@ Pass area= to zoom into one surface and get its full detail.`, {
   }, async ({ area, includeArchived }) => {
     const cfg = b();
     if (!cfg.root)
-      return txt4({ status: "uninitialized", action: "Run bootstrap first." });
+      return txt3({ status: "uninitialized", action: "Run bootstrap first." });
     const fetchFrom = async (id) => {
       if (!id)
         return [];
@@ -31390,7 +31144,7 @@ Pass area= to zoom into one surface and get its full detail.`, {
         claims: claims.length ? { count: claims.length, assertions: titles(claims), note: "Each claim's title IS its assertion. claim(claimId) reads one with its verification history." } : { count: 0, note: "No claims registered \u2014 nothing is currently being checked against the world." }
       };
     }
-    return txt4({
+    return txt3({
       brain: await purposeOf(cfg.root),
       ...area ? { scope: area } : {},
       ...out,
@@ -31424,7 +31178,7 @@ immediately, no restart needed.`, {}, async () => {
           const note = await trilium.getNote(id).catch(() => null);
           refreshed.push(note?.title ?? id);
         }
-        return txt4({
+        return txt3({
           status: "already_initialized",
           message: `BrainLLM structure exists. Config refreshed at: ${saved}`,
           ...refreshed.length ? { purposesRefreshed: refreshed, note: "These containers described themselves with text that no longer matched the canonical purpose, and have been re-engraved. Container notes are unreachable through revise(), so bootstrap is the only path that can correct them." } : {},
@@ -31440,7 +31194,7 @@ immediately, no restart needed.`, {}, async () => {
     const newConfig = await createBrainLLMStructure(trilium);
     const savedPath = saveConfig(newConfig);
     brainRef.config = newConfig;
-    return txt4({
+    return txt3({
       status: "initialized",
       message: `BrainLLM bootstrapped. Config written to: ${savedPath}. Ready to use \u2014 no restart needed.`,
       config: newConfig
@@ -31451,9 +31205,252 @@ immediately, no restart needed.`, {}, async () => {
   registerMemoryTools(server, trilium, brainRef);
   registerKnowledgeTools(server, trilium, brainRef);
   registerInsightsTools(server, trilium, brainRef);
-  if (mode === "full") {
-    registerAdvancedTools(server, trilium, brainRef);
-  }
+}
+
+// src/tools-advanced.ts
+var txt4 = (obj) => ({
+  content: [{ type: "text", text: typeof obj === "string" ? obj : JSON.stringify(obj, null, 2) }]
+});
+var noteStub = (n) => ({
+  id: n.noteId,
+  title: n.title,
+  ...n.type ? { type: n.type } : {}
+});
+var attrStub = (a) => ({
+  id: a.attributeId,
+  noteId: a.noteId,
+  type: a.type,
+  name: a.name,
+  value: a.value
+});
+function registerAdvancedTools(server, trilium, brainRef) {
+  const b = () => brainRef.config;
+  server.tool("search_notes", `Raw Trilium query search. Native query language: #label=value, note.title =* "x",
+note.dateModified >= 'YYYY-MM-DD', AND/OR. Unscoped unless ancestorNoteId is given.`, {
+    query: exports_external.string().describe("Trilium search query"),
+    ancestorNoteId: exports_external.string().optional().describe("Limit to this subtree"),
+    limit: exports_external.number().optional(),
+    orderBy: exports_external.string().optional().describe("title | dateModified | dateCreated"),
+    orderDirection: exports_external.enum(["asc", "desc"]).optional(),
+    fastSearch: exports_external.boolean().optional().describe("Skip content body scan"),
+    includeArchived: exports_external.boolean().optional(),
+    debug: exports_external.boolean().optional().describe("Return query parse debug info")
+  }, async ({ query, ancestorNoteId, limit, orderBy, orderDirection, fastSearch, includeArchived, debug }) => {
+    const result = await trilium.searchNotes(query, {
+      ancestorNoteId,
+      limit,
+      orderBy,
+      orderDirection,
+      fastSearch,
+      includeArchivedNotes: includeArchived,
+      debug
+    });
+    const out = { results: result.results.map(noteStub) };
+    if (result.debugInfo !== undefined)
+      out.debugInfo = result.debugInfo;
+    return txt4(out);
+  });
+  server.tool("get_note", "Full note metadata: title, type, mime, attributes (labels + relations), parent/child ids, dates.", { noteId: exports_external.string() }, async ({ noteId }) => {
+    const n = await trilium.getNote(noteId);
+    return txt4({
+      id: n.noteId,
+      title: n.title,
+      type: n.type,
+      mime: n.mime,
+      attributes: n.attributes.map((a) => ({ id: a.attributeId, type: a.type, name: a.name, value: a.value })),
+      parents: n.parentNoteIds,
+      children: n.childNoteIds,
+      created: n.dateCreated,
+      modified: n.dateModified
+    });
+  });
+  server.tool("get_note_content", "Raw note content (HTML / text / code).", { noteId: exports_external.string() }, async ({ noteId }) => txt4(await trilium.getNoteContent(noteId)));
+  server.tool("create_note", "Create a note at an explicit parent. Types: text/code/book/canvas/mermaid/relationMap/render/search/file/image.", {
+    parentNoteId: exports_external.string(),
+    title: exports_external.string(),
+    content: exports_external.string(),
+    type: exports_external.enum(["text", "code", "book", "canvas", "mermaid", "relationMap", "render", "search", "file", "image"]).optional(),
+    mime: exports_external.string().optional()
+  }, async ({ parentNoteId, title, content, type, mime }) => {
+    const r = await trilium.createNote(parentNoteId, title, content, type ?? "text", mime);
+    return txt4({ noteId: r.note.noteId, branchId: r.branch.branchId, title: r.note.title });
+  });
+  server.tool("update_note_content", "Replace a note's full content.", { noteId: exports_external.string(), content: exports_external.string() }, async ({ noteId, content }) => {
+    await trilium.updateNoteContent(noteId, content);
+    return txt4({ ok: true, noteId });
+  });
+  server.tool("patch_note", "Mutate note metadata: title, type, or mime.", { noteId: exports_external.string(), title: exports_external.string().optional(), type: exports_external.string().optional(), mime: exports_external.string().optional() }, async ({ noteId, title, type, mime }) => {
+    const fields = {};
+    if (title != null)
+      fields.title = title;
+    if (type != null)
+      fields.type = type;
+    if (mime != null)
+      fields.mime = mime;
+    const note = await trilium.patchNote(noteId, fields);
+    return txt4({ noteId: note.noteId, title: note.title, type: note.type });
+  });
+  server.tool("delete_note", "Hard-delete a note (and its subtree if this is its last branch). Irreversible.", { noteId: exports_external.string() }, async ({ noteId }) => {
+    await trilium.deleteNote(noteId);
+    return txt4({ ok: true, deleted: noteId });
+  });
+  server.tool("undelete_note", "Recover a recently Trilium-deleted note from Trilium's trash. canBeUndeleted must be true (check note_history). Distinct from recover() which restores BrainLLM-archived notes. Re-applies the BrainLLM label set for the container it lands in \u2014 the restore itself does not bring attributes back, and a note without #noteType is invisible to every read path.", { noteId: exports_external.string() }, async ({ noteId }) => {
+    await trilium.undeleteNote(noteId);
+    const cfg = b();
+    const note = await trilium.getNote(noteId).catch(() => null);
+    const restored = [];
+    let inferredKind;
+    if (note) {
+      const already = ownedLabel(note, "noteType");
+      if (already) {
+        inferredKind = already;
+      } else {
+        const parents = note.parentNoteIds ?? [];
+        const byContainer = [
+          [cfg.memory.sessions, "session"],
+          [cfg.memory.threads, "thread"],
+          [cfg.llm.diary, "diary"],
+          [cfg.insights.logs, "log"],
+          [cfg.knowledge.master, "user"],
+          [cfg.knowledge.domains, "domain"]
+        ];
+        for (const [containerId, kind] of byContainer) {
+          if (containerId && parents.includes(containerId)) {
+            inferredKind = kind;
+            break;
+          }
+        }
+        if (!inferredKind && parents.length) {
+          const parent = await trilium.getNote(parents[0]).catch(() => null);
+          if (parent && ownedLabel(parent, "noteType") === "thread")
+            inferredKind = "threadEntry";
+          else if (parent && ownedLabel(parent, "noteType") === "domain")
+            inferredKind = "information";
+        }
+        if (inferredKind) {
+          for (const l of labelPlan(inferredKind, {}, localToday())) {
+            if (!ownedLabel(note, l.name)) {
+              await trilium.addLabel(noteId, l.name, l.value, l.inheritable ?? false).catch(() => null);
+              restored.push(l.value ? `${l.name}=${l.value}` : l.name);
+            }
+          }
+        }
+      }
+    }
+    return txt4({
+      ok: true,
+      undeleted: noteId,
+      ...inferredKind ? { kind: inferredKind } : {},
+      ...restored.length ? { labelsRestored: restored } : {},
+      ...note && !inferredKind ? {
+        warning: "Could not infer this note's kind from its placement, so no #noteType was applied \u2014 it is currently INVISIBLE to brain(), recall() and every surface read. " + "Move it under its proper container and re-run, or set the label with add_label."
+      } : {}
+    });
+  });
+  server.tool("note_history", "Recent changes feed (creations / modifications / deletions), newest first.", { ancestorNoteId: exports_external.string().optional() }, async ({ ancestorNoteId }) => {
+    const changes = await trilium.getNoteHistory(ancestorNoteId);
+    return txt4(changes.map((c) => ({ id: c.noteId, title: c.current_title, deleted: c.current_isDeleted, date: c.date })));
+  });
+  server.tool("get_attribute", "Fetch a single attribute by id.", { attributeId: exports_external.string() }, async ({ attributeId }) => txt4(attrStub(await trilium.getAttribute(attributeId))));
+  server.tool("add_label", "Add a #label to a note (empty value = boolean flag). Adds a new attribute; does not dedupe.", { noteId: exports_external.string(), name: exports_external.string().describe("Label name (no # prefix)"), value: exports_external.string().optional(), isInheritable: exports_external.boolean().optional() }, async ({ noteId, name, value, isInheritable }) => {
+    const attr = await trilium.addLabel(noteId, name, value ?? "", isInheritable ?? false);
+    return txt4(attrStub(attr));
+  });
+  server.tool("add_relation", "Add a ~relation with any name (the core connect() enforces the canonical vocabulary).", { fromNoteId: exports_external.string(), relationName: exports_external.string(), toNoteId: exports_external.string(), isInheritable: exports_external.boolean().optional() }, async ({ fromNoteId, relationName, toNoteId, isInheritable }) => {
+    const attr = await trilium.addRelation(fromNoteId, relationName, toNoteId, isInheritable ?? false);
+    return txt4(attrStub(attr));
+  });
+  server.tool("update_attribute", "Update an attribute's value (labels) and/or position by id.", { attributeId: exports_external.string(), value: exports_external.string().optional(), position: exports_external.number().optional() }, async ({ attributeId, value, position }) => {
+    const fields = {};
+    if (value != null)
+      fields.value = value;
+    if (position != null)
+      fields.position = position;
+    return txt4(attrStub(await trilium.updateAttribute(attributeId, fields)));
+  });
+  server.tool("delete_attribute", "Delete any label or relation by attributeId.", { attributeId: exports_external.string() }, async ({ attributeId }) => {
+    await trilium.deleteAttribute(attributeId);
+    return txt4({ ok: true, deleted: attributeId });
+  });
+  server.tool("get_branch", "Fetch a branch (a note's placement under one parent).", { branchId: exports_external.string() }, async ({ branchId }) => txt4(await trilium.getBranch(branchId)));
+  server.tool("clone_note", "Place a note under an additional parent (multi-parent branch; shared content, no copy).", { noteId: exports_external.string(), parentNoteId: exports_external.string(), prefix: exports_external.string().optional() }, async ({ noteId, parentNoteId, prefix }) => {
+    const branch = await trilium.cloneNote(noteId, parentNoteId, prefix);
+    return txt4({ id: branch.branchId, noteId: branch.noteId, parentNoteId: branch.parentNoteId });
+  });
+  server.tool("move_note", "Move a note to a new parent (clone to the new parent, then remove the old branch).", { noteId: exports_external.string(), fromParentNoteId: exports_external.string(), toParentNoteId: exports_external.string() }, async ({ noteId, fromParentNoteId, toParentNoteId }) => {
+    const newBranch = await trilium.cloneNote(noteId, toParentNoteId);
+    const fresh = await trilium.getNote(noteId);
+    for (const bid of fresh.parentBranchIds) {
+      if (bid === newBranch.branchId)
+        continue;
+      const branch = await trilium.getBranch(bid);
+      if (branch.parentNoteId === fromParentNoteId) {
+        await trilium.deleteBranch(bid);
+        break;
+      }
+    }
+    return txt4({ ok: true, noteId, movedTo: toParentNoteId, newBranchId: newBranch.branchId });
+  });
+  server.tool("delete_branch", "Remove one placement of a note (deletes the note if it was the last branch).", { branchId: exports_external.string() }, async ({ branchId }) => {
+    await trilium.deleteBranch(branchId);
+    return txt4({ ok: true, deleted: branchId });
+  });
+  server.tool("create_revision", "Snapshot a note's current content as a revision.", { noteId: exports_external.string() }, async ({ noteId }) => {
+    await trilium.createRevision(noteId);
+    return txt4({ ok: true, noteId });
+  });
+  server.tool("get_revisions", "List a note's revisions, newest first.", { noteId: exports_external.string() }, async ({ noteId }) => {
+    const revs = await trilium.getNoteRevisions(noteId);
+    return txt4(revs.map((r) => ({ id: r.revisionId, title: r.title, date: r.utcDateCreated, size: r.contentLength })));
+  });
+  server.tool("get_revision_content", "Content of a historical revision snapshot.", { revisionId: exports_external.string() }, async ({ revisionId }) => txt4(await trilium.getRevisionContent(revisionId)));
+  server.tool("get_attachments", "List attachments on a note (id + title + mime + size).", { noteId: exports_external.string() }, async ({ noteId }) => {
+    const attachments = await trilium.getNoteAttachments(noteId);
+    return txt4(attachments.map((a) => ({ id: a.attachmentId, title: a.title, mime: a.mime, size: a.contentLength })));
+  });
+  server.tool("get_attachment_content", "Read the content of a text/code attachment.", { attachmentId: exports_external.string() }, async ({ attachmentId }) => txt4(await trilium.getAttachmentContent(attachmentId)));
+  server.tool("create_attachment", "Attach a file or text blob to a note (role: file | image).", { ownerId: exports_external.string(), title: exports_external.string(), mime: exports_external.string(), content: exports_external.string().describe("Text content (base64 for binary)"), role: exports_external.enum(["file", "image"]).optional() }, async ({ ownerId, title, mime, content, role }) => {
+    const att = await trilium.createAttachment(ownerId, title, mime, content, role ?? "file");
+    return txt4({ id: att.attachmentId, title: att.title, mime: att.mime, size: att.contentLength });
+  });
+  server.tool("update_attachment", "Update an attachment's content and/or metadata (title, mime). Pass content to replace the binary/text data in place; pass title/mime to update metadata only.", {
+    attachmentId: exports_external.string(),
+    title: exports_external.string().optional(),
+    mime: exports_external.string().optional().describe("MIME type \u2014 also used as Content-Type when writing content"),
+    content: exports_external.string().optional().describe("New content (replaces existing; text or base64 for binary)")
+  }, async ({ attachmentId, title, mime, content }) => {
+    if (content != null) {
+      await trilium.updateAttachmentContent(attachmentId, content, mime ?? "text/plain");
+    }
+    if (title != null || mime != null) {
+      const fields = {};
+      if (title != null)
+        fields.title = title;
+      if (mime != null)
+        fields.mime = mime;
+      const att = await trilium.updateAttachment(attachmentId, fields);
+      return txt4({ id: att.attachmentId, title: att.title, mime: att.mime, contentUpdated: content != null });
+    }
+    return txt4({ ok: true, attachmentId, contentUpdated: content != null });
+  });
+  server.tool("delete_attachment", "Permanently delete an attachment. Irreversible.", { attachmentId: exports_external.string() }, async ({ attachmentId }) => {
+    await trilium.deleteAttachment(attachmentId);
+    return txt4({ ok: true, deleted: attachmentId });
+  });
+  server.tool("get_day_note", "Get (or auto-create) the journal day note. Format: YYYY-MM-DD (default: today).", { date: exports_external.string().optional() }, async ({ date: date4 }) => txt4(await trilium.getDayNote(date4 ?? localToday())));
+  server.tool("get_week_note", "Get (or auto-create) the journal week note. Format: YYYY-Www.", { week: exports_external.string() }, async ({ week }) => txt4(await trilium.getWeekNote(week)));
+  server.tool("get_month_note", "Get (or auto-create) the journal month note. Format: YYYY-MM.", { month: exports_external.string() }, async ({ month }) => txt4(await trilium.getMonthNote(month)));
+  server.tool("get_year_note", "Get (or auto-create) the journal year note. Format: YYYY.", { year: exports_external.string() }, async ({ year }) => txt4(await trilium.getYearNote(year)));
+  server.tool("get_inbox_note", "Get the Trilium inbox note for a date (fixed #inbox note, or the day note). Format: YYYY-MM-DD.", { date: exports_external.string().optional() }, async ({ date: date4 }) => txt4(await trilium.getInboxNote(date4 ?? localToday())));
+  server.tool("get_app_info", "Trilium server version, DB version, runtime metadata.", {}, async () => txt4(await trilium.getAppInfo()));
+  server.tool("create_backup", "Trigger a named Trilium database backup. The backup file is written to Trilium's backup directory as <name>.db (default name: brainllm-{date}). Use a descriptive name for milestone snapshots (e.g. 'before-migration').", {
+    name: exports_external.string().optional().describe("Backup file name without .db extension (default: brainllm-{today})"),
+    date: exports_external.string().optional().describe("ISO date used in the default name when name is omitted (default: today)")
+  }, async ({ name, date: date4 }) => {
+    const backupName = name ?? `brainllm-${date4 ?? localToday()}`;
+    await trilium.createBackup(backupName);
+    return txt4({ ok: true, backup: `${backupName}.db` });
+  });
 }
 
 // src/annotations.ts
@@ -31472,6 +31469,8 @@ var TOOL_ANNOTATIONS = {
   template: READ,
   explore: READ,
   consistency: READ,
+  assembly: READ,
+  diff: READ,
   master: READ,
   master_recall: READ,
   llm: READ,
@@ -31487,6 +31486,7 @@ var TOOL_ANNOTATIONS = {
   graph: WRITE,
   maintain: WRITE,
   addendum: READ,
+  claim: APPEND,
   remember: WRITE,
   diary: APPEND,
   revise: WRITE,
@@ -32075,10 +32075,12 @@ function createServer(origin = null) {
   const s = new McpServer({
     name: "BrainLLM",
     title: "BrainLLM",
-    version: "10.5.0",
+    version: "10.5.2",
     icons: brandingIcons(origin)
   });
-  registerTools(s, trilium, brainRef, mode);
+  registerTools(s, trilium, brainRef);
+  if (mode === "full")
+    registerAdvancedTools(s, trilium, brainRef);
   const { unclassified } = applyToolAnnotations(s);
   if (unclassified.length) {
     console.error(`[brainllm] Unclassified tools, treated as writes: ${unclassified.join(", ")}`);