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,127 @@
|
|
|
1
|
+
import { mkdir, readFile, readdir, writeFile, stat } from 'node:fs/promises';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { dvalinHome } from '../memory/store.js';
|
|
4
|
+
/**
|
|
5
|
+
* Portable backup of everything DvalinCode stores locally under ~/.dvalincode
|
|
6
|
+
* (config, profiles, sessions, memory, audit logs, project metadata). Used to
|
|
7
|
+
* migrate a setup to another machine: export → copy the file → import.
|
|
8
|
+
*
|
|
9
|
+
* All DvalinCode data is UTF-8 text (JSON / JSONL / Markdown), so the bundle is
|
|
10
|
+
* a simple relative-path → content map — dependency-free and human-inspectable.
|
|
11
|
+
*/
|
|
12
|
+
export const DATA_BUNDLE_VERSION = 1;
|
|
13
|
+
const MAX_FILE_BYTES = 25 * 1024 * 1024; // skip anything implausibly large
|
|
14
|
+
/** Collect all local data into a portable bundle. */
|
|
15
|
+
export async function exportData(options = {}) {
|
|
16
|
+
const home = options.home ?? dvalinHome();
|
|
17
|
+
const includeAudit = options.includeAudit ?? true;
|
|
18
|
+
const files = {};
|
|
19
|
+
for await (const rel of walk(home, '')) {
|
|
20
|
+
const top = rel.split('/')[0];
|
|
21
|
+
if (!includeAudit && top === 'audit')
|
|
22
|
+
continue;
|
|
23
|
+
const abs = path.join(home, rel);
|
|
24
|
+
let info;
|
|
25
|
+
try {
|
|
26
|
+
info = await stat(abs);
|
|
27
|
+
}
|
|
28
|
+
catch {
|
|
29
|
+
continue;
|
|
30
|
+
}
|
|
31
|
+
if (!info.isFile() || info.size > MAX_FILE_BYTES)
|
|
32
|
+
continue;
|
|
33
|
+
try {
|
|
34
|
+
// utf-8 read; binary files (none expected) would round-trip lossily, so skip.
|
|
35
|
+
const content = await readFile(abs, 'utf-8');
|
|
36
|
+
files[rel] = content;
|
|
37
|
+
}
|
|
38
|
+
catch {
|
|
39
|
+
// unreadable / non-text — skip rather than abort the whole export
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
return {
|
|
43
|
+
app: 'dvalincode',
|
|
44
|
+
version: DATA_BUNDLE_VERSION,
|
|
45
|
+
exportedAt: new Date().toISOString(),
|
|
46
|
+
files,
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
/** Validate a parsed object is a DvalinCode data bundle. */
|
|
50
|
+
export function isDataBundle(value) {
|
|
51
|
+
if (!value || typeof value !== 'object')
|
|
52
|
+
return false;
|
|
53
|
+
const b = value;
|
|
54
|
+
return b.app === 'dvalincode' && typeof b.version === 'number' && !!b.files && typeof b.files === 'object';
|
|
55
|
+
}
|
|
56
|
+
/** Restore a bundle into ~/.dvalincode. Paths are sanitized to stay inside home. */
|
|
57
|
+
export async function importData(bundle, options = {}) {
|
|
58
|
+
if (!isDataBundle(bundle)) {
|
|
59
|
+
throw new Error('Not a valid DvalinCode data bundle.');
|
|
60
|
+
}
|
|
61
|
+
if (bundle.version > DATA_BUNDLE_VERSION) {
|
|
62
|
+
throw new Error(`Bundle version ${bundle.version} is newer than this build supports (${DATA_BUNDLE_VERSION}).`);
|
|
63
|
+
}
|
|
64
|
+
const home = options.home ?? dvalinHome();
|
|
65
|
+
const overwrite = options.overwrite ?? true;
|
|
66
|
+
const entries = Object.entries(bundle.files);
|
|
67
|
+
let written = 0;
|
|
68
|
+
let skipped = 0;
|
|
69
|
+
for (const [rel, content] of entries) {
|
|
70
|
+
const safeRel = sanitizeRelPath(rel);
|
|
71
|
+
if (!safeRel) {
|
|
72
|
+
skipped++;
|
|
73
|
+
continue;
|
|
74
|
+
}
|
|
75
|
+
const abs = path.join(home, safeRel);
|
|
76
|
+
if (!overwrite && (await exists(abs))) {
|
|
77
|
+
skipped++;
|
|
78
|
+
continue;
|
|
79
|
+
}
|
|
80
|
+
await mkdir(path.dirname(abs), { recursive: true });
|
|
81
|
+
await writeFile(abs, content, 'utf-8');
|
|
82
|
+
written++;
|
|
83
|
+
}
|
|
84
|
+
return { written, skipped, total: entries.length };
|
|
85
|
+
}
|
|
86
|
+
/** Reject absolute paths and `..` traversal; normalize separators. */
|
|
87
|
+
function sanitizeRelPath(rel) {
|
|
88
|
+
const normalized = rel.replace(/\\/g, '/').replace(/^\/+/, '');
|
|
89
|
+
if (!normalized || normalized.includes('\0'))
|
|
90
|
+
return null;
|
|
91
|
+
const parts = normalized.split('/');
|
|
92
|
+
if (parts.some(p => p === '..' || p === '.'))
|
|
93
|
+
return null;
|
|
94
|
+
return parts.join(path.sep);
|
|
95
|
+
}
|
|
96
|
+
async function exists(p) {
|
|
97
|
+
try {
|
|
98
|
+
await stat(p);
|
|
99
|
+
return true;
|
|
100
|
+
}
|
|
101
|
+
catch {
|
|
102
|
+
return false;
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
/** Recursively yield file paths relative to `base`, skipping dotfiles like .DS_Store. */
|
|
106
|
+
async function* walk(base, rel) {
|
|
107
|
+
const dir = path.join(base, rel);
|
|
108
|
+
let dirents;
|
|
109
|
+
try {
|
|
110
|
+
dirents = await readdir(dir, { withFileTypes: true });
|
|
111
|
+
}
|
|
112
|
+
catch {
|
|
113
|
+
return;
|
|
114
|
+
}
|
|
115
|
+
for (const dirent of dirents) {
|
|
116
|
+
if (dirent.name === '.DS_Store')
|
|
117
|
+
continue;
|
|
118
|
+
const childRel = rel ? `${rel}/${dirent.name}` : dirent.name;
|
|
119
|
+
if (dirent.isDirectory()) {
|
|
120
|
+
yield* walk(base, childRel);
|
|
121
|
+
}
|
|
122
|
+
else if (dirent.isFile()) {
|
|
123
|
+
yield childRel;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
//# sourceMappingURL=archive.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/data/archive.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { EvidencePack } from './pack.js';
|
|
2
|
+
/**
|
|
3
|
+
* A reviewer's bridge from DvalinCode's runtime controls to the compliance
|
|
4
|
+
* frameworks the project already tracks (docs/security/OPENSSF-SCORECARD.md,
|
|
5
|
+
* docs/governance/ISO-42001-AIMS.md). Each entry names a control, the pack
|
|
6
|
+
* section that *backs* it with real data, and the clause it maps to. The pack
|
|
7
|
+
* marks a control `backed: true` only when that section actually contains
|
|
8
|
+
* evidence in this export — we never fabricate coverage.
|
|
9
|
+
*/
|
|
10
|
+
export type ComplianceControl = {
|
|
11
|
+
id: string;
|
|
12
|
+
control: string;
|
|
13
|
+
section: 'policy' | 'trust' | 'runs';
|
|
14
|
+
openssf?: string;
|
|
15
|
+
iso42001?: string;
|
|
16
|
+
};
|
|
17
|
+
export declare const COMPLIANCE_CONTROLS: ComplianceControl[];
|
|
18
|
+
export type ComplianceEntry = ComplianceControl & {
|
|
19
|
+
backed: boolean;
|
|
20
|
+
};
|
|
21
|
+
/** Mark each control backed/unbacked by what this specific pack actually contains. */
|
|
22
|
+
export declare function evaluateCompliance(pack: Omit<EvidencePack, 'compliance' | 'manifest'>): ComplianceEntry[];
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
export const COMPLIANCE_CONTROLS = [
|
|
2
|
+
{
|
|
3
|
+
id: 'org-policy-narrowing',
|
|
4
|
+
control: 'Agent authority is bounded by an org policy resolved by narrowing (a repo source can only tighten the machine source).',
|
|
5
|
+
section: 'policy',
|
|
6
|
+
openssf: 'Least-privilege / access control',
|
|
7
|
+
iso42001: 'A.5 policies for AI; A.9 use limitation',
|
|
8
|
+
},
|
|
9
|
+
{
|
|
10
|
+
id: 'policy-integrity',
|
|
11
|
+
control: 'The governing policy is content-hashed; each run records the hash it ran under.',
|
|
12
|
+
section: 'policy',
|
|
13
|
+
iso42001: 'A.6 change management; A.8 records of processing',
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
id: 'network-egress-enforcement',
|
|
17
|
+
control: 'Outbound network is enforced per boundary (provider, shell/subprocess, MCP) and fails closed where isolation is unavailable.',
|
|
18
|
+
section: 'trust',
|
|
19
|
+
openssf: 'Network egress control',
|
|
20
|
+
iso42001: 'A.9 operational controls',
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
id: 'self-verifiable-posture',
|
|
24
|
+
control: 'The install can emit its own live security posture for independent verification (dvalincode trust).',
|
|
25
|
+
section: 'trust',
|
|
26
|
+
iso42001: 'A.7 transparency; Clause 9 monitoring',
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
id: 'tamper-evident-audit',
|
|
30
|
+
control: 'Every agent run produces a hash-chained audit log whose integrity is verifiable after the fact.',
|
|
31
|
+
section: 'runs',
|
|
32
|
+
openssf: 'Tamper-evident logging',
|
|
33
|
+
iso42001: 'A.8 records; Clause 9.2 audit',
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
id: 'audit-minimization',
|
|
37
|
+
control: 'Audit records are minimized — no prompts, file contents, shell arguments, or credentials are persisted.',
|
|
38
|
+
section: 'runs',
|
|
39
|
+
iso42001: 'A.9 data minimization; privacy by design',
|
|
40
|
+
},
|
|
41
|
+
];
|
|
42
|
+
/** Mark each control backed/unbacked by what this specific pack actually contains. */
|
|
43
|
+
export function evaluateCompliance(pack) {
|
|
44
|
+
return COMPLIANCE_CONTROLS.map(c => ({ ...c, backed: isBacked(c, pack) }));
|
|
45
|
+
}
|
|
46
|
+
function isBacked(c, pack) {
|
|
47
|
+
switch (c.section) {
|
|
48
|
+
case 'policy':
|
|
49
|
+
return Boolean(pack.policy?.hash);
|
|
50
|
+
case 'trust':
|
|
51
|
+
return Boolean(pack.trust);
|
|
52
|
+
case 'runs':
|
|
53
|
+
// Backed only when at least one run's chain is present and verified.
|
|
54
|
+
return pack.runs.length > 0 && pack.runs.every(r => r.verify.ok);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=compliance.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compliance.js","sourceRoot":"","sources":["../../src/evidence/compliance.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,mBAAmB,GAAwB;IACtD;QACE,EAAE,EAAE,sBAAsB;QAC1B,OAAO,EAAE,wHAAwH;QACjI,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,kCAAkC;QAC3C,QAAQ,EAAE,yCAAyC;KACpD;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,OAAO,EAAE,iFAAiF;QAC1F,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,kDAAkD;KAC7D;IACD;QACE,EAAE,EAAE,4BAA4B;QAChC,OAAO,EAAE,8HAA8H;QACvI,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,wBAAwB;QACjC,QAAQ,EAAE,0BAA0B;KACrC;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,OAAO,EAAE,qGAAqG;QAC9G,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,uCAAuC;KAClD;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,OAAO,EAAE,iGAAiG;QAC1G,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,wBAAwB;QACjC,QAAQ,EAAE,+BAA+B;KAC1C;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,OAAO,EAAE,yGAAyG;QAClH,OAAO,EAAE,MAAM;QACf,QAAQ,EAAE,0CAA0C;KACrD;CACF,CAAC;AAIF,sFAAsF;AACtF,MAAM,UAAU,kBAAkB,CAAC,IAAmD;IACpF,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,QAAQ,CAAC,CAAoB,EAAE,IAAmD;IACzF,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpC,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,KAAK,MAAM;YACT,qEAAqE;YACrE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { type AuditRecord, type RunMeta, type VerifyResult } from '../audit/log.js';
|
|
2
|
+
import { type PolicySource, type ResolvedPolicy } from '../core/policy.js';
|
|
3
|
+
import { type TrustReport } from '../core/trust.js';
|
|
4
|
+
import { type ComplianceEntry } from './compliance.js';
|
|
5
|
+
export declare const EVIDENCE_SCHEMA = "dvalincode-evidence/v1";
|
|
6
|
+
export type EvidenceRun = {
|
|
7
|
+
runId: string;
|
|
8
|
+
meta: RunMeta | null;
|
|
9
|
+
records: AuditRecord[];
|
|
10
|
+
verify: VerifyResult;
|
|
11
|
+
/** Link to the originating session turn, when the run recorded a sessionId. */
|
|
12
|
+
journalAnchor?: {
|
|
13
|
+
sessionId: string;
|
|
14
|
+
messageId: string;
|
|
15
|
+
auditHead?: string;
|
|
16
|
+
};
|
|
17
|
+
};
|
|
18
|
+
export type EvidencePack = {
|
|
19
|
+
schema: typeof EVIDENCE_SCHEMA;
|
|
20
|
+
generatedAt: string;
|
|
21
|
+
tool: {
|
|
22
|
+
name: 'dvalincode';
|
|
23
|
+
version: string;
|
|
24
|
+
};
|
|
25
|
+
policy: {
|
|
26
|
+
resolved: ResolvedPolicy;
|
|
27
|
+
sources: PolicySource[];
|
|
28
|
+
hash: string;
|
|
29
|
+
};
|
|
30
|
+
trust: TrustReport;
|
|
31
|
+
runs: EvidenceRun[];
|
|
32
|
+
compliance: ComplianceEntry[];
|
|
33
|
+
manifest: {
|
|
34
|
+
sections: Record<string, string>;
|
|
35
|
+
bundleHash: string;
|
|
36
|
+
};
|
|
37
|
+
};
|
|
38
|
+
export type BuildOptions = {
|
|
39
|
+
cwd?: string;
|
|
40
|
+
auditDir?: string;
|
|
41
|
+
sessionsDir?: string;
|
|
42
|
+
/** Explicit run ids; otherwise the newest `last` runs are included. */
|
|
43
|
+
runIds?: string[];
|
|
44
|
+
last?: number;
|
|
45
|
+
};
|
|
46
|
+
/** Assemble an Evidence Pack from the install's current policy, posture, and audit runs. */
|
|
47
|
+
export declare function buildEvidencePack(opts?: BuildOptions): EvidencePack;
|
|
48
|
+
export type VerifyReport = {
|
|
49
|
+
ok: boolean;
|
|
50
|
+
bundleHashOk: boolean;
|
|
51
|
+
sectionIssues: string[];
|
|
52
|
+
runIssues: string[];
|
|
53
|
+
minimizationIssues: string[];
|
|
54
|
+
};
|
|
55
|
+
/** Re-derive every hash and re-run each embedded chain — fully offline. */
|
|
56
|
+
export declare function verifyEvidencePack(pack: EvidencePack): VerifyReport;
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
import { sha256, canonicalJSON } from '../audit/hash.js';
|
|
2
|
+
import { defaultAuditDir, listRuns, readRecords, verifyRecords, } from '../audit/log.js';
|
|
3
|
+
import { loadPolicy } from '../core/policy.js';
|
|
4
|
+
import { buildTrustReport } from '../core/trust.js';
|
|
5
|
+
import { readJournal } from '../sessions/journal.js';
|
|
6
|
+
import { evaluateCompliance } from './compliance.js';
|
|
7
|
+
export const EVIDENCE_SCHEMA = 'dvalincode-evidence/v1';
|
|
8
|
+
/** Assemble an Evidence Pack from the install's current policy, posture, and audit runs. */
|
|
9
|
+
export function buildEvidencePack(opts = {}) {
|
|
10
|
+
const cwd = opts.cwd ?? process.cwd();
|
|
11
|
+
const auditDir = opts.auditDir ?? defaultAuditDir();
|
|
12
|
+
const loaded = loadPolicy(cwd);
|
|
13
|
+
const trust = buildTrustReport(cwd);
|
|
14
|
+
const ids = opts.runIds ?? listRuns(auditDir).slice(0, opts.last ?? 10);
|
|
15
|
+
const runs = ids.map(runId => {
|
|
16
|
+
let records = [];
|
|
17
|
+
let verify;
|
|
18
|
+
try {
|
|
19
|
+
records = readRecords(runId, auditDir);
|
|
20
|
+
verify = verifyRecords(runId, records);
|
|
21
|
+
}
|
|
22
|
+
catch (err) {
|
|
23
|
+
verify = { ok: false, reason: err instanceof Error ? err.message : String(err) };
|
|
24
|
+
}
|
|
25
|
+
const start = records.find(r => r.type === 'run_start');
|
|
26
|
+
const meta = start && start.type === 'run_start' ? stripType(start) : null;
|
|
27
|
+
return { runId, meta, records, verify, journalAnchor: findAnchor(meta, runId, opts.sessionsDir) };
|
|
28
|
+
});
|
|
29
|
+
const core = {
|
|
30
|
+
schema: EVIDENCE_SCHEMA,
|
|
31
|
+
generatedAt: new Date().toISOString(),
|
|
32
|
+
tool: { name: 'dvalincode', version: trust.version },
|
|
33
|
+
policy: { resolved: loaded.policy, sources: loaded.sources, hash: loaded.hash },
|
|
34
|
+
trust,
|
|
35
|
+
runs,
|
|
36
|
+
};
|
|
37
|
+
const compliance = evaluateCompliance(core);
|
|
38
|
+
const withCompliance = { ...core, compliance };
|
|
39
|
+
return { ...withCompliance, manifest: buildManifest(withCompliance) };
|
|
40
|
+
}
|
|
41
|
+
/** Re-derive every hash and re-run each embedded chain — fully offline. */
|
|
42
|
+
export function verifyEvidencePack(pack) {
|
|
43
|
+
const sectionIssues = [];
|
|
44
|
+
const runIssues = [];
|
|
45
|
+
const expected = manifestSections(stripManifest(pack));
|
|
46
|
+
for (const [name, hash] of Object.entries(expected)) {
|
|
47
|
+
if (pack.manifest.sections[name] !== hash)
|
|
48
|
+
sectionIssues.push(`section "${name}" hash mismatch`);
|
|
49
|
+
}
|
|
50
|
+
for (const name of Object.keys(pack.manifest.sections)) {
|
|
51
|
+
if (!(name in expected))
|
|
52
|
+
sectionIssues.push(`manifest lists unknown section "${name}"`);
|
|
53
|
+
}
|
|
54
|
+
const bundleHashOk = pack.manifest.bundleHash === sha256(canonicalJSON(stripBundleHash(pack)));
|
|
55
|
+
if (!bundleHashOk)
|
|
56
|
+
sectionIssues.push('bundle hash mismatch');
|
|
57
|
+
for (const run of pack.runs) {
|
|
58
|
+
const result = verifyRecords(run.runId, run.records);
|
|
59
|
+
if (!result.ok)
|
|
60
|
+
runIssues.push(`run ${run.runId}: ${result.reason ?? `broken at seq ${result.brokenAtSeq}`}`);
|
|
61
|
+
}
|
|
62
|
+
const minimizationIssues = scanForSecrets(pack);
|
|
63
|
+
return {
|
|
64
|
+
ok: sectionIssues.length === 0 && bundleHashOk && runIssues.length === 0 && minimizationIssues.length === 0,
|
|
65
|
+
bundleHashOk,
|
|
66
|
+
sectionIssues,
|
|
67
|
+
runIssues,
|
|
68
|
+
minimizationIssues,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
// ── internals ────────────────────────────────────────────────────────────────
|
|
72
|
+
function stripType(record) {
|
|
73
|
+
const { type: _drop, seq: _seq, ts: _ts, prevHash: _prev, ...rest } = record;
|
|
74
|
+
return rest;
|
|
75
|
+
}
|
|
76
|
+
function findAnchor(meta, runId, sessionsDir) {
|
|
77
|
+
const sessionId = meta?.sessionId;
|
|
78
|
+
if (!sessionId)
|
|
79
|
+
return undefined;
|
|
80
|
+
const end = readJournal(sessionId, sessionsDir).find(r => r.type === 'turn_end' && r.runId === runId);
|
|
81
|
+
if (!end || end.type !== 'turn_end')
|
|
82
|
+
return { sessionId, messageId: '(unknown)' };
|
|
83
|
+
return { sessionId, messageId: end.messageId, auditHead: end.auditHead };
|
|
84
|
+
}
|
|
85
|
+
/** Per-section SHA-256 of the meaningful sections (excludes the manifest itself). */
|
|
86
|
+
function manifestSections(core) {
|
|
87
|
+
return {
|
|
88
|
+
header: sha256(canonicalJSON({ schema: core.schema, generatedAt: core.generatedAt, tool: core.tool })),
|
|
89
|
+
policy: sha256(canonicalJSON(core.policy)),
|
|
90
|
+
trust: sha256(canonicalJSON(core.trust)),
|
|
91
|
+
runs: sha256(canonicalJSON(core.runs)),
|
|
92
|
+
compliance: sha256(canonicalJSON(core.compliance)),
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
function buildManifest(core) {
|
|
96
|
+
const sections = manifestSections(core);
|
|
97
|
+
return { sections, bundleHash: sha256(canonicalJSON(core)) };
|
|
98
|
+
}
|
|
99
|
+
function stripManifest(pack) {
|
|
100
|
+
const { manifest: _m, ...core } = pack;
|
|
101
|
+
return core;
|
|
102
|
+
}
|
|
103
|
+
function stripBundleHash(pack) {
|
|
104
|
+
return stripManifest(pack);
|
|
105
|
+
}
|
|
106
|
+
const SECRET_KEY = /^(authorization|api[-_]?key|apikey|password|secret|token|bearer)$/i;
|
|
107
|
+
/** Structural minimization guard: flag any key that looks like a credential with a non-empty value. */
|
|
108
|
+
function scanForSecrets(value, path = '') {
|
|
109
|
+
const issues = [];
|
|
110
|
+
if (Array.isArray(value)) {
|
|
111
|
+
value.forEach((v, i) => issues.push(...scanForSecrets(v, `${path}[${i}]`)));
|
|
112
|
+
}
|
|
113
|
+
else if (value && typeof value === 'object') {
|
|
114
|
+
for (const [key, v] of Object.entries(value)) {
|
|
115
|
+
if (SECRET_KEY.test(key) && typeof v === 'string' && v.length > 0) {
|
|
116
|
+
issues.push(`possible secret at ${path}.${key}`);
|
|
117
|
+
}
|
|
118
|
+
issues.push(...scanForSecrets(v, path ? `${path}.${key}` : key));
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
return issues;
|
|
122
|
+
}
|
|
123
|
+
//# sourceMappingURL=pack.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/evidence/pack.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
package/dist/index.js
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { runCli } from './cli.js';
|
|
3
|
+
runCli(process.argv).catch(error => {
|
|
4
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
5
|
+
console.error(`dvalincode: ${message}`);
|
|
6
|
+
process.exitCode = 1;
|
|
7
|
+
});
|
|
8
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACjC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { type McpEgressContext } from './governedFetch.js';
|
|
2
|
+
export type McpToolAnnotations = {
|
|
3
|
+
readOnlyHint?: boolean;
|
|
4
|
+
destructiveHint?: boolean;
|
|
5
|
+
title?: string;
|
|
6
|
+
};
|
|
7
|
+
export type McpToolDef = {
|
|
8
|
+
name: string;
|
|
9
|
+
description?: string;
|
|
10
|
+
inputSchema?: Record<string, unknown>;
|
|
11
|
+
annotations?: McpToolAnnotations;
|
|
12
|
+
};
|
|
13
|
+
export type McpContent = {
|
|
14
|
+
type: string;
|
|
15
|
+
text?: string;
|
|
16
|
+
[key: string]: unknown;
|
|
17
|
+
};
|
|
18
|
+
export type McpCallResult = {
|
|
19
|
+
content?: McpContent[];
|
|
20
|
+
isError?: boolean;
|
|
21
|
+
};
|
|
22
|
+
export type McpServerRef = {
|
|
23
|
+
id: string;
|
|
24
|
+
url: string;
|
|
25
|
+
};
|
|
26
|
+
export declare class McpClient {
|
|
27
|
+
private readonly server;
|
|
28
|
+
private readonly authHeaders;
|
|
29
|
+
private sessionId;
|
|
30
|
+
private nextId;
|
|
31
|
+
constructor(server: McpServerRef, authHeaders: Record<string, string>);
|
|
32
|
+
/**
|
|
33
|
+
* Handshake: `initialize` then the `notifications/initialized` acknowledgement.
|
|
34
|
+
* The egress context is passed per call so tool invocations can be audited
|
|
35
|
+
* against the live per-run sink (which the discovery step does not yet have).
|
|
36
|
+
*/
|
|
37
|
+
initialize(egress: McpEgressContext): Promise<void>;
|
|
38
|
+
listTools(egress: McpEgressContext): Promise<McpToolDef[]>;
|
|
39
|
+
callTool(name: string, args: unknown, egress: McpEgressContext): Promise<McpCallResult>;
|
|
40
|
+
private baseHeaders;
|
|
41
|
+
/** Send a JSON-RPC request and return the response message; throws on JSON-RPC error. */
|
|
42
|
+
private request;
|
|
43
|
+
/** Fire-and-forget notification (no id, no response expected). */
|
|
44
|
+
private notify;
|
|
45
|
+
}
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
import { governedMcpFetch } from './governedFetch.js';
|
|
2
|
+
/**
|
|
3
|
+
* A minimal, hand-rolled MCP client over the Streamable HTTP transport — no SDK,
|
|
4
|
+
* to preserve DvalinCode's zero-runtime-deps posture. It speaks only the three
|
|
5
|
+
* JSON-RPC methods v1 needs (`initialize`, `tools/list`, `tools/call`) and reads
|
|
6
|
+
* responses whether the server replies with `application/json` or a
|
|
7
|
+
* `text/event-stream` (SSE) body. All network I/O goes through `governedMcpFetch`.
|
|
8
|
+
*/
|
|
9
|
+
const PROTOCOL_VERSION = '2025-06-18';
|
|
10
|
+
const CLIENT_INFO = { name: 'dvalincode', version: '0.9.0' };
|
|
11
|
+
export class McpClient {
|
|
12
|
+
server;
|
|
13
|
+
authHeaders;
|
|
14
|
+
sessionId;
|
|
15
|
+
nextId = 1;
|
|
16
|
+
constructor(server, authHeaders) {
|
|
17
|
+
this.server = server;
|
|
18
|
+
this.authHeaders = authHeaders;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Handshake: `initialize` then the `notifications/initialized` acknowledgement.
|
|
22
|
+
* The egress context is passed per call so tool invocations can be audited
|
|
23
|
+
* against the live per-run sink (which the discovery step does not yet have).
|
|
24
|
+
*/
|
|
25
|
+
async initialize(egress) {
|
|
26
|
+
await this.request('initialize', { protocolVersion: PROTOCOL_VERSION, capabilities: {}, clientInfo: CLIENT_INFO }, 'initialize', egress);
|
|
27
|
+
await this.notify('notifications/initialized', egress);
|
|
28
|
+
}
|
|
29
|
+
async listTools(egress) {
|
|
30
|
+
const msg = await this.request('tools/list', {}, 'tools/list', egress);
|
|
31
|
+
return msg.result?.tools ?? [];
|
|
32
|
+
}
|
|
33
|
+
async callTool(name, args, egress) {
|
|
34
|
+
const msg = await this.request('tools/call', { name, arguments: args ?? {} }, name, egress);
|
|
35
|
+
return msg.result ?? {};
|
|
36
|
+
}
|
|
37
|
+
// ── transport ────────────────────────────────────────────────────────────
|
|
38
|
+
baseHeaders() {
|
|
39
|
+
const headers = {
|
|
40
|
+
'Content-Type': 'application/json',
|
|
41
|
+
Accept: 'application/json, text/event-stream',
|
|
42
|
+
'MCP-Protocol-Version': PROTOCOL_VERSION,
|
|
43
|
+
...this.authHeaders,
|
|
44
|
+
};
|
|
45
|
+
if (this.sessionId)
|
|
46
|
+
headers['Mcp-Session-Id'] = this.sessionId;
|
|
47
|
+
return headers;
|
|
48
|
+
}
|
|
49
|
+
/** Send a JSON-RPC request and return the response message; throws on JSON-RPC error. */
|
|
50
|
+
async request(method, params, auditTool, egress) {
|
|
51
|
+
const id = this.nextId++;
|
|
52
|
+
const res = await governedMcpFetch(this.server.url, { method: 'POST', headers: this.baseHeaders(), body: JSON.stringify({ jsonrpc: '2.0', id, method, params }) }, egress, auditTool);
|
|
53
|
+
// The server assigns a session on initialize; carry it on every later call.
|
|
54
|
+
const session = res.headers.get('mcp-session-id');
|
|
55
|
+
if (session)
|
|
56
|
+
this.sessionId = session;
|
|
57
|
+
if (!res.ok)
|
|
58
|
+
throw new Error(`MCP ${method} failed: HTTP ${res.status}`);
|
|
59
|
+
const msg = await readJsonRpc(res, id);
|
|
60
|
+
if (msg.error)
|
|
61
|
+
throw new Error(`MCP ${method} error: ${msg.error.message ?? `code ${msg.error.code}`}`);
|
|
62
|
+
return msg;
|
|
63
|
+
}
|
|
64
|
+
/** Fire-and-forget notification (no id, no response expected). */
|
|
65
|
+
async notify(method, egress) {
|
|
66
|
+
try {
|
|
67
|
+
const res = await governedMcpFetch(this.server.url, { method: 'POST', headers: this.baseHeaders(), body: JSON.stringify({ jsonrpc: '2.0', method }) }, egress, method);
|
|
68
|
+
await res.body?.cancel().catch(() => undefined);
|
|
69
|
+
}
|
|
70
|
+
catch {
|
|
71
|
+
// Notifications are best-effort; a failure here must not abort discovery.
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Read a JSON-RPC response whether the body is `application/json` (single object)
|
|
77
|
+
* or a `text/event-stream` (SSE) carrying the response as a `data:` event. For a
|
|
78
|
+
* short request/response this reads the full body — v1 does not stream partials.
|
|
79
|
+
*/
|
|
80
|
+
async function readJsonRpc(res, id) {
|
|
81
|
+
const contentType = res.headers.get('content-type') ?? '';
|
|
82
|
+
if (!contentType.includes('text/event-stream')) {
|
|
83
|
+
return (await res.json());
|
|
84
|
+
}
|
|
85
|
+
const text = await res.text();
|
|
86
|
+
let fallback;
|
|
87
|
+
for (const line of text.split('\n')) {
|
|
88
|
+
const trimmed = line.trim();
|
|
89
|
+
if (!trimmed.startsWith('data:'))
|
|
90
|
+
continue;
|
|
91
|
+
const payload = trimmed.slice(5).trim();
|
|
92
|
+
if (!payload || payload === '[DONE]')
|
|
93
|
+
continue;
|
|
94
|
+
let msg;
|
|
95
|
+
try {
|
|
96
|
+
msg = JSON.parse(payload);
|
|
97
|
+
}
|
|
98
|
+
catch {
|
|
99
|
+
continue;
|
|
100
|
+
}
|
|
101
|
+
if (msg.result === undefined && msg.error === undefined)
|
|
102
|
+
continue;
|
|
103
|
+
if (msg.id === id)
|
|
104
|
+
return msg;
|
|
105
|
+
fallback ??= msg;
|
|
106
|
+
}
|
|
107
|
+
if (fallback)
|
|
108
|
+
return fallback;
|
|
109
|
+
throw new Error('no JSON-RPC response found in SSE stream');
|
|
110
|
+
}
|
|
111
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { McpServerConfig } from '../server/configStore.js';
|
|
2
|
+
/**
|
|
3
|
+
* Resolve `${ENV}` placeholders in header values from the process environment.
|
|
4
|
+
* Secrets therefore live in the environment, never in DvalinCode's config file
|
|
5
|
+
* or audit trail. A missing variable resolves to an empty string (the request
|
|
6
|
+
* will fail auth loudly rather than silently sending a literal `${VAR}`).
|
|
7
|
+
*/
|
|
8
|
+
export declare function resolveHeaders(headers: Record<string, string> | undefined): Record<string, string>;
|
|
9
|
+
/** Servers that are explicitly enabled. Disabled/omitted servers are never connected. */
|
|
10
|
+
export declare function enabledServers(servers: McpServerConfig[] | undefined): McpServerConfig[];
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resolve `${ENV}` placeholders in header values from the process environment.
|
|
3
|
+
* Secrets therefore live in the environment, never in DvalinCode's config file
|
|
4
|
+
* or audit trail. A missing variable resolves to an empty string (the request
|
|
5
|
+
* will fail auth loudly rather than silently sending a literal `${VAR}`).
|
|
6
|
+
*/
|
|
7
|
+
export function resolveHeaders(headers) {
|
|
8
|
+
const out = {};
|
|
9
|
+
for (const [key, value] of Object.entries(headers ?? {})) {
|
|
10
|
+
out[key] = value.replace(/\$\{([A-Za-z0-9_]+)\}/g, (_, name) => process.env[name] ?? '');
|
|
11
|
+
}
|
|
12
|
+
return out;
|
|
13
|
+
}
|
|
14
|
+
/** Servers that are explicitly enabled. Disabled/omitted servers are never connected. */
|
|
15
|
+
export function enabledServers(servers) {
|
|
16
|
+
return (servers ?? []).filter(s => s.enabled);
|
|
17
|
+
}
|
|
18
|
+
//# sourceMappingURL=config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2C;IACxE,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,OAAsC;IACnE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { type ResolvedPolicy } from '../core/policy.js';
|
|
2
|
+
import type { AuditSink } from '../audit/log.js';
|
|
3
|
+
export type McpEgressContext = {
|
|
4
|
+
policy: ResolvedPolicy;
|
|
5
|
+
audit?: AuditSink;
|
|
6
|
+
serverId: string;
|
|
7
|
+
};
|
|
8
|
+
/**
|
|
9
|
+
* The one network path for MCP. Every request to a server passes through here so
|
|
10
|
+
* egress is enforced and audited before any third-party connection is made. An
|
|
11
|
+
* MCP gateway is **not** the model endpoint, so `checkEgress(policy, false)`
|
|
12
|
+
* blocks it under `network: off` / `endpoint-only`. Auth headers and bodies are
|
|
13
|
+
* never logged — the audit record carries only server, tool, host, outcome, and
|
|
14
|
+
* duration.
|
|
15
|
+
*/
|
|
16
|
+
export declare function governedMcpFetch(url: string, init: RequestInit, ctx: McpEgressContext, tool: string): Promise<Response>;
|