dvalincode 0.12.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.
- package/LICENSE +22 -0
- package/README.md +649 -0
- package/README.zh-CN.md +623 -0
- package/THIRD_PARTY_NOTICES.md +432 -0
- package/dist/agent/compact.d.ts +4 -0
- package/dist/agent/compact.js +40 -0
- package/dist/agent/compact.js.map +1 -0
- package/dist/agent/loop.d.ts +44 -0
- package/dist/agent/loop.js +262 -0
- package/dist/agent/loop.js.map +1 -0
- package/dist/agent/modes.d.ts +13 -0
- package/dist/agent/modes.js +44 -0
- package/dist/agent/modes.js.map +1 -0
- package/dist/agent/runner.d.ts +37 -0
- package/dist/agent/runner.js +171 -0
- package/dist/agent/runner.js.map +1 -0
- package/dist/agent/session.d.ts +73 -0
- package/dist/agent/session.js +282 -0
- package/dist/agent/session.js.map +1 -0
- package/dist/agent/types.d.ts +86 -0
- package/dist/agent/types.js +26 -0
- package/dist/agent/types.js.map +1 -0
- package/dist/audit/diffStat.d.ts +8 -0
- package/dist/audit/diffStat.js +17 -0
- package/dist/audit/diffStat.js.map +1 -0
- package/dist/audit/hash.d.ts +10 -0
- package/dist/audit/hash.js +33 -0
- package/dist/audit/hash.js.map +1 -0
- package/dist/audit/log.d.ts +147 -0
- package/dist/audit/log.js +163 -0
- package/dist/audit/log.js.map +1 -0
- package/dist/audit/minimize.d.ts +10 -0
- package/dist/audit/minimize.js +61 -0
- package/dist/audit/minimize.js.map +1 -0
- package/dist/audit/report.d.ts +8 -0
- package/dist/audit/report.js +113 -0
- package/dist/audit/report.js.map +1 -0
- package/dist/audit/taps.d.ts +8 -0
- package/dist/audit/taps.js +67 -0
- package/dist/audit/taps.js.map +1 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.js +56 -0
- package/dist/cli.js.map +1 -0
- package/dist/commands/ask.d.ts +3 -0
- package/dist/commands/ask.js +14 -0
- package/dist/commands/ask.js.map +1 -0
- package/dist/commands/chat.d.ts +3 -0
- package/dist/commands/chat.js +148 -0
- package/dist/commands/chat.js.map +1 -0
- package/dist/commands/data.d.ts +2 -0
- package/dist/commands/data.js +65 -0
- package/dist/commands/data.js.map +1 -0
- package/dist/commands/evidence.d.ts +2 -0
- package/dist/commands/evidence.js +50 -0
- package/dist/commands/evidence.js.map +1 -0
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +18 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/memory.d.ts +2 -0
- package/dist/commands/memory.js +74 -0
- package/dist/commands/memory.js.map +1 -0
- package/dist/commands/policy.d.ts +2 -0
- package/dist/commands/policy.js +95 -0
- package/dist/commands/policy.js.map +1 -0
- package/dist/commands/provider.d.ts +2 -0
- package/dist/commands/provider.js +130 -0
- package/dist/commands/provider.js.map +1 -0
- package/dist/commands/report.d.ts +2 -0
- package/dist/commands/report.js +47 -0
- package/dist/commands/report.js.map +1 -0
- package/dist/commands/runTool.d.ts +3 -0
- package/dist/commands/runTool.js +41 -0
- package/dist/commands/runTool.js.map +1 -0
- package/dist/commands/scan.d.ts +2 -0
- package/dist/commands/scan.js +15 -0
- package/dist/commands/scan.js.map +1 -0
- package/dist/commands/serve.d.ts +2 -0
- package/dist/commands/serve.js +18 -0
- package/dist/commands/serve.js.map +1 -0
- package/dist/commands/tools.d.ts +3 -0
- package/dist/commands/tools.js +11 -0
- package/dist/commands/tools.js.map +1 -0
- package/dist/commands/trust.d.ts +2 -0
- package/dist/commands/trust.js +16 -0
- package/dist/commands/trust.js.map +1 -0
- package/dist/commands/tui.d.ts +2 -0
- package/dist/commands/tui.js +13 -0
- package/dist/commands/tui.js.map +1 -0
- package/dist/core/context.d.ts +28 -0
- package/dist/core/context.js +29 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/diffPreview.d.ts +6 -0
- package/dist/core/diffPreview.js +37 -0
- package/dist/core/diffPreview.js.map +1 -0
- package/dist/core/ignorefile.d.ts +1 -0
- package/dist/core/ignorefile.js +14 -0
- package/dist/core/ignorefile.js.map +1 -0
- package/dist/core/permissions.d.ts +3 -0
- package/dist/core/permissions.js +9 -0
- package/dist/core/permissions.js.map +1 -0
- package/dist/core/policy.d.ts +182 -0
- package/dist/core/policy.js +358 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/projectScanner.d.ts +12 -0
- package/dist/core/projectScanner.js +85 -0
- package/dist/core/projectScanner.js.map +1 -0
- package/dist/core/subprocessSandbox.d.ts +42 -0
- package/dist/core/subprocessSandbox.js +132 -0
- package/dist/core/subprocessSandbox.js.map +1 -0
- package/dist/core/trust.d.ts +50 -0
- package/dist/core/trust.js +191 -0
- package/dist/core/trust.js.map +1 -0
- package/dist/core/workspace.d.ts +9 -0
- package/dist/core/workspace.js +55 -0
- package/dist/core/workspace.js.map +1 -0
- package/dist/data/archive.d.ts +39 -0
- package/dist/data/archive.js +127 -0
- package/dist/data/archive.js.map +1 -0
- package/dist/evidence/compliance.d.ts +22 -0
- package/dist/evidence/compliance.js +57 -0
- package/dist/evidence/compliance.js.map +1 -0
- package/dist/evidence/pack.d.ts +56 -0
- package/dist/evidence/pack.js +123 -0
- package/dist/evidence/pack.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/client.d.ts +45 -0
- package/dist/mcp/client.js +111 -0
- package/dist/mcp/client.js.map +1 -0
- package/dist/mcp/config.d.ts +10 -0
- package/dist/mcp/config.js +18 -0
- package/dist/mcp/config.js.map +1 -0
- package/dist/mcp/governedFetch.d.ts +16 -0
- package/dist/mcp/governedFetch.js +44 -0
- package/dist/mcp/governedFetch.js.map +1 -0
- package/dist/mcp/register.d.ts +26 -0
- package/dist/mcp/register.js +77 -0
- package/dist/mcp/register.js.map +1 -0
- package/dist/memory/importers.d.ts +17 -0
- package/dist/memory/importers.js +186 -0
- package/dist/memory/importers.js.map +1 -0
- package/dist/memory/store.d.ts +71 -0
- package/dist/memory/store.js +251 -0
- package/dist/memory/store.js.map +1 -0
- package/dist/providers/egress.d.ts +2 -0
- package/dist/providers/egress.js +172 -0
- package/dist/providers/egress.js.map +1 -0
- package/dist/providers/localPlanner.d.ts +3 -0
- package/dist/providers/localPlanner.js +21 -0
- package/dist/providers/localPlanner.js.map +1 -0
- package/dist/providers/manager.d.ts +30 -0
- package/dist/providers/manager.js +48 -0
- package/dist/providers/manager.js.map +1 -0
- package/dist/providers/openaiCompatible.d.ts +5 -0
- package/dist/providers/openaiCompatible.js +176 -0
- package/dist/providers/openaiCompatible.js.map +1 -0
- package/dist/providers/pool.d.ts +14 -0
- package/dist/providers/pool.js +59 -0
- package/dist/providers/pool.js.map +1 -0
- package/dist/providers/secrets.d.ts +8 -0
- package/dist/providers/secrets.js +17 -0
- package/dist/providers/secrets.js.map +1 -0
- package/dist/providers/trustedBaseUrls.d.ts +1 -0
- package/dist/providers/trustedBaseUrls.js +49 -0
- package/dist/providers/trustedBaseUrls.js.map +1 -0
- package/dist/providers/types.d.ts +59 -0
- package/dist/providers/types.js +2 -0
- package/dist/providers/types.js.map +1 -0
- package/dist/remediation/cases.d.ts +37 -0
- package/dist/remediation/cases.js +90 -0
- package/dist/remediation/cases.js.map +1 -0
- package/dist/remediation/localScan.d.ts +2 -0
- package/dist/remediation/localScan.js +212 -0
- package/dist/remediation/localScan.js.map +1 -0
- package/dist/remediation/sarif.d.ts +26 -0
- package/dist/remediation/sarif.js +150 -0
- package/dist/remediation/sarif.js.map +1 -0
- package/dist/remediation/worktree.d.ts +11 -0
- package/dist/remediation/worktree.js +90 -0
- package/dist/remediation/worktree.js.map +1 -0
- package/dist/server/configStore.d.ts +59 -0
- package/dist/server/configStore.js +73 -0
- package/dist/server/configStore.js.map +1 -0
- package/dist/server/index.d.ts +17 -0
- package/dist/server/index.js +120 -0
- package/dist/server/index.js.map +1 -0
- package/dist/server/playbookHandler.d.ts +3 -0
- package/dist/server/playbookHandler.js +44 -0
- package/dist/server/playbookHandler.js.map +1 -0
- package/dist/server/routes/config.d.ts +1 -0
- package/dist/server/routes/config.js +184 -0
- package/dist/server/routes/config.js.map +1 -0
- package/dist/server/routes/data.d.ts +1 -0
- package/dist/server/routes/data.js +29 -0
- package/dist/server/routes/data.js.map +1 -0
- package/dist/server/routes/files.d.ts +1 -0
- package/dist/server/routes/files.js +20 -0
- package/dist/server/routes/files.js.map +1 -0
- package/dist/server/routes/git.d.ts +1 -0
- package/dist/server/routes/git.js +29 -0
- package/dist/server/routes/git.js.map +1 -0
- package/dist/server/routes/projects.d.ts +3 -0
- package/dist/server/routes/projects.js +178 -0
- package/dist/server/routes/projects.js.map +1 -0
- package/dist/server/routes/remediation.d.ts +1 -0
- package/dist/server/routes/remediation.js +99 -0
- package/dist/server/routes/remediation.js.map +1 -0
- package/dist/server/routes/sessions.d.ts +1 -0
- package/dist/server/routes/sessions.js +46 -0
- package/dist/server/routes/sessions.js.map +1 -0
- package/dist/server/routes/skills.d.ts +1 -0
- package/dist/server/routes/skills.js +48 -0
- package/dist/server/routes/skills.js.map +1 -0
- package/dist/server/routes/tools.d.ts +1 -0
- package/dist/server/routes/tools.js +12 -0
- package/dist/server/routes/tools.js.map +1 -0
- package/dist/server/security.d.ts +7 -0
- package/dist/server/security.js +128 -0
- package/dist/server/security.js.map +1 -0
- package/dist/server/wsHandler.d.ts +2 -0
- package/dist/server/wsHandler.js +212 -0
- package/dist/server/wsHandler.js.map +1 -0
- package/dist/sessions/journal.d.ts +65 -0
- package/dist/sessions/journal.js +98 -0
- package/dist/sessions/journal.js.map +1 -0
- package/dist/sessions/markdown.d.ts +8 -0
- package/dist/sessions/markdown.js +69 -0
- package/dist/sessions/markdown.js.map +1 -0
- package/dist/sessions/store.d.ts +26 -0
- package/dist/sessions/store.js +136 -0
- package/dist/sessions/store.js.map +1 -0
- package/dist/skills/store.d.ts +24 -0
- package/dist/skills/store.js +215 -0
- package/dist/skills/store.js.map +1 -0
- package/dist/tools/deleteFile.d.ts +8 -0
- package/dist/tools/deleteFile.js +37 -0
- package/dist/tools/deleteFile.js.map +1 -0
- package/dist/tools/editFile.d.ts +10 -0
- package/dist/tools/editFile.js +66 -0
- package/dist/tools/editFile.js.map +1 -0
- package/dist/tools/gitDiff.d.ts +10 -0
- package/dist/tools/gitDiff.js +59 -0
- package/dist/tools/gitDiff.js.map +1 -0
- package/dist/tools/gitStatus.d.ts +5 -0
- package/dist/tools/gitStatus.js +45 -0
- package/dist/tools/gitStatus.js.map +1 -0
- package/dist/tools/listFiles.d.ts +9 -0
- package/dist/tools/listFiles.js +36 -0
- package/dist/tools/listFiles.js.map +1 -0
- package/dist/tools/listRemediationCases.d.ts +8 -0
- package/dist/tools/listRemediationCases.js +23 -0
- package/dist/tools/listRemediationCases.js.map +1 -0
- package/dist/tools/listSkills.d.ts +6 -0
- package/dist/tools/listSkills.js +21 -0
- package/dist/tools/listSkills.js.map +1 -0
- package/dist/tools/memoryDelete.d.ts +8 -0
- package/dist/tools/memoryDelete.js +24 -0
- package/dist/tools/memoryDelete.js.map +1 -0
- package/dist/tools/memoryImport.d.ts +18 -0
- package/dist/tools/memoryImport.js +64 -0
- package/dist/tools/memoryImport.js.map +1 -0
- package/dist/tools/memorySearch.d.ts +13 -0
- package/dist/tools/memorySearch.js +40 -0
- package/dist/tools/memorySearch.js.map +1 -0
- package/dist/tools/memoryUpdate.d.ts +19 -0
- package/dist/tools/memoryUpdate.js +38 -0
- package/dist/tools/memoryUpdate.js.map +1 -0
- package/dist/tools/memoryWrite.d.ts +22 -0
- package/dist/tools/memoryWrite.js +36 -0
- package/dist/tools/memoryWrite.js.map +1 -0
- package/dist/tools/prepareRemediationWorktree.d.ts +8 -0
- package/dist/tools/prepareRemediationWorktree.js +48 -0
- package/dist/tools/prepareRemediationWorktree.js.map +1 -0
- package/dist/tools/projectScripts.d.ts +11 -0
- package/dist/tools/projectScripts.js +64 -0
- package/dist/tools/projectScripts.js.map +1 -0
- package/dist/tools/readFile.d.ts +10 -0
- package/dist/tools/readFile.js +57 -0
- package/dist/tools/readFile.js.map +1 -0
- package/dist/tools/readSkill.d.ts +8 -0
- package/dist/tools/readSkill.js +25 -0
- package/dist/tools/readSkill.js.map +1 -0
- package/dist/tools/registry.d.ts +15 -0
- package/dist/tools/registry.js +121 -0
- package/dist/tools/registry.js.map +1 -0
- package/dist/tools/runCheck.d.ts +17 -0
- package/dist/tools/runCheck.js +125 -0
- package/dist/tools/runCheck.js.map +1 -0
- package/dist/tools/runSecurityScan.d.ts +8 -0
- package/dist/tools/runSecurityScan.js +36 -0
- package/dist/tools/runSecurityScan.js.map +1 -0
- package/dist/tools/searchText.d.ts +11 -0
- package/dist/tools/searchText.js +67 -0
- package/dist/tools/searchText.js.map +1 -0
- package/dist/tools/shell.d.ts +16 -0
- package/dist/tools/shell.js +114 -0
- package/dist/tools/shell.js.map +1 -0
- package/dist/tools/types.d.ts +57 -0
- package/dist/tools/types.js +2 -0
- package/dist/tools/types.js.map +1 -0
- package/dist/tools/writeFile.d.ts +9 -0
- package/dist/tools/writeFile.js +89 -0
- package/dist/tools/writeFile.js.map +1 -0
- package/dist/tui/app.d.ts +8 -0
- package/dist/tui/app.js +178 -0
- package/dist/tui/app.js.map +1 -0
- package/dist/tui/presets.d.ts +13 -0
- package/dist/tui/presets.js +11 -0
- package/dist/tui/presets.js.map +1 -0
- package/dist/tui/render.d.ts +14 -0
- package/dist/tui/render.js +83 -0
- package/dist/tui/render.js.map +1 -0
- package/dist/ui/output.d.ts +4 -0
- package/dist/ui/output.js +21 -0
- package/dist/ui/output.js.map +1 -0
- package/package.json +77 -0
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { checkEgress, PolicyViolationError } from '../core/policy.js';
|
|
2
|
+
/**
|
|
3
|
+
* The one network path for MCP. Every request to a server passes through here so
|
|
4
|
+
* egress is enforced and audited before any third-party connection is made. An
|
|
5
|
+
* MCP gateway is **not** the model endpoint, so `checkEgress(policy, false)`
|
|
6
|
+
* blocks it under `network: off` / `endpoint-only`. Auth headers and bodies are
|
|
7
|
+
* never logged — the audit record carries only server, tool, host, outcome, and
|
|
8
|
+
* duration.
|
|
9
|
+
*/
|
|
10
|
+
export async function governedMcpFetch(url, init, ctx, tool) {
|
|
11
|
+
const host = safeOrigin(url);
|
|
12
|
+
const started = Date.now();
|
|
13
|
+
const decision = checkEgress(ctx.policy, false);
|
|
14
|
+
if (!decision.allowed) {
|
|
15
|
+
ctx.audit?.append({ type: 'mcp_request', server: ctx.serverId, tool, host, outcome: 'blocked', durationMs: Date.now() - started });
|
|
16
|
+
ctx.audit?.append({ type: 'policy_violation', rule: decision.rule, tool: `mcp:${ctx.serverId}`, target: host });
|
|
17
|
+
throw new PolicyViolationError(`mcp:${ctx.serverId}`, decision.rule, host);
|
|
18
|
+
}
|
|
19
|
+
try {
|
|
20
|
+
const res = await fetch(url, init);
|
|
21
|
+
ctx.audit?.append({
|
|
22
|
+
type: 'mcp_request',
|
|
23
|
+
server: ctx.serverId,
|
|
24
|
+
tool,
|
|
25
|
+
host,
|
|
26
|
+
outcome: res.ok ? 'ok' : 'error',
|
|
27
|
+
durationMs: Date.now() - started,
|
|
28
|
+
});
|
|
29
|
+
return res;
|
|
30
|
+
}
|
|
31
|
+
catch (err) {
|
|
32
|
+
ctx.audit?.append({ type: 'mcp_request', server: ctx.serverId, tool, host, outcome: 'error', durationMs: Date.now() - started });
|
|
33
|
+
throw err;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
function safeOrigin(url) {
|
|
37
|
+
try {
|
|
38
|
+
return new URL(url).origin;
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
return 'invalid-url';
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=governedFetch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"governedFetch.js","sourceRoot":"","sources":["../../src/mcp/governedFetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAuB,MAAM,mBAAmB,CAAC;AAS3F;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,IAAiB,EACjB,GAAqB,EACrB,IAAY;IAEZ,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACnI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChH,MAAM,IAAI,oBAAoB,CAAC,OAAO,GAAG,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;YAChB,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,GAAG,CAAC,QAAQ;YACpB,IAAI;YACJ,IAAI;YACJ,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;YAChC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SACjC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACjI,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { type ResolvedPolicy } from '../core/policy.js';
|
|
2
|
+
import type { AuditSink } from '../audit/log.js';
|
|
3
|
+
import type { Tool } from '../tools/types.js';
|
|
4
|
+
import type { ToolRegistry } from '../tools/registry.js';
|
|
5
|
+
import type { McpServerConfig } from '../server/configStore.js';
|
|
6
|
+
import { McpClient, type McpToolDef } from './client.js';
|
|
7
|
+
/** Namespaced tool name — collision-proof and provenance-visible in the audit trail. */
|
|
8
|
+
export declare function mcpNamespacedName(serverId: string, toolName: string): string;
|
|
9
|
+
/** Adapt one discovered MCP tool into a DvalinCode `Tool` that proxies `tools/call`. */
|
|
10
|
+
export declare function mcpToolToTool(serverId: string, def: McpToolDef, client: McpClient): Tool<unknown>;
|
|
11
|
+
export type McpServerStatus = 'connected' | 'denied' | 'blocked' | 'error';
|
|
12
|
+
export type McpConnectionSummary = {
|
|
13
|
+
id: string;
|
|
14
|
+
status: McpServerStatus;
|
|
15
|
+
tools: number;
|
|
16
|
+
reason?: string;
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Connect to each enabled + policy-permitted MCP server, discover its tools, and
|
|
20
|
+
* register them into the registry. Discovery egress is enforced by the governed
|
|
21
|
+
* fetch; per-tool calls are enforced and audited against the live run later.
|
|
22
|
+
*/
|
|
23
|
+
export declare function registerMcpServers(registry: ToolRegistry, servers: McpServerConfig[] | undefined, ctx: {
|
|
24
|
+
policy: ResolvedPolicy;
|
|
25
|
+
audit?: AuditSink;
|
|
26
|
+
}): Promise<McpConnectionSummary[]>;
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { checkMcpServer, PolicyViolationError } from '../core/policy.js';
|
|
3
|
+
import { McpClient } from './client.js';
|
|
4
|
+
import { resolveHeaders, enabledServers } from './config.js';
|
|
5
|
+
/** Namespaced tool name — collision-proof and provenance-visible in the audit trail. */
|
|
6
|
+
export function mcpNamespacedName(serverId, toolName) {
|
|
7
|
+
return `mcp__${serverId}__${toolName}`;
|
|
8
|
+
}
|
|
9
|
+
/** Governance-first: only an explicitly read-only tool is `read`; everything else is the most-gated tier. */
|
|
10
|
+
function accessFor(def) {
|
|
11
|
+
return def.annotations?.readOnlyHint ? 'read' : 'execute';
|
|
12
|
+
}
|
|
13
|
+
function renderContent(result) {
|
|
14
|
+
const parts = (result.content ?? []).map(c => (typeof c.text === 'string' ? c.text : `[${c.type}]`));
|
|
15
|
+
const text = parts.join('\n').trim();
|
|
16
|
+
if (text)
|
|
17
|
+
return text;
|
|
18
|
+
return result.isError ? '(MCP tool returned an error with no content)' : '(no content)';
|
|
19
|
+
}
|
|
20
|
+
/** Adapt one discovered MCP tool into a DvalinCode `Tool` that proxies `tools/call`. */
|
|
21
|
+
export function mcpToolToTool(serverId, def, client) {
|
|
22
|
+
return {
|
|
23
|
+
name: mcpNamespacedName(serverId, def.name),
|
|
24
|
+
description: def.description ?? `MCP tool "${def.name}" from server "${serverId}"`,
|
|
25
|
+
access: accessFor(def),
|
|
26
|
+
inputSchema: z.unknown(),
|
|
27
|
+
parametersSchema: def.inputSchema ?? { type: 'object' },
|
|
28
|
+
isConcurrencySafe: () => Boolean(def.annotations?.readOnlyHint),
|
|
29
|
+
async run(input, context) {
|
|
30
|
+
// Egress + audit are bound to the live per-run context here, so every
|
|
31
|
+
// tools/call is checked against policy and recorded in this run's chain.
|
|
32
|
+
const result = await client.callTool(def.name, input ?? {}, {
|
|
33
|
+
policy: context.policy,
|
|
34
|
+
audit: context.audit,
|
|
35
|
+
serverId,
|
|
36
|
+
});
|
|
37
|
+
return {
|
|
38
|
+
title: `MCP ${serverId}: ${def.name}`,
|
|
39
|
+
output: renderContent(result),
|
|
40
|
+
metadata: { server: serverId, tool: def.name, isError: Boolean(result.isError) },
|
|
41
|
+
};
|
|
42
|
+
},
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Connect to each enabled + policy-permitted MCP server, discover its tools, and
|
|
47
|
+
* register them into the registry. Discovery egress is enforced by the governed
|
|
48
|
+
* fetch; per-tool calls are enforced and audited against the live run later.
|
|
49
|
+
*/
|
|
50
|
+
export async function registerMcpServers(registry, servers, ctx) {
|
|
51
|
+
const summaries = [];
|
|
52
|
+
for (const server of enabledServers(servers)) {
|
|
53
|
+
const decision = checkMcpServer(ctx.policy, server.id);
|
|
54
|
+
if (!decision.allowed) {
|
|
55
|
+
summaries.push({ id: server.id, status: 'denied', tools: 0, reason: decision.rule });
|
|
56
|
+
continue;
|
|
57
|
+
}
|
|
58
|
+
const client = new McpClient({ id: server.id, url: server.url }, resolveHeaders(server.headers));
|
|
59
|
+
const egress = { policy: ctx.policy, audit: ctx.audit, serverId: server.id };
|
|
60
|
+
try {
|
|
61
|
+
await client.initialize(egress);
|
|
62
|
+
const tools = await client.listTools(egress);
|
|
63
|
+
for (const def of tools)
|
|
64
|
+
registry.register(mcpToolToTool(server.id, def, client));
|
|
65
|
+
summaries.push({ id: server.id, status: 'connected', tools: tools.length });
|
|
66
|
+
}
|
|
67
|
+
catch (err) {
|
|
68
|
+
const blocked = err instanceof PolicyViolationError;
|
|
69
|
+
summaries.push({ id: server.id, status: blocked ? 'blocked' : 'error', tools: 0, reason: errMsg(err) });
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
return summaries;
|
|
73
|
+
}
|
|
74
|
+
function errMsg(err) {
|
|
75
|
+
return err instanceof Error ? err.message : String(err);
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=register.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/mcp/register.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { MemoryCandidate, MemoryScope } from './store.js';
|
|
2
|
+
export type MemoryImportSource = 'claude' | 'hermes' | 'markdown';
|
|
3
|
+
export type MemoryImportOptions = {
|
|
4
|
+
source: MemoryImportSource;
|
|
5
|
+
sourcePath?: string;
|
|
6
|
+
cwd?: string;
|
|
7
|
+
scope?: MemoryScope;
|
|
8
|
+
dryRun?: boolean;
|
|
9
|
+
};
|
|
10
|
+
export type MemoryImportResult = {
|
|
11
|
+
source: MemoryImportSource;
|
|
12
|
+
scope: MemoryScope;
|
|
13
|
+
candidates: MemoryCandidate[];
|
|
14
|
+
imported: number;
|
|
15
|
+
skipped: number;
|
|
16
|
+
};
|
|
17
|
+
export declare function importMemory(options: MemoryImportOptions): Promise<MemoryImportResult>;
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
import { stat, readFile, readdir } from 'node:fs/promises';
|
|
2
|
+
import { homedir } from 'node:os';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { addMemoryEntries } from './store.js';
|
|
5
|
+
export async function importMemory(options) {
|
|
6
|
+
const scope = options.scope ?? defaultScope(options.source);
|
|
7
|
+
const candidates = await collectCandidates(options);
|
|
8
|
+
if (options.dryRun) {
|
|
9
|
+
return { source: options.source, scope, candidates, imported: 0, skipped: 0 };
|
|
10
|
+
}
|
|
11
|
+
const result = await addMemoryEntries({ scope, cwd: options.cwd, candidates });
|
|
12
|
+
return {
|
|
13
|
+
source: options.source,
|
|
14
|
+
scope,
|
|
15
|
+
candidates,
|
|
16
|
+
imported: result.imported.length,
|
|
17
|
+
skipped: result.skipped,
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
async function collectCandidates(options) {
|
|
21
|
+
switch (options.source) {
|
|
22
|
+
case 'claude':
|
|
23
|
+
return collectClaudeCandidates(options.sourcePath, options.cwd);
|
|
24
|
+
case 'hermes':
|
|
25
|
+
return collectHermesCandidates(options.sourcePath);
|
|
26
|
+
case 'markdown':
|
|
27
|
+
if (!options.sourcePath)
|
|
28
|
+
throw new Error('markdown import requires sourcePath');
|
|
29
|
+
return collectMarkdownCandidates([options.sourcePath], 'import:markdown');
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
async function collectClaudeCandidates(sourcePath, cwd) {
|
|
33
|
+
const paths = sourcePath ? [sourcePath] : await defaultClaudePaths(cwd);
|
|
34
|
+
return collectMarkdownCandidates(paths, 'import:claude');
|
|
35
|
+
}
|
|
36
|
+
async function collectHermesCandidates(sourcePath) {
|
|
37
|
+
const base = sourcePath ?? path.join(homedir(), '.hermes', 'memories');
|
|
38
|
+
return collectMarkdownCandidates([base], 'import:hermes');
|
|
39
|
+
}
|
|
40
|
+
async function defaultClaudePaths(cwd) {
|
|
41
|
+
const paths = [];
|
|
42
|
+
if (cwd) {
|
|
43
|
+
paths.push(path.join(cwd, 'CLAUDE.md'));
|
|
44
|
+
paths.push(path.join(cwd, 'CLAUDE.local.md'));
|
|
45
|
+
const discovered = await findClaudeProjectMemoryDir(cwd);
|
|
46
|
+
if (discovered)
|
|
47
|
+
paths.push(discovered);
|
|
48
|
+
}
|
|
49
|
+
paths.push(path.join(homedir(), '.claude', 'CLAUDE.md'));
|
|
50
|
+
return paths;
|
|
51
|
+
}
|
|
52
|
+
async function findClaudeProjectMemoryDir(cwd) {
|
|
53
|
+
const projectsRoot = path.join(homedir(), '.claude', 'projects');
|
|
54
|
+
const basename = path.basename(cwd).toLowerCase();
|
|
55
|
+
try {
|
|
56
|
+
const children = await readdir(projectsRoot, { withFileTypes: true });
|
|
57
|
+
for (const child of children) {
|
|
58
|
+
if (!child.isDirectory())
|
|
59
|
+
continue;
|
|
60
|
+
const dirName = child.name.toLowerCase();
|
|
61
|
+
if (!dirName.includes(basename))
|
|
62
|
+
continue;
|
|
63
|
+
const memoryDir = path.join(projectsRoot, child.name, 'memory');
|
|
64
|
+
if (await exists(path.join(memoryDir, 'MEMORY.md')))
|
|
65
|
+
return memoryDir;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
// Claude may not be installed or may not have auto-memory yet.
|
|
70
|
+
}
|
|
71
|
+
return undefined;
|
|
72
|
+
}
|
|
73
|
+
async function collectMarkdownCandidates(paths, source) {
|
|
74
|
+
const files = [];
|
|
75
|
+
for (const p of paths) {
|
|
76
|
+
files.push(...await markdownFiles(p));
|
|
77
|
+
}
|
|
78
|
+
const candidates = [];
|
|
79
|
+
for (const file of files) {
|
|
80
|
+
const text = await readFile(file, 'utf-8').catch(() => '');
|
|
81
|
+
for (const chunk of splitMarkdownMemory(text)) {
|
|
82
|
+
candidates.push({
|
|
83
|
+
content: chunk,
|
|
84
|
+
kind: inferKind(chunk, file),
|
|
85
|
+
tags: inferTags(chunk, file),
|
|
86
|
+
source,
|
|
87
|
+
sourcePath: file,
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
return dedupeCandidates(candidates);
|
|
92
|
+
}
|
|
93
|
+
async function markdownFiles(input) {
|
|
94
|
+
if (!await exists(input))
|
|
95
|
+
return [];
|
|
96
|
+
const info = await stat(input);
|
|
97
|
+
if (info.isFile())
|
|
98
|
+
return input.toLowerCase().endsWith('.md') ? [input] : [];
|
|
99
|
+
if (!info.isDirectory())
|
|
100
|
+
return [];
|
|
101
|
+
const files = [];
|
|
102
|
+
const children = await readdir(input, { withFileTypes: true });
|
|
103
|
+
for (const child of children) {
|
|
104
|
+
const childPath = path.join(input, child.name);
|
|
105
|
+
if (child.isFile() && child.name.toLowerCase().endsWith('.md')) {
|
|
106
|
+
files.push(childPath);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
return files.sort();
|
|
110
|
+
}
|
|
111
|
+
function splitMarkdownMemory(text) {
|
|
112
|
+
const normalized = text.replace(/\r\n/g, '\n');
|
|
113
|
+
if (normalized.includes('§')) {
|
|
114
|
+
return normalized.split('§').map(cleanChunk).filter(Boolean);
|
|
115
|
+
}
|
|
116
|
+
const bullets = normalized
|
|
117
|
+
.split('\n')
|
|
118
|
+
.map(line => line.match(/^\s*[-*]\s+(.+)$/)?.[1] ?? '')
|
|
119
|
+
.map(cleanChunk)
|
|
120
|
+
.filter(Boolean);
|
|
121
|
+
if (bullets.length > 0)
|
|
122
|
+
return bullets;
|
|
123
|
+
return normalized
|
|
124
|
+
.split(/\n{2,}/)
|
|
125
|
+
.map(cleanChunk)
|
|
126
|
+
.filter(Boolean);
|
|
127
|
+
}
|
|
128
|
+
function cleanChunk(input) {
|
|
129
|
+
const text = input
|
|
130
|
+
.split('\n')
|
|
131
|
+
.filter(line => !line.trim().startsWith('#'))
|
|
132
|
+
.join('\n')
|
|
133
|
+
.trim();
|
|
134
|
+
if (!text || text.startsWith('```'))
|
|
135
|
+
return '';
|
|
136
|
+
if (/^(id|source|updated|created):/i.test(text))
|
|
137
|
+
return '';
|
|
138
|
+
return text.length > 1_800 ? `${text.slice(0, 1_800).trim()}...` : text;
|
|
139
|
+
}
|
|
140
|
+
function inferKind(content, file) {
|
|
141
|
+
const lower = `${file}\n${content}`.toLowerCase();
|
|
142
|
+
if (lower.includes('prefer') || lower.includes('preference'))
|
|
143
|
+
return 'preference';
|
|
144
|
+
if (lower.includes('command') || lower.includes('workflow') || lower.includes('run '))
|
|
145
|
+
return 'workflow';
|
|
146
|
+
if (lower.includes('decision') || lower.includes('adr'))
|
|
147
|
+
return 'decision';
|
|
148
|
+
if (lower.includes('bug') || lower.includes('lesson') || lower.includes('pitfall'))
|
|
149
|
+
return 'lesson';
|
|
150
|
+
return 'note';
|
|
151
|
+
}
|
|
152
|
+
function inferTags(content, file) {
|
|
153
|
+
const tags = new Set();
|
|
154
|
+
const base = path.basename(file, path.extname(file)).toLowerCase();
|
|
155
|
+
if (base && base !== 'memory')
|
|
156
|
+
tags.add(base);
|
|
157
|
+
for (const token of content.toLowerCase().match(/\b(test|build|deploy|api|database|frontend|backend|security|git|docker|python|typescript)\b/g) ?? []) {
|
|
158
|
+
tags.add(token);
|
|
159
|
+
}
|
|
160
|
+
return [...tags].slice(0, 6);
|
|
161
|
+
}
|
|
162
|
+
function dedupeCandidates(candidates) {
|
|
163
|
+
const seen = new Set();
|
|
164
|
+
const result = [];
|
|
165
|
+
for (const candidate of candidates) {
|
|
166
|
+
const key = candidate.content.toLowerCase().replace(/\s+/g, ' ').trim();
|
|
167
|
+
if (!key || seen.has(key))
|
|
168
|
+
continue;
|
|
169
|
+
seen.add(key);
|
|
170
|
+
result.push(candidate);
|
|
171
|
+
}
|
|
172
|
+
return result;
|
|
173
|
+
}
|
|
174
|
+
function defaultScope(source) {
|
|
175
|
+
return source === 'hermes' ? 'user' : 'project';
|
|
176
|
+
}
|
|
177
|
+
async function exists(input) {
|
|
178
|
+
try {
|
|
179
|
+
await stat(input);
|
|
180
|
+
return true;
|
|
181
|
+
}
|
|
182
|
+
catch {
|
|
183
|
+
return false;
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
//# sourceMappingURL=importers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"importers.js","sourceRoot":"","sources":["../../src/memory/importers.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
export type MemoryScope = 'user' | 'project';
|
|
2
|
+
export type MemoryKind = 'preference' | 'project_fact' | 'decision' | 'workflow' | 'lesson' | 'note';
|
|
3
|
+
export type MemorySource = 'manual' | 'agent' | 'import:claude' | 'import:hermes' | 'import:markdown';
|
|
4
|
+
export type MemoryEntry = {
|
|
5
|
+
id: string;
|
|
6
|
+
scope: MemoryScope;
|
|
7
|
+
kind: MemoryKind;
|
|
8
|
+
content: string;
|
|
9
|
+
tags: string[];
|
|
10
|
+
source: MemorySource;
|
|
11
|
+
sourcePath?: string;
|
|
12
|
+
projectId?: string;
|
|
13
|
+
projectRoot?: string;
|
|
14
|
+
confidence: number;
|
|
15
|
+
createdAt: string;
|
|
16
|
+
updatedAt: string;
|
|
17
|
+
lastUsedAt?: string;
|
|
18
|
+
};
|
|
19
|
+
export type MemoryCandidate = {
|
|
20
|
+
content: string;
|
|
21
|
+
kind?: MemoryKind;
|
|
22
|
+
tags?: string[];
|
|
23
|
+
source: MemorySource;
|
|
24
|
+
sourcePath?: string;
|
|
25
|
+
};
|
|
26
|
+
export type MemorySearchOptions = {
|
|
27
|
+
cwd?: string;
|
|
28
|
+
scopes?: MemoryScope[];
|
|
29
|
+
maxResults?: number;
|
|
30
|
+
};
|
|
31
|
+
export type MemorySearchResult = MemoryEntry & {
|
|
32
|
+
score: number;
|
|
33
|
+
};
|
|
34
|
+
export declare function dvalinHome(): string;
|
|
35
|
+
export declare function memoryRoot(): string;
|
|
36
|
+
export declare function projectMemoryId(cwd: string): Promise<string>;
|
|
37
|
+
export declare function projectMemoryDir(cwd: string): Promise<string>;
|
|
38
|
+
export declare function userMemoryDir(): string;
|
|
39
|
+
export declare function addMemoryEntry(input: {
|
|
40
|
+
scope: MemoryScope;
|
|
41
|
+
cwd?: string;
|
|
42
|
+
content: string;
|
|
43
|
+
kind?: MemoryKind;
|
|
44
|
+
tags?: string[];
|
|
45
|
+
source?: MemorySource;
|
|
46
|
+
sourcePath?: string;
|
|
47
|
+
confidence?: number;
|
|
48
|
+
}): Promise<MemoryEntry>;
|
|
49
|
+
export declare function addMemoryEntries(input: {
|
|
50
|
+
scope: MemoryScope;
|
|
51
|
+
cwd?: string;
|
|
52
|
+
candidates: MemoryCandidate[];
|
|
53
|
+
}): Promise<{
|
|
54
|
+
imported: MemoryEntry[];
|
|
55
|
+
skipped: number;
|
|
56
|
+
}>;
|
|
57
|
+
export declare function listMemoryEntries(options?: MemorySearchOptions): Promise<MemoryEntry[]>;
|
|
58
|
+
export declare function searchMemory(query: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
|
|
59
|
+
export declare function updateMemoryEntry(input: {
|
|
60
|
+
id: string;
|
|
61
|
+
cwd?: string;
|
|
62
|
+
content?: string;
|
|
63
|
+
kind?: MemoryKind;
|
|
64
|
+
tags?: string[];
|
|
65
|
+
confidence?: number;
|
|
66
|
+
}): Promise<MemoryEntry | null>;
|
|
67
|
+
export declare function deleteMemoryEntry(input: {
|
|
68
|
+
id: string;
|
|
69
|
+
cwd?: string;
|
|
70
|
+
}): Promise<boolean>;
|
|
71
|
+
export declare function renderRelevantMemory(cwd: string, query: string, maxResults?: number): Promise<string>;
|