@once-agent/sdk 0.1.10 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (166) hide show
  1. package/README.md +76 -1
  2. package/dist/cli.js +50 -1
  3. package/dist/cli.js.map +1 -1
  4. package/dist/connect/identity.d.ts +22 -0
  5. package/dist/connect/identity.d.ts.map +1 -0
  6. package/dist/connect/identity.js +159 -0
  7. package/dist/connect/identity.js.map +1 -0
  8. package/dist/connect/index.d.ts +17 -0
  9. package/dist/connect/index.d.ts.map +1 -0
  10. package/dist/connect/index.js +9 -0
  11. package/dist/connect/index.js.map +1 -0
  12. package/dist/connect/local-agent-tool.d.ts +62 -0
  13. package/dist/connect/local-agent-tool.d.ts.map +1 -0
  14. package/dist/connect/local-agent-tool.js +131 -0
  15. package/dist/connect/local-agent-tool.js.map +1 -0
  16. package/dist/connect/manifest.d.ts +55 -0
  17. package/dist/connect/manifest.d.ts.map +1 -0
  18. package/dist/connect/manifest.js +166 -0
  19. package/dist/connect/manifest.js.map +1 -0
  20. package/dist/connect/openai-function-tools.d.ts +66 -0
  21. package/dist/connect/openai-function-tools.d.ts.map +1 -0
  22. package/dist/connect/openai-function-tools.js +182 -0
  23. package/dist/connect/openai-function-tools.js.map +1 -0
  24. package/dist/connect/payload.d.ts +30 -0
  25. package/dist/connect/payload.d.ts.map +1 -0
  26. package/dist/connect/payload.js +122 -0
  27. package/dist/connect/payload.js.map +1 -0
  28. package/dist/connect/tool-classifier.d.ts +40 -0
  29. package/dist/connect/tool-classifier.d.ts.map +1 -0
  30. package/dist/connect/tool-classifier.js +271 -0
  31. package/dist/connect/tool-classifier.js.map +1 -0
  32. package/dist/connect/toolset.d.ts +42 -0
  33. package/dist/connect/toolset.d.ts.map +1 -0
  34. package/dist/connect/toolset.js +123 -0
  35. package/dist/connect/toolset.js.map +1 -0
  36. package/dist/discovery/index.d.ts +13 -0
  37. package/dist/discovery/index.d.ts.map +1 -0
  38. package/dist/discovery/index.js +8 -0
  39. package/dist/discovery/index.js.map +1 -0
  40. package/dist/execution-observation.d.ts +122 -0
  41. package/dist/execution-observation.d.ts.map +1 -0
  42. package/dist/execution-observation.js +324 -0
  43. package/dist/execution-observation.js.map +1 -0
  44. package/dist/gateway/index.d.ts +9 -0
  45. package/dist/gateway/index.d.ts.map +1 -0
  46. package/dist/gateway/index.js +5 -0
  47. package/dist/gateway/index.js.map +1 -0
  48. package/dist/gateway/local-toolset.d.ts +32 -0
  49. package/dist/gateway/local-toolset.d.ts.map +1 -0
  50. package/dist/gateway/local-toolset.js +79 -0
  51. package/dist/gateway/local-toolset.js.map +1 -0
  52. package/dist/gateway/openai-function-tools.d.ts +28 -0
  53. package/dist/gateway/openai-function-tools.d.ts.map +1 -0
  54. package/dist/gateway/openai-function-tools.js +117 -0
  55. package/dist/gateway/openai-function-tools.js.map +1 -0
  56. package/dist/gateway/planner.d.ts +53 -0
  57. package/dist/gateway/planner.d.ts.map +1 -0
  58. package/dist/gateway/planner.js +155 -0
  59. package/dist/gateway/planner.js.map +1 -0
  60. package/dist/gateway/tool-graph-binding.d.ts +51 -0
  61. package/dist/gateway/tool-graph-binding.d.ts.map +1 -0
  62. package/dist/gateway/tool-graph-binding.js +123 -0
  63. package/dist/gateway/tool-graph-binding.js.map +1 -0
  64. package/dist/index.d.ts +2 -0
  65. package/dist/index.d.ts.map +1 -1
  66. package/dist/index.js +1 -0
  67. package/dist/index.js.map +1 -1
  68. package/dist/langchain-execution-observer.d.ts +22 -0
  69. package/dist/langchain-execution-observer.d.ts.map +1 -0
  70. package/dist/langchain-execution-observer.js +128 -0
  71. package/dist/langchain-execution-observer.js.map +1 -0
  72. package/dist/langchain-runtime-discovery.d.ts +33 -0
  73. package/dist/langchain-runtime-discovery.d.ts.map +1 -0
  74. package/dist/langchain-runtime-discovery.js +214 -0
  75. package/dist/langchain-runtime-discovery.js.map +1 -0
  76. package/dist/mcp-live-discovery.d.ts +71 -0
  77. package/dist/mcp-live-discovery.d.ts.map +1 -0
  78. package/dist/mcp-live-discovery.js +710 -0
  79. package/dist/mcp-live-discovery.js.map +1 -0
  80. package/dist/mcp-live-report.d.ts +3 -0
  81. package/dist/mcp-live-report.d.ts.map +1 -0
  82. package/dist/mcp-live-report.js +50 -0
  83. package/dist/mcp-live-report.js.map +1 -0
  84. package/dist/mcp-tool-refresh-report.d.ts +3 -0
  85. package/dist/mcp-tool-refresh-report.d.ts.map +1 -0
  86. package/dist/mcp-tool-refresh-report.js +44 -0
  87. package/dist/mcp-tool-refresh-report.js.map +1 -0
  88. package/dist/mcp-tool-refresh.d.ts +33 -0
  89. package/dist/mcp-tool-refresh.d.ts.map +1 -0
  90. package/dist/mcp-tool-refresh.js +489 -0
  91. package/dist/mcp-tool-refresh.js.map +1 -0
  92. package/dist/openai-agents-execution-observer.d.ts +24 -0
  93. package/dist/openai-agents-execution-observer.d.ts.map +1 -0
  94. package/dist/openai-agents-execution-observer.js +163 -0
  95. package/dist/openai-agents-execution-observer.js.map +1 -0
  96. package/dist/otel-execution-observer.d.ts +16 -0
  97. package/dist/otel-execution-observer.d.ts.map +1 -0
  98. package/dist/otel-execution-observer.js +129 -0
  99. package/dist/otel-execution-observer.js.map +1 -0
  100. package/dist/runtime-tool-discovery.d.ts +86 -0
  101. package/dist/runtime-tool-discovery.d.ts.map +1 -0
  102. package/dist/runtime-tool-discovery.js +429 -0
  103. package/dist/runtime-tool-discovery.js.map +1 -0
  104. package/dist/tool-discovery.d.ts +51 -0
  105. package/dist/tool-discovery.d.ts.map +1 -0
  106. package/dist/tool-discovery.js +487 -0
  107. package/dist/tool-discovery.js.map +1 -0
  108. package/dist/tool-importance.d.ts +34 -0
  109. package/dist/tool-importance.d.ts.map +1 -0
  110. package/dist/tool-importance.js +269 -0
  111. package/dist/tool-importance.js.map +1 -0
  112. package/dist/tool-report.d.ts +3 -0
  113. package/dist/tool-report.d.ts.map +1 -0
  114. package/dist/tool-report.js +75 -0
  115. package/dist/tool-report.js.map +1 -0
  116. package/dist/vercel-execution-observer.d.ts +12 -0
  117. package/dist/vercel-execution-observer.d.ts.map +1 -0
  118. package/dist/vercel-execution-observer.js +97 -0
  119. package/dist/vercel-execution-observer.js.map +1 -0
  120. package/dist-cjs/connect/identity.js +162 -0
  121. package/dist-cjs/connect/identity.js.map +1 -0
  122. package/dist-cjs/connect/index.js +26 -0
  123. package/dist-cjs/connect/index.js.map +1 -0
  124. package/dist-cjs/connect/local-agent-tool.js +137 -0
  125. package/dist-cjs/connect/local-agent-tool.js.map +1 -0
  126. package/dist-cjs/connect/manifest.js +171 -0
  127. package/dist-cjs/connect/manifest.js.map +1 -0
  128. package/dist-cjs/connect/openai-function-tools.js +187 -0
  129. package/dist-cjs/connect/openai-function-tools.js.map +1 -0
  130. package/dist-cjs/connect/payload.js +125 -0
  131. package/dist-cjs/connect/payload.js.map +1 -0
  132. package/dist-cjs/connect/tool-classifier.js +276 -0
  133. package/dist-cjs/connect/tool-classifier.js.map +1 -0
  134. package/dist-cjs/connect/toolset.js +126 -0
  135. package/dist-cjs/connect/toolset.js.map +1 -0
  136. package/dist-cjs/discovery/index.js +26 -0
  137. package/dist-cjs/discovery/index.js.map +1 -0
  138. package/dist-cjs/execution-observation.js +330 -0
  139. package/dist-cjs/execution-observation.js.map +1 -0
  140. package/dist-cjs/gateway/index.js +16 -0
  141. package/dist-cjs/gateway/index.js.map +1 -0
  142. package/dist-cjs/gateway/local-toolset.js +84 -0
  143. package/dist-cjs/gateway/local-toolset.js.map +1 -0
  144. package/dist-cjs/gateway/openai-function-tools.js +120 -0
  145. package/dist-cjs/gateway/openai-function-tools.js.map +1 -0
  146. package/dist-cjs/gateway/planner.js +160 -0
  147. package/dist-cjs/gateway/planner.js.map +1 -0
  148. package/dist-cjs/gateway/tool-graph-binding.js +126 -0
  149. package/dist-cjs/gateway/tool-graph-binding.js.map +1 -0
  150. package/dist-cjs/index.js +4 -1
  151. package/dist-cjs/index.js.map +1 -1
  152. package/dist-cjs/langchain-execution-observer.js +131 -0
  153. package/dist-cjs/langchain-execution-observer.js.map +1 -0
  154. package/dist-cjs/langchain-runtime-discovery.js +218 -0
  155. package/dist-cjs/langchain-runtime-discovery.js.map +1 -0
  156. package/dist-cjs/openai-agents-execution-observer.js +166 -0
  157. package/dist-cjs/openai-agents-execution-observer.js.map +1 -0
  158. package/dist-cjs/otel-execution-observer.js +132 -0
  159. package/dist-cjs/otel-execution-observer.js.map +1 -0
  160. package/dist-cjs/runtime-tool-discovery.js +436 -0
  161. package/dist-cjs/runtime-tool-discovery.js.map +1 -0
  162. package/dist-cjs/tool-importance.js +272 -0
  163. package/dist-cjs/tool-importance.js.map +1 -0
  164. package/dist-cjs/vercel-execution-observer.js +100 -0
  165. package/dist-cjs/vercel-execution-observer.js.map +1 -0
  166. package/package.json +25 -3
@@ -0,0 +1,487 @@
1
+ import { createHash } from "node:crypto";
2
+ import { promises as fs } from "node:fs";
3
+ import os from "node:os";
4
+ import path from "node:path";
5
+ import { collectSourceFiles, detectProjectMetadata, scanFile } from "./scan.js";
6
+ import { assessToolImportance } from "./tool-importance.js";
7
+ function stableId(prefix, value) {
8
+ const hash = createHash("sha256")
9
+ .update(JSON.stringify(value))
10
+ .digest("hex");
11
+ return `${prefix}:${hash}`;
12
+ }
13
+ function displayPath(root, filePath) {
14
+ const resolvedRoot = path.resolve(root);
15
+ const resolvedFile = path.resolve(filePath);
16
+ const home = path.resolve(os.homedir());
17
+ if (resolvedFile === resolvedRoot ||
18
+ resolvedFile.startsWith(resolvedRoot + path.sep)) {
19
+ return path.relative(resolvedRoot, resolvedFile) || ".";
20
+ }
21
+ if (resolvedFile === home ||
22
+ resolvedFile.startsWith(home + path.sep)) {
23
+ const relative = path.relative(home, resolvedFile);
24
+ return relative
25
+ ? `~/${relative.replaceAll(path.sep, "/")}`
26
+ : "~";
27
+ }
28
+ return filePath;
29
+ }
30
+ function stripJsonComments(input) {
31
+ let output = "";
32
+ let inString = false;
33
+ let quote = "";
34
+ let escaped = false;
35
+ let lineComment = false;
36
+ let blockComment = false;
37
+ for (let index = 0; index < input.length; index++) {
38
+ const char = input[index] ?? "";
39
+ const next = input[index + 1] ?? "";
40
+ if (lineComment) {
41
+ if (char === "\n") {
42
+ lineComment = false;
43
+ output += char;
44
+ }
45
+ continue;
46
+ }
47
+ if (blockComment) {
48
+ if (char === "*" &&
49
+ next === "/") {
50
+ blockComment = false;
51
+ index++;
52
+ }
53
+ else if (char === "\n") {
54
+ output += char;
55
+ }
56
+ continue;
57
+ }
58
+ if (inString) {
59
+ output += char;
60
+ if (escaped) {
61
+ escaped = false;
62
+ continue;
63
+ }
64
+ if (char === "\\") {
65
+ escaped = true;
66
+ continue;
67
+ }
68
+ if (char === quote) {
69
+ inString = false;
70
+ quote = "";
71
+ }
72
+ continue;
73
+ }
74
+ if (char === '"' ||
75
+ char === "'") {
76
+ inString = true;
77
+ quote = char;
78
+ output += char;
79
+ continue;
80
+ }
81
+ if (char === "/" &&
82
+ next === "/") {
83
+ lineComment = true;
84
+ index++;
85
+ continue;
86
+ }
87
+ if (char === "/" &&
88
+ next === "*") {
89
+ blockComment = true;
90
+ index++;
91
+ continue;
92
+ }
93
+ output += char;
94
+ }
95
+ return output;
96
+ }
97
+ function asRecord(value) {
98
+ if (value &&
99
+ typeof value === "object" &&
100
+ !Array.isArray(value)) {
101
+ return value;
102
+ }
103
+ return undefined;
104
+ }
105
+ function inferTransport(value) {
106
+ const record = asRecord(value);
107
+ if (!record) {
108
+ return "UNKNOWN";
109
+ }
110
+ if (typeof record.command === "string") {
111
+ return "STDIO";
112
+ }
113
+ if (typeof record.url === "string") {
114
+ const type = typeof record.type === "string"
115
+ ? record.type.toLowerCase()
116
+ : "";
117
+ if (type.includes("sse")) {
118
+ return "SSE";
119
+ }
120
+ return "HTTP";
121
+ }
122
+ return "UNKNOWN";
123
+ }
124
+ function serverMapsFromJson(parsed) {
125
+ const root = asRecord(parsed);
126
+ if (!root) {
127
+ return [];
128
+ }
129
+ const maps = [];
130
+ for (const key of ["mcpServers", "servers"]) {
131
+ const value = asRecord(root[key]);
132
+ if (value) {
133
+ maps.push(value);
134
+ }
135
+ }
136
+ const customizations = asRecord(root.customizations);
137
+ const vscode = asRecord(customizations?.vscode);
138
+ const mcp = asRecord(vscode?.mcp);
139
+ for (const key of ["mcpServers", "servers"]) {
140
+ const value = asRecord(mcp?.[key]);
141
+ if (value) {
142
+ maps.push(value);
143
+ }
144
+ }
145
+ return maps;
146
+ }
147
+ async function readJsonMcpSources(root, candidate) {
148
+ let raw;
149
+ try {
150
+ raw = await fs.readFile(candidate.filePath, "utf8");
151
+ }
152
+ catch {
153
+ return [];
154
+ }
155
+ let parsed;
156
+ try {
157
+ parsed = JSON.parse(stripJsonComments(raw.replace(/^\uFEFF/, "")));
158
+ }
159
+ catch {
160
+ return [];
161
+ }
162
+ const sources = [];
163
+ for (const serverMap of serverMapsFromJson(parsed)) {
164
+ for (const [name, definition] of Object.entries(serverMap)) {
165
+ const configPath = displayPath(root, candidate.filePath);
166
+ sources.push({
167
+ sourceId: stableId("mcp-source", {
168
+ host: candidate.host,
169
+ scope: candidate.scope,
170
+ configPath,
171
+ name
172
+ }),
173
+ kind: "MCP_SERVER",
174
+ host: candidate.host,
175
+ name,
176
+ scope: candidate.scope,
177
+ configPath,
178
+ transport: inferTransport(definition),
179
+ evidence: "HOST_CONFIGURED",
180
+ status: "CONFIGURED_NOT_PROBED"
181
+ });
182
+ }
183
+ }
184
+ return sources;
185
+ }
186
+ async function readCodexSources(root, candidate) {
187
+ let raw;
188
+ try {
189
+ raw = await fs.readFile(candidate.filePath, "utf8");
190
+ }
191
+ catch {
192
+ return [];
193
+ }
194
+ const names = new Set();
195
+ const sectionPattern = /^\s*\[mcp_servers\.([^\]]+)\]\s*$/gm;
196
+ for (const match of raw.matchAll(sectionPattern)) {
197
+ const rawName = (match[1] ?? "").trim();
198
+ const name = rawName.replace(/^(?:"([^"]+)"|'([^']+)')$/, (_whole, doubleQuoted, singleQuoted) => doubleQuoted ?? singleQuoted ?? rawName);
199
+ if (name) {
200
+ names.add(name);
201
+ }
202
+ }
203
+ const configPath = displayPath(root, candidate.filePath);
204
+ return [...names].map(name => ({
205
+ sourceId: stableId("mcp-source", {
206
+ host: candidate.host,
207
+ scope: candidate.scope,
208
+ configPath,
209
+ name
210
+ }),
211
+ kind: "MCP_SERVER",
212
+ host: candidate.host,
213
+ name,
214
+ scope: candidate.scope,
215
+ configPath,
216
+ transport: "UNKNOWN",
217
+ evidence: "HOST_CONFIGURED",
218
+ status: "CONFIGURED_NOT_PROBED"
219
+ }));
220
+ }
221
+ function configCandidates(root) {
222
+ const home = os.homedir();
223
+ const appData = process.env.APPDATA;
224
+ const candidates = [
225
+ {
226
+ host: "generic-mcp",
227
+ scope: "PROJECT",
228
+ filePath: path.join(root, ".mcp.json"),
229
+ parser: "JSON"
230
+ },
231
+ {
232
+ host: "cursor",
233
+ scope: "PROJECT",
234
+ filePath: path.join(root, ".cursor", "mcp.json"),
235
+ parser: "JSON"
236
+ },
237
+ {
238
+ host: "vscode",
239
+ scope: "PROJECT",
240
+ filePath: path.join(root, ".vscode", "mcp.json"),
241
+ parser: "JSON"
242
+ },
243
+ {
244
+ host: "github-copilot",
245
+ scope: "PROJECT",
246
+ filePath: path.join(root, ".github", "mcp.json"),
247
+ parser: "JSON"
248
+ },
249
+ {
250
+ host: "devcontainer-vscode",
251
+ scope: "PROJECT",
252
+ filePath: path.join(root, "devcontainer.json"),
253
+ parser: "JSON"
254
+ },
255
+ {
256
+ host: "devcontainer-vscode",
257
+ scope: "PROJECT",
258
+ filePath: path.join(root, ".devcontainer", "devcontainer.json"),
259
+ parser: "JSON"
260
+ },
261
+ {
262
+ host: "cursor",
263
+ scope: "USER",
264
+ filePath: path.join(home, ".cursor", "mcp.json"),
265
+ parser: "JSON"
266
+ },
267
+ {
268
+ host: "github-copilot",
269
+ scope: "USER",
270
+ filePath: path.join(home, ".copilot", "mcp-config.json"),
271
+ parser: "JSON"
272
+ },
273
+ {
274
+ host: "codex",
275
+ scope: "USER",
276
+ filePath: path.join(home, ".codex", "config.toml"),
277
+ parser: "CODEX_TOML"
278
+ },
279
+ {
280
+ host: "windsurf",
281
+ scope: "USER",
282
+ filePath: path.join(home, ".codeium", "windsurf", "mcp_config.json"),
283
+ parser: "JSON"
284
+ },
285
+ {
286
+ host: "claude-desktop",
287
+ scope: "USER",
288
+ filePath: path.join(home, ".config", "Claude", "claude_desktop_config.json"),
289
+ parser: "JSON"
290
+ },
291
+ {
292
+ host: "claude-desktop",
293
+ scope: "USER",
294
+ filePath: path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
295
+ parser: "JSON"
296
+ }
297
+ ];
298
+ if (appData) {
299
+ candidates.push({
300
+ host: "claude-desktop",
301
+ scope: "USER",
302
+ filePath: path.join(appData, "Claude", "claude_desktop_config.json"),
303
+ parser: "JSON"
304
+ });
305
+ }
306
+ return candidates;
307
+ }
308
+ async function discoverConfiguredSources(root) {
309
+ const sources = [];
310
+ for (const candidate of configCandidates(root)) {
311
+ const discovered = candidate.parser === "CODEX_TOML"
312
+ ? await readCodexSources(root, candidate)
313
+ : await readJsonMcpSources(root, candidate);
314
+ sources.push(...discovered);
315
+ }
316
+ const unique = new Map();
317
+ for (const source of sources) {
318
+ unique.set(source.sourceId, source);
319
+ }
320
+ return [...unique.values()].sort((left, right) => left.scope.localeCompare(right.scope) ||
321
+ left.host.localeCompare(right.host) ||
322
+ left.name.localeCompare(right.name));
323
+ }
324
+ function findingName(finding) {
325
+ if (finding.functionName) {
326
+ return finding.functionName;
327
+ }
328
+ return `${finding.category.toLowerCase()}_${finding.line}`;
329
+ }
330
+ function toolFromFinding(root, finding) {
331
+ const canonicalName = findingName(finding);
332
+ const assessment = assessToolImportance({
333
+ name: canonicalName,
334
+ description: finding.reason,
335
+ sourceCategory: finding.category,
336
+ evidence: "SOURCE_DISCOVERED"
337
+ });
338
+ const sourceFile = finding.file.replaceAll("\\", "/");
339
+ return {
340
+ toolId: stableId("tool", {
341
+ kind: "source",
342
+ file: sourceFile,
343
+ line: finding.line,
344
+ name: canonicalName,
345
+ category: finding.category
346
+ }),
347
+ canonicalName,
348
+ displayName: canonicalName,
349
+ description: finding.reason,
350
+ origin: {
351
+ kind: "source",
352
+ host: "project",
353
+ scope: "workspace"
354
+ },
355
+ source: {
356
+ file: sourceFile,
357
+ line: finding.line,
358
+ category: finding.category
359
+ },
360
+ evidence: {
361
+ level: "SOURCE_DISCOVERED",
362
+ source: "once-consequential-scanner"
363
+ },
364
+ visibility: {
365
+ configured: false,
366
+ runtimeRegistered: false,
367
+ modelVisible: false,
368
+ executed: false
369
+ },
370
+ once: assessment
371
+ };
372
+ }
373
+ function lineNumberAt(text, index) {
374
+ return text
375
+ .slice(0, index)
376
+ .split("\n")
377
+ .length;
378
+ }
379
+ async function discoverDeclaredTools(root, filePath) {
380
+ let text;
381
+ try {
382
+ text = await fs.readFile(filePath, "utf8");
383
+ }
384
+ catch {
385
+ return [];
386
+ }
387
+ const declarations = [];
388
+ const decoratorPattern = /@(?:tool|function_tool|kernel_function)(?:\([^\n)]*\))?\s*\r?\n\s*(?:async\s+)?def\s+([A-Za-z_][A-Za-z0-9_]*)/g;
389
+ for (const match of text.matchAll(decoratorPattern)) {
390
+ if (!match[1] || match.index === undefined)
391
+ continue;
392
+ declarations.push({
393
+ name: match[1],
394
+ line: lineNumberAt(text, match.index),
395
+ reason: "Framework tool decorator discovered in source."
396
+ });
397
+ }
398
+ const toolsArrayPattern = /\btools\s*[:=]\s*\[([^\]]{1,1200})\]/g;
399
+ for (const match of text.matchAll(toolsArrayPattern)) {
400
+ if (!match[1] || match.index === undefined)
401
+ continue;
402
+ const body = match[1];
403
+ const tokenPattern = /(?:^|,)\s*([A-Za-z_$][A-Za-z0-9_$]*)\s*(?=,|$)/g;
404
+ for (const token of body.matchAll(tokenPattern)) {
405
+ const name = token[1];
406
+ if (!name)
407
+ continue;
408
+ declarations.push({
409
+ name,
410
+ line: lineNumberAt(text, match.index),
411
+ reason: "Tool registered in a source tools collection."
412
+ });
413
+ }
414
+ }
415
+ const relative = path.relative(root, filePath)
416
+ .replaceAll("\\", "/");
417
+ const unique = new Map();
418
+ for (const declaration of declarations) {
419
+ unique.set(`${declaration.name}:${declaration.line}`, declaration);
420
+ }
421
+ return [...unique.values()].map(declaration => {
422
+ const assessment = assessToolImportance({
423
+ name: declaration.name,
424
+ description: declaration.reason,
425
+ evidence: "SOURCE_DISCOVERED"
426
+ });
427
+ return {
428
+ toolId: stableId("tool", {
429
+ kind: "declared-tool",
430
+ file: relative,
431
+ line: declaration.line,
432
+ name: declaration.name
433
+ }),
434
+ canonicalName: declaration.name,
435
+ displayName: declaration.name,
436
+ description: declaration.reason,
437
+ origin: {
438
+ kind: "source",
439
+ host: "project",
440
+ scope: "workspace"
441
+ },
442
+ source: {
443
+ file: relative,
444
+ line: declaration.line
445
+ },
446
+ evidence: {
447
+ level: "SOURCE_DISCOVERED",
448
+ source: "framework-registration-scan"
449
+ },
450
+ visibility: {
451
+ configured: false,
452
+ runtimeRegistered: false,
453
+ modelVisible: false,
454
+ executed: false
455
+ },
456
+ once: assessment
457
+ };
458
+ });
459
+ }
460
+ export async function discoverToolGraph(requestedRoot) {
461
+ const root = path.resolve(requestedRoot);
462
+ const metadata = await detectProjectMetadata(root);
463
+ const configuredSources = await discoverConfiguredSources(root);
464
+ const files = await collectSourceFiles(root);
465
+ const tools = [];
466
+ for (const file of files) {
467
+ const findings = await scanFile(root, file);
468
+ tools.push(...findings.map(finding => toolFromFinding(root, finding)));
469
+ tools.push(...await discoverDeclaredTools(root, file));
470
+ }
471
+ const uniqueTools = new Map();
472
+ for (const tool of tools) {
473
+ uniqueTools.set(tool.toolId, tool);
474
+ }
475
+ return {
476
+ root,
477
+ languages: metadata.languages,
478
+ tooling: metadata.tooling,
479
+ configuredSources,
480
+ tools: [...uniqueTools.values()].sort((left, right) => right.once.actionPriority.score -
481
+ left.once.actionPriority.score ||
482
+ right.once.criticality.score -
483
+ left.once.criticality.score ||
484
+ left.canonicalName.localeCompare(right.canonicalName))
485
+ };
486
+ }
487
+ //# sourceMappingURL=tool-discovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-discovery.js","sourceRoot":"","sources":["../src/tool-discovery.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ export type ToolEvidenceLevel = "EXECUTED" | "MODEL_VISIBLE" | "RUNTIME_REGISTERED" | "SERVER_AUTHORITATIVE" | "HOST_CONFIGURED" | "SOURCE_DISCOVERED" | "REGISTRY_CANDIDATE";
2
+ export type ToolEffectClass = "READ_ONLY" | "GENERATION_ONLY" | "LOCAL_MUTATION" | "EXTERNAL_LOW_IMPACT_MUTATION" | "EXTERNAL_COMMUNICATION" | "EXTERNAL_BUSINESS_MUTATION" | "DATABASE_MUTATION" | "QUEUE_EVENT_MUTATION" | "STORAGE_MUTATION" | "CODE_REPOSITORY_MUTATION" | "MONEY_MOVEMENT" | "IDENTITY_ACCESS_SECURITY" | "PRODUCTION_INFRASTRUCTURE" | "DESTRUCTIVE_ADMIN" | "DYNAMIC_EXECUTION" | "UNKNOWN";
3
+ export type ToolQualification = "NOT_APPLICABLE" | "UNLIKELY" | "REVIEW_REQUIRED" | "QUALIFIED" | "UNKNOWN";
4
+ export type ToolProtectionState = "NONE" | "NATIVE_IDEMPOTENCY" | "AUTHORITATIVE_RECONCILIATION" | "ONCE_HEALTHY" | "ONCE_UNVERIFIED";
5
+ export type ToolImportanceBand = "I0" | "I1" | "I2" | "I3" | "I4" | "I5";
6
+ export type ToolActionBand = "BYPASS" | "OBSERVE" | "REVIEW" | "QUALIFY" | "PROTECT_PRIORITY" | "CRITICAL_GAP";
7
+ export type ToolImportanceAssessment = {
8
+ effectClass: ToolEffectClass;
9
+ criticality: {
10
+ score: number;
11
+ band: ToolImportanceBand;
12
+ confidence: number;
13
+ reasons: string[];
14
+ };
15
+ qualification: ToolQualification;
16
+ actionPriority: {
17
+ score: number;
18
+ band: ToolActionBand;
19
+ reasons: string[];
20
+ };
21
+ protection: ToolProtectionState;
22
+ protectedCritical: boolean;
23
+ };
24
+ export type ToolImportanceInput = {
25
+ name: string;
26
+ description?: string;
27
+ sourceCategory?: string;
28
+ evidence: ToolEvidenceLevel;
29
+ qualification?: ToolQualification;
30
+ protection?: ToolProtectionState;
31
+ readOnlyHint?: boolean;
32
+ };
33
+ export declare function assessToolImportance(input: ToolImportanceInput): ToolImportanceAssessment;
34
+ //# sourceMappingURL=tool-importance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-importance.d.ts","sourceRoot":"","sources":["../src/tool-importance.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,eAAe,GACf,oBAAoB,GACpB,sBAAsB,GACtB,iBAAiB,GACjB,mBAAmB,GACnB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,iBAAiB,GACjB,gBAAgB,GAChB,8BAA8B,GAC9B,wBAAwB,GACxB,4BAA4B,GAC5B,mBAAmB,GACnB,sBAAsB,GACtB,kBAAkB,GAClB,0BAA0B,GAC1B,gBAAgB,GAChB,0BAA0B,GAC1B,2BAA2B,GAC3B,mBAAmB,GACnB,mBAAmB,GACnB,SAAS,CAAC;AAEd,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,UAAU,GACV,iBAAiB,GACjB,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,oBAAoB,GACpB,8BAA8B,GAC9B,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,MAAM,kBAAkB,GAC1B,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,kBAAkB,GAClB,cAAc,CAAC;AAEnB,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,eAAe,CAAC;IAC7B,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,kBAAkB,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,aAAa,EAAE,iBAAiB,CAAC;IACjC,cAAc,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,UAAU,EAAE,mBAAmB,CAAC;IAChC,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AA+PF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,GACzB,wBAAwB,CAiG1B"}