agent-knowledge 1.7.3 → 1.8.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.
- package/.claude-plugin/plugin.json +1 -1
- package/.mcp.json +1 -1
- package/CHANGELOG.md +101 -0
- package/README.md +43 -18
- package/agent-desk-plugin.json +1 -1
- package/dist/dashboard.d.ts.map +1 -1
- package/dist/dashboard.js +28 -1
- package/dist/dashboard.js.map +1 -1
- package/dist/knowledge/analyze.d.ts +18 -0
- package/dist/knowledge/analyze.d.ts.map +1 -1
- package/dist/knowledge/analyze.js +22 -0
- package/dist/knowledge/analyze.js.map +1 -1
- package/dist/knowledge/freshness.d.ts +99 -0
- package/dist/knowledge/freshness.d.ts.map +1 -0
- package/dist/knowledge/freshness.js +303 -0
- package/dist/knowledge/freshness.js.map +1 -0
- package/dist/knowledge/promote.d.ts +145 -0
- package/dist/knowledge/promote.d.ts.map +1 -0
- package/dist/knowledge/promote.js +532 -0
- package/dist/knowledge/promote.js.map +1 -0
- package/dist/knowledge/query-log.d.ts +88 -0
- package/dist/knowledge/query-log.d.ts.map +1 -0
- package/dist/knowledge/query-log.js +207 -0
- package/dist/knowledge/query-log.js.map +1 -0
- package/dist/knowledge/scoring.d.ts +22 -2
- package/dist/knowledge/scoring.d.ts.map +1 -1
- package/dist/knowledge/scoring.js +51 -3
- package/dist/knowledge/scoring.js.map +1 -1
- package/dist/knowledge/search.d.ts +56 -5
- package/dist/knowledge/search.d.ts.map +1 -1
- package/dist/knowledge/search.js +88 -10
- package/dist/knowledge/search.js.map +1 -1
- package/dist/knowledge/store.d.ts +12 -0
- package/dist/knowledge/store.d.ts.map +1 -1
- package/dist/knowledge/store.js +18 -0
- package/dist/knowledge/store.js.map +1 -1
- package/dist/search/mmr.d.ts +54 -0
- package/dist/search/mmr.d.ts.map +1 -0
- package/dist/search/mmr.js +138 -0
- package/dist/search/mmr.js.map +1 -0
- package/dist/server.d.ts +334 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +378 -301
- package/dist/server.js.map +1 -1
- package/dist/sessions/indexer.d.ts.map +1 -1
- package/dist/sessions/indexer.js +13 -11
- package/dist/sessions/indexer.js.map +1 -1
- package/dist/tool-handlers.d.ts +10 -3
- package/dist/tool-handlers.d.ts.map +1 -1
- package/dist/tool-handlers.js +150 -21
- package/dist/tool-handlers.js.map +1 -1
- package/dist/ui/app.js +271 -1
- package/dist/ui/render-knowledge.js +3 -3
- package/dist/ui/styles.css +209 -0
- package/dist/wakeup.d.ts +59 -14
- package/dist/wakeup.d.ts.map +1 -1
- package/dist/wakeup.js +406 -43
- package/dist/wakeup.js.map +1 -1
- package/docs/ARCHITECTURE.md +31 -6
- package/docs/SETUP.md +20 -8
- package/docs/USER-MANUAL.md +205 -59
- package/docs/hooks.md +81 -21
- package/package.json +4 -1
- package/scripts/hooks/first-prompt-inject.mjs +230 -0
- package/scripts/hooks/precompact-flush.mjs +89 -60
- package/scripts/hooks/session-start.js +73 -9
|
@@ -13,6 +13,18 @@ export interface KnowledgeEntry {
|
|
|
13
13
|
content?: string;
|
|
14
14
|
confidence?: string;
|
|
15
15
|
confidence_score?: number;
|
|
16
|
+
/**
|
|
17
|
+
* When true, the entry is exempt from decay in ranking (see scoring.ts)
|
|
18
|
+
* AND the promoter appends fresh activity instead of overwriting the body.
|
|
19
|
+
* Use for durable decisions / architecture / identity.
|
|
20
|
+
*/
|
|
21
|
+
evergreen?: boolean;
|
|
22
|
+
/**
|
|
23
|
+
* Optional free-form author string from frontmatter.
|
|
24
|
+
* Examples: "human", "agent:opencode", "claude-code".
|
|
25
|
+
* Surfaced in the dashboard card footer.
|
|
26
|
+
*/
|
|
27
|
+
author?: string;
|
|
16
28
|
}
|
|
17
29
|
/**
|
|
18
30
|
* Parse YAML-like frontmatter delimited by `---`.
|
|
@@ -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;
|
|
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;AAuBD;;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"}
|
package/dist/knowledge/store.js
CHANGED
|
@@ -87,6 +87,13 @@ export function listEntries(dir, category, tag) {
|
|
|
87
87
|
const [entryCategory = ''] = file.split('/');
|
|
88
88
|
const confidence = typeof meta.confidence === 'string' ? meta.confidence : undefined;
|
|
89
89
|
const confidenceScore = typeof meta.confidence_score === 'string' ? parseFloat(meta.confidence_score) : undefined;
|
|
90
|
+
const evergreenRaw = typeof meta.evergreen === 'string' ? meta.evergreen : undefined;
|
|
91
|
+
const evergreen = evergreenRaw
|
|
92
|
+
? evergreenRaw.toLowerCase() === 'true' || evergreenRaw === '1'
|
|
93
|
+
: undefined;
|
|
94
|
+
const author = typeof meta.author === 'string' && meta.author.trim().length > 0
|
|
95
|
+
? meta.author.trim()
|
|
96
|
+
: undefined;
|
|
90
97
|
entries.push({
|
|
91
98
|
path: file,
|
|
92
99
|
title: (typeof meta.title === 'string' ? meta.title : '') || file.replace(/\.md$/, ''),
|
|
@@ -97,6 +104,8 @@ export function listEntries(dir, category, tag) {
|
|
|
97
104
|
...(confidenceScore !== undefined && !isNaN(confidenceScore)
|
|
98
105
|
? { confidence_score: confidenceScore }
|
|
99
106
|
: {}),
|
|
107
|
+
...(evergreen ? { evergreen } : {}),
|
|
108
|
+
...(author ? { author } : {}),
|
|
100
109
|
});
|
|
101
110
|
}
|
|
102
111
|
catch (err) {
|
|
@@ -125,6 +134,13 @@ export function readEntry(dir, entryPath) {
|
|
|
125
134
|
const [entryCategory = ''] = entryPath.split('/');
|
|
126
135
|
const confidence = typeof meta.confidence === 'string' ? meta.confidence : undefined;
|
|
127
136
|
const confidenceScore = typeof meta.confidence_score === 'string' ? parseFloat(meta.confidence_score) : undefined;
|
|
137
|
+
const evergreenRaw = typeof meta.evergreen === 'string' ? meta.evergreen : undefined;
|
|
138
|
+
const evergreen = evergreenRaw
|
|
139
|
+
? evergreenRaw.toLowerCase() === 'true' || evergreenRaw === '1'
|
|
140
|
+
: undefined;
|
|
141
|
+
const author = typeof meta.author === 'string' && meta.author.trim().length > 0
|
|
142
|
+
? meta.author.trim()
|
|
143
|
+
: undefined;
|
|
128
144
|
const entry = {
|
|
129
145
|
path: entryPath,
|
|
130
146
|
title: (typeof meta.title === 'string' ? meta.title : '') || entryPath.replace(/\.md$/, ''),
|
|
@@ -136,6 +152,8 @@ export function readEntry(dir, entryPath) {
|
|
|
136
152
|
...(confidenceScore !== undefined && !isNaN(confidenceScore)
|
|
137
153
|
? { confidence_score: confidenceScore }
|
|
138
154
|
: {}),
|
|
155
|
+
...(evergreen ? { evergreen } : {}),
|
|
156
|
+
...(author ? { author } : {}),
|
|
139
157
|
};
|
|
140
158
|
return { entry, content };
|
|
141
159
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/knowledge/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AAG7F;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;
|
|
1
|
+
{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/knowledge/store.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Maximal Marginal Relevance re-ranking.
|
|
3
|
+
*
|
|
4
|
+
* MMR iteratively picks items that maximize relevance to the query while
|
|
5
|
+
* penalizing similarity to items already picked. Trades a little top-1
|
|
6
|
+
* relevance for diversity in the top-K — kills near-duplicate clusters in
|
|
7
|
+
* the output, which is the common failure mode of "5 hits that all say the
|
|
8
|
+
* same thing".
|
|
9
|
+
*
|
|
10
|
+
* score(c) = lambda * relevance(c) - (1 - lambda) * max_{s ∈ selected} sim(c, s)
|
|
11
|
+
*
|
|
12
|
+
* Lambda:
|
|
13
|
+
* 1.0 = pure relevance (no reranking; identity pass)
|
|
14
|
+
* 0.7 = default — mild diversification
|
|
15
|
+
* 0.0 = pure diversity — maximally spread, often drops obviously-relevant hits
|
|
16
|
+
*/
|
|
17
|
+
export interface MmrOptions<T> {
|
|
18
|
+
/** Number of items to return. Default: min(items.length, 10). */
|
|
19
|
+
k?: number;
|
|
20
|
+
/** Relevance-vs-diversity tradeoff, 0-1. Default: 0.7. */
|
|
21
|
+
lambda?: number;
|
|
22
|
+
/** Pairwise similarity fn — cosine on embeddings, Jaccard on token sets, etc. */
|
|
23
|
+
sim: (a: T, b: T) => number;
|
|
24
|
+
/** Query-relevance score for an item. Typically the retrieval ranker's score. */
|
|
25
|
+
relevance: (x: T) => number;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Re-rank items using MMR. Returns a new array (does not mutate input).
|
|
29
|
+
*
|
|
30
|
+
* The returned array has length min(items.length, k) and is sorted by pick
|
|
31
|
+
* order — first element is the highest-relevance item, subsequent elements
|
|
32
|
+
* trade relevance for novelty.
|
|
33
|
+
*/
|
|
34
|
+
export declare function rerankMMR<T>(items: readonly T[], options: MmrOptions<T>): T[];
|
|
35
|
+
/**
|
|
36
|
+
* Count distinct "clusters" in a ranked list, where items are considered in
|
|
37
|
+
* the same cluster if pairwise similarity exceeds threshold. Useful as a
|
|
38
|
+
* diversity@K metric — how many DIFFERENT things does the top-K surface?
|
|
39
|
+
*
|
|
40
|
+
* Uses simple connected-components over the similarity graph.
|
|
41
|
+
*/
|
|
42
|
+
export declare function diversityAtK<T>(items: readonly T[], sim: (a: T, b: T) => number, threshold?: number): number;
|
|
43
|
+
/**
|
|
44
|
+
* Cosine similarity for number[] embeddings. Returns 0 for zero-magnitude
|
|
45
|
+
* vectors rather than NaN, so MMR remains well-defined.
|
|
46
|
+
*/
|
|
47
|
+
export declare function cosineSim(a: readonly number[], b: readonly number[]): number;
|
|
48
|
+
/**
|
|
49
|
+
* Token-set Jaccard similarity — a cheap, embedding-free fallback for MMR.
|
|
50
|
+
* Tokenizes by whitespace/punctuation and lowercases. Good enough to catch
|
|
51
|
+
* the "same-topic near-duplicate" case when embeddings are unavailable.
|
|
52
|
+
*/
|
|
53
|
+
export declare function jaccardTokenSim(a: string, b: string): number;
|
|
54
|
+
//# sourceMappingURL=mmr.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mmr.d.ts","sourceRoot":"","sources":["../../src/search/mmr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,iEAAiE;IACjE,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;IAC5B,iFAAiF;IACjF,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAsC7E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,EAC3B,SAAS,SAAM,GACd,MAAM,CA2BR;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAa5E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAe5D"}
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Maximal Marginal Relevance re-ranking.
|
|
3
|
+
*
|
|
4
|
+
* MMR iteratively picks items that maximize relevance to the query while
|
|
5
|
+
* penalizing similarity to items already picked. Trades a little top-1
|
|
6
|
+
* relevance for diversity in the top-K — kills near-duplicate clusters in
|
|
7
|
+
* the output, which is the common failure mode of "5 hits that all say the
|
|
8
|
+
* same thing".
|
|
9
|
+
*
|
|
10
|
+
* score(c) = lambda * relevance(c) - (1 - lambda) * max_{s ∈ selected} sim(c, s)
|
|
11
|
+
*
|
|
12
|
+
* Lambda:
|
|
13
|
+
* 1.0 = pure relevance (no reranking; identity pass)
|
|
14
|
+
* 0.7 = default — mild diversification
|
|
15
|
+
* 0.0 = pure diversity — maximally spread, often drops obviously-relevant hits
|
|
16
|
+
*/
|
|
17
|
+
/**
|
|
18
|
+
* Re-rank items using MMR. Returns a new array (does not mutate input).
|
|
19
|
+
*
|
|
20
|
+
* The returned array has length min(items.length, k) and is sorted by pick
|
|
21
|
+
* order — first element is the highest-relevance item, subsequent elements
|
|
22
|
+
* trade relevance for novelty.
|
|
23
|
+
*/
|
|
24
|
+
export function rerankMMR(items, options) {
|
|
25
|
+
const { sim, relevance } = options;
|
|
26
|
+
const lambda = options.lambda ?? 0.7;
|
|
27
|
+
const k = Math.min(options.k ?? 10, items.length);
|
|
28
|
+
if (k <= 0 || items.length === 0)
|
|
29
|
+
return [];
|
|
30
|
+
// Normalize lambda for safety — clamp to [0, 1].
|
|
31
|
+
const lam = Math.max(0, Math.min(1, lambda));
|
|
32
|
+
const remaining = [...items];
|
|
33
|
+
const selected = [];
|
|
34
|
+
// Pick #1: highest relevance (same as the input ranker).
|
|
35
|
+
remaining.sort((a, b) => relevance(b) - relevance(a));
|
|
36
|
+
selected.push(remaining.shift());
|
|
37
|
+
while (selected.length < k && remaining.length > 0) {
|
|
38
|
+
let bestIdx = 0;
|
|
39
|
+
let bestScore = -Infinity;
|
|
40
|
+
for (let i = 0; i < remaining.length; i++) {
|
|
41
|
+
const candidate = remaining[i];
|
|
42
|
+
let maxSim = 0;
|
|
43
|
+
for (const s of selected) {
|
|
44
|
+
const pairSim = sim(candidate, s);
|
|
45
|
+
if (pairSim > maxSim)
|
|
46
|
+
maxSim = pairSim;
|
|
47
|
+
}
|
|
48
|
+
const score = lam * relevance(candidate) - (1 - lam) * maxSim;
|
|
49
|
+
if (score > bestScore) {
|
|
50
|
+
bestScore = score;
|
|
51
|
+
bestIdx = i;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
selected.push(remaining.splice(bestIdx, 1)[0]);
|
|
55
|
+
}
|
|
56
|
+
return selected;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Count distinct "clusters" in a ranked list, where items are considered in
|
|
60
|
+
* the same cluster if pairwise similarity exceeds threshold. Useful as a
|
|
61
|
+
* diversity@K metric — how many DIFFERENT things does the top-K surface?
|
|
62
|
+
*
|
|
63
|
+
* Uses simple connected-components over the similarity graph.
|
|
64
|
+
*/
|
|
65
|
+
export function diversityAtK(items, sim, threshold = 0.7) {
|
|
66
|
+
const n = items.length;
|
|
67
|
+
if (n === 0)
|
|
68
|
+
return 0;
|
|
69
|
+
const parent = Array.from({ length: n }, (_, i) => i);
|
|
70
|
+
function find(x) {
|
|
71
|
+
while (parent[x] !== x) {
|
|
72
|
+
parent[x] = parent[parent[x]];
|
|
73
|
+
x = parent[x];
|
|
74
|
+
}
|
|
75
|
+
return x;
|
|
76
|
+
}
|
|
77
|
+
function union(a, b) {
|
|
78
|
+
const ra = find(a);
|
|
79
|
+
const rb = find(b);
|
|
80
|
+
if (ra !== rb)
|
|
81
|
+
parent[ra] = rb;
|
|
82
|
+
}
|
|
83
|
+
for (let i = 0; i < n; i++) {
|
|
84
|
+
for (let j = i + 1; j < n; j++) {
|
|
85
|
+
if (sim(items[i], items[j]) >= threshold)
|
|
86
|
+
union(i, j);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
const roots = new Set();
|
|
90
|
+
for (let i = 0; i < n; i++)
|
|
91
|
+
roots.add(find(i));
|
|
92
|
+
return roots.size;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Cosine similarity for number[] embeddings. Returns 0 for zero-magnitude
|
|
96
|
+
* vectors rather than NaN, so MMR remains well-defined.
|
|
97
|
+
*/
|
|
98
|
+
export function cosineSim(a, b) {
|
|
99
|
+
const len = Math.min(a.length, b.length);
|
|
100
|
+
if (len === 0)
|
|
101
|
+
return 0;
|
|
102
|
+
let dot = 0;
|
|
103
|
+
let na = 0;
|
|
104
|
+
let nb = 0;
|
|
105
|
+
for (let i = 0; i < len; i++) {
|
|
106
|
+
dot += a[i] * b[i];
|
|
107
|
+
na += a[i] * a[i];
|
|
108
|
+
nb += b[i] * b[i];
|
|
109
|
+
}
|
|
110
|
+
const denom = Math.sqrt(na) * Math.sqrt(nb);
|
|
111
|
+
return denom === 0 ? 0 : dot / denom;
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Token-set Jaccard similarity — a cheap, embedding-free fallback for MMR.
|
|
115
|
+
* Tokenizes by whitespace/punctuation and lowercases. Good enough to catch
|
|
116
|
+
* the "same-topic near-duplicate" case when embeddings are unavailable.
|
|
117
|
+
*/
|
|
118
|
+
export function jaccardTokenSim(a, b) {
|
|
119
|
+
const tokenize = (s) => {
|
|
120
|
+
const out = new Set();
|
|
121
|
+
for (const tok of s.toLowerCase().split(/[\s.,;:!?()[\]{}"'<>/\\|`~@#$%^&*=+_-]+/)) {
|
|
122
|
+
if (tok.length > 2)
|
|
123
|
+
out.add(tok);
|
|
124
|
+
}
|
|
125
|
+
return out;
|
|
126
|
+
};
|
|
127
|
+
const ta = tokenize(a);
|
|
128
|
+
const tb = tokenize(b);
|
|
129
|
+
if (ta.size === 0 || tb.size === 0)
|
|
130
|
+
return 0;
|
|
131
|
+
let inter = 0;
|
|
132
|
+
for (const t of ta)
|
|
133
|
+
if (tb.has(t))
|
|
134
|
+
inter++;
|
|
135
|
+
const union = ta.size + tb.size - inter;
|
|
136
|
+
return union === 0 ? 0 : inter / union;
|
|
137
|
+
}
|
|
138
|
+
//# sourceMappingURL=mmr.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mmr.js","sourceRoot":"","sources":["../../src/search/mmr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAI,KAAmB,EAAE,OAAsB;IACtE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE5C,iDAAiD;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAE7C,MAAM,SAAS,GAAQ,CAAC,GAAG,KAAK,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAQ,EAAE,CAAC;IAEzB,yDAAyD;IACzD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC,CAAC;IAElC,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,SAAS,GAAG,CAAC,QAAQ,CAAC;QAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBAClC,IAAI,OAAO,GAAG,MAAM;oBAAE,MAAM,GAAG,OAAO,CAAC;YACzC,CAAC;YACD,MAAM,KAAK,GAAG,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC;YAC9D,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAC;gBAClB,OAAO,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAmB,EACnB,GAA2B,EAC3B,SAAS,GAAG,GAAG;IAEf,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEtB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,SAAS,IAAI,CAAC,CAAS;QACrB,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,SAAS,KAAK,CAAC,CAAS,EAAE,CAAS;QACjC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,EAAE,KAAK,EAAE;YAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS;gBAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,CAAoB,EAAE,CAAoB;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAe,EAAE;QAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,yCAAyC,CAAC,EAAE,CAAC;YACnF,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,KAAK,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC;IACxC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;AACzC,CAAC"}
|
package/dist/server.d.ts
CHANGED
|
@@ -3,5 +3,339 @@ export interface ServerOptions {
|
|
|
3
3
|
/** Only the leader instance (dashboard owner) runs background indexing. */
|
|
4
4
|
isLeader?: boolean;
|
|
5
5
|
}
|
|
6
|
+
export declare const TOOLS: readonly [{
|
|
7
|
+
name: string;
|
|
8
|
+
description: string;
|
|
9
|
+
inputSchema: {
|
|
10
|
+
type: "object";
|
|
11
|
+
properties: {
|
|
12
|
+
action: {
|
|
13
|
+
type: string;
|
|
14
|
+
enum: string[];
|
|
15
|
+
description: string;
|
|
16
|
+
};
|
|
17
|
+
token_budget: {
|
|
18
|
+
type: string;
|
|
19
|
+
description: string;
|
|
20
|
+
};
|
|
21
|
+
sections: {
|
|
22
|
+
type: string;
|
|
23
|
+
description: string;
|
|
24
|
+
};
|
|
25
|
+
section_budgets: {
|
|
26
|
+
type: string;
|
|
27
|
+
description: string;
|
|
28
|
+
additionalProperties: {
|
|
29
|
+
type: string;
|
|
30
|
+
};
|
|
31
|
+
};
|
|
32
|
+
category: {
|
|
33
|
+
type: string;
|
|
34
|
+
enum: ("projects" | "people" | "decisions" | "workflows" | "notes")[];
|
|
35
|
+
description: string;
|
|
36
|
+
};
|
|
37
|
+
tag: {
|
|
38
|
+
type: string;
|
|
39
|
+
description: string;
|
|
40
|
+
};
|
|
41
|
+
path: {
|
|
42
|
+
type: string;
|
|
43
|
+
description: string;
|
|
44
|
+
};
|
|
45
|
+
filename: {
|
|
46
|
+
type: string;
|
|
47
|
+
description: string;
|
|
48
|
+
};
|
|
49
|
+
content: {
|
|
50
|
+
type: string;
|
|
51
|
+
description: string;
|
|
52
|
+
};
|
|
53
|
+
};
|
|
54
|
+
required: string[];
|
|
55
|
+
};
|
|
56
|
+
}, {
|
|
57
|
+
name: string;
|
|
58
|
+
description: string;
|
|
59
|
+
inputSchema: {
|
|
60
|
+
type: "object";
|
|
61
|
+
properties: {
|
|
62
|
+
query: {
|
|
63
|
+
type: string;
|
|
64
|
+
description: string;
|
|
65
|
+
};
|
|
66
|
+
scope: {
|
|
67
|
+
type: string;
|
|
68
|
+
enum: ("decisions" | "all" | "errors" | "plans" | "configs" | "tools" | "files")[];
|
|
69
|
+
description: string;
|
|
70
|
+
};
|
|
71
|
+
project: {
|
|
72
|
+
type: string;
|
|
73
|
+
description: string;
|
|
74
|
+
};
|
|
75
|
+
role: {
|
|
76
|
+
type: string;
|
|
77
|
+
enum: string[];
|
|
78
|
+
description: string;
|
|
79
|
+
};
|
|
80
|
+
max_results: {
|
|
81
|
+
type: string;
|
|
82
|
+
description: string;
|
|
83
|
+
};
|
|
84
|
+
ranked: {
|
|
85
|
+
type: string;
|
|
86
|
+
description: string;
|
|
87
|
+
};
|
|
88
|
+
semantic: {
|
|
89
|
+
type: string;
|
|
90
|
+
description: string;
|
|
91
|
+
};
|
|
92
|
+
category: {
|
|
93
|
+
type: string;
|
|
94
|
+
enum: ("projects" | "people" | "decisions" | "workflows" | "notes")[];
|
|
95
|
+
description: string;
|
|
96
|
+
};
|
|
97
|
+
category_mode: {
|
|
98
|
+
type: string;
|
|
99
|
+
enum: string[];
|
|
100
|
+
description: string;
|
|
101
|
+
};
|
|
102
|
+
mmr: {
|
|
103
|
+
type: string;
|
|
104
|
+
description: string;
|
|
105
|
+
};
|
|
106
|
+
mmr_lambda: {
|
|
107
|
+
type: string;
|
|
108
|
+
description: string;
|
|
109
|
+
};
|
|
110
|
+
explain: {
|
|
111
|
+
type: string;
|
|
112
|
+
description: string;
|
|
113
|
+
};
|
|
114
|
+
};
|
|
115
|
+
required: string[];
|
|
116
|
+
};
|
|
117
|
+
}, {
|
|
118
|
+
name: string;
|
|
119
|
+
description: string;
|
|
120
|
+
inputSchema: {
|
|
121
|
+
type: "object";
|
|
122
|
+
properties: {
|
|
123
|
+
action: {
|
|
124
|
+
type: string;
|
|
125
|
+
enum: string[];
|
|
126
|
+
description: string;
|
|
127
|
+
};
|
|
128
|
+
session_id: {
|
|
129
|
+
type: string;
|
|
130
|
+
description: string;
|
|
131
|
+
};
|
|
132
|
+
project: {
|
|
133
|
+
type: string;
|
|
134
|
+
description: string;
|
|
135
|
+
};
|
|
136
|
+
include_tools: {
|
|
137
|
+
type: string;
|
|
138
|
+
description: string;
|
|
139
|
+
};
|
|
140
|
+
tail: {
|
|
141
|
+
type: string;
|
|
142
|
+
description: string;
|
|
143
|
+
};
|
|
144
|
+
limit: {
|
|
145
|
+
type: string;
|
|
146
|
+
description: string;
|
|
147
|
+
};
|
|
148
|
+
offset: {
|
|
149
|
+
type: string;
|
|
150
|
+
description: string;
|
|
151
|
+
};
|
|
152
|
+
};
|
|
153
|
+
required: string[];
|
|
154
|
+
};
|
|
155
|
+
}, {
|
|
156
|
+
name: string;
|
|
157
|
+
description: string;
|
|
158
|
+
inputSchema: {
|
|
159
|
+
type: "object";
|
|
160
|
+
properties: {
|
|
161
|
+
action: {
|
|
162
|
+
type: string;
|
|
163
|
+
enum: string[];
|
|
164
|
+
description: string;
|
|
165
|
+
};
|
|
166
|
+
vacuum: {
|
|
167
|
+
type: string;
|
|
168
|
+
description: string;
|
|
169
|
+
};
|
|
170
|
+
force_vacuum: {
|
|
171
|
+
type: string;
|
|
172
|
+
description: string;
|
|
173
|
+
};
|
|
174
|
+
git_url: {
|
|
175
|
+
type: string;
|
|
176
|
+
description: string;
|
|
177
|
+
};
|
|
178
|
+
memory_dir: {
|
|
179
|
+
type: string;
|
|
180
|
+
description: string;
|
|
181
|
+
};
|
|
182
|
+
auto_distill: {
|
|
183
|
+
type: string;
|
|
184
|
+
description: string;
|
|
185
|
+
};
|
|
186
|
+
promote_mode: {
|
|
187
|
+
type: string;
|
|
188
|
+
enum: string[];
|
|
189
|
+
description: string;
|
|
190
|
+
};
|
|
191
|
+
min_score: {
|
|
192
|
+
type: string;
|
|
193
|
+
description: string;
|
|
194
|
+
};
|
|
195
|
+
min_recall_count: {
|
|
196
|
+
type: string;
|
|
197
|
+
description: string;
|
|
198
|
+
};
|
|
199
|
+
min_unique_queries: {
|
|
200
|
+
type: string;
|
|
201
|
+
description: string;
|
|
202
|
+
};
|
|
203
|
+
};
|
|
204
|
+
required: string[];
|
|
205
|
+
};
|
|
206
|
+
}, {
|
|
207
|
+
name: string;
|
|
208
|
+
description: string;
|
|
209
|
+
inputSchema: {
|
|
210
|
+
type: "object";
|
|
211
|
+
properties: {
|
|
212
|
+
action: {
|
|
213
|
+
type: string;
|
|
214
|
+
enum: string[];
|
|
215
|
+
description: string;
|
|
216
|
+
};
|
|
217
|
+
source: {
|
|
218
|
+
type: string;
|
|
219
|
+
description: string;
|
|
220
|
+
};
|
|
221
|
+
target: {
|
|
222
|
+
type: string;
|
|
223
|
+
description: string;
|
|
224
|
+
};
|
|
225
|
+
entry: {
|
|
226
|
+
type: string;
|
|
227
|
+
description: string;
|
|
228
|
+
};
|
|
229
|
+
rel_type: {
|
|
230
|
+
type: string;
|
|
231
|
+
enum: ("related_to" | "supersedes" | "depends_on" | "contradicts" | "specializes" | "part_of" | "alternative_to" | "builds_on" | "calls" | "imports" | "inherits")[];
|
|
232
|
+
description: string;
|
|
233
|
+
};
|
|
234
|
+
strength: {
|
|
235
|
+
type: string;
|
|
236
|
+
description: string;
|
|
237
|
+
};
|
|
238
|
+
depth: {
|
|
239
|
+
type: string;
|
|
240
|
+
description: string;
|
|
241
|
+
};
|
|
242
|
+
valid_from: {
|
|
243
|
+
type: string;
|
|
244
|
+
description: string;
|
|
245
|
+
};
|
|
246
|
+
valid_to: {
|
|
247
|
+
type: string;
|
|
248
|
+
description: string;
|
|
249
|
+
};
|
|
250
|
+
as_of: {
|
|
251
|
+
type: string;
|
|
252
|
+
description: string;
|
|
253
|
+
};
|
|
254
|
+
direction: {
|
|
255
|
+
type: string;
|
|
256
|
+
enum: string[];
|
|
257
|
+
description: string;
|
|
258
|
+
};
|
|
259
|
+
edges: {
|
|
260
|
+
type: string;
|
|
261
|
+
description: string;
|
|
262
|
+
items: {
|
|
263
|
+
type: string;
|
|
264
|
+
properties: {
|
|
265
|
+
source: {
|
|
266
|
+
type: string;
|
|
267
|
+
};
|
|
268
|
+
target: {
|
|
269
|
+
type: string;
|
|
270
|
+
};
|
|
271
|
+
rel_type: {
|
|
272
|
+
type: string;
|
|
273
|
+
enum: ("related_to" | "supersedes" | "depends_on" | "contradicts" | "specializes" | "part_of" | "alternative_to" | "builds_on" | "calls" | "imports" | "inherits")[];
|
|
274
|
+
};
|
|
275
|
+
strength: {
|
|
276
|
+
type: string;
|
|
277
|
+
};
|
|
278
|
+
origin: {
|
|
279
|
+
type: string;
|
|
280
|
+
};
|
|
281
|
+
};
|
|
282
|
+
required: string[];
|
|
283
|
+
};
|
|
284
|
+
};
|
|
285
|
+
origin: {
|
|
286
|
+
type: string;
|
|
287
|
+
description: string;
|
|
288
|
+
};
|
|
289
|
+
};
|
|
290
|
+
required: string[];
|
|
291
|
+
};
|
|
292
|
+
}, {
|
|
293
|
+
name: string;
|
|
294
|
+
description: string;
|
|
295
|
+
inputSchema: {
|
|
296
|
+
type: "object";
|
|
297
|
+
properties: {
|
|
298
|
+
action: {
|
|
299
|
+
type: string;
|
|
300
|
+
enum: string[];
|
|
301
|
+
description: string;
|
|
302
|
+
};
|
|
303
|
+
category: {
|
|
304
|
+
type: string;
|
|
305
|
+
enum: ("projects" | "people" | "decisions" | "workflows" | "notes")[];
|
|
306
|
+
description: string;
|
|
307
|
+
};
|
|
308
|
+
threshold: {
|
|
309
|
+
type: string;
|
|
310
|
+
description: string;
|
|
311
|
+
};
|
|
312
|
+
max_entries: {
|
|
313
|
+
type: string;
|
|
314
|
+
description: string;
|
|
315
|
+
};
|
|
316
|
+
top_n: {
|
|
317
|
+
type: string;
|
|
318
|
+
description: string;
|
|
319
|
+
};
|
|
320
|
+
since_days: {
|
|
321
|
+
type: string;
|
|
322
|
+
description: string;
|
|
323
|
+
};
|
|
324
|
+
min_count: {
|
|
325
|
+
type: string;
|
|
326
|
+
description: string;
|
|
327
|
+
};
|
|
328
|
+
group_similarity: {
|
|
329
|
+
type: string;
|
|
330
|
+
description: string;
|
|
331
|
+
};
|
|
332
|
+
min_touching_sessions: {
|
|
333
|
+
type: string;
|
|
334
|
+
description: string;
|
|
335
|
+
};
|
|
336
|
+
};
|
|
337
|
+
required: string[];
|
|
338
|
+
};
|
|
339
|
+
}];
|
|
6
340
|
export declare function createServer(options?: ServerOptions): Server;
|
|
7
341
|
//# sourceMappingURL=server.d.ts.map
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAUnE,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAUnE,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAmaD,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOR,CAAC;AAEX,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CA4C5D"}
|