@yadsh/dsh-qa-surface 0.2.0 → 0.3.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.
Files changed (161) hide show
  1. package/CHANGELOG.md +84 -1
  2. package/README.md +87 -12
  3. package/compatibility.json +11 -3
  4. package/docs/ARCHITECTURE.md +1 -1
  5. package/docs/COMPATIBILITY.md +1 -1
  6. package/docs/CONFIGURATION.md +88 -1
  7. package/docs/SOURCES-MIGRATION.md +28 -0
  8. package/docs/SOURCES-PROVENANCE-AUDIT.md +88 -0
  9. package/docs/SPEC-dsh-qa-surface-accounts.md +219 -0
  10. package/docs/SPEC-dsh-qa-surface-sources-provenance.md +1692 -0
  11. package/lib/accounts/index.js +2 -0
  12. package/lib/accounts/index.js.map +1 -0
  13. package/lib/accounts/store.js +478 -0
  14. package/lib/accounts/store.js.map +1 -0
  15. package/lib/attestation.js.map +1 -1
  16. package/lib/cli.js +143 -0
  17. package/lib/cli.js.map +1 -0
  18. package/lib/client/QaAccountsController.js +329 -0
  19. package/lib/client/QaAccountsController.js.map +1 -0
  20. package/lib/client/QaSessionController.js +203 -127
  21. package/lib/client/QaSessionController.js.map +1 -1
  22. package/lib/client/QaSurface.js +234 -72
  23. package/lib/client/QaSurface.js.map +1 -1
  24. package/lib/client/QaTranscriptAdapter.js +27 -241
  25. package/lib/client/QaTranscriptAdapter.js.map +1 -1
  26. package/lib/client/attestation.js +6 -0
  27. package/lib/client/attestation.js.map +1 -1
  28. package/lib/client/components/Markdown.js +54 -13
  29. package/lib/client/components/Markdown.js.map +1 -1
  30. package/lib/client/components/QaAuthGate.js +40 -0
  31. package/lib/client/components/QaAuthGate.js.map +1 -0
  32. package/lib/client/components/QaChangelog.js +112 -0
  33. package/lib/client/components/QaChangelog.js.map +1 -0
  34. package/lib/client/components/QaMessage.js +47 -17
  35. package/lib/client/components/QaMessage.js.map +1 -1
  36. package/lib/client/components/QaSidebar.js +63 -20
  37. package/lib/client/components/QaSidebar.js.map +1 -1
  38. package/lib/client/components/QaSourcesDrawer.js +113 -32
  39. package/lib/client/components/QaSourcesDrawer.js.map +1 -1
  40. package/lib/client/components/QaTurnRail.js +281 -0
  41. package/lib/client/components/QaTurnRail.js.map +1 -0
  42. package/lib/client/components/QaWelcomeNotice.js +125 -0
  43. package/lib/client/components/QaWelcomeNotice.js.map +1 -0
  44. package/lib/client/components/QaWidthHandle.js +142 -0
  45. package/lib/client/components/QaWidthHandle.js.map +1 -0
  46. package/lib/client/components/source-refs.js +78 -0
  47. package/lib/client/components/source-refs.js.map +1 -0
  48. package/lib/client/create-session.js +51 -0
  49. package/lib/client/create-session.js.map +1 -0
  50. package/lib/client/index.js +100 -12
  51. package/lib/client/index.js.map +1 -1
  52. package/lib/client/project-session-state.js +78 -0
  53. package/lib/client/project-session-state.js.map +1 -0
  54. package/lib/client/session-admission.js +38 -0
  55. package/lib/client/session-admission.js.map +1 -0
  56. package/lib/client/session-assets.js +52 -0
  57. package/lib/client/session-assets.js.map +1 -0
  58. package/lib/client/session-sources.js +61 -0
  59. package/lib/client/session-sources.js.map +1 -0
  60. package/lib/client/settlement.js +24 -0
  61. package/lib/client/settlement.js.map +1 -0
  62. package/lib/client/styles.js +151 -9
  63. package/lib/client/styles.js.map +1 -1
  64. package/lib/client/tool-presentation.js +102 -0
  65. package/lib/client/tool-presentation.js.map +1 -0
  66. package/lib/client/turn-sources.js +98 -0
  67. package/lib/client/turn-sources.js.map +1 -0
  68. package/lib/client/types.js +2 -0
  69. package/lib/client/types.js.map +1 -1
  70. package/lib/client/use-session-ui-state.js +68 -0
  71. package/lib/client/use-session-ui-state.js.map +1 -0
  72. package/lib/client/use-transcript-view.js +44 -0
  73. package/lib/client/use-transcript-view.js.map +1 -0
  74. package/lib/client.js +4649 -861
  75. package/lib/client.js.map +1 -1
  76. package/lib/config.js +218 -102
  77. package/lib/config.js.map +1 -1
  78. package/lib/entry-redirect.js +44 -0
  79. package/lib/entry-redirect.js.map +1 -0
  80. package/lib/host-route.js +25 -1
  81. package/lib/host-route.js.map +1 -1
  82. package/lib/index.js +209 -23
  83. package/lib/index.js.map +1 -1
  84. package/lib/launch-token.js +42 -0
  85. package/lib/launch-token.js.map +1 -0
  86. package/lib/provenance/collector.js +40 -0
  87. package/lib/provenance/collector.js.map +1 -0
  88. package/lib/provenance/connectors.js +147 -0
  89. package/lib/provenance/connectors.js.map +1 -0
  90. package/lib/provenance/dedupe.js +89 -0
  91. package/lib/provenance/dedupe.js.map +1 -0
  92. package/lib/provenance/extractors.js +340 -0
  93. package/lib/provenance/extractors.js.map +1 -0
  94. package/lib/provenance/file-preview.js +39 -0
  95. package/lib/provenance/file-preview.js.map +1 -0
  96. package/lib/provenance/host-store.js +387 -0
  97. package/lib/provenance/host-store.js.map +1 -0
  98. package/lib/provenance/index.js +9 -0
  99. package/lib/provenance/index.js.map +1 -0
  100. package/lib/provenance/normalize.js +128 -0
  101. package/lib/provenance/normalize.js.map +1 -0
  102. package/lib/provenance/reported.js +53 -0
  103. package/lib/provenance/reported.js.map +1 -0
  104. package/lib/provenance/types.js +2 -0
  105. package/lib/provenance/types.js.map +1 -0
  106. package/lib/resolve-config.js +161 -0
  107. package/lib/resolve-config.js.map +1 -1
  108. package/lib/secure-session.js +50 -8
  109. package/lib/secure-session.js.map +1 -1
  110. package/lib/typert.host.js +599 -6
  111. package/lib/typert.remote-client.d.ts +19 -3
  112. package/lib/typert.remote-client.js +471 -3
  113. package/lib/types/accounts/index.d.ts +2 -0
  114. package/lib/types/accounts/store.d.ts +121 -0
  115. package/lib/types/attestation.d.ts +1 -1
  116. package/lib/types/cli.d.ts +9 -0
  117. package/lib/types/client/QaAccountsController.d.ts +95 -0
  118. package/lib/types/client/QaConfigController.d.ts +1 -1
  119. package/lib/types/client/QaSessionController.d.ts +46 -7
  120. package/lib/types/client/QaSurface.d.ts +8 -3
  121. package/lib/types/client/QaTranscriptAdapter.d.ts +5 -10
  122. package/lib/types/client/components/Markdown.d.ts +11 -1
  123. package/lib/types/client/components/QaAgentsDrawer.d.ts +1 -1
  124. package/lib/types/client/components/QaAuthGate.d.ts +15 -0
  125. package/lib/types/client/components/QaChangelog.d.ts +21 -0
  126. package/lib/types/client/components/QaMessage.d.ts +10 -3
  127. package/lib/types/client/components/QaSidebar.d.ts +30 -2
  128. package/lib/types/client/components/QaSourcesDrawer.d.ts +15 -3
  129. package/lib/types/client/components/QaTurnRail.d.ts +59 -0
  130. package/lib/types/client/components/QaWelcomeNotice.d.ts +27 -0
  131. package/lib/types/client/components/QaWidthHandle.d.ts +36 -0
  132. package/lib/types/client/components/source-refs.d.ts +16 -0
  133. package/lib/types/client/create-session.d.ts +16 -0
  134. package/lib/types/client/index.d.ts +1 -0
  135. package/lib/types/client/project-session-state.d.ts +30 -0
  136. package/lib/types/client/session-admission.d.ts +23 -0
  137. package/lib/types/client/session-assets.d.ts +20 -0
  138. package/lib/types/client/session-sources.d.ts +28 -0
  139. package/lib/types/client/settlement.d.ts +6 -0
  140. package/lib/types/client/tool-presentation.d.ts +6 -0
  141. package/lib/types/client/turn-sources.d.ts +14 -0
  142. package/lib/types/client/types.d.ts +73 -9
  143. package/lib/types/client/use-session-ui-state.d.ts +35 -0
  144. package/lib/types/client/use-transcript-view.d.ts +20 -0
  145. package/lib/types/entry-redirect.d.ts +20 -0
  146. package/lib/types/host-route.d.ts +14 -1
  147. package/lib/types/index.d.ts +47 -3
  148. package/lib/types/launch-token.d.ts +21 -0
  149. package/lib/types/provenance/collector.d.ts +26 -0
  150. package/lib/types/provenance/connectors.d.ts +11 -0
  151. package/lib/types/provenance/dedupe.d.ts +6 -0
  152. package/lib/types/provenance/extractors.d.ts +14 -0
  153. package/lib/types/provenance/file-preview.d.ts +10 -0
  154. package/lib/types/provenance/host-store.d.ts +54 -0
  155. package/lib/types/provenance/index.d.ts +10 -0
  156. package/lib/types/provenance/normalize.d.ts +13 -0
  157. package/lib/types/provenance/reported.d.ts +5 -0
  158. package/lib/types/provenance/types.d.ts +78 -0
  159. package/lib/types/secure-session.d.ts +11 -2
  160. package/lib/types/types.d.ts +167 -11
  161. package/package.json +58 -41
@@ -0,0 +1,89 @@
1
+ import { compactLocations } from "./normalize.js";
2
+ const EVIDENCE_STRENGTH = {
3
+ discovered: 0,
4
+ inherited: 1,
5
+ reported: 2,
6
+ queried: 3,
7
+ read: 4,
8
+ fetched: 4,
9
+ };
10
+ function originKey(origin) {
11
+ return [
12
+ origin.sessionId,
13
+ origin.turn,
14
+ origin.step ?? "",
15
+ origin.toolCallId ?? "",
16
+ origin.agentId ?? "",
17
+ origin.subagentRunId ?? "",
18
+ ].join("\u0000");
19
+ }
20
+ function mergeOrigins(left, right) {
21
+ const seen = new Set();
22
+ return [...left, ...right].filter((origin) => {
23
+ const key = originKey(origin);
24
+ if (seen.has(key))
25
+ return false;
26
+ seen.add(key);
27
+ return true;
28
+ });
29
+ }
30
+ function bestText(left, right) {
31
+ if (left === undefined || left === "")
32
+ return right;
33
+ if (right === undefined || right === "")
34
+ return left;
35
+ return right.length > left.length ? right : left;
36
+ }
37
+ function mergePair(left, right, mergeFileRanges) {
38
+ const stronger = EVIDENCE_STRENGTH[right.evidence] > EVIDENCE_STRENGTH[left.evidence]
39
+ ? right
40
+ : left;
41
+ const leftTitleExplicit = left.metadata?.titleExplicit === true;
42
+ const rightTitleExplicit = right.metadata?.titleExplicit === true;
43
+ const uri = bestText(left.uri, right.uri);
44
+ const path = bestText(left.path, right.path);
45
+ const snippet = bestText(left.snippet, right.snippet);
46
+ return {
47
+ ...left,
48
+ kind: stronger.kind,
49
+ title: rightTitleExplicit
50
+ ? right.title
51
+ : leftTitleExplicit
52
+ ? left.title
53
+ : right.score > left.score
54
+ ? right.title
55
+ : (bestText(left.title, right.title) ?? left.title),
56
+ ...(uri === undefined ? {} : { uri }),
57
+ ...(path === undefined ? {} : { path }),
58
+ ...(snippet === undefined ? {} : { snippet }),
59
+ locations: mergeFileRanges
60
+ ? compactLocations([...left.locations, ...right.locations])
61
+ : [
62
+ ...new Map([...left.locations, ...right.locations].map((location) => [
63
+ JSON.stringify(location),
64
+ location,
65
+ ])).values(),
66
+ ],
67
+ evidence: stronger.evidence,
68
+ origins: mergeOrigins(left.origins, right.origins),
69
+ score: Math.max(left.score, right.score),
70
+ metadata: { ...left.metadata, ...right.metadata },
71
+ };
72
+ }
73
+ /** Merge by canonical id and rank by score, preserving first-use order on ties. */
74
+ export function dedupeAndRankSources(sources, options = {}) {
75
+ const merged = new Map();
76
+ sources.forEach((source, order) => {
77
+ const previous = merged.get(source.id);
78
+ merged.set(source.id, {
79
+ source: previous === undefined
80
+ ? source
81
+ : mergePair(previous.source, source, options.mergeFileRanges ?? true),
82
+ order: previous?.order ?? order,
83
+ });
84
+ });
85
+ return [...merged.values()]
86
+ .sort((left, right) => right.source.score - left.source.score || left.order - right.order)
87
+ .map(({ source }) => source);
88
+ }
89
+ //# sourceMappingURL=dedupe.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dedupe.js","sourceRoot":"","sources":["../../src/provenance/dedupe.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,340 @@
1
+ import { canonicalizeUrl, canonicalizeWorkspacePath } from "./normalize.js";
2
+ import { createConfluenceExtractor, createJiraExtractor, createKnowledgeExtractor, } from "./connectors.js";
3
+ function record(value) {
4
+ return typeof value === "object" && value !== null && !Array.isArray(value)
5
+ ? value
6
+ : undefined;
7
+ }
8
+ function parsedArgs(value) {
9
+ if (typeof value !== "string")
10
+ return record(value) ?? {};
11
+ try {
12
+ return record(JSON.parse(value)) ?? {};
13
+ }
14
+ catch {
15
+ return {};
16
+ }
17
+ }
18
+ function presentationRecord(value) {
19
+ const direct = record(value);
20
+ if (direct === undefined)
21
+ return undefined;
22
+ if (typeof direct.path === "string" ||
23
+ typeof direct.url === "string" ||
24
+ typeof direct.shape === "string" ||
25
+ Array.isArray(direct.lines) ||
26
+ Array.isArray(direct.sources) ||
27
+ Array.isArray(direct.files)) {
28
+ return direct;
29
+ }
30
+ for (const key of ["presentation", "presentationMeta", "result", "data"]) {
31
+ const nested = record(direct[key]);
32
+ if (nested !== undefined)
33
+ return nested;
34
+ }
35
+ return direct;
36
+ }
37
+ function sourceTitleFromUrl(url) {
38
+ try {
39
+ const parsed = new URL(url);
40
+ const path = parsed.pathname === "/" ? "" : parsed.pathname.replace(/\/$/u, "");
41
+ return `${parsed.hostname}${path}`;
42
+ }
43
+ catch {
44
+ return url;
45
+ }
46
+ }
47
+ const CODE_EXTENSIONS = new Set([
48
+ "c",
49
+ "cc",
50
+ "cpp",
51
+ "cs",
52
+ "css",
53
+ "go",
54
+ "h",
55
+ "hpp",
56
+ "html",
57
+ "java",
58
+ "js",
59
+ "jsx",
60
+ "kt",
61
+ "php",
62
+ "py",
63
+ "rb",
64
+ "rs",
65
+ "scala",
66
+ "sh",
67
+ "sql",
68
+ "swift",
69
+ "ts",
70
+ "tsx",
71
+ "vue",
72
+ ]);
73
+ function fileKind(path) {
74
+ const extension = path.split(".").at(-1)?.toLowerCase();
75
+ return extension !== undefined && CODE_EXTENSIONS.has(extension)
76
+ ? "code"
77
+ : "file";
78
+ }
79
+ function basename(path) {
80
+ return path.split("/").at(-1) || path;
81
+ }
82
+ function firstText(result) {
83
+ if (typeof result === "string")
84
+ return result;
85
+ if (!Array.isArray(result))
86
+ return undefined;
87
+ for (const block of result) {
88
+ const item = record(block);
89
+ if (item?.type === "text" && typeof item.text === "string")
90
+ return item.text;
91
+ }
92
+ return undefined;
93
+ }
94
+ function snippet(value) {
95
+ const line = value
96
+ ?.split(/\r?\n/u)
97
+ .find((part) => part.trim() !== "")
98
+ ?.trim();
99
+ if (line === undefined || line === "")
100
+ return undefined;
101
+ const compact = line.replace(/\s+/gu, " ");
102
+ return compact.length <= 240 ? compact : `${compact.slice(0, 239)}…`;
103
+ }
104
+ export const readFileExtractor = {
105
+ id: "dsh-read-file",
106
+ matches(context) {
107
+ const meta = presentationRecord(context.presentation);
108
+ return (context.toolName === "read" ||
109
+ context.toolName === "read_file" ||
110
+ (typeof meta?.path === "string" && Array.isArray(meta.lines)));
111
+ },
112
+ extract(context) {
113
+ const args = parsedArgs(context.args);
114
+ const meta = presentationRecord(context.presentation);
115
+ const rawPath = typeof meta?.path === "string"
116
+ ? meta.path
117
+ : typeof args.file_path === "string"
118
+ ? args.file_path
119
+ : typeof args.path === "string"
120
+ ? args.path
121
+ : undefined;
122
+ if (rawPath === undefined || rawPath.trim() === "")
123
+ return [];
124
+ const path = canonicalizeWorkspacePath(rawPath, context.workspaceRoot);
125
+ const lines = Array.isArray(meta?.lines)
126
+ ? meta.lines
127
+ .map(record)
128
+ .filter((line) => line !== undefined)
129
+ : [];
130
+ const numbers = lines
131
+ .map((line) => line.number)
132
+ .filter((number) => Number.isSafeInteger(number) && Number(number) > 0);
133
+ const lineStart = numbers.length > 0 ? Math.min(...numbers) : undefined;
134
+ const lineEnd = numbers.length > 0 ? Math.max(...numbers) : undefined;
135
+ const sourceSnippet = snippet(lines.length > 0
136
+ ? lines
137
+ .map((line) => (typeof line.text === "string" ? line.text : ""))
138
+ .join("\n")
139
+ : firstText(context.result));
140
+ return [
141
+ {
142
+ id: `file:${path}`,
143
+ kind: fileKind(path),
144
+ title: basename(path),
145
+ path,
146
+ ...(sourceSnippet === undefined ? {} : { snippet: sourceSnippet }),
147
+ locations: [
148
+ {
149
+ path,
150
+ ...(lineStart === undefined ? {} : { lineStart }),
151
+ ...(lineEnd === undefined ? {} : { lineEnd }),
152
+ },
153
+ ],
154
+ evidence: "read",
155
+ origins: [context.origin],
156
+ score: 100,
157
+ metadata: {
158
+ ...(typeof meta?.totalLines === "number"
159
+ ? { totalLines: meta.totalLines }
160
+ : {}),
161
+ ...(typeof meta?.lang === "string" ? { lang: meta.lang } : {}),
162
+ },
163
+ },
164
+ ];
165
+ },
166
+ };
167
+ function webSources(meta) {
168
+ return Array.isArray(meta?.sources)
169
+ ? meta.sources
170
+ .map(record)
171
+ .filter((item) => item !== undefined)
172
+ : [];
173
+ }
174
+ export function createWebSearchExtractor(maxPromotedPerSearch = 5, urlOptions = {}) {
175
+ return {
176
+ id: "dsh-web-search",
177
+ matches(context) {
178
+ const meta = presentationRecord(context.presentation);
179
+ return context.toolName === "web_search" || webSources(meta).length > 0;
180
+ },
181
+ extract(context) {
182
+ const meta = presentationRecord(context.presentation);
183
+ return webSources(meta).flatMap((item, index) => {
184
+ if (typeof item.url !== "string")
185
+ return [];
186
+ const uri = canonicalizeUrl(item.url, urlOptions);
187
+ if (uri === null)
188
+ return [];
189
+ const promoted = index < maxPromotedPerSearch;
190
+ const explicitTitle = typeof item.title === "string" && item.title.trim() !== ""
191
+ ? item.title.trim()
192
+ : undefined;
193
+ const titleExplicit = explicitTitle !== undefined;
194
+ const sourceSnippet = snippet(typeof item.snippet === "string" ? item.snippet : undefined);
195
+ return [
196
+ {
197
+ id: `web:${uri}`,
198
+ kind: "web",
199
+ title: explicitTitle ?? sourceTitleFromUrl(uri),
200
+ uri,
201
+ ...(sourceSnippet === undefined ? {} : { snippet: sourceSnippet }),
202
+ locations: [],
203
+ evidence: promoted ? "queried" : "discovered",
204
+ origins: [context.origin],
205
+ score: promoted ? 55 : 20,
206
+ metadata: {
207
+ searchResult: true,
208
+ titleExplicit,
209
+ ...(typeof item.publishedAt === "string"
210
+ ? { publishedAt: item.publishedAt }
211
+ : {}),
212
+ },
213
+ },
214
+ ];
215
+ });
216
+ },
217
+ };
218
+ }
219
+ export function createWebFetchExtractor(urlOptions = {}) {
220
+ return {
221
+ id: "dsh-web-fetch",
222
+ matches(context) {
223
+ const meta = presentationRecord(context.presentation);
224
+ return (context.toolName === "web_fetch" ||
225
+ (typeof meta?.url === "string" && typeof meta.statusCode === "number"));
226
+ },
227
+ extract(context) {
228
+ const args = parsedArgs(context.args);
229
+ const meta = presentationRecord(context.presentation);
230
+ const rawUrl = typeof meta?.url === "string"
231
+ ? meta.url
232
+ : typeof args.url === "string"
233
+ ? args.url
234
+ : undefined;
235
+ const uri = rawUrl === undefined ? null : canonicalizeUrl(rawUrl, urlOptions);
236
+ if (uri === null)
237
+ return [];
238
+ const explicitTitle = typeof meta?.title === "string" && meta.title.trim() !== ""
239
+ ? meta.title.trim()
240
+ : undefined;
241
+ const titleExplicit = explicitTitle !== undefined;
242
+ const sourceSnippet = snippet(firstText(context.result));
243
+ return [
244
+ {
245
+ id: `web:${uri}`,
246
+ kind: "web",
247
+ title: explicitTitle ?? sourceTitleFromUrl(uri),
248
+ uri,
249
+ ...(sourceSnippet === undefined ? {} : { snippet: sourceSnippet }),
250
+ locations: [],
251
+ evidence: "fetched",
252
+ origins: [context.origin],
253
+ score: 100,
254
+ metadata: {
255
+ titleExplicit,
256
+ ...(typeof meta?.statusCode === "number"
257
+ ? { statusCode: meta.statusCode }
258
+ : {}),
259
+ ...(typeof meta?.truncated === "boolean"
260
+ ? { truncated: meta.truncated }
261
+ : {}),
262
+ },
263
+ },
264
+ ];
265
+ },
266
+ };
267
+ }
268
+ export const webFetchExtractor = createWebFetchExtractor();
269
+ export const fileSearchExtractor = {
270
+ id: "dsh-file-search",
271
+ matches(context) {
272
+ const meta = presentationRecord(context.presentation);
273
+ return meta?.shape === "matches" && Array.isArray(meta.files);
274
+ },
275
+ extract(context) {
276
+ const meta = presentationRecord(context.presentation);
277
+ if (!Array.isArray(meta?.files))
278
+ return [];
279
+ return meta.files.flatMap((candidate) => {
280
+ const file = record(candidate);
281
+ if (typeof file?.path !== "string")
282
+ return [];
283
+ const path = canonicalizeWorkspacePath(file.path, context.workspaceRoot);
284
+ const matches = Array.isArray(file.matches)
285
+ ? file.matches
286
+ .map(record)
287
+ .filter((item) => item !== undefined)
288
+ : [];
289
+ const numbers = matches
290
+ .map((item) => item.lineNumber)
291
+ .filter((number) => Number.isSafeInteger(number) && Number(number) > 0);
292
+ const sourceSnippet = snippet(matches.find((item) => typeof item.line === "string")?.line);
293
+ return [
294
+ {
295
+ id: `file:${path}`,
296
+ kind: fileKind(path),
297
+ title: basename(path),
298
+ path,
299
+ ...(sourceSnippet === undefined ? {} : { snippet: sourceSnippet }),
300
+ locations: numbers.map((lineStart) => ({
301
+ path,
302
+ lineStart,
303
+ lineEnd: lineStart,
304
+ })),
305
+ evidence: "discovered",
306
+ origins: [context.origin],
307
+ score: 30,
308
+ metadata: { searchMatch: true },
309
+ },
310
+ ];
311
+ });
312
+ },
313
+ };
314
+ export class SourceExtractorRegistry {
315
+ extractors = [];
316
+ register(extractor) {
317
+ this.extractors.push(extractor);
318
+ return () => {
319
+ const index = this.extractors.indexOf(extractor);
320
+ if (index !== -1)
321
+ this.extractors.splice(index, 1);
322
+ };
323
+ }
324
+ extract(context) {
325
+ return this.extractors.flatMap((extractor) => extractor.matches(context) ? [...extractor.extract(context)] : []);
326
+ }
327
+ }
328
+ export function createDefaultSourceExtractorRegistry(maxPromotedPerSearch = 5, urlOptions = {}) {
329
+ const registry = new SourceExtractorRegistry();
330
+ // Strong consumers go first; dedupe promotes them over discovery candidates.
331
+ registry.register(readFileExtractor);
332
+ registry.register(createWebFetchExtractor(urlOptions));
333
+ registry.register(createWebSearchExtractor(maxPromotedPerSearch, urlOptions));
334
+ registry.register(fileSearchExtractor);
335
+ registry.register(createJiraExtractor(urlOptions));
336
+ registry.register(createConfluenceExtractor(urlOptions));
337
+ registry.register(createKnowledgeExtractor(urlOptions));
338
+ return registry;
339
+ }
340
+ //# sourceMappingURL=extractors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extractors.js","sourceRoot":"","sources":["../../src/provenance/extractors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAO5E,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAIzB,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAuB;QAC1B,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IACE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;QAC9B,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAChC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAC3B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GACR,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrE,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,GAAG;IACH,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,GAAG;IACH,KAAK;IACL,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,KAAK;IACL,OAAO;IACP,IAAI;IACJ,KAAK;IACL,KAAK;CACN,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACxD,OAAO,SAAS,KAAK,SAAS,IAAI,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC;QAC9D,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,SAAS,SAAS,CAAC,MAAe;IAChC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YACxD,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,OAAO,CAAC,KAAyB;IACxC,MAAM,IAAI,GAAG,KAAK;QAChB,EAAE,KAAK,CAAC,QAAQ,CAAC;SAChB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACnC,EAAE,IAAI,EAAE,CAAC;IACX,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,EAAE,EAAE,eAAe;IACnB,OAAO,CAAC,OAAO;QACb,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACtD,OAAO,CACL,OAAO,CAAC,QAAQ,KAAK,MAAM;YAC3B,OAAO,CAAC,QAAQ,KAAK,WAAW;YAChC,CAAC,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,OAAO;QACb,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,OAAO,GACX,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ;YAC5B,CAAC,CAAC,IAAI,CAAC,IAAI;YACX,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;gBAClC,CAAC,CAAC,IAAI,CAAC,SAAS;gBAChB,CAAC,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;oBAC7B,CAAC,CAAC,IAAI,CAAC,IAAI;oBACX,CAAC,CAAC,SAAS,CAAC;QACpB,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;YACtC,CAAC,CAAC,IAAI,CAAC,KAAK;iBACP,GAAG,CAAC,MAAM,CAAC;iBACX,MAAM,CAAC,CAAC,IAAI,EAAyB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;YAChE,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,OAAO,GAAG,KAAK;aAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;aAC1B,MAAM,CACL,CAAC,MAAM,EAAoB,EAAE,CAC3B,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CACrD,CAAC;QACJ,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtE,MAAM,aAAa,GAAG,OAAO,CAC3B,KAAK,CAAC,MAAM,GAAG,CAAC;YACd,CAAC,CAAC,KAAK;iBACF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;iBAC/D,IAAI,CAAC,IAAI,CAAC;YACf,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAC9B,CAAC;QACF,OAAO;YACL;gBACE,EAAE,EAAE,QAAQ,IAAI,EAAE;gBAClB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;gBACpB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;gBACrB,IAAI;gBACJ,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;gBAClE,SAAS,EAAE;oBACT;wBACE,IAAI;wBACJ,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;wBACjD,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;qBAC9C;iBACF;gBACD,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;gBACzB,KAAK,EAAE,GAAG;gBACV,QAAQ,EAAE;oBACR,GAAG,CAAC,OAAO,IAAI,EAAE,UAAU,KAAK,QAAQ;wBACtC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;wBACjC,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/D;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,SAAS,UAAU,CAAC,IAA+B;IACjD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,OAAO;aACT,GAAG,CAAC,MAAM,CAAC;aACX,MAAM,CAAC,CAAC,IAAI,EAAyB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;QAChE,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,oBAAoB,GAAG,CAAC,EACxB,UAAU,GAA0C,EAAE;IAEtD,OAAO;QACL,EAAE,EAAE,gBAAgB;QACpB,OAAO,CAAC,OAAO;YACb,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACtD,OAAO,OAAO,CAAC,QAAQ,KAAK,YAAY,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,CAAC,OAAO;YACb,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACtD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAuB,EAAE;gBACnE,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ;oBAAE,OAAO,EAAE,CAAC;gBAC5C,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;gBAClD,IAAI,GAAG,KAAK,IAAI;oBAAE,OAAO,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,KAAK,GAAG,oBAAoB,CAAC;gBAC9C,MAAM,aAAa,GACjB,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;oBACxD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBACnB,CAAC,CAAC,SAAS,CAAC;gBAChB,MAAM,aAAa,GAAG,aAAa,KAAK,SAAS,CAAC;gBAClD,MAAM,aAAa,GAAG,OAAO,CAC3B,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAC5D,CAAC;gBACF,OAAO;oBACL;wBACE,EAAE,EAAE,OAAO,GAAG,EAAE;wBAChB,IAAI,EAAE,KAAK;wBACX,KAAK,EAAE,aAAa,IAAI,kBAAkB,CAAC,GAAG,CAAC;wBAC/C,GAAG;wBACH,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;wBAClE,SAAS,EAAE,EAAE;wBACb,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;wBAC7C,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;wBACzB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;wBACzB,QAAQ,EAAE;4BACR,YAAY,EAAE,IAAI;4BAClB,aAAa;4BACb,GAAG,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;gCACtC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;gCACnC,CAAC,CAAC,EAAE,CAAC;yBACR;qBACF;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAAU,GAA0C,EAAE;IAEtD,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,OAAO,CAAC,OAAO;YACb,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACtD,OAAO,CACL,OAAO,CAAC,QAAQ,KAAK,WAAW;gBAChC,CAAC,OAAO,IAAI,EAAE,GAAG,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CACvE,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,OAAO;YACb,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACtD,MAAM,MAAM,GACV,OAAO,IAAI,EAAE,GAAG,KAAK,QAAQ;gBAC3B,CAAC,CAAC,IAAI,CAAC,GAAG;gBACV,CAAC,CAAC,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ;oBAC5B,CAAC,CAAC,IAAI,CAAC,GAAG;oBACV,CAAC,CAAC,SAAS,CAAC;YAClB,MAAM,GAAG,GACP,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACpE,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;YAC5B,MAAM,aAAa,GACjB,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;gBACzD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;gBACnB,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,aAAa,GAAG,aAAa,KAAK,SAAS,CAAC;YAClD,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YACzD,OAAO;gBACL;oBACE,EAAE,EAAE,OAAO,GAAG,EAAE;oBAChB,IAAI,EAAE,KAAK;oBACX,KAAK,EAAE,aAAa,IAAI,kBAAkB,CAAC,GAAG,CAAC;oBAC/C,GAAG;oBACH,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;oBAClE,SAAS,EAAE,EAAE;oBACb,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;oBACzB,KAAK,EAAE,GAAG;oBACV,QAAQ,EAAE;wBACR,aAAa;wBACb,GAAG,CAAC,OAAO,IAAI,EAAE,UAAU,KAAK,QAAQ;4BACtC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;4BACjC,CAAC,CAAC,EAAE,CAAC;wBACP,GAAG,CAAC,OAAO,IAAI,EAAE,SAAS,KAAK,SAAS;4BACtC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;4BAC/B,CAAC,CAAC,EAAE,CAAC;qBACR;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAoB,uBAAuB,EAAE,CAAC;AAE5E,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,EAAE,EAAE,iBAAiB;IACrB,OAAO,CAAC,OAAO;QACb,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACtD,OAAO,IAAI,EAAE,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,CAAC,OAAO;QACb,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,EAAuB,EAAE;YAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;gBACzC,CAAC,CAAC,IAAI,CAAC,OAAO;qBACT,GAAG,CAAC,MAAM,CAAC;qBACX,MAAM,CAAC,CAAC,IAAI,EAAyB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;gBAChE,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,OAAO,GAAG,OAAO;iBACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC;iBAC9B,MAAM,CACL,CAAC,MAAM,EAAoB,EAAE,CAC3B,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CACrD,CAAC;YACJ,MAAM,aAAa,GAAG,OAAO,CAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,IACnC,CACrB,CAAC;YACF,OAAO;gBACL;oBACE,EAAE,EAAE,QAAQ,IAAI,EAAE;oBAClB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;oBACpB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;oBACrB,IAAI;oBACJ,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;oBAClE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;wBACrC,IAAI;wBACJ,SAAS;wBACT,OAAO,EAAE,SAAS;qBACnB,CAAC,CAAC;oBACH,QAAQ,EAAE,YAAY;oBACtB,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;oBACzB,KAAK,EAAE,EAAE;oBACT,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;iBAChC;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,OAAO,uBAAuB;IACjB,UAAU,GAAsB,EAAE,CAAC;IAEpD,QAAQ,CAAC,SAA0B;QACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,GAAG,EAAE;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,OAA+B;QACrC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAC3C,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAClE,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,oCAAoC,CAClD,oBAAoB,GAAG,CAAC,EACxB,UAAU,GAA0C,EAAE;IAEtD,MAAM,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAC/C,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9E,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
@@ -0,0 +1,39 @@
1
+ import { open, realpath, stat } from "node:fs/promises";
2
+ import { isAbsolute, relative, resolve, sep } from "node:path";
3
+ /** Read one canonical in-root file without following a symlink outside root. */
4
+ export async function readSourceFilePreview({ root, sourcePath, maxBytes, maxMarkdownRenderBytes, }) {
5
+ const rootPath = await realpath(root);
6
+ const candidate = isAbsolute(sourcePath)
7
+ ? sourcePath
8
+ : resolve(rootPath, sourcePath);
9
+ const canonical = await realpath(candidate);
10
+ const fromRoot = relative(rootPath, canonical);
11
+ if (fromRoot === "" ||
12
+ fromRoot === ".." ||
13
+ fromRoot.startsWith(`..${sep}`) ||
14
+ isAbsolute(fromRoot)) {
15
+ throw new Error("source path escapes the configured root");
16
+ }
17
+ const info = await stat(canonical);
18
+ if (!info.isFile())
19
+ throw new Error("source path is not a file");
20
+ const handle = await open(canonical, "r");
21
+ try {
22
+ const limit = Math.min(maxBytes, info.size);
23
+ const buffer = Buffer.alloc(limit);
24
+ const { bytesRead } = await handle.read(buffer, 0, limit, 0);
25
+ const markdown = /\.(?:md|markdown)$/iu.test(canonical);
26
+ return {
27
+ path: sourcePath,
28
+ content: buffer.subarray(0, bytesRead).toString("utf8"),
29
+ size: info.size,
30
+ truncated: info.size > bytesRead,
31
+ markdown,
32
+ renderableMarkdown: markdown && info.size <= maxMarkdownRenderBytes,
33
+ };
34
+ }
35
+ finally {
36
+ await handle.close();
37
+ }
38
+ }
39
+ //# sourceMappingURL=file-preview.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-preview.js","sourceRoot":"","sources":["../../src/provenance/file-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAU/D,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,sBAAsB,GACK;IAC3B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC;QACtC,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/C,IACE,QAAQ,KAAK,EAAE;QACf,QAAQ,KAAK,IAAI;QACjB,QAAQ,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC;QAC/B,UAAU,CAAC,QAAQ,CAAC,EACpB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,IAAI,GAAG,SAAS;YAChC,QAAQ;YACR,kBAAkB,EAAE,QAAQ,IAAI,IAAI,CAAC,IAAI,IAAI,sBAAsB;SACpE,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}