@andespindola/brainlink 1.0.2 → 1.0.4

package/README.md

@@ -534,9 +534,14 @@ Available tools:
 - `brainlink_context`: read indexed context for a task or question; pass `strategy: "rag"` for fresh retrieval assembly, `strategy: "cag"` for persisted context packs or `strategy: "auto"` for CAG hits with RAG fallback.
 - `brainlink_context_packs`: list or clear persisted CAG context packs.
 - `brainlink_search`: search indexed notes.
+- `brainlink_explain`: explain why indexed notes matched a query.
 - `brainlink_dedupe`: detect duplicate candidates using exact hash + semantic similarity scores.
 - `brainlink_resolve_duplicate`: resolve duplicate pairs (`merge`, `link`, `ignore`) with connectivity-safe fallback edges.
 - `brainlink_add_note`: write durable Markdown memory and reindex.
+- `brainlink_remember`: capture durable memory with inferred title, tags and Context Links; supports dry-run.
+- `brainlink_inbox_add`: capture a quick untriaged memory item.
+- `brainlink_inbox_list`: list untriaged inbox memory items.
+- `brainlink_inbox_process`: suggest titles, tags and links for inbox items.
 - `brainlink_delete_note`: delete a durable Markdown note by title or path after explicit confirmation and reindex.
 - `brainlink_add_file`: ingest a local file as a note and reindex.
 - `brainlink_canonicalize_context_links`: ensure existing notes link to inferred context hubs.
@@ -544,14 +549,20 @@ Available tools:
 - `brainlink_volatile_clear`: clear temporary memory for the current vault/agent namespace.
 - `brainlink_index`: rebuild the vault index. Pass `full=true` for a complete source reindex.
 - `brainlink_stats`: read indexed vault statistics.
+- `brainlink_doctor_actions`: return vault checks plus prioritized executable next actions.
 - `brainlink_validate`: validate broken links and orphan notes.
 - `brainlink_sync`: run index, stats, validation, broken-link and orphan checks in one call.
 - `brainlink_graph`: read indexed graph nodes and weighted links.
 - `brainlink_graph_contexts`: list the visual graph contexts used by the local server.
 - `brainlink_broken_links`: list unresolved wiki links.
+- `brainlink_suggest_links`: suggest Context Links for content or fixes for unresolved wiki links.
+- `brainlink_repair_links`: repair unresolved wiki links by retargeting safe matches or creating placeholder target notes.
 - `brainlink_orphans`: list disconnected notes.
+- `brainlink_session_close`: write or preview a session handoff note.
+- `brainlink_project_init`: seed project memory from local project docs.
 
 For the most automatic workflow, start MCP sessions with `brainlink_bootstrap` (optionally with `query`) and then continue with `brainlink_context`/`brainlink_add_note`.
+MCP is kept in parity with practical Brainlink CLI workflows when a feature is safe and meaningful for tool clients.
 By default, Brainlink enforces context-first for MCP reads (`enforceContextFirst=true`): non-context read tools return preflight until `brainlink_context` is called for the vault/agent session.
 By default, MCP startup already runs bootstrap on the configured default vault/agent (`autoBootstrapOnStartup=true`), so sessions begin warm.
 By default, Brainlink enforces bootstrap and auto-runs it for read tools when session state is missing or stale (`autoBootstrapOnRead=true`).
@@ -633,7 +644,7 @@ blink server --vault ./vault --no-index
 
 ## HTTP API
 
-The HTTP API is read-only and exists only to power the graph UI and local inspection workflows.
+The HTTP API is mostly read-oriented and exists to power the graph UI, local inspection workflows and the local document-import modal.
 
 The server always refuses non-loopback hosts. Brainlink HTTP only runs on localhost.
 
@@ -654,6 +665,7 @@ Routes:
 - `GET /api/broken-links`
 - `GET /api/orphans`
 - `GET /api/validate`
+- `POST /api/import-file` with multipart field `file`
 
 Read routes accept `agent=<agent-id>`:
 
@@ -700,6 +712,27 @@ blink quickstart --vault ./team-vault --mcp-only --json
 Runs index + doctor + stats + validation, refreshes bootstrap session readiness, optionally returns context for a query, and (by default) upgrades local agent integration for plug-and-play MCP usage.
 When `--mode`, `--limit` or `--tokens` are omitted, quickstart uses agent profile defaults when available.
 
+### Practical Memory Workflows
+
+```bash
+blink remember --content "Keep Markdown as the source of truth. #architecture"
+blink remember --content-file ./handoff.md --dry-run
+blink inbox add --content "Quick note to triage later"
+blink inbox list
+blink inbox process --json
+blink session-close --content "Validated release flow"
+blink daily --dry-run
+blink suggest-links --content "Architecture and release flow"
+blink suggest-links --broken
+blink repair-links
+blink search "architecture" --explain
+blink explain "architecture"
+blink doctor --actionable
+blink project init --path .
+```
+
+`remember` infers a title, tags and Context Links before writing a durable note. `inbox` captures quick untriaged memory and later suggests titles, tags and links. `session-close`/`daily` writes a handoff note with vault health and git status. `suggest-links` proposes Context Links or likely fixes for unresolved wiki links. `repair-links` retargets high-confidence broken links and creates `#triage` placeholder notes for unresolved targets that cannot be safely retargeted. `doctor --actionable` returns prioritized commands instead of only checks. `project init` seeds memory from project docs such as `AGENTS.md`, `README.md` and architecture docs.
+
 ### `config`
 
 ```bash
@@ -768,6 +801,18 @@ Imports durable memory from a legacy SQLite database into Markdown notes (`agent
 When `--db` is omitted, Brainlink auto-detects common legacy paths such as `<vault>/.brainlink/brainlink.db`.
 Use `--agent <id>` to force all imported rows into one namespace, `--limit` for incremental imports, `--dry-run` to preview without writing files, and `--no-index` to defer reindexing.
 
+### `import-file`
+
+```bash
+blink import-file ./report.pdf --vault ./team-vault
+blink import-file ./report.pdf --vault ./team-vault --agent coding-agent
+blink import-file ./report.pdf --vault ./team-vault --title "Quarterly Report"
+blink import-file ./report.pdf --vault ./team-vault --no-auto-index
+```
+
+Converts a document with Docling and imports the converted Markdown as a durable note. The `docling` executable must be installed and available in `PATH`.
+The graph UI exposes the same flow through the upload button in the toolbar.
+
 ### `init`
 
 ```bash
@@ -1000,7 +1045,7 @@ blink server --vault ./vault --no-open
 blink server --vault ./vault --no-watch
 ```
 
-Starts the local read-only graph UI and HTTP API.
+Starts the local graph UI and HTTP API.
 Watch mode is enabled by default for Markdown changes in local filesystem vaults. Use `--no-watch` to run without the watcher.
 By default, it tries to open a native desktop GUI window for the graph URL.
 On Linux, native GUI is disabled by default; enable it with `BRAINLINK_LINUX_NATIVE_GUI=1`.

package/dist/application/frontend/client-css.js

@@ -379,6 +379,133 @@ li small {
   display: none;
 }
 
+.upload-dialog {
+  position: absolute;
+  z-index: 7;
+  top: 88px;
+  right: 14px;
+  width: min(420px, calc(100vw - 28px));
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: var(--panel);
+  color: var(--text);
+  box-shadow: 0 24px 80px rgba(1, 6, 13, 0.48);
+  overflow: hidden;
+}
+
+.upload-dialog[hidden] {
+  display: none;
+}
+
+.upload-dialog form {
+  display: grid;
+  gap: 14px;
+}
+
+.upload-dialog header,
+.upload-dialog footer {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 14px;
+  padding: 16px;
+}
+
+.upload-dialog header {
+  border-bottom: 1px solid var(--line);
+}
+
+.upload-dialog h2,
+.upload-dialog p {
+  margin: 0;
+}
+
+.upload-dialog h2 {
+  margin-top: 4px;
+  font-size: 18px;
+  line-height: 1.2;
+}
+
+#uploadClose,
+#uploadSubmit {
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: var(--panel-strong);
+  color: var(--text);
+  cursor: pointer;
+}
+
+#uploadClose {
+  flex: 0 0 auto;
+  width: 38px;
+  height: 38px;
+  padding: 0;
+  font-size: 22px;
+  line-height: 1;
+}
+
+#uploadSubmit {
+  min-width: 98px;
+  height: 38px;
+  padding: 0 14px;
+}
+
+#uploadSubmit:disabled {
+  cursor: progress;
+  opacity: 0.62;
+}
+
+#uploadClose:hover,
+#uploadClose:focus,
+#uploadSubmit:hover,
+#uploadSubmit:focus {
+  border-color: var(--accent);
+  color: var(--accent);
+}
+
+.upload-field {
+  display: grid;
+  gap: 7px;
+  padding: 0 16px;
+}
+
+.upload-field span,
+.upload-check span {
+  color: var(--muted);
+  font-size: 12px;
+}
+
+.upload-field input[type="text"],
+.upload-field input[type="file"] {
+  width: 100%;
+  min-height: 40px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: rgba(12, 24, 36, 0.94);
+  color: var(--text);
+  padding: 8px 10px;
+}
+
+.upload-check {
+  display: flex;
+  align-items: center;
+  gap: 9px;
+  padding: 0 16px;
+}
+
+.upload-check input {
+  width: 16px;
+  height: 16px;
+}
+
+#uploadStatus {
+  min-height: 16px;
+  color: var(--muted);
+  font-size: 12px;
+  line-height: 1.35;
+  overflow-wrap: anywhere;
+}
+
 .content-dialog article {
   display: grid;
   grid-template-rows: auto auto minmax(0, 1fr);
@@ -501,6 +628,40 @@ li small {
   grid-column: span 2;
 }
 
+.content-actions {
+  grid-column: span 2;
+}
+
+.node-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.node-actions button {
+  width: auto;
+  min-height: 34px;
+  padding: 0 10px;
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: var(--panel-strong);
+  color: var(--text);
+  cursor: pointer;
+}
+
+.node-actions button:hover,
+.node-actions button:focus {
+  border-color: var(--accent);
+  color: var(--accent);
+}
+
+#contentActionStatus {
+  min-height: 16px;
+  margin: 0;
+  color: var(--muted);
+  font-size: 12px;
+}
+
 .content-dialog .note-content {
   max-height: none;
   min-height: 0;
@@ -559,6 +720,13 @@ li small {
     max-height: none;
   }
 
+  .upload-dialog {
+    top: 8px;
+    right: 8px;
+    left: 8px;
+    width: auto;
+  }
+
   .content-dialog header {
     align-items: flex-start;
     gap: 12px;

package/dist/application/frontend/client-html.js

@@ -35,6 +35,7 @@ export const createClientHtml = () => `<!doctype html>
               <select id="context"></select>
             </label>
             <div class="toolbar" aria-label="Graph controls">
+              <button id="uploadOpen" type="button" title="Import document">⇧</button>
               <button id="zoomIn" type="button" title="Zoom in">+</button>
               <button id="zoomOut" type="button" title="Zoom out">-</button>
               <button id="fit" type="button" title="Focus central hub">◎</button>
@@ -48,6 +49,33 @@ export const createClientHtml = () => `<!doctype html>
           <div id="graphLabels" class="graph-labels" aria-hidden="true"></div>
           <div id="graphTooltip" class="graph-tooltip" role="tooltip" hidden></div>
           <canvas id="miniMap" class="mini-map" aria-label="Graph overview"></canvas>
+          <aside id="uploadDialog" class="upload-dialog" role="dialog" aria-labelledby="uploadTitle" hidden>
+            <form id="uploadForm">
+              <header>
+                <div>
+                  <span class="eyebrow">Context import</span>
+                  <h2 id="uploadTitle">Upload document</h2>
+                </div>
+                <button id="uploadClose" type="button" aria-label="Close upload dialog" title="Close upload dialog">&times;</button>
+              </header>
+              <label class="upload-field">
+                <span>File</span>
+                <input id="uploadFile" name="file" type="file" required />
+              </label>
+              <label class="upload-field">
+                <span>Title</span>
+                <input id="uploadTitleInput" name="title" type="text" placeholder="Use filename" autocomplete="off" />
+              </label>
+              <label class="upload-check">
+                <input id="uploadAllowSensitive" name="allowSensitive" type="checkbox" />
+                <span>Allow sensitive-looking content</span>
+              </label>
+              <footer>
+                <p id="uploadStatus" role="status"></p>
+                <button id="uploadSubmit" type="submit">Import</button>
+              </footer>
+            </form>
+          </aside>
           <aside id="contentDialog" class="content-dialog" role="dialog" aria-labelledby="contentTitle" hidden>
             <article>
               <header>
@@ -79,6 +107,15 @@ export const createClientHtml = () => `<!doctype html>
                   <h3>Backlinks</h3>
                   <ul id="contentIncoming"></ul>
                 </section>
+                <section class="content-meta-section content-actions">
+                  <h3>Actions</h3>
+                  <div class="node-actions">
+                    <button id="copyWikiLink" type="button">Copy wiki link</button>
+                    <button id="suggestNodeLinks" type="button">Suggest links</button>
+                  </div>
+                  <p id="contentActionStatus"></p>
+                  <ul id="contentLinkSuggestions"></ul>
+                </section>
               </div>
               <pre id="contentBody" class="note-content"></pre>
             </article>

package/dist/application/frontend/client-js.js

@@ -12,6 +12,15 @@ const elements = {
   fit: byId('fit'),
   releaseNode: byId('releaseNode'),
   reset: byId('reset'),
+  uploadOpen: byId('uploadOpen'),
+  uploadDialog: byId('uploadDialog'),
+  uploadForm: byId('uploadForm'),
+  uploadFile: byId('uploadFile'),
+  uploadTitleInput: byId('uploadTitleInput'),
+  uploadAllowSensitive: byId('uploadAllowSensitive'),
+  uploadClose: byId('uploadClose'),
+  uploadSubmit: byId('uploadSubmit'),
+  uploadStatus: byId('uploadStatus'),
   labels: byId('graphLabels'),
   tooltip: byId('graphTooltip'),
   miniMap: byId('miniMap'),
@@ -24,7 +33,11 @@ const elements = {
   contentOutgoing: byId('contentOutgoing'),
   contentIncoming: byId('contentIncoming'),
   contentBody: byId('contentBody'),
-  contentClose: byId('contentClose')
+  contentClose: byId('contentClose'),
+  copyWikiLink: byId('copyWikiLink'),
+  suggestNodeLinks: byId('suggestNodeLinks'),
+  contentActionStatus: byId('contentActionStatus'),
+  contentLinkSuggestions: byId('contentLinkSuggestions')
 }
 
 const state = {
@@ -917,6 +930,59 @@ const closeContentDialog = () => {
   elements.contentDialog.hidden = true
 }
 
+const selectedNode = () => {
+  if (!state.selectedNodeId) {
+    return null
+  }
+
+  const packed = nodeByIdFromChunk().get(state.selectedNodeId)
+  if (!packed) {
+    return null
+  }
+
+  return {
+    id: packed[0],
+    title: packed[1],
+    path: packed[4] || ''
+  }
+}
+
+const copySelectedWikiLink = async () => {
+  const node = selectedNode()
+  if (!node) {
+    elements.contentActionStatus.textContent = 'Select a note first.'
+    return
+  }
+
+  const value = '[[' + node.title + ']]'
+  try {
+    await navigator.clipboard.writeText(value)
+    elements.contentActionStatus.textContent = 'Copied ' + value
+  } catch {
+    elements.contentActionStatus.textContent = value
+  }
+}
+
+const loadSelectedLinkSuggestions = async () => {
+  const content = elements.contentBody.textContent || ''
+  if (!content.trim()) {
+    elements.contentActionStatus.textContent = 'Selected note has no content.'
+    return
+  }
+
+  elements.contentActionStatus.textContent = 'Loading suggestions...'
+  const response = await fetch('/api/suggest-links?limit=5&content=' + encodeURIComponent(content.slice(0, 2000)) + scopeQuery('&'))
+  if (!response.ok) {
+    throw new Error('Failed to load link suggestions')
+  }
+  const payload = await response.json()
+  const suggestions = Array.isArray(payload.suggestions) ? payload.suggestions : []
+  elements.contentLinkSuggestions.innerHTML = suggestions.length > 0
+    ? suggestions.map((item) => '<li><button type="button" data-title="' + escapeHtml(item.title) + '">[[' + escapeHtml(item.title) + ']]</button></li>').join('')
+    : '<li>No strong suggestions</li>'
+  elements.contentActionStatus.textContent = suggestions.length > 0 ? 'Suggested Context Links' : 'No strong suggestions found.'
+}
+
 const loadNodeDetails = async (nodeId) => {
   if (!nodeId) {
     return
@@ -956,6 +1022,8 @@ const loadNodeDetails = async (nodeId) => {
   elements.contentOutgoing.innerHTML = list(related.outgoing)
   elements.contentIncoming.innerHTML = list(related.incoming)
   elements.contentBody.textContent = typeof node.content === 'string' ? node.content : ''
+  elements.contentActionStatus.textContent = ''
+  elements.contentLinkSuggestions.innerHTML = ''
 
   openContentDialog()
 }
@@ -1368,6 +1436,10 @@ const setupInput = () => {
   })
 
   window.addEventListener('keydown', (event) => {
+    if (event.key === 'Escape' && !elements.uploadDialog.hidden) {
+      closeUploadDialog()
+      return
+    }
     if (event.key === 'Escape' && !elements.contentDialog.hidden) {
       closeContentDialog()
       return
@@ -1386,6 +1458,95 @@ const setupInput = () => {
   })
 }
 
+const openUploadDialog = () => {
+  elements.uploadDialog.hidden = false
+  elements.uploadStatus.textContent = ''
+  elements.uploadTitleInput.value = ''
+  elements.uploadFile.value = ''
+  elements.uploadAllowSensitive.checked = false
+  window.setTimeout(() => elements.uploadFile.focus(), 0)
+}
+
+const closeUploadDialog = () => {
+  elements.uploadDialog.hidden = true
+}
+
+const setUploadBusy = (busy) => {
+  elements.uploadSubmit.disabled = busy
+  elements.uploadFile.disabled = busy
+  elements.uploadTitleInput.disabled = busy
+  elements.uploadAllowSensitive.disabled = busy
+}
+
+const uploadImportUrl = () => {
+  const params = new URLSearchParams()
+  if (state.agentId) {
+    params.set('agent', state.agentId)
+  }
+  const query = params.toString()
+
+  return '/api/import-file' + (query ? '?' + query : '')
+}
+
+const submitUpload = async (event) => {
+  event.preventDefault()
+  const file = elements.uploadFile.files?.[0]
+  if (!file) {
+    elements.uploadStatus.textContent = 'Choose a file to import.'
+    return
+  }
+
+  const form = new FormData()
+  form.append('file', file)
+  const title = elements.uploadTitleInput.value.trim()
+  if (title) {
+    form.append('title', title)
+  }
+  if (elements.uploadAllowSensitive.checked) {
+    form.append('allowSensitive', 'true')
+  }
+
+  setUploadBusy(true)
+  elements.uploadStatus.textContent = 'Importing...'
+
+  try {
+    const response = await fetch(uploadImportUrl(), {
+      method: 'POST',
+      body: form
+    })
+    const payload = await response.json().catch(() => ({}))
+    if (!response.ok) {
+      throw new Error(payload?.error || 'Import failed')
+    }
+
+    elements.uploadStatus.textContent = 'Imported "' + String(payload?.title || file.name) + '".'
+    await loadAgents()
+    await loadContexts()
+    scheduleChunkFetch({ fit: true })
+    window.setTimeout(closeUploadDialog, 700)
+  } catch (error) {
+    elements.uploadStatus.textContent = error instanceof Error ? error.message : String(error)
+  } finally {
+    setUploadBusy(false)
+  }
+}
+
+const setupUploadDialog = () => {
+  elements.uploadOpen.addEventListener('click', openUploadDialog)
+  elements.uploadClose.addEventListener('click', closeUploadDialog)
+  elements.uploadForm.addEventListener('submit', (event) => {
+    submitUpload(event).catch((error) => {
+      elements.uploadStatus.textContent = error instanceof Error ? error.message : String(error)
+      setUploadBusy(false)
+    })
+  })
+  elements.uploadDialog.addEventListener('click', (event) => {
+    if (event.target === elements.uploadDialog) {
+      closeUploadDialog()
+    }
+  })
+}
+
 const setupControls = () => {
   elements.zoomIn.addEventListener('click', () => {
     zoomAtPoint(state.viewport.width / 2, state.viewport.height / 2, 1.06)
@@ -1416,6 +1577,31 @@ const setupControls = () => {
     closeContentDialog()
   })
 
+  elements.copyWikiLink.addEventListener('click', () => {
+    copySelectedWikiLink().catch((error) => {
+      elements.contentActionStatus.textContent = error instanceof Error ? error.message : String(error)
+    })
+  })
+
+  elements.suggestNodeLinks.addEventListener('click', () => {
+    loadSelectedLinkSuggestions().catch((error) => {
+      elements.contentActionStatus.textContent = error instanceof Error ? error.message : String(error)
+    })
+  })
+
+  elements.contentLinkSuggestions.addEventListener('click', (event) => {
+    const button = event.target.closest('button[data-title]')
+    if (!button) {
+      return
+    }
+    const value = '[[' + button.dataset.title + ']]'
+    navigator.clipboard.writeText(value).then(() => {
+      elements.contentActionStatus.textContent = 'Copied ' + value
+    }).catch(() => {
+      elements.contentActionStatus.textContent = value
+    })
+  })
+
   elements.contentDialog.addEventListener('click', (event) => {
     if (event.target === elements.contentDialog) {
       closeContentDialog()
@@ -1629,6 +1815,7 @@ const bootstrap = async () => {
   setupRenderWorker()
   setupInput()
   setupControls()
+  setupUploadDialog()
   setupContextControl()
   wireNodeLinkClicks()
 

package/dist/application/import-file.js

@@ -0,0 +1,45 @@
+import { basename, extname } from 'node:path';
+import { sharedAgentId } from '../domain/agents.js';
+import { convertDocumentWithDocling } from '../infrastructure/docling.js';
+import { addNoteWithMetadata } from './add-note.js';
+import { indexVault } from './index-vault.js';
+const titleFromSourceName = (sourceName) => {
+    const name = basename(sourceName, extname(sourceName))
+        .replace(/[_-]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    return name.length > 0 ? name : 'Imported Document';
+};
+const buildImportedContent = (sourceName, markdown) => [
+    `Imported from \`${sourceName}\` with Docling. #import #document`,
+    '',
+    '## Extracted Content',
+    '',
+    markdown.trim()
+].join('\n');
+const toResult = (title, sourceName, added, index) => ({
+    title,
+    sourceName,
+    path: added.path,
+    writeConnectivity: {
+        autoLinked: added.autoLinked,
+        linkTarget: added.linkTarget,
+        context: added.context,
+        hubCreated: added.hubCreated,
+        guaranteedEdge: added.autoLinked
+    },
+    ...(index ? { index } : {})
+});
+export const importFile = async (input) => {
+    const sourceName = input.originalName?.trim() || basename(input.filePath);
+    const title = input.title?.trim() || titleFromSourceName(sourceName);
+    const converter = input.converter ?? convertDocumentWithDocling;
+    const converted = await converter({ path: input.filePath });
+    const content = buildImportedContent(sourceName, converted.markdown);
+    const added = await addNoteWithMetadata(input.vaultPath, title, content, input.agentId ?? sharedAgentId, {
+        allowSensitive: input.allowSensitive,
+        autoContextLinks: input.autoContextLinks
+    });
+    const index = input.autoIndex === false ? undefined : await indexVault(input.vaultPath);
+    return toResult(title, sourceName, added, index);
+};

package/dist/application/inbox.js

@@ -0,0 +1,54 @@
+import { relative } from 'node:path';
+import { addNoteWithMetadata } from './add-note.js';
+import { buildRememberSuggestion } from './memory-suggestions.js';
+import { indexVault } from './index-vault.js';
+import { ensureVault, readMarkdownFiles } from '../infrastructure/file-system-vault.js';
+const compactPreview = (content) => content
+    .replace(/^---[\s\S]*?\n---\n?/, '')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .slice(0, 180);
+const extractTitle = (content, fallback) => content.match(/^#\s+(.+)$/m)?.[1]?.trim() || fallback;
+export const addInboxItem = async (input) => {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const result = await addNoteWithMetadata(input.vaultPath, `Inbox ${timestamp}`, `${input.content.trim()}\n\n#inbox #triage`, input.agentId, {
+        autoContextLinks: false
+    });
+    const index = input.autoIndex === false ? null : await indexVault(input.vaultPath);
+    return {
+        item: result,
+        index
+    };
+};
+export const listInboxItems = async (vaultPath, limit = 20) => {
+    const absoluteVaultPath = await ensureVault(vaultPath);
+    const files = await readMarkdownFiles(absoluteVaultPath);
+    return files
+        .filter((file) => /(^|\s)#inbox\b/.test(file.content))
+        .sort((left, right) => right.updatedAt.getTime() - left.updatedAt.getTime())
+        .slice(0, Math.max(0, limit))
+        .map((file) => ({
+        title: extractTitle(file.content, 'Inbox item'),
+        path: relative(absoluteVaultPath, file.absolutePath),
+        updatedAt: file.updatedAt.toISOString(),
+        preview: compactPreview(file.content)
+    }));
+};
+export const processInboxItems = async (input) => {
+    const items = await listInboxItems(input.vaultPath, input.limit ?? 10);
+    const suggestions = await Promise.all(items.map(async (item) => {
+        const suggestion = await buildRememberSuggestion({
+            vaultPath: input.vaultPath,
+            content: item.preview,
+            agentId: input.agentId,
+            linkLimit: 5
+        });
+        return {
+            ...item,
+            suggestedTitle: suggestion.title,
+            suggestedTags: suggestion.tags,
+            suggestedLinks: suggestion.links.map((link) => link.title)
+        };
+    }));
+    return suggestions;
+};