agent-knowledge 2.0.0 → 3.1.1

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 (129) hide show
  1. package/CHANGELOG.md +59 -0
  2. package/README.md +35 -32
  3. package/dist/embeddings/local.d.ts.map +1 -1
  4. package/dist/embeddings/local.js +3 -1
  5. package/dist/embeddings/local.js.map +1 -1
  6. package/dist/events.d.ts +6 -0
  7. package/dist/events.d.ts.map +1 -1
  8. package/dist/events.js +10 -2
  9. package/dist/events.js.map +1 -1
  10. package/dist/index.js +12 -0
  11. package/dist/index.js.map +1 -1
  12. package/dist/knowledge/analyze.d.ts.map +1 -1
  13. package/dist/knowledge/analyze.js +18 -11
  14. package/dist/knowledge/analyze.js.map +1 -1
  15. package/dist/knowledge/distill.d.ts.map +1 -1
  16. package/dist/knowledge/distill.js +28 -16
  17. package/dist/knowledge/distill.js.map +1 -1
  18. package/dist/knowledge/git.d.ts +3 -4
  19. package/dist/knowledge/git.d.ts.map +1 -1
  20. package/dist/knowledge/git.js +60 -46
  21. package/dist/knowledge/git.js.map +1 -1
  22. package/dist/knowledge/graph.d.ts +2 -0
  23. package/dist/knowledge/graph.d.ts.map +1 -1
  24. package/dist/knowledge/graph.js +8 -0
  25. package/dist/knowledge/graph.js.map +1 -1
  26. package/dist/knowledge/ingest-freshness.d.ts +22 -0
  27. package/dist/knowledge/ingest-freshness.d.ts.map +1 -0
  28. package/dist/knowledge/ingest-freshness.js +93 -0
  29. package/dist/knowledge/ingest-freshness.js.map +1 -0
  30. package/dist/knowledge/remove.d.ts +11 -0
  31. package/dist/knowledge/remove.d.ts.map +1 -0
  32. package/dist/knowledge/remove.js +24 -0
  33. package/dist/knowledge/remove.js.map +1 -0
  34. package/dist/knowledge/search.d.ts +74 -8
  35. package/dist/knowledge/search.d.ts.map +1 -1
  36. package/dist/knowledge/search.js +321 -40
  37. package/dist/knowledge/search.js.map +1 -1
  38. package/dist/knowledge/similar.d.ts +7 -0
  39. package/dist/knowledge/similar.d.ts.map +1 -0
  40. package/dist/knowledge/similar.js +51 -0
  41. package/dist/knowledge/similar.js.map +1 -0
  42. package/dist/knowledge/store.d.ts +17 -0
  43. package/dist/knowledge/store.d.ts.map +1 -1
  44. package/dist/knowledge/store.js +117 -79
  45. package/dist/knowledge/store.js.map +1 -1
  46. package/dist/rest-server.d.ts +12 -2
  47. package/dist/rest-server.d.ts.map +1 -1
  48. package/dist/rest-server.js +75 -10
  49. package/dist/rest-server.js.map +1 -1
  50. package/dist/search/bm25.d.ts +8 -0
  51. package/dist/search/bm25.d.ts.map +1 -1
  52. package/dist/search/bm25.js +32 -20
  53. package/dist/search/bm25.js.map +1 -1
  54. package/dist/search/excerpt.d.ts +1 -1
  55. package/dist/search/excerpt.d.ts.map +1 -1
  56. package/dist/search/excerpt.js +19 -1
  57. package/dist/search/excerpt.js.map +1 -1
  58. package/dist/search/lexicon.d.ts +37 -0
  59. package/dist/search/lexicon.d.ts.map +1 -0
  60. package/dist/search/lexicon.js +83 -0
  61. package/dist/search/lexicon.js.map +1 -0
  62. package/dist/search/mmr.d.ts +9 -3
  63. package/dist/search/mmr.d.ts.map +1 -1
  64. package/dist/search/mmr.js +21 -7
  65. package/dist/search/mmr.js.map +1 -1
  66. package/dist/search/types.d.ts +2 -0
  67. package/dist/search/types.d.ts.map +1 -1
  68. package/dist/server.d.ts.map +1 -1
  69. package/dist/server.js +0 -5
  70. package/dist/server.js.map +1 -1
  71. package/dist/sessions/human.d.ts +12 -0
  72. package/dist/sessions/human.d.ts.map +1 -0
  73. package/dist/sessions/human.js +52 -0
  74. package/dist/sessions/human.js.map +1 -0
  75. package/dist/sessions/parser.d.ts +39 -0
  76. package/dist/sessions/parser.d.ts.map +1 -1
  77. package/dist/sessions/parser.js +142 -18
  78. package/dist/sessions/parser.js.map +1 -1
  79. package/dist/sessions/search.d.ts +2 -0
  80. package/dist/sessions/search.d.ts.map +1 -1
  81. package/dist/sessions/search.js +147 -67
  82. package/dist/sessions/search.js.map +1 -1
  83. package/dist/sessions/snapshot.d.ts +19 -0
  84. package/dist/sessions/snapshot.d.ts.map +1 -0
  85. package/dist/sessions/snapshot.js +118 -0
  86. package/dist/sessions/snapshot.js.map +1 -0
  87. package/dist/sessions/summary.d.ts +24 -5
  88. package/dist/sessions/summary.d.ts.map +1 -1
  89. package/dist/sessions/summary.js +106 -145
  90. package/dist/sessions/summary.js.map +1 -1
  91. package/dist/slice.d.ts +5 -0
  92. package/dist/slice.d.ts.map +1 -0
  93. package/dist/slice.js +28 -0
  94. package/dist/slice.js.map +1 -0
  95. package/dist/text.d.ts +9 -0
  96. package/dist/text.d.ts.map +1 -0
  97. package/dist/text.js +16 -0
  98. package/dist/text.js.map +1 -0
  99. package/dist/tool-handlers.d.ts.map +1 -1
  100. package/dist/tool-handlers.js +6 -10
  101. package/dist/tool-handlers.js.map +1 -1
  102. package/dist/transport/rest.d.ts.map +1 -1
  103. package/dist/transport/rest.js +152 -35
  104. package/dist/transport/rest.js.map +1 -1
  105. package/dist/vectorstore/store.d.ts +9 -0
  106. package/dist/vectorstore/store.d.ts.map +1 -1
  107. package/dist/vectorstore/store.js +23 -0
  108. package/dist/vectorstore/store.js.map +1 -1
  109. package/dist/wakeup.d.ts +5 -0
  110. package/dist/wakeup.d.ts.map +1 -1
  111. package/dist/wakeup.js +10 -1
  112. package/dist/wakeup.js.map +1 -1
  113. package/docs/ARCHITECTURE.md +6 -9
  114. package/docs/HOOKS.md +138 -237
  115. package/docs/SETUP.md +61 -122
  116. package/docs/USER-MANUAL.md +45 -31
  117. package/package.json +6 -6
  118. package/plugin/skills/knowledge-ingest/scripts/validate.mjs +2 -2
  119. package/scripts/plugins/opencode/agent-knowledge.ts +32 -81
  120. package/scripts/setup.js +78 -145
  121. package/scripts/source-walk.d.mts +12 -0
  122. package/scripts/source-walk.mjs +94 -0
  123. package/scripts/tree-sitter-extract.mjs +10 -76
  124. package/scripts/hooks/first-prompt-inject.mjs +0 -242
  125. package/scripts/hooks/precompact-distill.mjs +0 -105
  126. package/scripts/hooks/precompact-flush.mjs +0 -192
  127. package/scripts/hooks/session-start-ingest.mjs +0 -238
  128. package/scripts/hooks/session-start.js +0 -211
  129. package/scripts/hooks/sessionend-distill.mjs +0 -198
@@ -0,0 +1,51 @@
1
+ import { getEmbeddingProvider } from '../embeddings/index.js';
2
+ import { getVectorStore } from '../sessions/indexer.js';
3
+ import { askedAbout } from './search.js';
4
+ /** How long a first prompt waits for the embedding model: a cold one is left for the next. */
5
+ const MODEL_WAIT_MS = 1_500;
6
+ /**
7
+ * The provider whose closeness the rule's dials were measured on (tests/first-prompt-eval):
8
+ * the local model. Another's cosines lie elsewhere, so it adds nothing until measured.
9
+ */
10
+ const MEASURED = 'local';
11
+ let cache = null;
12
+ /**
13
+ * How close in meaning each curated entry is to a prompt: the cosine of its closest chunk,
14
+ * from the embeddings the indexer keeps (the first-prompt rule's second judge, `similar`).
15
+ * Null without them: another provider, no entry embedded, or the model not answering in time.
16
+ */
17
+ export async function promptSimilarity(prompt, waitMs = MODEL_WAIT_MS) {
18
+ const asked = (async () => {
19
+ const provider = await getEmbeddingProvider();
20
+ if (provider?.name !== MEASURED)
21
+ return null;
22
+ return { name: provider.name, v: await provider.embedOne(askedAbout(prompt)) };
23
+ })().catch(() => null);
24
+ const got = await Promise.race([
25
+ asked,
26
+ new Promise((r) => setTimeout(() => r(null), waitMs).unref()),
27
+ ]);
28
+ if (!got || got.v.length === 0)
29
+ return null;
30
+ const { name, v } = got;
31
+ const key = `${name}:${v.length}`;
32
+ const fresh = getVectorStore().knowledgeVectors(name, v.length, cache?.key === key ? cache.stamp : undefined);
33
+ if (fresh)
34
+ cache = { key, ...fresh };
35
+ if (!cache || cache.vectors.size === 0)
36
+ return null;
37
+ const similar = new Map();
38
+ for (const [id, chunks] of cache.vectors) {
39
+ let best = -1;
40
+ for (const c of chunks) {
41
+ let dot = 0;
42
+ for (let i = 0; i < c.length; i++)
43
+ dot += c[i] * v[i];
44
+ if (dot > best)
45
+ best = dot;
46
+ }
47
+ similar.set(id, best);
48
+ }
49
+ return similar;
50
+ }
51
+ //# sourceMappingURL=similar.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"similar.js","sourceRoot":"","sources":["../../src/knowledge/similar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,8FAA8F;AAC9F,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B;;;GAGG;AACH,MAAM,QAAQ,GAAG,OAAO,CAAC;AAEzB,IAAI,KAAK,GAAgF,IAAI,CAAC;AAE9F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,MAAM,GAAG,aAAa;IAEtB,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE;QACxB,MAAM,QAAQ,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC9C,IAAI,QAAQ,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACjF,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QAC7B,KAAK;QACL,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;KACpE,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC;IACxB,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC,gBAAgB,CAC7C,IAAI,EACJ,CAAC,CAAC,MAAM,EACR,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC7C,CAAC;IACF,IAAI,KAAK;QAAE,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACzC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YACxD,IAAI,GAAG,GAAG,IAAI;gBAAE,IAAI,GAAG,GAAG,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -25,11 +25,28 @@ export interface KnowledgeEntry {
25
25
  * Shown on the entry's page in the /knowledge pane.
26
26
  */
27
27
  author?: string;
28
+ /**
29
+ * A session's record, not curated knowledge (`isSnapshot`): its category is `sessions`,
30
+ * and Browse's all, the first-prompt hits and Analyze leave it out.
31
+ */
32
+ snapshot?: boolean;
28
33
  }
34
+ /**
35
+ * Whether an entry records a session rather than knowledge: a snapshot (`sessions/`), or what
36
+ * the 2.x hooks wrote beside the curated entries: a `type` naming a session (session-end,
37
+ * precompact, …), or their file names (`projects/session-<cwd>-<id>.md`,
38
+ * `projects/precompact-<cwd>-<id>.md`, ending in the session id).
39
+ */
40
+ export declare function isSnapshot(rel: string, meta?: Record<string, string | string[]>): boolean;
29
41
  /**
30
42
  * Parse YAML-like frontmatter delimited by `---`.
31
43
  * Extracts title, tags (as array), updated, and any other simple key-value pairs.
32
44
  */
45
+ /**
46
+ * A YAML scalar as written in frontmatter, its value without the quotes: `"Task #1: x"` is
47
+ * Task #1: x (`\"`, `\\`, `\n`, `\t` unescaped), `'it''s'` is it's; a plain one as it is.
48
+ */
49
+ export declare function yamlScalar(v: string): string;
33
50
  export declare function parseFrontmatter(content: string): {
34
51
  meta: Record<string, string | string[]>;
35
52
  body: string;
@@ -1 +1 @@
1
- {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/knowledge/store.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,oEAAqE,CAAC;AAC7F,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd,CAwBA;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,EAAE,CAepE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAuD1F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA8C5C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,CA0BR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAenE"}
1
+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/knowledge/store.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,oEAAqE,CAAC;AAC7F,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAM,GAAG,OAAO,CAK7F;AAoED;;;GAGG;AACH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd,CAwBA;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,EAAE,CAepE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAsB1F;AAmBD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAa5C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,CA0BR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAQnE"}
@@ -14,10 +14,92 @@ export function sanitizePath(input) {
14
14
  }
15
15
  return input;
16
16
  }
17
+ /**
18
+ * Whether an entry records a session rather than knowledge: a snapshot (`sessions/`), or what
19
+ * the 2.x hooks wrote beside the curated entries: a `type` naming a session (session-end,
20
+ * precompact, …), or their file names (`projects/session-<cwd>-<id>.md`,
21
+ * `projects/precompact-<cwd>-<id>.md`, ending in the session id).
22
+ */
23
+ export function isSnapshot(rel, meta = {}) {
24
+ if (rel.startsWith('sessions/'))
25
+ return true;
26
+ const type = typeof meta.type === 'string' ? meta.type.toLowerCase() : '';
27
+ if (/^(?:session|pre-?compact)/.test(type))
28
+ return true;
29
+ return /^projects\/(?:session|precompact)-.*[0-9a-f]{8}\.md$/i.test(rel);
30
+ }
31
+ /** The day an entry was written: its `updated`, else a date in its file name, else the file's. */
32
+ function dayOf(rel, updated, mtimeMs) {
33
+ if (updated)
34
+ return updated;
35
+ const name = rel.split('/').at(-1) ?? '';
36
+ const m = /(\d{4})-?(\d{2})-?(\d{2})/.exec(name);
37
+ if (m && Number(m[2]) >= 1 && Number(m[2]) <= 12)
38
+ return `${m[1]}-${m[2]}-${m[3]}`;
39
+ return Number.isFinite(mtimeMs) && mtimeMs > 0
40
+ ? new Date(mtimeMs).toISOString().slice(0, 10)
41
+ : '';
42
+ }
43
+ /**
44
+ * A session record's name when its file gives none (the 2.x dumps): `project · day · what`, as
45
+ * the snapshots are named. The project is its frontmatter's, its folder's (`cwd`), or the one
46
+ * the 2.x file name carries (`projects/session-C--work-repo-<id>.md` → repo).
47
+ */
48
+ function recordTitle(rel, meta, day, heading) {
49
+ const str = (k) => (typeof meta[k] === 'string' ? meta[k] : '');
50
+ const slug = /(?:^|\/)(?:session|precompact|PreCompact)-(.+?)-[0-9a-f]{8,}\.md$/i.exec(rel)?.[1];
51
+ const project = str('project') ||
52
+ str('cwd').split(/[\\/]/).filter(Boolean).at(-1) ||
53
+ (slug && !/^\d/.test(slug) ? slug.split('-').filter(Boolean).at(-1) : '') ||
54
+ rel.split('/').at(-2) ||
55
+ '';
56
+ const what = heading ||
57
+ (/pre-?compact/i.test(`${str('type')} ${rel}`) ? 'before a compaction' : 'session end');
58
+ return [project, day, what].filter(Boolean).join(' · ');
59
+ }
60
+ /**
61
+ * An entry as its file says it: the title its frontmatter gives, else its first heading, else
62
+ * its path; the day (`dayOf`); a session's record told apart (`isSnapshot`).
63
+ */
64
+ function entryOf(rel, content, mtimeMs) {
65
+ const { meta, body } = parseFrontmatter(content);
66
+ const str = (k) => (typeof meta[k] === 'string' ? meta[k] : '');
67
+ const confidenceScore = str('confidence_score') ? parseFloat(str('confidence_score')) : NaN;
68
+ const evergreen = ['true', '1'].includes(str('evergreen').toLowerCase());
69
+ const author = str('author').trim();
70
+ const snapshot = isSnapshot(rel, meta);
71
+ const heading = /^#\s+(.+?)\s*$/m.exec(body)?.[1];
72
+ const updated = dayOf(rel, str('updated'), mtimeMs);
73
+ return {
74
+ path: rel,
75
+ title: str('title') ||
76
+ (snapshot ? recordTitle(rel, meta, updated, heading) : heading) ||
77
+ rel.replace(/\.md$/, ''),
78
+ tags: Array.isArray(meta.tags) ? meta.tags : [],
79
+ updated,
80
+ category: snapshot ? 'sessions' : (rel.split('/')[0] ?? ''),
81
+ ...(str('confidence') ? { confidence: str('confidence') } : {}),
82
+ ...(!isNaN(confidenceScore) ? { confidence_score: confidenceScore } : {}),
83
+ ...(evergreen ? { evergreen } : {}),
84
+ ...(author ? { author } : {}),
85
+ ...(snapshot ? { snapshot } : {}),
86
+ };
87
+ }
17
88
  /**
18
89
  * Parse YAML-like frontmatter delimited by `---`.
19
90
  * Extracts title, tags (as array), updated, and any other simple key-value pairs.
20
91
  */
92
+ /**
93
+ * A YAML scalar as written in frontmatter, its value without the quotes: `"Task #1: x"` is
94
+ * Task #1: x (`\"`, `\\`, `\n`, `\t` unescaped), `'it''s'` is it's; a plain one as it is.
95
+ */
96
+ export function yamlScalar(v) {
97
+ if (v.length >= 2 && v.startsWith('"') && v.endsWith('"'))
98
+ return v.slice(1, -1).replace(/\\(["\\nt])/g, (_, c) => ({ n: '\n', t: '\t' })[c] ?? c);
99
+ if (v.length >= 2 && v.startsWith("'") && v.endsWith("'"))
100
+ return v.slice(1, -1).replace(/''/g, "'");
101
+ return v;
102
+ }
21
103
  export function parseFrontmatter(content) {
22
104
  // Normalize \r\n to \n for cross-platform compatibility
23
105
  const normalized = content.replace(/\r\n/g, '\n');
@@ -28,16 +110,16 @@ export function parseFrontmatter(content) {
28
110
  for (const line of match[1].split('\n')) {
29
111
  const m = line.match(/^(\w+):\s*(.+)$/);
30
112
  if (m) {
31
- let val = m[2].trim();
32
- // Parse inline arrays like [tag1, tag2, tag3]
33
- if (val.startsWith('[') && val.endsWith(']')) {
34
- val = val
35
- .slice(1, -1)
36
- .split(',')
37
- .map((s) => s.trim())
38
- .filter((s) => s.length > 0);
39
- }
40
- meta[m[1]] = val;
113
+ const raw = m[2].trim();
114
+ // Inline arrays like [tag1, "tag 2", 'tag3']
115
+ meta[m[1]] =
116
+ raw.startsWith('[') && raw.endsWith(']')
117
+ ? raw
118
+ .slice(1, -1)
119
+ .split(',')
120
+ .map((s) => yamlScalar(s.trim()))
121
+ .filter((s) => s.length > 0)
122
+ : yamlScalar(raw);
41
123
  }
42
124
  }
43
125
  return { meta, body: match[2] };
@@ -65,45 +147,15 @@ export function getAllFiles(dir, base = '') {
65
147
  */
66
148
  export function listEntries(dir, category, tag) {
67
149
  const searchDir = category ? path.join(dir, category) : dir;
68
- const basePrefix = category || '';
69
- const files = getAllFiles(searchDir, basePrefix);
150
+ const files = getAllFiles(searchDir, category || '');
70
151
  const entries = [];
71
152
  for (const file of files) {
72
153
  const fullPath = path.join(dir, file);
73
154
  try {
74
- const content = fs.readFileSync(fullPath, 'utf-8');
75
- const { meta } = parseFrontmatter(content);
76
- // Filter by tag if specified
77
- if (tag) {
78
- const tags = Array.isArray(meta.tags) ? meta.tags : [];
79
- if (!tags.some((t) => t.toLowerCase() === tag.toLowerCase())) {
80
- continue;
81
- }
82
- }
83
- // Derive category from the first path segment
84
- const [entryCategory = ''] = file.split('/');
85
- const confidence = typeof meta.confidence === 'string' ? meta.confidence : undefined;
86
- const confidenceScore = typeof meta.confidence_score === 'string' ? parseFloat(meta.confidence_score) : undefined;
87
- const evergreenRaw = typeof meta.evergreen === 'string' ? meta.evergreen : undefined;
88
- const evergreen = evergreenRaw
89
- ? evergreenRaw.toLowerCase() === 'true' || evergreenRaw === '1'
90
- : undefined;
91
- const author = typeof meta.author === 'string' && meta.author.trim().length > 0
92
- ? meta.author.trim()
93
- : undefined;
94
- entries.push({
95
- path: file,
96
- title: (typeof meta.title === 'string' ? meta.title : '') || file.replace(/\.md$/, ''),
97
- tags: Array.isArray(meta.tags) ? meta.tags : [],
98
- updated: (typeof meta.updated === 'string' ? meta.updated : '') || '',
99
- category: entryCategory,
100
- ...(confidence ? { confidence } : {}),
101
- ...(confidenceScore !== undefined && !isNaN(confidenceScore)
102
- ? { confidence_score: confidenceScore }
103
- : {}),
104
- ...(evergreen ? { evergreen } : {}),
105
- ...(author ? { author } : {}),
106
- });
155
+ const entry = entryOf(file, fs.readFileSync(fullPath, 'utf-8'), fs.statSync(fullPath).mtimeMs);
156
+ if (tag && !entry.tags.some((t) => t.toLowerCase() === tag.toLowerCase()))
157
+ continue;
158
+ entries.push(entry);
107
159
  }
108
160
  catch (err) {
109
161
  console.error('[knowledge] list entry:', err instanceof Error ? err.message : err);
@@ -113,44 +165,35 @@ export function listEntries(dir, category, tag) {
113
165
  return entries;
114
166
  }
115
167
  /**
116
- * Read a specific entry by its relative path.
117
- * Includes path traversal protection.
168
+ * The file of the entry at `entryPath` under `dir`. Throws for anything that is no entry, as
169
+ * getAllFiles lists them: a path out of `dir`, a file that is not `.md`, a hidden file or one
170
+ * in a hidden folder (`.git/config`, `.identity-declined`).
118
171
  */
119
- export function readEntry(dir, entryPath) {
172
+ function entryFile(dir, entryPath) {
120
173
  sanitizePath(entryPath);
121
174
  const filePath = path.resolve(dir, entryPath);
122
- // Path traversal protection
123
- if (!filePath.startsWith(path.resolve(dir))) {
175
+ const root = path.resolve(dir);
176
+ if (!filePath.startsWith(root + path.sep))
124
177
  throw new Error('Path traversal not allowed');
178
+ const parts = path.relative(root, filePath).split(path.sep);
179
+ if (!filePath.endsWith('.md') || parts.some((p) => p.startsWith('.'))) {
180
+ throw new Error(`Not a knowledge entry: ${entryPath}`);
125
181
  }
182
+ return filePath;
183
+ }
184
+ /**
185
+ * Read a specific entry by its relative path.
186
+ * Includes path traversal protection.
187
+ */
188
+ export function readEntry(dir, entryPath) {
189
+ const filePath = entryFile(dir, entryPath);
126
190
  if (!fs.existsSync(filePath)) {
127
191
  throw new Error(`File not found: ${entryPath}`);
128
192
  }
129
193
  const content = fs.readFileSync(filePath, 'utf-8');
130
- const { meta, body } = parseFrontmatter(content);
131
- const [entryCategory = ''] = entryPath.split('/');
132
- const confidence = typeof meta.confidence === 'string' ? meta.confidence : undefined;
133
- const confidenceScore = typeof meta.confidence_score === 'string' ? parseFloat(meta.confidence_score) : undefined;
134
- const evergreenRaw = typeof meta.evergreen === 'string' ? meta.evergreen : undefined;
135
- const evergreen = evergreenRaw
136
- ? evergreenRaw.toLowerCase() === 'true' || evergreenRaw === '1'
137
- : undefined;
138
- const author = typeof meta.author === 'string' && meta.author.trim().length > 0
139
- ? meta.author.trim()
140
- : undefined;
141
194
  const entry = {
142
- path: entryPath,
143
- title: (typeof meta.title === 'string' ? meta.title : '') || entryPath.replace(/\.md$/, ''),
144
- tags: Array.isArray(meta.tags) ? meta.tags : [],
145
- updated: (typeof meta.updated === 'string' ? meta.updated : '') || '',
146
- category: entryCategory,
147
- content: body,
148
- ...(confidence ? { confidence } : {}),
149
- ...(confidenceScore !== undefined && !isNaN(confidenceScore)
150
- ? { confidence_score: confidenceScore }
151
- : {}),
152
- ...(evergreen ? { evergreen } : {}),
153
- ...(author ? { author } : {}),
195
+ ...entryOf(entryPath, content, fs.statSync(filePath).mtimeMs),
196
+ content: parseFrontmatter(content).body,
154
197
  };
155
198
  return { entry, content };
156
199
  }
@@ -186,12 +229,7 @@ export function writeEntry(dir, category, filename, content) {
186
229
  * Returns true if the file was deleted, false if it didn't exist.
187
230
  */
188
231
  export function deleteEntry(dir, entryPath) {
189
- sanitizePath(entryPath);
190
- const filePath = path.resolve(dir, entryPath);
191
- // Path traversal protection
192
- if (!filePath.startsWith(path.resolve(dir))) {
193
- throw new Error('Path traversal not allowed');
194
- }
232
+ const filePath = entryFile(dir, entryPath);
195
233
  if (!fs.existsSync(filePath)) {
196
234
  return false;
197
235
  }
@@ -1 +1 @@
1
- {"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/knowledge/store.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/knowledge/store.ts"],"names":[],"mappings":"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"}
@@ -3,6 +3,8 @@ export declare const DEFAULT_PORT = 3423;
3
3
  export interface RestServer {
4
4
  httpServer: Server;
5
5
  port: number;
6
+ /** Where it answers: its bound address (loopback for an unspecified one) and port. */
7
+ url: string;
6
8
  close(): void;
7
9
  }
8
10
  /** Listens on `port` (0 picks a free one); rejects with code EADDRINUSE when it is taken. */
@@ -12,10 +14,18 @@ export interface RestLeader {
12
14
  readonly server: RestServer | null;
13
15
  close(): void;
14
16
  }
17
+ export interface LeaderOptions {
18
+ /** How often the holder asks itself for /health. */
19
+ watchMs?: number;
20
+ /** Whether the server at `url` answers; the default asks /health with a 5 s timeout. */
21
+ probe?: (url: string) => Promise<boolean>;
22
+ }
15
23
  /**
16
24
  * Serves REST on `port` from whichever process holds it. A process that finds the port
17
25
  * taken tries again every `retryMs`, so the pane stays up when the serving one exits.
18
- * `onServe` runs once, when this process starts serving.
26
+ * The holder checks itself every `watchMs`: two checks in a row without an answer close
27
+ * its listener and it binds again (or, when another process took the port meanwhile,
28
+ * waits like any other). `onServe` runs once, when this process first starts serving.
19
29
  */
20
- export declare function serveRestWhenFree(port: number, retryMs?: number, onServe?: () => void): RestLeader;
30
+ export declare function serveRestWhenFree(port: number, retryMs?: number, onServe?: () => void, { watchMs, probe }?: LeaderOptions): RestLeader;
21
31
  //# sourceMappingURL=rest-server.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"rest-server.d.ts","sourceRoot":"","sources":["../src/rest-server.ts"],"names":[],"mappings":"AAUA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAMtD,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;CACf;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,IAAI,SAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBxE;AAED,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,SAAQ,EACf,OAAO,GAAE,MAAM,IAAe,GAC7B,UAAU,CAkCZ"}
1
+ {"version":3,"file":"rest-server.d.ts","sourceRoot":"","sources":["../src/rest-server.ts"],"names":[],"mappings":"AAaA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAMtD,eAAO,MAAM,YAAY,OAAO,CAAC;AAGjC,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,IAAI,CAAC;CACf;AAQD,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,IAAI,SAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAgCxE;AAED,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAgBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,SAAQ,EACf,OAAO,GAAE,MAAM,IAAe,EAC9B,EAAE,OAAgB,EAAE,KAAe,EAAE,GAAE,aAAkB,GACxD,UAAU,CA8DZ"}
@@ -1,17 +1,26 @@
1
1
  // =============================================================================
2
2
  // agent-knowledge — REST server
3
3
  //
4
- // The local REST API the Claude Code /knowledge pane, the hook scripts, the
5
- // opencode plugin and agent-tasks call. One process serves it: the first to
6
- // bind the port; the others retry, so one of them takes over when the serving
7
- // process exits. Binds 127.0.0.1 (AGENT_KNOWLEDGE_HOST overrides) and runs
8
- // every request through the request guard.
4
+ // The local REST API the Claude Code plugin (the /knowledge pane and the
5
+ // session lifecycle), the opencode plugin and agent-tasks call. One process
6
+ // serves it: the first to bind the port; the others retry, so one of them
7
+ // takes over when the serving process exits. The serving process asks itself
8
+ // for /health now and then and, when it gets no answer, lets the port go and
9
+ // binds it again, so a listener that stopped accepting never holds the port.
10
+ // Binds 127.0.0.1 (AGENT_KNOWLEDGE_HOST overrides) and runs every request
11
+ // through the request guard.
9
12
  // =============================================================================
10
13
  import { createServer } from 'node:http';
11
14
  import { createRequestGuard } from './transport/guard.js';
12
15
  import { json } from './transport/http.js';
13
16
  import { createRouter } from './transport/rest.js';
14
17
  export const DEFAULT_PORT = 3423;
18
+ const KEEP_ALIVE_MS = 65_000;
19
+ /** The address a bound server answers on; `0.0.0.0` and `::` answer on loopback. */
20
+ function urlOf({ address, family, port }) {
21
+ const host = address === '0.0.0.0' ? '127.0.0.1' : address === '::' ? '::1' : address;
22
+ return `http://${family === 'IPv6' ? `[${host}]` : host}:${port}`;
23
+ }
15
24
  /** Listens on `port` (0 picks a free one); rejects with code EADDRINUSE when it is taken. */
16
25
  export function startRestServer(port = DEFAULT_PORT) {
17
26
  const host = process.env.AGENT_KNOWLEDGE_HOST || '127.0.0.1';
@@ -25,31 +34,85 @@ export function startRestServer(port = DEFAULT_PORT) {
25
34
  json(res, { error: 'Internal server error' }, 500);
26
35
  });
27
36
  });
37
+ // An idle connection is kept well past the pane's 5 s poll: at Node's default (5 s) the server
38
+ // closes it just as a client reuses it, and that request is reset (ECONNRESET).
39
+ httpServer.keepAliveTimeout = KEEP_ALIVE_MS;
40
+ httpServer.headersTimeout = KEEP_ALIVE_MS + 1_000;
28
41
  return new Promise((resolve, reject) => {
29
42
  httpServer.once('error', reject);
30
43
  httpServer.listen(port, host, () => {
31
- const bound = httpServer.address().port;
44
+ const address = httpServer.address();
45
+ const bound = address.port;
32
46
  guard = createRequestGuard(bound, host);
33
47
  process.stderr.write(`agent-knowledge REST API: http://localhost:${bound}\n`);
34
- resolve({ httpServer, port: bound, close: () => httpServer.close() });
48
+ resolve({
49
+ httpServer,
50
+ port: bound,
51
+ url: urlOf(address),
52
+ close: () => {
53
+ httpServer.close();
54
+ httpServer.closeAllConnections();
55
+ },
56
+ });
35
57
  });
36
58
  });
37
59
  }
60
+ /** Unanswered self-checks in a row after which the holder lets the port go. */
61
+ const STRIKES = 2;
62
+ async function answers(url) {
63
+ try {
64
+ const res = await fetch(`${url}/health`, {
65
+ signal: AbortSignal.timeout(5_000),
66
+ });
67
+ return res.ok;
68
+ }
69
+ catch {
70
+ return false;
71
+ }
72
+ }
38
73
  /**
39
74
  * Serves REST on `port` from whichever process holds it. A process that finds the port
40
75
  * taken tries again every `retryMs`, so the pane stays up when the serving one exits.
41
- * `onServe` runs once, when this process starts serving.
76
+ * The holder checks itself every `watchMs`: two checks in a row without an answer close
77
+ * its listener and it binds again (or, when another process took the port meanwhile,
78
+ * waits like any other). `onServe` runs once, when this process first starts serving.
42
79
  */
43
- export function serveRestWhenFree(port, retryMs = 5_000, onServe = () => { }) {
80
+ export function serveRestWhenFree(port, retryMs = 5_000, onServe = () => { }, { watchMs = 30_000, probe = answers } = {}) {
44
81
  let server = null;
45
82
  let timer = null;
83
+ let watch = null;
46
84
  let isClosed = false;
85
+ let hasServed = false;
86
+ let misses = 0;
87
+ const check = async () => {
88
+ const s = server;
89
+ if (!s || isClosed)
90
+ return;
91
+ if (await probe(s.url)) {
92
+ misses = 0;
93
+ return;
94
+ }
95
+ if (++misses < STRIKES || server !== s)
96
+ return;
97
+ process.stderr.write(`[knowledge] REST server on ${s.port} stopped answering: letting the port go\n`);
98
+ misses = 0;
99
+ server = null;
100
+ if (watch)
101
+ clearInterval(watch);
102
+ s.close();
103
+ attempt();
104
+ };
47
105
  const attempt = () => {
48
106
  startRestServer(port).then((s) => {
49
107
  if (isClosed)
50
108
  return s.close();
51
109
  server = s;
52
- onServe();
110
+ watch = setInterval(() => void check(), watchMs);
111
+ watch.unref();
112
+ if (!hasServed) {
113
+ hasServed = true;
114
+ onServe();
115
+ }
53
116
  }, (err) => {
54
117
  if (isClosed)
55
118
  return;
@@ -70,6 +133,8 @@ export function serveRestWhenFree(port, retryMs = 5_000, onServe = () => { }) {
70
133
  isClosed = true;
71
134
  if (timer)
72
135
  clearTimeout(timer);
136
+ if (watch)
137
+ clearInterval(watch);
73
138
  server?.close();
74
139
  },
75
140
  };
@@ -1 +1 @@
1
- {"version":3,"file":"rest-server.js","sourceRoot":"","sources":["../src/rest-server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"rest-server.js","sourceRoot":"","sources":["../src/rest-server.ts"],"names":[],"mappings":"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"}
@@ -5,6 +5,8 @@
5
5
  * swap rankers via configuration. Tokenizer + stopword list match
6
6
  * tfidf.ts so the two rankers are directly comparable on the same corpus.
7
7
  */
8
+ /** The words of `text` the index ranks on: lowercase, stopwords left out. */
9
+ export declare function tokenize(text: string): string[];
8
10
  export interface BM25Options {
9
11
  k1?: number;
10
12
  b?: number;
@@ -19,6 +21,12 @@ export declare class BM25Index {
19
21
  private readonly b;
20
22
  constructor(opts?: BM25Options);
21
23
  addDocument(id: string, text: string): void;
24
+ /** Takes a document out of the index; nothing when it is not in it. */
25
+ removeDocument(id: string): void;
26
+ /** BM25 IDF (Robertson-Sparck-Jones, with +1 to avoid negatives) of a term in `df` documents. */
27
+ private idf;
28
+ /** Whether the document holds the term. */
29
+ has(id: string, term: string): boolean;
22
30
  search(query: string, maxResults?: number): Array<{
23
31
  id: string;
24
32
  score: number;
@@ -1 +1 @@
1
- {"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkIH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;gBAEf,IAAI,GAAE,WAAgB;IAKlC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAqC3C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAgChF,KAAK,IAAI,IAAI;CAOd"}
1
+ {"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../src/search/bm25.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsHH,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAOD,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;gBAEf,IAAI,GAAE,WAAgB;IAKlC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAsB3C,uEAAuE;IACvE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAkBhC,iGAAiG;IACjG,OAAO,CAAC,GAAG;IAIX,2CAA2C;IAC3C,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAItC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA8BhF,KAAK,IAAI,IAAI;CAOd"}