@oomkapwn/enquire-mcp 3.7.10 → 3.7.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (156) hide show
  1. package/CHANGELOG.md +117 -0
  2. package/README.md +4 -4
  3. package/dist/bases.d.ts +14 -0
  4. package/dist/bases.d.ts.map +1 -1
  5. package/dist/bases.js +34 -4
  6. package/dist/bases.js.map +1 -1
  7. package/dist/embed-db.d.ts +10 -1
  8. package/dist/embed-db.d.ts.map +1 -1
  9. package/dist/embed-db.js +15 -3
  10. package/dist/embed-db.js.map +1 -1
  11. package/dist/http-transport.d.ts +18 -0
  12. package/dist/http-transport.d.ts.map +1 -1
  13. package/dist/http-transport.js +34 -1
  14. package/dist/http-transport.js.map +1 -1
  15. package/dist/index.d.ts +1 -1
  16. package/dist/index.js +1 -1
  17. package/dist/tools/media.d.ts.map +1 -1
  18. package/dist/tools/media.js +5 -1
  19. package/dist/tools/media.js.map +1 -1
  20. package/dist/tools/search.d.ts.map +1 -1
  21. package/dist/tools/search.js +12 -1
  22. package/dist/tools/search.js.map +1 -1
  23. package/dist/tools.d.ts +980 -0
  24. package/dist/tools.d.ts.map +1 -0
  25. package/dist/tools.js +3132 -0
  26. package/dist/tools.js.map +1 -0
  27. package/docs/QUICKSTART.md +1 -1
  28. package/docs/api-reference/.nojekyll +1 -0
  29. package/docs/api-reference/assets/hierarchy.js +1 -0
  30. package/docs/api-reference/assets/highlight.css +71 -0
  31. package/docs/api-reference/assets/icons.js +18 -0
  32. package/docs/api-reference/assets/icons.svg +1 -0
  33. package/docs/api-reference/assets/main.js +60 -0
  34. package/docs/api-reference/assets/navigation.js +1 -0
  35. package/docs/api-reference/assets/search.js +1 -0
  36. package/docs/api-reference/assets/style.css +1633 -0
  37. package/docs/api-reference/functions/index.buildEmbedText.html +15 -0
  38. package/docs/api-reference/functions/index.buildMcpServer.html +4 -0
  39. package/docs/api-reference/functions/index.formatReadyBanner.html +4 -0
  40. package/docs/api-reference/functions/index.main.html +1 -0
  41. package/docs/api-reference/functions/index.parsePositiveInt.html +1 -0
  42. package/docs/api-reference/functions/index.parseQuantizationMode.html +5 -0
  43. package/docs/api-reference/functions/index.prepareServerDeps.html +5 -0
  44. package/docs/api-reference/functions/index.startServer.html +1 -0
  45. package/docs/api-reference/functions/tools.appendToNote.html +17 -0
  46. package/docs/api-reference/functions/tools.archiveNote.html +15 -0
  47. package/docs/api-reference/functions/tools.assertHnswModelMatchesEmbedder.html +13 -0
  48. package/docs/api-reference/functions/tools.chatThreadAppend.html +22 -0
  49. package/docs/api-reference/functions/tools.chatThreadRead.html +16 -0
  50. package/docs/api-reference/functions/tools.contextPack.html +21 -0
  51. package/docs/api-reference/functions/tools.createNote.html +19 -0
  52. package/docs/api-reference/functions/tools.dataviewQuery.html +16 -0
  53. package/docs/api-reference/functions/tools.embeddingsSearch.html +40 -0
  54. package/docs/api-reference/functions/tools.findPath.html +23 -0
  55. package/docs/api-reference/functions/tools.findSimilar.html +21 -0
  56. package/docs/api-reference/functions/tools.frontmatterGet.html +15 -0
  57. package/docs/api-reference/functions/tools.frontmatterSearch.html +16 -0
  58. package/docs/api-reference/functions/tools.frontmatterSet.html +19 -0
  59. package/docs/api-reference/functions/tools.getBacklinks.html +15 -0
  60. package/docs/api-reference/functions/tools.getNoteNeighbors.html +16 -0
  61. package/docs/api-reference/functions/tools.getOpenQuestions.html +19 -0
  62. package/docs/api-reference/functions/tools.getOutboundLinks.html +16 -0
  63. package/docs/api-reference/functions/tools.getRecentEdits.html +14 -0
  64. package/docs/api-reference/functions/tools.getUnresolvedWikilinks.html +14 -0
  65. package/docs/api-reference/functions/tools.getVaultStats.html +13 -0
  66. package/docs/api-reference/functions/tools.lintWiki.html +20 -0
  67. package/docs/api-reference/functions/tools.listCanvases.html +16 -0
  68. package/docs/api-reference/functions/tools.listNotes.html +19 -0
  69. package/docs/api-reference/functions/tools.listPdfs.html +15 -0
  70. package/docs/api-reference/functions/tools.listTags.html +14 -0
  71. package/docs/api-reference/functions/tools.ocrPdf.html +18 -0
  72. package/docs/api-reference/functions/tools.openInUi.html +17 -0
  73. package/docs/api-reference/functions/tools.paperAudit.html +16 -0
  74. package/docs/api-reference/functions/tools.pickEmbedTextForHyde.html +8 -0
  75. package/docs/api-reference/functions/tools.readCanvas.html +19 -0
  76. package/docs/api-reference/functions/tools.readNote.html +20 -0
  77. package/docs/api-reference/functions/tools.readPdf.html +18 -0
  78. package/docs/api-reference/functions/tools.renameNote.html +24 -0
  79. package/docs/api-reference/functions/tools.replaceInNotes.html +20 -0
  80. package/docs/api-reference/functions/tools.resolveTarget.html +24 -0
  81. package/docs/api-reference/functions/tools.resolveWikilink.html +20 -0
  82. package/docs/api-reference/functions/tools.searchHybrid.html +62 -0
  83. package/docs/api-reference/functions/tools.searchText.html +19 -0
  84. package/docs/api-reference/functions/tools.semanticSearch.html +19 -0
  85. package/docs/api-reference/functions/tools.validateNoteProposal.html +19 -0
  86. package/docs/api-reference/hierarchy.html +1 -0
  87. package/docs/api-reference/index.html +1 -0
  88. package/docs/api-reference/interfaces/index.ServeOptions.html +74 -0
  89. package/docs/api-reference/interfaces/index.ServerDeps.html +27 -0
  90. package/docs/api-reference/interfaces/tool-manifest.ToolManifestEntry.html +33 -0
  91. package/docs/api-reference/interfaces/tools.ArchiveNoteArgs.html +12 -0
  92. package/docs/api-reference/interfaces/tools.BacklinkHit.html +15 -0
  93. package/docs/api-reference/interfaces/tools.CanvasEdge.html +19 -0
  94. package/docs/api-reference/interfaces/tools.CanvasSummary.html +16 -0
  95. package/docs/api-reference/interfaces/tools.ChatThreadAppendArgs.html +10 -0
  96. package/docs/api-reference/interfaces/tools.ChatThreadMessage.html +14 -0
  97. package/docs/api-reference/interfaces/tools.ChatThreadReadResult.html +10 -0
  98. package/docs/api-reference/interfaces/tools.ContextPackArgs.html +12 -0
  99. package/docs/api-reference/interfaces/tools.ContextPackResult.html +20 -0
  100. package/docs/api-reference/interfaces/tools.EmbedHit.html +21 -0
  101. package/docs/api-reference/interfaces/tools.EmbedSearchResponse.html +14 -0
  102. package/docs/api-reference/interfaces/tools.FindPathResult.html +17 -0
  103. package/docs/api-reference/interfaces/tools.FrontmatterSearchArgs.html +20 -0
  104. package/docs/api-reference/interfaces/tools.FrontmatterSetArgs.html +13 -0
  105. package/docs/api-reference/interfaces/tools.HnswSearchContext.html +21 -0
  106. package/docs/api-reference/interfaces/tools.LintWikiArgs.html +14 -0
  107. package/docs/api-reference/interfaces/tools.LintWikiFinding.html +14 -0
  108. package/docs/api-reference/interfaces/tools.LintWikiResult.html +9 -0
  109. package/docs/api-reference/interfaces/tools.NoteNeighbors.html +17 -0
  110. package/docs/api-reference/interfaces/tools.NoteReadFull.html +20 -0
  111. package/docs/api-reference/interfaces/tools.NoteReadMap.html +25 -0
  112. package/docs/api-reference/interfaces/tools.NoteSummary.html +14 -0
  113. package/docs/api-reference/interfaces/tools.OcrPdfArgs.html +16 -0
  114. package/docs/api-reference/interfaces/tools.OcrPdfPage.html +15 -0
  115. package/docs/api-reference/interfaces/tools.OcrPdfResult.html +18 -0
  116. package/docs/api-reference/interfaces/tools.OpenInUiResult.html +11 -0
  117. package/docs/api-reference/interfaces/tools.OpenQuestion.html +20 -0
  118. package/docs/api-reference/interfaces/tools.OutboundLink.html +20 -0
  119. package/docs/api-reference/interfaces/tools.PaperAuditFinding.html +17 -0
  120. package/docs/api-reference/interfaces/tools.PathStep.html +9 -0
  121. package/docs/api-reference/interfaces/tools.PdfSummary.html +9 -0
  122. package/docs/api-reference/interfaces/tools.ReadCanvasResult.html +15 -0
  123. package/docs/api-reference/interfaces/tools.ReadPdfArgs.html +8 -0
  124. package/docs/api-reference/interfaces/tools.ReadPdfPage.html +13 -0
  125. package/docs/api-reference/interfaces/tools.ReadPdfResult.html +18 -0
  126. package/docs/api-reference/interfaces/tools.RenameNoteResult.html +14 -0
  127. package/docs/api-reference/interfaces/tools.RenameProposal.html +13 -0
  128. package/docs/api-reference/interfaces/tools.ReplaceInNotesArgs.html +15 -0
  129. package/docs/api-reference/interfaces/tools.ReplaceInNotesFileResult.html +6 -0
  130. package/docs/api-reference/interfaces/tools.ReplaceInNotesResult.html +21 -0
  131. package/docs/api-reference/interfaces/tools.SearchHit.html +16 -0
  132. package/docs/api-reference/interfaces/tools.SearchHybridHit.html +30 -0
  133. package/docs/api-reference/interfaces/tools.SearchHybridResponse.html +23 -0
  134. package/docs/api-reference/interfaces/tools.SearchResponse.html +13 -0
  135. package/docs/api-reference/interfaces/tools.SemanticHit.html +15 -0
  136. package/docs/api-reference/interfaces/tools.SimilarNote.html +15 -0
  137. package/docs/api-reference/interfaces/tools.TagSummary.html +13 -0
  138. package/docs/api-reference/interfaces/tools.UnresolvedWikilink.html +22 -0
  139. package/docs/api-reference/interfaces/tools.ValidateProposalArgs.html +10 -0
  140. package/docs/api-reference/interfaces/tools.ValidateProposalResult.html +14 -0
  141. package/docs/api-reference/interfaces/tools.VaultStats.html +26 -0
  142. package/docs/api-reference/modules/index.html +1 -0
  143. package/docs/api-reference/modules/tool-manifest.html +1 -0
  144. package/docs/api-reference/modules/tools.html +1 -0
  145. package/docs/api-reference/types/tools.CanvasNode.html +7 -0
  146. package/docs/api-reference/types/tools.SearchMode.html +7 -0
  147. package/docs/api-reference/variables/index.VERSION.html +9 -0
  148. package/docs/api-reference/variables/tool-manifest.TOOL_MANIFEST.html +1 -0
  149. package/docs/http-transport.md +12 -4
  150. package/examples/README.md +32 -0
  151. package/examples/chatgpt-actions.md +70 -0
  152. package/examples/claude-desktop-hybrid.json +22 -0
  153. package/examples/claude-desktop.json +12 -0
  154. package/examples/cursor-mcp.json +18 -0
  155. package/examples/queries.jsonl +10 -0
  156. package/package.json +7 -2
@@ -0,0 +1,12 @@
1
+ {
2
+ "_comment_purpose": "Drop-in MCP server config for Claude Desktop. Edit the absolute paths to point at your enquire-mcp install + your Obsidian vault, then merge this into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %AppData%\\Claude\\claude_desktop_config.json (Windows).",
3
+ "_comment_tier1": "Tier 1 — TF-IDF only, zero setup. Just point at the vault and go. Recall is fine for ~1k-note vaults; sub-200ms typical query latency.",
4
+ "_comment_tier3": "For the full hybrid stack (BM25 + TF-IDF + ML embeddings + HNSW + reranker), see `claude-desktop-hybrid.json` next to this file.",
5
+ "mcpServers": {
6
+ "enquire": {
7
+ "command": "npx",
8
+ "args": ["-y", "@oomkapwn/enquire-mcp@latest", "serve", "--vault", "/ABSOLUTE/PATH/TO/YOUR/Obsidian Vault"],
9
+ "env": {}
10
+ }
11
+ }
12
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "_comment_purpose": "Cursor MCP config (stdio transport). Place at ~/.cursor/mcp.json (or your editor's MCP config location). Cursor reloads MCP servers automatically when this file changes.",
3
+ "_comment_docs": "https://docs.cursor.com/context/model-context-protocol",
4
+ "mcpServers": {
5
+ "enquire": {
6
+ "command": "npx",
7
+ "args": [
8
+ "-y",
9
+ "@oomkapwn/enquire-mcp@latest",
10
+ "serve",
11
+ "--vault", "/ABSOLUTE/PATH/TO/YOUR/Obsidian Vault",
12
+ "--persistent-index",
13
+ "--enable-reranker",
14
+ "--use-hnsw"
15
+ ]
16
+ }
17
+ }
18
+ }
@@ -0,0 +1,10 @@
1
+ {"id": "q01", "query": "Apollo program", "relevant": ["Reference/Apollo Program.md", "Reference/NASA history.md"]}
2
+ {"id": "q02", "query": "obsidian plugin development", "relevant": ["Notes/Plugin Dev Notes.md", "Reference/Obsidian API.md"]}
3
+ {"id": "q03", "query": "wikilink graph algorithms", "relevant": ["Reference/PageRank.md", "Notes/Graph Boost Retrieval.md"]}
4
+ {"id": "q04", "query": "BM25 ranking explained", "relevant": ["Reference/BM25.md", "Notes/IR Basics.md"]}
5
+ {"id": "q05", "query": "cross-encoder reranking BGE", "relevant": ["Reference/Reranker Models.md", "Notes/RRF Pipeline.md"]}
6
+ {"id": "q06", "query": "HNSW approximate nearest neighbor", "relevant": ["Reference/HNSW Paper.md", "Notes/Vector Index Choices.md"]}
7
+ {"id": "q07", "query": "late chunking embeddings", "relevant": ["Reference/Late Chunking.md", "Notes/Context Windowing.md"]}
8
+ {"id": "q08", "query": "int8 vector quantization", "relevant": ["Reference/Scalar Quantization.md", "Notes/Storage Optimization.md"]}
9
+ {"id": "q09", "query": "MCP stateful sessions", "relevant": ["Reference/MCP Spec.md", "Notes/Streamable HTTP.md"]}
10
+ {"id": "q10", "query": "Reciprocal Rank Fusion", "relevant": ["Reference/RRF Cormack.md", "Notes/Hybrid Retrieval.md"]}
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "@oomkapwn/enquire-mcp",
4
- "version": "3.7.10",
5
- "description": "The most advanced Obsidian MCP — long-term memory for AI agents. Hybrid retrieval (BM25 + TF-IDF + multilingual ML embeddings, RRF-fused) with BGE cross-encoder reranking, HNSW + int8 quantization, late-chunking, HyDE + sub-question decomposition, agentic RAG, PDFs (with OCR), standalone Bases (.base query execution — no Obsidian needed), GraphRAG-light (Louvain wikilink community detection), wikilinks, backlinks, Dataview, frontmatter, canvas. Open-source long-term memory / second brain for Claude Code, Claude Desktop, Cursor, ChatGPT custom GPT, Codex, OpenClaw, and any MCP client. 44 tools, 19 MCP prompts, 5 cross-encoder reranker models, 786 tests, SLSA-3, semver-bound, MIT.",
4
+ "version": "3.7.12",
5
+ "description": "The most advanced Obsidian MCP — long-term memory for AI agents. Hybrid retrieval (BM25 + TF-IDF + multilingual ML embeddings, RRF-fused) with BGE cross-encoder reranking, HNSW + int8 quantization, late-chunking, HyDE + sub-question decomposition, agentic RAG, PDFs (with OCR), standalone Bases (.base query execution — no Obsidian needed), GraphRAG-light (Louvain wikilink community detection), wikilinks, backlinks, Dataview, frontmatter, canvas. Open-source long-term memory / second brain for Claude Code, Claude Desktop, Cursor, ChatGPT custom GPT, Codex, OpenClaw, and any MCP client. 44 tools, 19 MCP prompts, BGE cross-encoder reranker verified end-to-end (+4 aliases in catalog, transformers.js bump pending), 801 tests, SLSA-3, semver-bound, MIT.",
6
6
  "type": "module",
7
7
  "bin": {
8
8
  "enquire-mcp": "dist/index.js"
@@ -38,11 +38,16 @@
38
38
  "types": "./dist/communities.d.ts",
39
39
  "import": "./dist/communities.js"
40
40
  },
41
+ "./tool-manifest": {
42
+ "types": "./dist/tool-manifest.d.ts",
43
+ "import": "./dist/tool-manifest.js"
44
+ },
41
45
  "./package.json": "./package.json"
42
46
  },
43
47
  "files": [
44
48
  "dist",
45
49
  "docs",
50
+ "examples",
46
51
  "assets/social-preview.png",
47
52
  "README.md",
48
53
  "LICENSE",