ocr-provenance-mcp 1.0.0

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.

Potentially problematic release.


This version of ocr-provenance-mcp might be problematic. Click here for more details.

Files changed (578) hide show
  1. package/.env.example +55 -0
  2. package/LICENSE +78 -0
  3. package/README.md +1154 -0
  4. package/dist/bin-http.d.ts +24 -0
  5. package/dist/bin-http.d.ts.map +1 -0
  6. package/dist/bin-http.js +275 -0
  7. package/dist/bin-http.js.map +1 -0
  8. package/dist/bin-setup.d.ts +11 -0
  9. package/dist/bin-setup.d.ts.map +1 -0
  10. package/dist/bin-setup.js +610 -0
  11. package/dist/bin-setup.js.map +1 -0
  12. package/dist/bin.d.ts +16 -0
  13. package/dist/bin.d.ts.map +1 -0
  14. package/dist/bin.js +16 -0
  15. package/dist/bin.js.map +1 -0
  16. package/dist/index.d.ts +13 -0
  17. package/dist/index.d.ts.map +1 -0
  18. package/dist/index.js +90 -0
  19. package/dist/index.js.map +1 -0
  20. package/dist/models/chunk.d.ts +136 -0
  21. package/dist/models/chunk.d.ts.map +1 -0
  22. package/dist/models/chunk.js +27 -0
  23. package/dist/models/chunk.js.map +1 -0
  24. package/dist/models/cluster.d.ts +79 -0
  25. package/dist/models/cluster.d.ts.map +1 -0
  26. package/dist/models/cluster.js +10 -0
  27. package/dist/models/cluster.js.map +1 -0
  28. package/dist/models/comparison.d.ts +62 -0
  29. package/dist/models/comparison.d.ts.map +1 -0
  30. package/dist/models/comparison.js +8 -0
  31. package/dist/models/comparison.js.map +1 -0
  32. package/dist/models/document.d.ts +104 -0
  33. package/dist/models/document.d.ts.map +1 -0
  34. package/dist/models/document.js +15 -0
  35. package/dist/models/document.js.map +1 -0
  36. package/dist/models/embedding.d.ts +87 -0
  37. package/dist/models/embedding.d.ts.map +1 -0
  38. package/dist/models/embedding.js +23 -0
  39. package/dist/models/embedding.js.map +1 -0
  40. package/dist/models/extraction.d.ts +15 -0
  41. package/dist/models/extraction.d.ts.map +1 -0
  42. package/dist/models/extraction.js +2 -0
  43. package/dist/models/extraction.js.map +1 -0
  44. package/dist/models/form-fill.d.ts +23 -0
  45. package/dist/models/form-fill.d.ts.map +1 -0
  46. package/dist/models/form-fill.js +2 -0
  47. package/dist/models/form-fill.js.map +1 -0
  48. package/dist/models/image.d.ts +177 -0
  49. package/dist/models/image.d.ts.map +1 -0
  50. package/dist/models/image.js +8 -0
  51. package/dist/models/image.js.map +1 -0
  52. package/dist/models/index.d.ts +14 -0
  53. package/dist/models/index.d.ts.map +1 -0
  54. package/dist/models/index.js +22 -0
  55. package/dist/models/index.js.map +1 -0
  56. package/dist/models/provenance.d.ts +174 -0
  57. package/dist/models/provenance.d.ts.map +1 -0
  58. package/dist/models/provenance.js +53 -0
  59. package/dist/models/provenance.js.map +1 -0
  60. package/dist/models/uploaded-file.d.ts +20 -0
  61. package/dist/models/uploaded-file.d.ts.map +1 -0
  62. package/dist/models/uploaded-file.js +2 -0
  63. package/dist/models/uploaded-file.js.map +1 -0
  64. package/dist/server/errors.d.ts +93 -0
  65. package/dist/server/errors.d.ts.map +1 -0
  66. package/dist/server/errors.js +256 -0
  67. package/dist/server/errors.js.map +1 -0
  68. package/dist/server/events.d.ts +36 -0
  69. package/dist/server/events.d.ts.map +1 -0
  70. package/dist/server/events.js +48 -0
  71. package/dist/server/events.js.map +1 -0
  72. package/dist/server/permissions.d.ts +26 -0
  73. package/dist/server/permissions.d.ts.map +1 -0
  74. package/dist/server/permissions.js +194 -0
  75. package/dist/server/permissions.js.map +1 -0
  76. package/dist/server/register-tools.d.ts +25 -0
  77. package/dist/server/register-tools.d.ts.map +1 -0
  78. package/dist/server/register-tools.js +102 -0
  79. package/dist/server/register-tools.js.map +1 -0
  80. package/dist/server/startup.d.ts +16 -0
  81. package/dist/server/startup.d.ts.map +1 -0
  82. package/dist/server/startup.js +37 -0
  83. package/dist/server/startup.js.map +1 -0
  84. package/dist/server/state.d.ts +166 -0
  85. package/dist/server/state.d.ts.map +1 -0
  86. package/dist/server/state.js +424 -0
  87. package/dist/server/state.js.map +1 -0
  88. package/dist/server/transports/http-transport.d.ts +37 -0
  89. package/dist/server/transports/http-transport.d.ts.map +1 -0
  90. package/dist/server/transports/http-transport.js +204 -0
  91. package/dist/server/transports/http-transport.js.map +1 -0
  92. package/dist/server/transports/index.d.ts +9 -0
  93. package/dist/server/transports/index.d.ts.map +1 -0
  94. package/dist/server/transports/index.js +9 -0
  95. package/dist/server/transports/index.js.map +1 -0
  96. package/dist/server/transports/session-manager.d.ts +40 -0
  97. package/dist/server/transports/session-manager.d.ts.map +1 -0
  98. package/dist/server/transports/session-manager.js +74 -0
  99. package/dist/server/transports/session-manager.js.map +1 -0
  100. package/dist/server/types.d.ts +82 -0
  101. package/dist/server/types.d.ts.map +1 -0
  102. package/dist/server/types.js +14 -0
  103. package/dist/server/types.js.map +1 -0
  104. package/dist/services/audit.d.ts +26 -0
  105. package/dist/services/audit.d.ts.map +1 -0
  106. package/dist/services/audit.js +43 -0
  107. package/dist/services/audit.js.map +1 -0
  108. package/dist/services/chunking/chunk-deduplicator.d.ts +33 -0
  109. package/dist/services/chunking/chunk-deduplicator.d.ts.map +1 -0
  110. package/dist/services/chunking/chunk-deduplicator.js +46 -0
  111. package/dist/services/chunking/chunk-deduplicator.js.map +1 -0
  112. package/dist/services/chunking/chunk-merger.d.ts +26 -0
  113. package/dist/services/chunking/chunk-merger.d.ts.map +1 -0
  114. package/dist/services/chunking/chunk-merger.js +94 -0
  115. package/dist/services/chunking/chunk-merger.js.map +1 -0
  116. package/dist/services/chunking/chunker.d.ts +62 -0
  117. package/dist/services/chunking/chunker.d.ts.map +1 -0
  118. package/dist/services/chunking/chunker.js +566 -0
  119. package/dist/services/chunking/chunker.js.map +1 -0
  120. package/dist/services/chunking/heading-normalizer.d.ts +33 -0
  121. package/dist/services/chunking/heading-normalizer.d.ts.map +1 -0
  122. package/dist/services/chunking/heading-normalizer.js +101 -0
  123. package/dist/services/chunking/heading-normalizer.js.map +1 -0
  124. package/dist/services/chunking/json-block-analyzer.d.ts +163 -0
  125. package/dist/services/chunking/json-block-analyzer.d.ts.map +1 -0
  126. package/dist/services/chunking/json-block-analyzer.js +1033 -0
  127. package/dist/services/chunking/json-block-analyzer.js.map +1 -0
  128. package/dist/services/chunking/markdown-parser.d.ts +75 -0
  129. package/dist/services/chunking/markdown-parser.d.ts.map +1 -0
  130. package/dist/services/chunking/markdown-parser.js +428 -0
  131. package/dist/services/chunking/markdown-parser.js.map +1 -0
  132. package/dist/services/chunking/text-normalizer.d.ts +20 -0
  133. package/dist/services/chunking/text-normalizer.d.ts.map +1 -0
  134. package/dist/services/chunking/text-normalizer.js +36 -0
  135. package/dist/services/chunking/text-normalizer.js.map +1 -0
  136. package/dist/services/clm/contract-schemas.d.ts +36 -0
  137. package/dist/services/clm/contract-schemas.d.ts.map +1 -0
  138. package/dist/services/clm/contract-schemas.js +92 -0
  139. package/dist/services/clm/contract-schemas.js.map +1 -0
  140. package/dist/services/clm/summarization.d.ts +46 -0
  141. package/dist/services/clm/summarization.d.ts.map +1 -0
  142. package/dist/services/clm/summarization.js +61 -0
  143. package/dist/services/clm/summarization.js.map +1 -0
  144. package/dist/services/clustering/clustering-service.d.ts +58 -0
  145. package/dist/services/clustering/clustering-service.d.ts.map +1 -0
  146. package/dist/services/clustering/clustering-service.js +467 -0
  147. package/dist/services/clustering/clustering-service.js.map +1 -0
  148. package/dist/services/comparison/diff-service.d.ts +41 -0
  149. package/dist/services/comparison/diff-service.d.ts.map +1 -0
  150. package/dist/services/comparison/diff-service.js +120 -0
  151. package/dist/services/comparison/diff-service.js.map +1 -0
  152. package/dist/services/embedding/embedder.d.ts +55 -0
  153. package/dist/services/embedding/embedder.d.ts.map +1 -0
  154. package/dist/services/embedding/embedder.js +202 -0
  155. package/dist/services/embedding/embedder.js.map +1 -0
  156. package/dist/services/embedding/nomic.d.ts +67 -0
  157. package/dist/services/embedding/nomic.d.ts.map +1 -0
  158. package/dist/services/embedding/nomic.js +280 -0
  159. package/dist/services/embedding/nomic.js.map +1 -0
  160. package/dist/services/gemini/circuit-breaker.d.ts +106 -0
  161. package/dist/services/gemini/circuit-breaker.d.ts.map +1 -0
  162. package/dist/services/gemini/circuit-breaker.js +237 -0
  163. package/dist/services/gemini/circuit-breaker.js.map +1 -0
  164. package/dist/services/gemini/client.d.ts +173 -0
  165. package/dist/services/gemini/client.d.ts.map +1 -0
  166. package/dist/services/gemini/client.js +483 -0
  167. package/dist/services/gemini/client.js.map +1 -0
  168. package/dist/services/gemini/config.d.ts +116 -0
  169. package/dist/services/gemini/config.d.ts.map +1 -0
  170. package/dist/services/gemini/config.js +118 -0
  171. package/dist/services/gemini/config.js.map +1 -0
  172. package/dist/services/gemini/index.d.ts +9 -0
  173. package/dist/services/gemini/index.d.ts.map +1 -0
  174. package/dist/services/gemini/index.js +13 -0
  175. package/dist/services/gemini/index.js.map +1 -0
  176. package/dist/services/gemini/rate-limiter.d.ts +62 -0
  177. package/dist/services/gemini/rate-limiter.d.ts.map +1 -0
  178. package/dist/services/gemini/rate-limiter.js +120 -0
  179. package/dist/services/gemini/rate-limiter.js.map +1 -0
  180. package/dist/services/images/extractor.d.ts +88 -0
  181. package/dist/services/images/extractor.d.ts.map +1 -0
  182. package/dist/services/images/extractor.js +340 -0
  183. package/dist/services/images/extractor.js.map +1 -0
  184. package/dist/services/images/optimizer.d.ts +130 -0
  185. package/dist/services/images/optimizer.d.ts.map +1 -0
  186. package/dist/services/images/optimizer.js +228 -0
  187. package/dist/services/images/optimizer.js.map +1 -0
  188. package/dist/services/ocr/datalab.d.ts +64 -0
  189. package/dist/services/ocr/datalab.d.ts.map +1 -0
  190. package/dist/services/ocr/datalab.js +425 -0
  191. package/dist/services/ocr/datalab.js.map +1 -0
  192. package/dist/services/ocr/errors.d.ts +38 -0
  193. package/dist/services/ocr/errors.d.ts.map +1 -0
  194. package/dist/services/ocr/errors.js +83 -0
  195. package/dist/services/ocr/errors.js.map +1 -0
  196. package/dist/services/ocr/file-manager.d.ts +76 -0
  197. package/dist/services/ocr/file-manager.d.ts.map +1 -0
  198. package/dist/services/ocr/file-manager.js +238 -0
  199. package/dist/services/ocr/file-manager.js.map +1 -0
  200. package/dist/services/ocr/form-fill.d.ts +48 -0
  201. package/dist/services/ocr/form-fill.d.ts.map +1 -0
  202. package/dist/services/ocr/form-fill.js +213 -0
  203. package/dist/services/ocr/form-fill.js.map +1 -0
  204. package/dist/services/ocr/processor.d.ts +95 -0
  205. package/dist/services/ocr/processor.d.ts.map +1 -0
  206. package/dist/services/ocr/processor.js +259 -0
  207. package/dist/services/ocr/processor.js.map +1 -0
  208. package/dist/services/provenance/agent-metadata.d.ts +82 -0
  209. package/dist/services/provenance/agent-metadata.d.ts.map +1 -0
  210. package/dist/services/provenance/agent-metadata.js +106 -0
  211. package/dist/services/provenance/agent-metadata.js.map +1 -0
  212. package/dist/services/provenance/chain-hash.d.ts +57 -0
  213. package/dist/services/provenance/chain-hash.d.ts.map +1 -0
  214. package/dist/services/provenance/chain-hash.js +131 -0
  215. package/dist/services/provenance/chain-hash.js.map +1 -0
  216. package/dist/services/provenance/exporter.d.ts +202 -0
  217. package/dist/services/provenance/exporter.d.ts.map +1 -0
  218. package/dist/services/provenance/exporter.js +457 -0
  219. package/dist/services/provenance/exporter.js.map +1 -0
  220. package/dist/services/provenance/index.d.ts +15 -0
  221. package/dist/services/provenance/index.d.ts.map +1 -0
  222. package/dist/services/provenance/index.js +17 -0
  223. package/dist/services/provenance/index.js.map +1 -0
  224. package/dist/services/provenance/tracker.d.ts +138 -0
  225. package/dist/services/provenance/tracker.d.ts.map +1 -0
  226. package/dist/services/provenance/tracker.js +293 -0
  227. package/dist/services/provenance/tracker.js.map +1 -0
  228. package/dist/services/provenance/verifier.d.ts +153 -0
  229. package/dist/services/provenance/verifier.d.ts.map +1 -0
  230. package/dist/services/provenance/verifier.js +536 -0
  231. package/dist/services/provenance/verifier.js.map +1 -0
  232. package/dist/services/python-pool.d.ts +70 -0
  233. package/dist/services/python-pool.d.ts.map +1 -0
  234. package/dist/services/python-pool.js +265 -0
  235. package/dist/services/python-pool.js.map +1 -0
  236. package/dist/services/search/bm25.d.ts +180 -0
  237. package/dist/services/search/bm25.d.ts.map +1 -0
  238. package/dist/services/search/bm25.js +656 -0
  239. package/dist/services/search/bm25.js.map +1 -0
  240. package/dist/services/search/fusion.d.ts +103 -0
  241. package/dist/services/search/fusion.d.ts.map +1 -0
  242. package/dist/services/search/fusion.js +122 -0
  243. package/dist/services/search/fusion.js.map +1 -0
  244. package/dist/services/search/local-reranker.d.ts +30 -0
  245. package/dist/services/search/local-reranker.d.ts.map +1 -0
  246. package/dist/services/search/local-reranker.js +123 -0
  247. package/dist/services/search/local-reranker.js.map +1 -0
  248. package/dist/services/search/quality.d.ts +11 -0
  249. package/dist/services/search/quality.d.ts.map +1 -0
  250. package/dist/services/search/quality.js +17 -0
  251. package/dist/services/search/quality.js.map +1 -0
  252. package/dist/services/search/query-classifier.d.ts +34 -0
  253. package/dist/services/search/query-classifier.d.ts.map +1 -0
  254. package/dist/services/search/query-classifier.js +114 -0
  255. package/dist/services/search/query-classifier.js.map +1 -0
  256. package/dist/services/search/query-expander.d.ts +73 -0
  257. package/dist/services/search/query-expander.d.ts.map +1 -0
  258. package/dist/services/search/query-expander.js +281 -0
  259. package/dist/services/search/query-expander.js.map +1 -0
  260. package/dist/services/search/reranker.d.ts +44 -0
  261. package/dist/services/search/reranker.d.ts.map +1 -0
  262. package/dist/services/search/reranker.js +101 -0
  263. package/dist/services/search/reranker.js.map +1 -0
  264. package/dist/services/storage/database/annotation-operations.d.ts +113 -0
  265. package/dist/services/storage/database/annotation-operations.d.ts.map +1 -0
  266. package/dist/services/storage/database/annotation-operations.js +177 -0
  267. package/dist/services/storage/database/annotation-operations.js.map +1 -0
  268. package/dist/services/storage/database/approval-operations.d.ts +132 -0
  269. package/dist/services/storage/database/approval-operations.d.ts.map +1 -0
  270. package/dist/services/storage/database/approval-operations.js +206 -0
  271. package/dist/services/storage/database/approval-operations.js.map +1 -0
  272. package/dist/services/storage/database/chunk-operations.d.ts +132 -0
  273. package/dist/services/storage/database/chunk-operations.d.ts.map +1 -0
  274. package/dist/services/storage/database/chunk-operations.js +306 -0
  275. package/dist/services/storage/database/chunk-operations.js.map +1 -0
  276. package/dist/services/storage/database/cluster-operations.d.ts +97 -0
  277. package/dist/services/storage/database/cluster-operations.d.ts.map +1 -0
  278. package/dist/services/storage/database/cluster-operations.js +258 -0
  279. package/dist/services/storage/database/cluster-operations.js.map +1 -0
  280. package/dist/services/storage/database/comparison-operations.d.ts +41 -0
  281. package/dist/services/storage/database/comparison-operations.d.ts.map +1 -0
  282. package/dist/services/storage/database/comparison-operations.js +65 -0
  283. package/dist/services/storage/database/comparison-operations.js.map +1 -0
  284. package/dist/services/storage/database/converters.d.ts +36 -0
  285. package/dist/services/storage/database/converters.d.ts.map +1 -0
  286. package/dist/services/storage/database/converters.js +244 -0
  287. package/dist/services/storage/database/converters.js.map +1 -0
  288. package/dist/services/storage/database/document-operations.d.ts +145 -0
  289. package/dist/services/storage/database/document-operations.d.ts.map +1 -0
  290. package/dist/services/storage/database/document-operations.js +498 -0
  291. package/dist/services/storage/database/document-operations.js.map +1 -0
  292. package/dist/services/storage/database/embedding-operations.d.ts +130 -0
  293. package/dist/services/storage/database/embedding-operations.d.ts.map +1 -0
  294. package/dist/services/storage/database/embedding-operations.js +315 -0
  295. package/dist/services/storage/database/embedding-operations.js.map +1 -0
  296. package/dist/services/storage/database/extraction-operations.d.ts +47 -0
  297. package/dist/services/storage/database/extraction-operations.d.ts.map +1 -0
  298. package/dist/services/storage/database/extraction-operations.js +85 -0
  299. package/dist/services/storage/database/extraction-operations.js.map +1 -0
  300. package/dist/services/storage/database/form-fill-operations.d.ts +58 -0
  301. package/dist/services/storage/database/form-fill-operations.d.ts.map +1 -0
  302. package/dist/services/storage/database/form-fill-operations.js +116 -0
  303. package/dist/services/storage/database/form-fill-operations.js.map +1 -0
  304. package/dist/services/storage/database/helpers.d.ts +29 -0
  305. package/dist/services/storage/database/helpers.d.ts.map +1 -0
  306. package/dist/services/storage/database/helpers.js +55 -0
  307. package/dist/services/storage/database/helpers.js.map +1 -0
  308. package/dist/services/storage/database/image-operations.d.ts +202 -0
  309. package/dist/services/storage/database/image-operations.d.ts.map +1 -0
  310. package/dist/services/storage/database/image-operations.js +484 -0
  311. package/dist/services/storage/database/image-operations.js.map +1 -0
  312. package/dist/services/storage/database/index.d.ts +13 -0
  313. package/dist/services/storage/database/index.d.ts.map +1 -0
  314. package/dist/services/storage/database/index.js +16 -0
  315. package/dist/services/storage/database/index.js.map +1 -0
  316. package/dist/services/storage/database/lock-operations.d.ts +59 -0
  317. package/dist/services/storage/database/lock-operations.d.ts.map +1 -0
  318. package/dist/services/storage/database/lock-operations.js +89 -0
  319. package/dist/services/storage/database/lock-operations.js.map +1 -0
  320. package/dist/services/storage/database/obligation-operations.d.ts +88 -0
  321. package/dist/services/storage/database/obligation-operations.d.ts.map +1 -0
  322. package/dist/services/storage/database/obligation-operations.js +206 -0
  323. package/dist/services/storage/database/obligation-operations.js.map +1 -0
  324. package/dist/services/storage/database/ocr-operations.d.ts +33 -0
  325. package/dist/services/storage/database/ocr-operations.d.ts.map +1 -0
  326. package/dist/services/storage/database/ocr-operations.js +70 -0
  327. package/dist/services/storage/database/ocr-operations.js.map +1 -0
  328. package/dist/services/storage/database/playbook-operations.d.ts +72 -0
  329. package/dist/services/storage/database/playbook-operations.d.ts.map +1 -0
  330. package/dist/services/storage/database/playbook-operations.js +247 -0
  331. package/dist/services/storage/database/playbook-operations.js.map +1 -0
  332. package/dist/services/storage/database/provenance-operations.d.ts +112 -0
  333. package/dist/services/storage/database/provenance-operations.d.ts.map +1 -0
  334. package/dist/services/storage/database/provenance-operations.js +251 -0
  335. package/dist/services/storage/database/provenance-operations.js.map +1 -0
  336. package/dist/services/storage/database/service.d.ts +142 -0
  337. package/dist/services/storage/database/service.d.ts.map +1 -0
  338. package/dist/services/storage/database/service.js +310 -0
  339. package/dist/services/storage/database/service.js.map +1 -0
  340. package/dist/services/storage/database/static-operations.d.ts +30 -0
  341. package/dist/services/storage/database/static-operations.d.ts.map +1 -0
  342. package/dist/services/storage/database/static-operations.js +218 -0
  343. package/dist/services/storage/database/static-operations.js.map +1 -0
  344. package/dist/services/storage/database/stats-operations.d.ts +101 -0
  345. package/dist/services/storage/database/stats-operations.d.ts.map +1 -0
  346. package/dist/services/storage/database/stats-operations.js +394 -0
  347. package/dist/services/storage/database/stats-operations.js.map +1 -0
  348. package/dist/services/storage/database/tag-operations.d.ts +76 -0
  349. package/dist/services/storage/database/tag-operations.d.ts.map +1 -0
  350. package/dist/services/storage/database/tag-operations.js +178 -0
  351. package/dist/services/storage/database/tag-operations.js.map +1 -0
  352. package/dist/services/storage/database/types.d.ts +286 -0
  353. package/dist/services/storage/database/types.d.ts.map +1 -0
  354. package/dist/services/storage/database/types.js +39 -0
  355. package/dist/services/storage/database/types.js.map +1 -0
  356. package/dist/services/storage/database/upload-operations.d.ts +71 -0
  357. package/dist/services/storage/database/upload-operations.d.ts.map +1 -0
  358. package/dist/services/storage/database/upload-operations.js +124 -0
  359. package/dist/services/storage/database/upload-operations.js.map +1 -0
  360. package/dist/services/storage/database/user-operations.d.ts +102 -0
  361. package/dist/services/storage/database/user-operations.d.ts.map +1 -0
  362. package/dist/services/storage/database/user-operations.js +151 -0
  363. package/dist/services/storage/database/user-operations.js.map +1 -0
  364. package/dist/services/storage/database/workflow-operations.d.ts +98 -0
  365. package/dist/services/storage/database/workflow-operations.d.ts.map +1 -0
  366. package/dist/services/storage/database/workflow-operations.js +157 -0
  367. package/dist/services/storage/database/workflow-operations.js.map +1 -0
  368. package/dist/services/storage/database.d.ts +16 -0
  369. package/dist/services/storage/database.d.ts.map +1 -0
  370. package/dist/services/storage/database.js +15 -0
  371. package/dist/services/storage/database.js.map +1 -0
  372. package/dist/services/storage/index.d.ts +10 -0
  373. package/dist/services/storage/index.d.ts.map +1 -0
  374. package/dist/services/storage/index.js +10 -0
  375. package/dist/services/storage/index.js.map +1 -0
  376. package/dist/services/storage/migrations/index.d.ts +16 -0
  377. package/dist/services/storage/migrations/index.d.ts.map +1 -0
  378. package/dist/services/storage/migrations/index.js +20 -0
  379. package/dist/services/storage/migrations/index.js.map +1 -0
  380. package/dist/services/storage/migrations/operations.d.ts +40 -0
  381. package/dist/services/storage/migrations/operations.d.ts.map +1 -0
  382. package/dist/services/storage/migrations/operations.js +2910 -0
  383. package/dist/services/storage/migrations/operations.js.map +1 -0
  384. package/dist/services/storage/migrations/schema-definitions.d.ts +306 -0
  385. package/dist/services/storage/migrations/schema-definitions.d.ts.map +1 -0
  386. package/dist/services/storage/migrations/schema-definitions.js +1006 -0
  387. package/dist/services/storage/migrations/schema-definitions.js.map +1 -0
  388. package/dist/services/storage/migrations/schema-helpers.d.ts +50 -0
  389. package/dist/services/storage/migrations/schema-helpers.d.ts.map +1 -0
  390. package/dist/services/storage/migrations/schema-helpers.js +176 -0
  391. package/dist/services/storage/migrations/schema-helpers.js.map +1 -0
  392. package/dist/services/storage/migrations/types.d.ts +15 -0
  393. package/dist/services/storage/migrations/types.d.ts.map +1 -0
  394. package/dist/services/storage/migrations/types.js +21 -0
  395. package/dist/services/storage/migrations/types.js.map +1 -0
  396. package/dist/services/storage/migrations/verification.d.ts +20 -0
  397. package/dist/services/storage/migrations/verification.d.ts.map +1 -0
  398. package/dist/services/storage/migrations/verification.js +78 -0
  399. package/dist/services/storage/migrations/verification.js.map +1 -0
  400. package/dist/services/storage/migrations.d.ts +16 -0
  401. package/dist/services/storage/migrations.d.ts.map +1 -0
  402. package/dist/services/storage/migrations.js +17 -0
  403. package/dist/services/storage/migrations.js.map +1 -0
  404. package/dist/services/storage/types.d.ts +12 -0
  405. package/dist/services/storage/types.d.ts.map +1 -0
  406. package/dist/services/storage/types.js +5 -0
  407. package/dist/services/storage/types.js.map +1 -0
  408. package/dist/services/storage/vector.d.ts +208 -0
  409. package/dist/services/storage/vector.d.ts.map +1 -0
  410. package/dist/services/storage/vector.js +526 -0
  411. package/dist/services/storage/vector.js.map +1 -0
  412. package/dist/services/vlm/pipeline.d.ts +194 -0
  413. package/dist/services/vlm/pipeline.d.ts.map +1 -0
  414. package/dist/services/vlm/pipeline.js +800 -0
  415. package/dist/services/vlm/pipeline.js.map +1 -0
  416. package/dist/services/vlm/prompts.d.ts +171 -0
  417. package/dist/services/vlm/prompts.d.ts.map +1 -0
  418. package/dist/services/vlm/prompts.js +229 -0
  419. package/dist/services/vlm/prompts.js.map +1 -0
  420. package/dist/services/vlm/service.d.ts +174 -0
  421. package/dist/services/vlm/service.d.ts.map +1 -0
  422. package/dist/services/vlm/service.js +256 -0
  423. package/dist/services/vlm/service.js.map +1 -0
  424. package/dist/services/webhook-delivery.d.ts +4 -0
  425. package/dist/services/webhook-delivery.d.ts.map +1 -0
  426. package/dist/services/webhook-delivery.js +140 -0
  427. package/dist/services/webhook-delivery.js.map +1 -0
  428. package/dist/tools/chunks.d.ts +19 -0
  429. package/dist/tools/chunks.d.ts.map +1 -0
  430. package/dist/tools/chunks.js +392 -0
  431. package/dist/tools/chunks.js.map +1 -0
  432. package/dist/tools/clm.d.ts +16 -0
  433. package/dist/tools/clm.d.ts.map +1 -0
  434. package/dist/tools/clm.js +668 -0
  435. package/dist/tools/clm.js.map +1 -0
  436. package/dist/tools/clustering.d.ts +13 -0
  437. package/dist/tools/clustering.d.ts.map +1 -0
  438. package/dist/tools/clustering.js +498 -0
  439. package/dist/tools/clustering.js.map +1 -0
  440. package/dist/tools/collaboration.d.ts +15 -0
  441. package/dist/tools/collaboration.d.ts.map +1 -0
  442. package/dist/tools/collaboration.js +516 -0
  443. package/dist/tools/collaboration.js.map +1 -0
  444. package/dist/tools/comparison.d.ts +13 -0
  445. package/dist/tools/comparison.d.ts.map +1 -0
  446. package/dist/tools/comparison.js +735 -0
  447. package/dist/tools/comparison.js.map +1 -0
  448. package/dist/tools/compliance.d.ts +15 -0
  449. package/dist/tools/compliance.d.ts.map +1 -0
  450. package/dist/tools/compliance.js +640 -0
  451. package/dist/tools/compliance.js.map +1 -0
  452. package/dist/tools/config.d.ts +19 -0
  453. package/dist/tools/config.d.ts.map +1 -0
  454. package/dist/tools/config.js +213 -0
  455. package/dist/tools/config.js.map +1 -0
  456. package/dist/tools/database.d.ts +62 -0
  457. package/dist/tools/database.d.ts.map +1 -0
  458. package/dist/tools/database.js +288 -0
  459. package/dist/tools/database.js.map +1 -0
  460. package/dist/tools/documents.d.ts +61 -0
  461. package/dist/tools/documents.d.ts.map +1 -0
  462. package/dist/tools/documents.js +1624 -0
  463. package/dist/tools/documents.js.map +1 -0
  464. package/dist/tools/embeddings.d.ts +14 -0
  465. package/dist/tools/embeddings.d.ts.map +1 -0
  466. package/dist/tools/embeddings.js +626 -0
  467. package/dist/tools/embeddings.js.map +1 -0
  468. package/dist/tools/evaluation.d.ts +25 -0
  469. package/dist/tools/evaluation.d.ts.map +1 -0
  470. package/dist/tools/evaluation.js +523 -0
  471. package/dist/tools/evaluation.js.map +1 -0
  472. package/dist/tools/events.d.ts +16 -0
  473. package/dist/tools/events.d.ts.map +1 -0
  474. package/dist/tools/events.js +493 -0
  475. package/dist/tools/events.js.map +1 -0
  476. package/dist/tools/extraction-structured.d.ts +13 -0
  477. package/dist/tools/extraction-structured.d.ts.map +1 -0
  478. package/dist/tools/extraction-structured.js +390 -0
  479. package/dist/tools/extraction-structured.js.map +1 -0
  480. package/dist/tools/extraction.d.ts +24 -0
  481. package/dist/tools/extraction.d.ts.map +1 -0
  482. package/dist/tools/extraction.js +424 -0
  483. package/dist/tools/extraction.js.map +1 -0
  484. package/dist/tools/file-management.d.ts +14 -0
  485. package/dist/tools/file-management.d.ts.map +1 -0
  486. package/dist/tools/file-management.js +523 -0
  487. package/dist/tools/file-management.js.map +1 -0
  488. package/dist/tools/form-fill.d.ts +13 -0
  489. package/dist/tools/form-fill.d.ts.map +1 -0
  490. package/dist/tools/form-fill.js +250 -0
  491. package/dist/tools/form-fill.js.map +1 -0
  492. package/dist/tools/health.d.ts +19 -0
  493. package/dist/tools/health.d.ts.map +1 -0
  494. package/dist/tools/health.js +229 -0
  495. package/dist/tools/health.js.map +1 -0
  496. package/dist/tools/images.d.ts +54 -0
  497. package/dist/tools/images.d.ts.map +1 -0
  498. package/dist/tools/images.js +787 -0
  499. package/dist/tools/images.js.map +1 -0
  500. package/dist/tools/ingestion.d.ts +94 -0
  501. package/dist/tools/ingestion.d.ts.map +1 -0
  502. package/dist/tools/ingestion.js +1659 -0
  503. package/dist/tools/ingestion.js.map +1 -0
  504. package/dist/tools/intelligence.d.ts +18 -0
  505. package/dist/tools/intelligence.d.ts.map +1 -0
  506. package/dist/tools/intelligence.js +1039 -0
  507. package/dist/tools/intelligence.js.map +1 -0
  508. package/dist/tools/provenance.d.ts +51 -0
  509. package/dist/tools/provenance.d.ts.map +1 -0
  510. package/dist/tools/provenance.js +691 -0
  511. package/dist/tools/provenance.js.map +1 -0
  512. package/dist/tools/reports.d.ts +41 -0
  513. package/dist/tools/reports.d.ts.map +1 -0
  514. package/dist/tools/reports.js +1394 -0
  515. package/dist/tools/reports.js.map +1 -0
  516. package/dist/tools/search.d.ts +35 -0
  517. package/dist/tools/search.d.ts.map +1 -0
  518. package/dist/tools/search.js +2528 -0
  519. package/dist/tools/search.js.map +1 -0
  520. package/dist/tools/shared.d.ts +52 -0
  521. package/dist/tools/shared.d.ts.map +1 -0
  522. package/dist/tools/shared.js +54 -0
  523. package/dist/tools/shared.js.map +1 -0
  524. package/dist/tools/tags.d.ts +15 -0
  525. package/dist/tools/tags.d.ts.map +1 -0
  526. package/dist/tools/tags.js +287 -0
  527. package/dist/tools/tags.js.map +1 -0
  528. package/dist/tools/timeline.d.ts +15 -0
  529. package/dist/tools/timeline.d.ts.map +1 -0
  530. package/dist/tools/timeline.js +14 -0
  531. package/dist/tools/timeline.js.map +1 -0
  532. package/dist/tools/users.d.ts +14 -0
  533. package/dist/tools/users.d.ts.map +1 -0
  534. package/dist/tools/users.js +257 -0
  535. package/dist/tools/users.js.map +1 -0
  536. package/dist/tools/vlm.d.ts +40 -0
  537. package/dist/tools/vlm.d.ts.map +1 -0
  538. package/dist/tools/vlm.js +475 -0
  539. package/dist/tools/vlm.js.map +1 -0
  540. package/dist/tools/workflow.d.ts +16 -0
  541. package/dist/tools/workflow.d.ts.map +1 -0
  542. package/dist/tools/workflow.js +495 -0
  543. package/dist/tools/workflow.js.map +1 -0
  544. package/dist/utils/backoff.d.ts +53 -0
  545. package/dist/utils/backoff.d.ts.map +1 -0
  546. package/dist/utils/backoff.js +78 -0
  547. package/dist/utils/backoff.js.map +1 -0
  548. package/dist/utils/config-persistence.d.ts +33 -0
  549. package/dist/utils/config-persistence.d.ts.map +1 -0
  550. package/dist/utils/config-persistence.js +61 -0
  551. package/dist/utils/config-persistence.js.map +1 -0
  552. package/dist/utils/hash.d.ts +65 -0
  553. package/dist/utils/hash.d.ts.map +1 -0
  554. package/dist/utils/hash.js +146 -0
  555. package/dist/utils/hash.js.map +1 -0
  556. package/dist/utils/math.d.ts +21 -0
  557. package/dist/utils/math.d.ts.map +1 -0
  558. package/dist/utils/math.js +39 -0
  559. package/dist/utils/math.js.map +1 -0
  560. package/dist/utils/validation.d.ts +697 -0
  561. package/dist/utils/validation.d.ts.map +1 -0
  562. package/dist/utils/validation.js +529 -0
  563. package/dist/utils/validation.js.map +1 -0
  564. package/package.json +96 -0
  565. package/python/.gitkeep +0 -0
  566. package/python/__init__.py +104 -0
  567. package/python/clustering_worker.py +440 -0
  568. package/python/docx_image_extractor.py +524 -0
  569. package/python/embedding_worker.py +552 -0
  570. package/python/file_manager_worker.py +564 -0
  571. package/python/form_fill_worker.py +399 -0
  572. package/python/gpu_utils.py +582 -0
  573. package/python/image_extractor.py +317 -0
  574. package/python/image_optimizer.py +444 -0
  575. package/python/ocr_worker.py +712 -0
  576. package/python/pyproject.toml +76 -0
  577. package/python/requirements.txt +51 -0
  578. package/python/reranker_worker.py +87 -0
@@ -0,0 +1,475 @@
1
+ /**
2
+ * VLM (Vision Language Model) MCP Tools
3
+ *
4
+ * Tools for Gemini 3 multimodal image analysis of legal and medical documents.
5
+ * Uses the VLMService for analysis and VLMPipeline for batch processing.
6
+ *
7
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
8
+ * Use console.error() for all logging.
9
+ *
10
+ * @module tools/vlm
11
+ */
12
+ import { z } from 'zod';
13
+ import * as fs from 'fs';
14
+ import { requireDatabase, withDatabaseOperation } from '../server/state.js';
15
+ import { successResult } from '../server/types.js';
16
+ import { MCPError } from '../server/errors.js';
17
+ import { formatResponse, handleError, } from './shared.js';
18
+ import { validateInput, sanitizePath } from '../utils/validation.js';
19
+ import { getVLMService } from '../services/vlm/service.js';
20
+ import { VLMPipeline } from '../services/vlm/pipeline.js';
21
+ import { GeminiClient, getSharedClient } from '../services/gemini/client.js';
22
+ // ===============================================================================
23
+ // VALIDATION SCHEMAS
24
+ // ===============================================================================
25
+ const VLMDescribeInput = z.object({
26
+ image_path: z.string().min(1),
27
+ context_text: z.string().optional(),
28
+ use_thinking: z.boolean().default(false),
29
+ });
30
+ const VLMProcessInput = z.object({
31
+ document_id: z.string().optional(),
32
+ batch_size: z.number().int().min(1).max(20).default(5),
33
+ limit: z.number().int().min(1).max(500).default(50),
34
+ });
35
+ const VLMAnalyzePDFInput = z.object({
36
+ pdf_path: z.string().min(1),
37
+ prompt: z.string().optional(),
38
+ });
39
+ const VLMStatusInput = z.object({});
40
+ // ═══════════════════════════════════════════════════════════════════════════════
41
+ // VLM TOOL HANDLERS
42
+ // ═══════════════════════════════════════════════════════════════════════════════
43
+ /**
44
+ * Handle ocr_vlm_describe - Generate detailed description of an image using Gemini 3
45
+ *
46
+ * If the image is a database-tracked image (matched by extracted_path), this tool
47
+ * will also generate an embedding with full provenance chain for searchability.
48
+ * For arbitrary images not in the database, only the description is returned.
49
+ */
50
+ export async function handleVLMDescribe(params) {
51
+ try {
52
+ const input = validateInput(VLMDescribeInput, params);
53
+ const imagePath = sanitizePath(input.image_path);
54
+ const contextText = input.context_text;
55
+ const useThinking = input.use_thinking;
56
+ // Validate image path exists
57
+ if (!fs.existsSync(imagePath)) {
58
+ throw new MCPError('PATH_NOT_FOUND', `Image file not found: ${imagePath}`, {
59
+ image_path: imagePath,
60
+ });
61
+ }
62
+ return await withDatabaseOperation(async () => {
63
+ const vlm = getVLMService();
64
+ // Enrich context with table metadata for database-tracked images
65
+ let enrichedContext = contextText;
66
+ try {
67
+ const { db } = requireDatabase();
68
+ const conn = db.getConnection();
69
+ // Look up image by path to get page number
70
+ const imgRow = conn.prepare('SELECT document_id, page_number FROM images WHERE extracted_path = ?').get(imagePath);
71
+ if (imgRow != null && imgRow.page_number != null) {
72
+ // Find table provenance for this document
73
+ const tableRows = conn.prepare("SELECT processing_params FROM provenance WHERE root_document_id IN (SELECT provenance_id FROM documents WHERE id = ?) AND processing_params LIKE '%table_columns%' AND json_extract(processing_params, '$.character_start') IS NOT NULL").all(imgRow.document_id);
74
+ const tableContextParts = [];
75
+ for (const row of tableRows) {
76
+ try {
77
+ const params = JSON.parse(row.processing_params);
78
+ const cols = params.table_columns;
79
+ const summary = params.table_summary;
80
+ if (cols && cols.length > 0) {
81
+ const part = summary ?? `Table with columns: ${cols.join(', ')}`;
82
+ tableContextParts.push(part);
83
+ }
84
+ }
85
+ catch (error) {
86
+ console.error(`[vlm] Failed to parse table processing_params for row: ${error instanceof Error ? error.message : String(error)}`);
87
+ }
88
+ }
89
+ if (tableContextParts.length > 0) {
90
+ const tableContext = `This page contains structured table data. ${tableContextParts.join('. ')}`;
91
+ enrichedContext = enrichedContext
92
+ ? `${enrichedContext}\n\n${tableContext}`
93
+ : tableContext;
94
+ }
95
+ }
96
+ }
97
+ catch (error) {
98
+ console.error(`[vlm] Failed to enrich VLM context from database for image ${imagePath}: ${error instanceof Error ? error.message : String(error)}`);
99
+ }
100
+ let result;
101
+ if (useThinking) {
102
+ // Use deep analysis with extended reasoning
103
+ result = await vlm.analyzeDeep(imagePath);
104
+ }
105
+ else {
106
+ result = await vlm.describeImage(imagePath, {
107
+ contextText: enrichedContext,
108
+ highResolution: true,
109
+ });
110
+ }
111
+ // Try to generate embedding for database-tracked images
112
+ const warnings = [];
113
+ let embeddingId = null;
114
+ let embeddingGenerated = false;
115
+ try {
116
+ const { db, vector } = requireDatabase();
117
+ const conn = db.getConnection();
118
+ // Look up image by extracted_path
119
+ const dbImage = conn.prepare('SELECT id, document_id, page_number, image_index, extracted_path, provenance_id FROM images WHERE extracted_path = ?').get(imagePath);
120
+ if (dbImage && dbImage.provenance_id && result.description) {
121
+ const { getEmbeddingClient, MODEL_NAME: EMBEDDING_MODEL } = await import('../services/embedding/nomic.js');
122
+ const { v4: uuidv4 } = await import('uuid');
123
+ const { computeHash } = await import('../utils/hash.js');
124
+ const { ProvenanceType } = await import('../models/provenance.js');
125
+ const embeddingClient = getEmbeddingClient();
126
+ const vectors = await embeddingClient.embedChunks([result.description], 1);
127
+ if (vectors.length > 0) {
128
+ const embId = uuidv4();
129
+ const now = new Date().toISOString();
130
+ const descriptionHash = computeHash(result.description);
131
+ // Get IMAGE provenance to build chain
132
+ const imageProv = db.getProvenance(dbImage.provenance_id);
133
+ if (imageProv) {
134
+ // Create VLM_DESCRIPTION provenance (depth 3)
135
+ const vlmDescProvId = uuidv4();
136
+ const imageParentIds = JSON.parse(imageProv.parent_ids);
137
+ const vlmParentIds = [...imageParentIds, dbImage.provenance_id];
138
+ db.insertProvenance({
139
+ id: vlmDescProvId,
140
+ type: ProvenanceType.VLM_DESCRIPTION,
141
+ created_at: now,
142
+ processed_at: now,
143
+ source_file_created_at: null,
144
+ source_file_modified_at: null,
145
+ source_type: 'VLM',
146
+ source_path: dbImage.extracted_path,
147
+ source_id: dbImage.provenance_id,
148
+ root_document_id: imageProv.root_document_id,
149
+ location: {
150
+ page_number: dbImage.page_number,
151
+ chunk_index: dbImage.image_index,
152
+ },
153
+ content_hash: descriptionHash,
154
+ input_hash: imageProv.content_hash,
155
+ file_hash: imageProv.file_hash,
156
+ processor: 'gemini-vlm:describe',
157
+ processor_version: '3.0',
158
+ processing_params: { type: 'vlm_describe', use_thinking: useThinking },
159
+ processing_duration_ms: result.processingTimeMs ?? null,
160
+ processing_quality_score: null,
161
+ parent_id: dbImage.provenance_id,
162
+ parent_ids: JSON.stringify(vlmParentIds),
163
+ chain_depth: 3,
164
+ chain_path: JSON.stringify(['DOCUMENT', 'OCR_RESULT', 'IMAGE', 'VLM_DESCRIPTION']),
165
+ });
166
+ // Create EMBEDDING provenance (depth 4)
167
+ const embProvId = uuidv4();
168
+ const embParentIds = [...vlmParentIds, vlmDescProvId];
169
+ db.insertProvenance({
170
+ id: embProvId,
171
+ type: ProvenanceType.EMBEDDING,
172
+ created_at: now,
173
+ processed_at: now,
174
+ source_file_created_at: null,
175
+ source_file_modified_at: null,
176
+ source_type: 'EMBEDDING',
177
+ source_path: null,
178
+ source_id: vlmDescProvId,
179
+ root_document_id: imageProv.root_document_id,
180
+ location: {
181
+ page_number: dbImage.page_number,
182
+ chunk_index: dbImage.image_index,
183
+ },
184
+ content_hash: descriptionHash,
185
+ input_hash: descriptionHash,
186
+ file_hash: imageProv.file_hash,
187
+ processor: EMBEDDING_MODEL,
188
+ processor_version: '1.5.0',
189
+ processing_params: { task_type: 'search_document', dimensions: 768 },
190
+ processing_duration_ms: null,
191
+ processing_quality_score: null,
192
+ parent_id: vlmDescProvId,
193
+ parent_ids: JSON.stringify(embParentIds),
194
+ chain_depth: 4,
195
+ chain_path: JSON.stringify(['DOCUMENT', 'OCR_RESULT', 'IMAGE', 'VLM_DESCRIPTION', 'EMBEDDING']),
196
+ });
197
+ // Insert embedding record
198
+ db.insertEmbedding({
199
+ id: embId,
200
+ chunk_id: null,
201
+ image_id: dbImage.id,
202
+ extraction_id: null,
203
+ document_id: dbImage.document_id,
204
+ original_text: result.description,
205
+ original_text_length: result.description.length,
206
+ source_file_path: dbImage.extracted_path ?? 'unknown',
207
+ source_file_name: dbImage.extracted_path?.split('/').pop() ?? 'vlm_description',
208
+ source_file_hash: 'vlm_generated',
209
+ page_number: dbImage.page_number,
210
+ page_range: null,
211
+ character_start: 0,
212
+ character_end: result.description.length,
213
+ chunk_index: dbImage.image_index,
214
+ total_chunks: 1,
215
+ model_name: EMBEDDING_MODEL,
216
+ model_version: '1.5.0',
217
+ task_type: 'search_document',
218
+ inference_mode: 'local',
219
+ gpu_device: 'cuda:0',
220
+ provenance_id: embProvId,
221
+ content_hash: descriptionHash,
222
+ generation_duration_ms: null,
223
+ });
224
+ // Store vector
225
+ vector.storeVector(embId, vectors[0]);
226
+ // Update image.vlm_embedding_id
227
+ conn.prepare('UPDATE images SET vlm_embedding_id = ? WHERE id = ?').run(embId, dbImage.id);
228
+ embeddingId = embId;
229
+ embeddingGenerated = true;
230
+ console.error(`[INFO] VLM describe embedding generated for image ${dbImage.id}: ${embId}`);
231
+ }
232
+ }
233
+ }
234
+ }
235
+ catch (embError) {
236
+ const errMsg = embError instanceof Error ? embError.message : String(embError);
237
+ console.error(`[WARN] VLM describe embedding generation failed: ${errMsg}`);
238
+ warnings.push(`Embedding generation failed: ${errMsg}. Description stored but not semantically searchable.`);
239
+ }
240
+ return formatResponse(successResult({
241
+ description: result.description,
242
+ analysis: result.analysis,
243
+ model: result.model,
244
+ processing_time_ms: result.processingTimeMs,
245
+ tokens_used: result.tokensUsed,
246
+ confidence: result.analysis.confidence,
247
+ embedding_id: embeddingId,
248
+ embedding_generated: embeddingGenerated,
249
+ ...(warnings.length > 0 ? { warnings } : {}),
250
+ next_steps: [
251
+ { tool: 'ocr_image_get', description: 'View image details including the new description' },
252
+ { tool: 'ocr_image_search', description: 'Search for similar images (mode=semantic for meaning-based)' },
253
+ ],
254
+ }));
255
+ }); // end withDatabaseOperation
256
+ }
257
+ catch (error) {
258
+ return handleError(error);
259
+ }
260
+ }
261
+ /**
262
+ * Handle ocr_vlm_process - Process VLM on a single document or all pending images
263
+ *
264
+ * If document_id is provided, processes all images in that document.
265
+ * If document_id is omitted, processes all pending images across all documents.
266
+ */
267
+ export async function handleVLMProcess(params) {
268
+ try {
269
+ const input = validateInput(VLMProcessInput, params);
270
+ const documentId = input.document_id;
271
+ const batchSize = input.batch_size ?? 5;
272
+ const limit = input.limit ?? 50;
273
+ return await withDatabaseOperation(async () => {
274
+ const { db, vector } = requireDatabase();
275
+ const conn = db.getConnection();
276
+ if (documentId) {
277
+ // Single document mode
278
+ const doc = db.getDocument(documentId);
279
+ if (!doc) {
280
+ throw new MCPError('DOCUMENT_NOT_FOUND', `Document not found: ${documentId}`, {
281
+ document_id: documentId,
282
+ });
283
+ }
284
+ const pipeline = new VLMPipeline(conn, {
285
+ config: {
286
+ batchSize,
287
+ concurrency: 5,
288
+ minConfidence: 0.5,
289
+ skipEmbeddings: false,
290
+ skipProvenance: false,
291
+ },
292
+ dbService: db,
293
+ vectorService: vector,
294
+ });
295
+ const result = await pipeline.processDocument(documentId);
296
+ const responseData = {
297
+ mode: 'document',
298
+ document_id: documentId,
299
+ total: result.total,
300
+ successful: result.successful,
301
+ failed: result.failed,
302
+ total_tokens: result.totalTokens,
303
+ processing_time_ms: result.totalTimeMs,
304
+ results: result.results.map((r) => ({
305
+ image_id: r.imageId,
306
+ success: r.success,
307
+ confidence: r.confidence,
308
+ tokens_used: r.tokensUsed,
309
+ error: r.error,
310
+ })),
311
+ next_steps: [
312
+ { tool: 'ocr_image_list', description: 'Browse all images for this document' },
313
+ { tool: 'ocr_vlm_status', description: 'Check VLM service health' },
314
+ ],
315
+ };
316
+ return formatResponse(successResult(responseData));
317
+ }
318
+ else {
319
+ // All pending mode
320
+ const pipeline = new VLMPipeline(conn, {
321
+ config: {
322
+ batchSize,
323
+ concurrency: 5,
324
+ minConfidence: 0.5,
325
+ skipEmbeddings: false,
326
+ skipProvenance: false,
327
+ },
328
+ dbService: db,
329
+ vectorService: vector,
330
+ });
331
+ const result = await pipeline.processPending(limit);
332
+ const responseData = {
333
+ mode: 'pending',
334
+ processed: result.total,
335
+ successful: result.successful,
336
+ failed: result.failed,
337
+ total_tokens: result.totalTokens,
338
+ processing_time_ms: result.totalTimeMs,
339
+ next_steps: [
340
+ { tool: 'ocr_document_list', description: 'Browse all documents in the database' },
341
+ { tool: 'ocr_vlm_status', description: 'Check VLM service health' },
342
+ ],
343
+ };
344
+ return formatResponse(successResult(responseData));
345
+ }
346
+ }); // end withDatabaseOperation
347
+ }
348
+ catch (error) {
349
+ return handleError(error);
350
+ }
351
+ }
352
+ /**
353
+ * Handle ocr_vlm_analyze_pdf - Analyze a PDF document directly with Gemini 3
354
+ */
355
+ export async function handleVLMAnalyzePDF(params) {
356
+ try {
357
+ const input = validateInput(VLMAnalyzePDFInput, params);
358
+ const pdfPath = sanitizePath(input.pdf_path);
359
+ const prompt = input.prompt;
360
+ // Validate PDF path exists
361
+ if (!fs.existsSync(pdfPath)) {
362
+ throw new MCPError('PATH_NOT_FOUND', `PDF file not found: ${pdfPath}`, { pdf_path: pdfPath });
363
+ }
364
+ // Check file size (max 20MB for Gemini)
365
+ const stats = fs.statSync(pdfPath);
366
+ if (stats.size > 20 * 1024 * 1024) {
367
+ throw new MCPError('VALIDATION_ERROR', `PDF file exceeds 20MB Gemini limit: ${(stats.size / 1024 / 1024).toFixed(2)}MB`, { pdf_path: pdfPath, size_mb: stats.size / 1024 / 1024 });
368
+ }
369
+ const client = getSharedClient();
370
+ const fileRef = GeminiClient.fileRefFromPath(pdfPath);
371
+ const defaultPrompt = `Analyze this legal/medical document. Provide:
372
+ 1. Document type and purpose
373
+ 2. Key information (names, dates, identifiers)
374
+ 3. Summary of content
375
+ 4. Any notable findings
376
+
377
+ Return as JSON with fields: documentType, summary, keyDates, keyNames, findings`;
378
+ const response = await client.analyzePDF(prompt || defaultPrompt, fileRef);
379
+ return formatResponse(successResult({
380
+ pdf_path: pdfPath,
381
+ analysis: response.text,
382
+ model: response.model,
383
+ processing_time_ms: response.processingTimeMs,
384
+ tokens_used: response.usage.totalTokens,
385
+ input_tokens: response.usage.inputTokens,
386
+ output_tokens: response.usage.outputTokens,
387
+ next_steps: [
388
+ { tool: 'ocr_ingest_files', description: 'Ingest the PDF for full OCR pipeline processing' },
389
+ ],
390
+ }));
391
+ }
392
+ catch (error) {
393
+ return handleError(error);
394
+ }
395
+ }
396
+ /**
397
+ * Handle ocr_vlm_status - Get VLM service status and statistics
398
+ */
399
+ export async function handleVLMStatus(params) {
400
+ try {
401
+ validateInput(VLMStatusInput, params);
402
+ const vlm = getVLMService();
403
+ const status = vlm.getStatus();
404
+ // Check if GEMINI_API_KEY is configured
405
+ const apiKeyConfigured = !!(process.env.GEMINI_API_KEY?.trim());
406
+ return formatResponse(successResult({
407
+ api_key_configured: apiKeyConfigured,
408
+ model: status.model,
409
+ rate_limiter: {
410
+ requests_remaining: status.rateLimiter.requestsRemaining,
411
+ tokens_remaining: status.rateLimiter.tokensRemaining,
412
+ reset_in_ms: status.rateLimiter.resetInMs,
413
+ },
414
+ circuit_breaker: {
415
+ state: status.circuitBreaker.state,
416
+ failure_count: status.circuitBreaker.failureCount,
417
+ time_to_recovery: status.circuitBreaker.timeToRecovery,
418
+ },
419
+ next_steps: [
420
+ { tool: 'ocr_vlm_process', description: 'Process pending VLM images' },
421
+ { tool: 'ocr_image_pending', description: 'List images awaiting VLM processing' },
422
+ { tool: 'ocr_vlm_analyze_pdf', description: 'Analyze a PDF directly with Gemini AI' },
423
+ ],
424
+ }));
425
+ }
426
+ catch (error) {
427
+ return handleError(error);
428
+ }
429
+ }
430
+ // ═══════════════════════════════════════════════════════════════════════════════
431
+ // TOOL DEFINITIONS FOR MCP REGISTRATION
432
+ // ═══════════════════════════════════════════════════════════════════════════════
433
+ /**
434
+ * VLM tools collection for MCP server registration
435
+ */
436
+ export const vlmTools = {
437
+ ocr_vlm_describe: {
438
+ description: '[PROCESSING] Use to generate a detailed AI description of a single image file. Returns multi-paragraph description with optional embedding. Requires GEMINI_API_KEY.',
439
+ inputSchema: {
440
+ image_path: z.string().min(1).describe('Path to image file (PNG, JPG, JPEG, GIF, WEBP)'),
441
+ context_text: z.string().optional().describe('Surrounding text context from document'),
442
+ use_thinking: z
443
+ .boolean()
444
+ .default(false)
445
+ .describe('Use extended reasoning (thinking mode) for complex analysis'),
446
+ },
447
+ handler: handleVLMDescribe,
448
+ },
449
+ ocr_vlm_process: {
450
+ description: '[PROCESSING] Use to run VLM analysis on document images. Pass document_id for one document, omit for all pending. Requires GEMINI_API_KEY.',
451
+ inputSchema: {
452
+ document_id: z.string().optional().describe('Document ID (omit to process all pending)'),
453
+ batch_size: z.number().int().min(1).max(20).default(5).describe('Images per batch'),
454
+ limit: z.number().int().min(1).max(500).default(50).describe('Maximum images to process (pending mode only)'),
455
+ },
456
+ handler: handleVLMProcess,
457
+ },
458
+ ocr_vlm_analyze_pdf: {
459
+ description: '[PROCESSING] Use to analyze a PDF directly with Gemini 3 multimodal AI (max 20MB). Returns AI analysis with optional custom prompt. No database needed.',
460
+ inputSchema: {
461
+ pdf_path: z.string().min(1).describe('Path to PDF file'),
462
+ prompt: z
463
+ .string()
464
+ .optional()
465
+ .describe('Custom analysis prompt (default: general legal/medical analysis)'),
466
+ },
467
+ handler: handleVLMAnalyzePDF,
468
+ },
469
+ ocr_vlm_status: {
470
+ description: '[STATUS] Use to check VLM service health (API config, rate limits, circuit breaker state). Returns service status. Use to diagnose VLM failures.',
471
+ inputSchema: {},
472
+ handler: handleVLMStatus,
473
+ },
474
+ };
475
+ //# sourceMappingURL=vlm.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vlm.js","sourceRoot":"","sources":["../../src/tools/vlm.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Workflow and Approval Chain Tools
3
+ *
4
+ * Provides 8 MCP tools for document workflow state management and
5
+ * multi-step approval chains:
6
+ * - ocr_workflow_submit/review/assign/status/queue (5 workflow tools)
7
+ * - ocr_approval_chain_create/apply (2 approval chain tools)
8
+ * - ocr_approval_step_decide (1 approval step tool)
9
+ *
10
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
11
+ *
12
+ * @module tools/workflow
13
+ */
14
+ import { type ToolDefinition } from './shared.js';
15
+ export declare const workflowTools: Record<string, ToolDefinition>;
16
+ //# sourceMappingURL=workflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/tools/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAkD,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AA0iBlG,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA+FxD,CAAC"}