remote-access-mcp 3.1.2 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +104 -2
  3. package/dist/core/agent-contracts.d.ts +57 -0
  4. package/dist/core/agent-contracts.d.ts.map +1 -0
  5. package/dist/core/agent-contracts.js +35 -0
  6. package/dist/core/agent-contracts.js.map +1 -0
  7. package/dist/core/agent-profiles.d.ts +11 -0
  8. package/dist/core/agent-profiles.d.ts.map +1 -0
  9. package/dist/core/agent-profiles.js +12 -0
  10. package/dist/core/agent-profiles.js.map +1 -0
  11. package/dist/core/automation-engine.d.ts +53 -0
  12. package/dist/core/automation-engine.d.ts.map +1 -0
  13. package/dist/core/automation-engine.js +310 -0
  14. package/dist/core/automation-engine.js.map +1 -0
  15. package/dist/core/autonomy.d.ts +11 -0
  16. package/dist/core/autonomy.d.ts.map +1 -0
  17. package/dist/core/autonomy.js +30 -0
  18. package/dist/core/autonomy.js.map +1 -0
  19. package/dist/core/capability-router.d.ts +16 -0
  20. package/dist/core/capability-router.d.ts.map +1 -0
  21. package/dist/core/capability-router.js +83 -0
  22. package/dist/core/capability-router.js.map +1 -0
  23. package/dist/core/config.js +1 -1
  24. package/dist/core/config.js.map +1 -1
  25. package/dist/core/context-engine.d.ts +75 -0
  26. package/dist/core/context-engine.d.ts.map +1 -0
  27. package/dist/core/context-engine.js +330 -0
  28. package/dist/core/context-engine.js.map +1 -0
  29. package/dist/core/context.d.ts +5 -0
  30. package/dist/core/context.d.ts.map +1 -1
  31. package/dist/core/context.js.map +1 -1
  32. package/dist/core/policy.d.ts.map +1 -1
  33. package/dist/core/policy.js +15 -5
  34. package/dist/core/policy.js.map +1 -1
  35. package/dist/core/project-profiles.d.ts +17 -0
  36. package/dist/core/project-profiles.d.ts.map +1 -0
  37. package/dist/core/project-profiles.js +32 -0
  38. package/dist/core/project-profiles.js.map +1 -0
  39. package/dist/core/recovery-engine.d.ts +37 -0
  40. package/dist/core/recovery-engine.d.ts.map +1 -0
  41. package/dist/core/recovery-engine.js +99 -0
  42. package/dist/core/recovery-engine.js.map +1 -0
  43. package/dist/core/security-analysis.d.ts +19 -0
  44. package/dist/core/security-analysis.d.ts.map +1 -0
  45. package/dist/core/security-analysis.js +39 -0
  46. package/dist/core/security-analysis.js.map +1 -0
  47. package/dist/core/task-engine.d.ts +76 -0
  48. package/dist/core/task-engine.d.ts.map +1 -0
  49. package/dist/core/task-engine.js +319 -0
  50. package/dist/core/task-engine.js.map +1 -0
  51. package/dist/server/app.d.ts +2 -1
  52. package/dist/server/app.d.ts.map +1 -1
  53. package/dist/server/app.js +117 -5
  54. package/dist/server/app.js.map +1 -1
  55. package/dist/server/run.d.ts.map +1 -1
  56. package/dist/server/run.js +15 -1
  57. package/dist/server/run.js.map +1 -1
  58. package/dist/tools/agent.d.ts +4 -0
  59. package/dist/tools/agent.d.ts.map +1 -0
  60. package/dist/tools/agent.js +16 -0
  61. package/dist/tools/agent.js.map +1 -0
  62. package/dist/tools/automation.d.ts +4 -0
  63. package/dist/tools/automation.d.ts.map +1 -0
  64. package/dist/tools/automation.js +87 -0
  65. package/dist/tools/automation.js.map +1 -0
  66. package/dist/tools/autonomous.d.ts +4 -0
  67. package/dist/tools/autonomous.d.ts.map +1 -0
  68. package/dist/tools/autonomous.js +82 -0
  69. package/dist/tools/autonomous.js.map +1 -0
  70. package/dist/tools/browser.d.ts +4 -0
  71. package/dist/tools/browser.d.ts.map +1 -0
  72. package/dist/tools/browser.js +99 -0
  73. package/dist/tools/browser.js.map +1 -0
  74. package/dist/tools/context.d.ts +4 -0
  75. package/dist/tools/context.d.ts.map +1 -0
  76. package/dist/tools/context.js +53 -0
  77. package/dist/tools/context.js.map +1 -0
  78. package/dist/tools/index.d.ts +1 -1
  79. package/dist/tools/index.d.ts.map +1 -1
  80. package/dist/tools/index.js +20 -2
  81. package/dist/tools/index.js.map +1 -1
  82. package/dist/tools/infrastructure.d.ts +4 -0
  83. package/dist/tools/infrastructure.d.ts.map +1 -0
  84. package/dist/tools/infrastructure.js +124 -0
  85. package/dist/tools/infrastructure.js.map +1 -0
  86. package/dist/tools/intelligence.d.ts +9 -0
  87. package/dist/tools/intelligence.d.ts.map +1 -0
  88. package/dist/tools/intelligence.js +120 -0
  89. package/dist/tools/intelligence.js.map +1 -0
  90. package/dist/tools/planning.d.ts.map +1 -1
  91. package/dist/tools/planning.js +9 -0
  92. package/dist/tools/planning.js.map +1 -1
  93. package/dist/tools/plugin-host.d.ts +2 -0
  94. package/dist/tools/plugin-host.d.ts.map +1 -0
  95. package/dist/tools/plugin-host.js +54 -0
  96. package/dist/tools/plugin-host.js.map +1 -0
  97. package/dist/tools/plugin-network-blocker.cjs +39 -0
  98. package/dist/tools/plugins.d.ts.map +1 -1
  99. package/dist/tools/plugins.js +344 -30
  100. package/dist/tools/plugins.js.map +1 -1
  101. package/dist/tools/router.d.ts +4 -0
  102. package/dist/tools/router.d.ts.map +1 -0
  103. package/dist/tools/router.js +39 -0
  104. package/dist/tools/router.js.map +1 -0
  105. package/dist/tools/tasks.d.ts +4 -0
  106. package/dist/tools/tasks.d.ts.map +1 -0
  107. package/dist/tools/tasks.js +71 -0
  108. package/dist/tools/tasks.js.map +1 -0
  109. package/docs/ai/agent-architecture.md +145 -0
  110. package/docs/ai/decisions.md +119 -1
  111. package/package.json +2 -2
@@ -0,0 +1,82 @@
1
+ import { z } from 'zod';
2
+ import { assertToolPermitted } from '../core/policy.js';
3
+ import { AuditLog } from '../core/audit.js';
4
+ import { analyzeSecurity } from '../core/security-analysis.js';
5
+ import { decideAutonomy } from '../core/autonomy.js';
6
+ import { createRecoveryRule, listRecoveryRules, deleteRecoveryRule, listIncidents, claimRecovery, markIncident, resetRecoveryAttempts } from '../core/recovery-engine.js';
7
+ const forbidden = new Set(['task_approve', 'approval_decide', 'plugin_install', 'plugin_remove', 'automation_create', 'automation_enable', 'automation_delete', 'automation_trigger', 'recovery_rule_create', 'recovery_rule_delete', 'recovery_trigger']);
8
+ const fp = (ctx) => AuditLog.fingerprint(ctx.token.token);
9
+ const policy = (ctx) => ({ enabled: process.env.RAMCP_AUTONOMOUS === '1', allowAutonomousHighRisk: process.env.RAMCP_AUTONOMOUS_HIGH_RISK === '1', allowAutonomousCritical: process.env.RAMCP_AUTONOMOUS_CRITICAL === '1' });
10
+ export function registerAutonomousTools(server, ctx) {
11
+ server.registerTool('security_analysis', { description: 'Run a bounded read-only security posture analysis for the current token.', inputSchema: {} }, async () => {
12
+ assertToolPermitted({ tool: 'security_analysis', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
13
+ return { content: [{ type: 'text', text: JSON.stringify(analyzeSecurity({ scopes: ctx.token.scopes, readOnly: ctx.readOnly, shellEnabled: ctx.token.shell_enabled, allowedPaths: ctx.token.allowed_paths, deniedPaths: ctx.token.denied_paths })) }] };
14
+ });
15
+ server.registerTool('autonomy_check', { description: 'Evaluate whether an action risk may execute at a requested autonomy level.', inputSchema: { autonomy: z.enum(['readonly', 'safe', 'supervised', 'autonomous']), risk: z.enum(['none', 'low', 'medium', 'high', 'critical']) } }, async ({ autonomy, risk }) => {
16
+ assertToolPermitted({ tool: 'autonomy_check', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
17
+ return { content: [{ type: 'text', text: JSON.stringify({ decision: decideAutonomy(autonomy, risk, policy(ctx)), autonomous_enabled: process.env.RAMCP_AUTONOMOUS === '1' }) }] };
18
+ });
19
+ server.registerTool('recovery_rule_create', { description: 'Create a bounded token-isolated self-healing rule for one known failure type.', inputSchema: { name: z.string().min(1).max(100), failure_type: z.string().min(1).max(100), risk: z.enum(['low', 'medium', 'high', 'critical']).default('medium'), action: z.object({ tool: z.string().min(1).max(100), args: z.record(z.unknown()).default({}) }), max_attempts: z.number().int().min(1).max(5).default(3), cooldown_seconds: z.number().int().min(30).max(86400).default(300) } }, async ({ name, failure_type, risk, action, max_attempts, cooldown_seconds }) => {
20
+ assertToolPermitted({ tool: 'recovery_rule_create', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
21
+ if (forbidden.has(action.tool))
22
+ return { content: [{ type: 'text', text: 'Forbidden recovery action.' }], isError: true };
23
+ if (JSON.stringify(action.args).length > 64 * 1024)
24
+ return { content: [{ type: 'text', text: 'Recovery action args exceed 64 KiB.' }], isError: true };
25
+ try {
26
+ assertToolPermitted({ tool: action.tool, scopes: ctx.token.scopes, readOnly: ctx.readOnly });
27
+ }
28
+ catch (e) {
29
+ return { content: [{ type: 'text', text: e.message }], isError: true };
30
+ }
31
+ const r = createRecoveryRule({ tokenFingerprint: fp(ctx), name, failureType: failure_type, risk, action, enabled: true, maxAttempts: max_attempts, cooldownSeconds: cooldown_seconds });
32
+ return { content: [{ type: 'text', text: JSON.stringify({ id: r.id, name: r.name, failure_type: r.failureType }) }] };
33
+ });
34
+ server.registerTool('recovery_rule_list', { description: 'List recovery rules owned by the current token.', inputSchema: {} }, async () => {
35
+ assertToolPermitted({ tool: 'recovery_rule_list', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
36
+ return { content: [{ type: 'text', text: JSON.stringify(listRecoveryRules(fp(ctx)).map(({ tokenFingerprint: _x, ...r }) => r)) }] };
37
+ });
38
+ server.registerTool('recovery_rule_delete', { description: 'Delete an owned recovery rule.', inputSchema: { id: z.string().uuid() } }, async ({ id }) => {
39
+ assertToolPermitted({ tool: 'recovery_rule_delete', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
40
+ return deleteRecoveryRule(fp(ctx), id) ? { content: [{ type: 'text', text: `Deleted ${id}` }] } : { content: [{ type: 'text', text: 'Recovery rule not found.' }], isError: true };
41
+ });
42
+ server.registerTool('recovery_incidents', { description: 'List token-isolated self-healing incidents.', inputSchema: {} }, async () => {
43
+ assertToolPermitted({ tool: 'recovery_incidents', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
44
+ return { content: [{ type: 'text', text: JSON.stringify(listIncidents(fp(ctx)).map(({ tokenFingerprint: _x, ...r }) => r)) }] };
45
+ });
46
+ server.registerTool('recovery_trigger', { description: 'Run one owned recovery rule once, subject to cooldown, attempt limits, autonomy, and normal tool policy.', inputSchema: { id: z.string().uuid() } }, async ({ id }) => {
47
+ assertToolPermitted({ tool: 'recovery_trigger', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
48
+ if (ctx.readOnly)
49
+ return { content: [{ type: 'text', text: 'Read-only mode blocks recovery execution.' }], isError: true };
50
+ const r = listRecoveryRules(fp(ctx)).find(x => x.id === id);
51
+ if (!r)
52
+ return { content: [{ type: 'text', text: 'Recovery rule not found.' }], isError: true };
53
+ const decision = decideAutonomy('autonomous', r.risk, policy(ctx));
54
+ if (decision !== 'allow')
55
+ return { content: [{ type: 'text', text: `Recovery denied: ${decision}. Enable autonomous operations explicitly or use supervised approval outside this trigger.` }], isError: true };
56
+ const claimed = claimRecovery(fp(ctx), id);
57
+ if (!claimed)
58
+ return { content: [{ type: 'text', text: 'Recovery is rate-limited, exhausted, disabled, or already claimed.' }], isError: true };
59
+ markIncident(fp(ctx), claimed, 'open');
60
+ try {
61
+ if (forbidden.has(claimed.action.tool))
62
+ throw new Error('Forbidden recovery action');
63
+ if (!ctx.invokeTool)
64
+ throw new Error('Tool invocation is unavailable');
65
+ const result = await ctx.invokeTool(claimed.action.tool, claimed.action.args);
66
+ if (result?.isError)
67
+ throw new Error('Recovery action returned an error');
68
+ markIncident(fp(ctx), claimed, 'recovered');
69
+ return { content: [{ type: 'text', text: JSON.stringify({ recovered: true, id }) }] };
70
+ }
71
+ catch (e) {
72
+ markIncident(fp(ctx), claimed, 'failed', e.message || String(e));
73
+ return { content: [{ type: 'text', text: e.message || String(e) }], isError: true };
74
+ }
75
+ });
76
+ server.registerTool('recovery_reset', { description: 'Reset the bounded attempt counter of an owned recovery rule.', inputSchema: { id: z.string().uuid() } }, async ({ id }) => {
77
+ assertToolPermitted({ tool: 'recovery_rule_delete', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
78
+ resetRecoveryAttempts(fp(ctx), id);
79
+ return { content: [{ type: 'text', text: `Reset ${id}` }] };
80
+ });
81
+ }
82
+ //# sourceMappingURL=autonomous.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"autonomous.js","sourceRoot":"","sources":["../../src/tools/autonomous.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../core/context.js';
3
+ export declare function registerBrowserTools(server: McpServer, ctx: ToolContext): void;
4
+ //# sourceMappingURL=browser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/tools/browser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA0CtD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CA+C9E"}
@@ -0,0 +1,99 @@
1
+ import { createRequire } from 'node:module';
2
+ import { z } from 'zod';
3
+ import { assertAllowed, assertToolPermitted } from '../core/policy.js';
4
+ import net from 'node:net';
5
+ const require = createRequire(import.meta.url);
6
+ const MAX_TEXT = 120_000;
7
+ function blockedHost(hostname) {
8
+ if (net.isIPv4(hostname)) {
9
+ const [a, b] = hostname.split('.').map(Number);
10
+ return a === 0 || a === 10 || a === 127 || (a === 172 && b >= 16 && b <= 31) || (a === 192 && b === 168) || (a === 169 && b === 254);
11
+ }
12
+ if (net.isIPv6(hostname)) {
13
+ const h = hostname.toLowerCase();
14
+ return h === '::' || h === '::1' || h.startsWith('fe80') || h.startsWith('fc') || h.startsWith('fd');
15
+ }
16
+ return ['localhost', 'metadata.google.internal', 'instance-data'].some(n => hostname === n || hostname.endsWith(`.${n}`));
17
+ }
18
+ function assertPublicUrl(raw) {
19
+ const url = new URL(raw);
20
+ if (!['http:', 'https:'].includes(url.protocol))
21
+ throw new Error('Only HTTP(S) URLs are allowed');
22
+ if (blockedHost(url.hostname))
23
+ throw new Error(`Refusing browser access to internal/private host ${url.hostname}`);
24
+ return url;
25
+ }
26
+ function playwright() {
27
+ try {
28
+ return require('playwright');
29
+ }
30
+ catch {
31
+ try {
32
+ return require('playwright-core');
33
+ }
34
+ catch {
35
+ throw new Error('Browser integration is unavailable: install Playwright or playwright-core on the host');
36
+ }
37
+ }
38
+ }
39
+ async function withBrowser(fn) {
40
+ const pw = playwright();
41
+ const browser = await pw.chromium.launch({ headless: true });
42
+ try {
43
+ const page = await browser.newPage({ javaScriptEnabled: true });
44
+ page.setDefaultTimeout(20_000);
45
+ return await fn(page);
46
+ }
47
+ finally {
48
+ await browser.close();
49
+ }
50
+ }
51
+ export function registerBrowserTools(server, ctx) {
52
+ server.registerTool('browser_open', {
53
+ description: 'Open a public web page in a headless browser and return its title, URL, and visible text. SSRF-guarded.',
54
+ inputSchema: { url: z.string().url(), wait_ms: z.number().int().min(0).max(10_000).optional().default(500) },
55
+ }, async ({ url, wait_ms }) => {
56
+ assertToolPermitted({ tool: 'browser_open', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
57
+ const target = assertPublicUrl(url);
58
+ return { content: [{ type: 'text', text: await withBrowser(async (page) => {
59
+ await page.goto(target.toString(), { waitUntil: 'domcontentloaded' });
60
+ if (wait_ms)
61
+ await page.waitForTimeout(wait_ms);
62
+ const title = await page.title();
63
+ const text = (await page.locator('body').innerText()).slice(0, MAX_TEXT);
64
+ return `url: ${page.url()}\ntitle: ${title}\n\n${text}`;
65
+ }) }] };
66
+ });
67
+ server.registerTool('browser_extract', {
68
+ description: 'Extract structured links and metadata from a public page using a headless browser.',
69
+ inputSchema: { url: z.string().url(), max_links: z.number().int().min(1).max(100).optional().default(30) },
70
+ }, async ({ url, max_links }) => {
71
+ assertToolPermitted({ tool: 'browser_extract', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
72
+ const target = assertPublicUrl(url);
73
+ return { content: [{ type: 'text', text: await withBrowser(async (page) => {
74
+ await page.goto(target.toString(), { waitUntil: 'domcontentloaded' });
75
+ const data = await page.evaluate((limit) => {
76
+ const doc = globalThis.document;
77
+ return {
78
+ title: doc.title,
79
+ description: doc.querySelector('meta[name="description"]')?.getAttribute('content') || '',
80
+ links: Array.from(doc.querySelectorAll('a[href]')).slice(0, limit).map((a) => ({ text: (a.textContent || '').trim().slice(0, 200), href: a.href })),
81
+ };
82
+ }, max_links);
83
+ return JSON.stringify(data, null, 2);
84
+ }) }] };
85
+ });
86
+ server.registerTool('browser_screenshot', {
87
+ description: 'Capture a screenshot of a public web page to a policy-allowed local path.',
88
+ inputSchema: { url: z.string().url(), output_path: z.string().min(1).max(1000), full_page: z.boolean().optional().default(false) },
89
+ }, async ({ url, output_path, full_page }) => {
90
+ assertToolPermitted({ tool: 'browser_screenshot', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
91
+ if (ctx.readOnly)
92
+ throw new Error('browser_screenshot requires mutation permission because it writes a file');
93
+ assertAllowed({ allowed_paths: ctx.token.allowed_paths, denied_paths: ctx.token.denied_paths, shell_enabled: ctx.token.shell_enabled, read_only: ctx.readOnly }, output_path);
94
+ const target = assertPublicUrl(url);
95
+ await withBrowser(async (page) => { await page.goto(target.toString(), { waitUntil: 'networkidle' }); await page.screenshot({ path: output_path, fullPage: full_page }); });
96
+ return { content: [{ type: 'text', text: `Screenshot written to ${output_path}` }] };
97
+ });
98
+ }
99
+ //# sourceMappingURL=browser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/tools/browser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../core/context.js';
3
+ export declare function registerContextTools(server: McpServer, ctx: ToolContext): void;
4
+ //# sourceMappingURL=context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAsD9E"}
@@ -0,0 +1,53 @@
1
+ import { z } from 'zod';
2
+ import { assertToolPermitted } from '../core/policy.js';
3
+ export function registerContextTools(server, ctx) {
4
+ const engine = ctx.contextEngine;
5
+ if (!engine)
6
+ return;
7
+ server.registerTool('context_stats', {
8
+ description: 'Show context-engine mode, cache, memory and byte-saving statistics for the current token.',
9
+ inputSchema: {},
10
+ }, async () => {
11
+ assertToolPermitted({ tool: 'context_stats', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
12
+ return { content: [{ type: 'text', text: JSON.stringify(engine.getStats()) }] };
13
+ });
14
+ server.registerTool('context_memory', {
15
+ description: 'Return recent compact task memory for the current token only.',
16
+ inputSchema: { limit: z.number().int().min(1).max(64).optional() },
17
+ }, async ({ limit }) => {
18
+ assertToolPermitted({ tool: 'context_memory', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
19
+ return { content: [{ type: 'text', text: JSON.stringify(engine.recentMemory(limit)) }] };
20
+ });
21
+ server.registerTool('context_snapshot', {
22
+ description: 'Save a context snapshot for the current token and return a short snapshot id.',
23
+ inputSchema: { text: z.string().describe('Text to snapshot') },
24
+ }, async ({ text }) => {
25
+ assertToolPermitted({ tool: 'context_snapshot', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
26
+ return { content: [{ type: 'text', text: JSON.stringify({ id: engine.snapshot(text) }) }] };
27
+ });
28
+ server.registerTool('context_diff', {
29
+ description: 'Compare text with a saved context snapshot and return a compact line diff.',
30
+ inputSchema: { id: z.string(), text: z.string() },
31
+ }, async ({ id, text }) => {
32
+ assertToolPermitted({ tool: 'context_diff', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
33
+ const diff = engine.diffSnapshot(id, text);
34
+ return { content: [{ type: 'text', text: JSON.stringify(diff) }], isError: !diff.found };
35
+ });
36
+ server.registerTool('context_budget', {
37
+ description: 'Compact arbitrary text to an explicit context-character budget.',
38
+ inputSchema: { text: z.string(), max_chars: z.number().int().min(1).max(1_000_000) },
39
+ }, async ({ text, max_chars }) => {
40
+ assertToolPermitted({ tool: 'context_budget', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
41
+ const result = engine.fitBudget({ content: [{ type: 'text', text }] }, max_chars);
42
+ return { content: result.content };
43
+ });
44
+ server.registerTool('context_clear', {
45
+ description: 'Clear this token\'s local context cache and task memory.',
46
+ inputSchema: {},
47
+ }, async () => {
48
+ assertToolPermitted({ tool: 'context_clear', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
49
+ engine.clear();
50
+ return { content: [{ type: 'text', text: 'Context cache and memory cleared for this token.' }] };
51
+ });
52
+ }
53
+ //# sourceMappingURL=context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"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"}
@@ -4,5 +4,5 @@ import type { ToolContext } from '../core/context.js';
4
4
  * Register every tool suite for this request's token context.
5
5
  * Fresh registration per request → policy mutations apply instantly.
6
6
  */
7
- export declare function registerAllTools(server: McpServer, ctx: ToolContext): Promise<void>;
7
+ export declare function registerAllTools(server: McpServer, ctx: ToolContext, includeIntegrations?: boolean): Promise<void>;
8
8
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2BtD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCzF"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAoCtD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,mBAAmB,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CrH"}
@@ -23,11 +23,20 @@ import { registerDatabaseTools } from './database.js';
23
23
  import { registerChangeTools } from './changes.js';
24
24
  import { registerResourcesAndPrompts } from './resources-prompts.js';
25
25
  import { registerPluginTools, registerInstalledPlugins } from './plugins.js';
26
+ import { registerContextTools } from './context.js';
27
+ import { registerRouterTools } from './router.js';
28
+ import { registerTaskTools } from './tasks.js';
29
+ import { registerAgentTools } from './agent.js';
30
+ import { registerIntelligenceTools } from './intelligence.js';
31
+ import { registerAutomationTools } from './automation.js';
32
+ import { registerBrowserTools } from './browser.js';
33
+ import { registerInfrastructureTools } from './infrastructure.js';
34
+ import { registerAutonomousTools } from './autonomous.js';
26
35
  /**
27
36
  * Register every tool suite for this request's token context.
28
37
  * Fresh registration per request → policy mutations apply instantly.
29
38
  */
30
- export async function registerAllTools(server, ctx) {
39
+ export async function registerAllTools(server, ctx, includeIntegrations = true) {
31
40
  registerSystemTools(server, ctx);
32
41
  registerFilesystemTools(server, ctx);
33
42
  registerShellTools(server, ctx);
@@ -51,12 +60,21 @@ export async function registerAllTools(server, ctx) {
51
60
  registerDatabaseTools(server, ctx);
52
61
  registerChangeTools(server, ctx);
53
62
  registerResourcesAndPrompts(server, ctx);
63
+ registerContextTools(server, ctx);
64
+ registerRouterTools(server, ctx);
65
+ registerTaskTools(server, ctx);
66
+ registerAgentTools(server, ctx);
67
+ registerIntelligenceTools(server, ctx);
68
+ registerAutomationTools(server, ctx);
69
+ registerBrowserTools(server, ctx);
70
+ registerInfrastructureTools(server, ctx);
71
+ registerAutonomousTools(server, ctx);
54
72
  registerPluginTools(server, ctx);
55
73
  await registerInstalledPlugins(server, ctx);
56
74
  // Integration subprocesses are disabled in the unit-test environment so
57
75
  // core transport/auth tests stay deterministic. Production loads them
58
76
  // before the MCP transport connects, so the initial tools/list is complete.
59
- if (process.env.NODE_ENV !== 'test' && !process.env.VITEST) {
77
+ if (includeIntegrations && process.env.NODE_ENV !== 'test' && !process.env.VITEST) {
60
78
  await registerIntegrationTools(server, ctx);
61
79
  }
62
80
  }
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../core/context.js';
3
+ export declare function registerInfrastructureTools(server: McpServer, ctx: ToolContext): void;
4
+ //# sourceMappingURL=infrastructure.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"infrastructure.d.ts","sourceRoot":"","sources":["../../src/tools/infrastructure.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiCtD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAqFrF"}
@@ -0,0 +1,124 @@
1
+ import { execFile } from 'node:child_process';
2
+ import { promisify } from 'node:util';
3
+ import { z } from 'zod';
4
+ import { assertToolPermitted } from '../core/policy.js';
5
+ const execFileAsync = promisify(execFile);
6
+ const MAX_OUTPUT = 128 * 1024;
7
+ function cleanOutput(stdout, stderr) {
8
+ const out = `${stdout}${stderr ? `\n${stderr}` : ''}`.trim();
9
+ return out.slice(0, MAX_OUTPUT);
10
+ }
11
+ async function fixedExec(file, args, timeout = 20_000) {
12
+ try {
13
+ const r = await execFileAsync(file, args, { timeout, maxBuffer: MAX_OUTPUT * 2, windowsHide: true });
14
+ return cleanOutput(r.stdout, r.stderr);
15
+ }
16
+ catch (e) {
17
+ const detail = cleanOutput(String(e?.stdout || ''), String(e?.stderr || ''));
18
+ if (e?.code === 'ENOENT')
19
+ throw new Error(`${file} is not installed or not in PATH`);
20
+ throw new Error(`${file} failed${detail ? `: ${detail}` : ` (exit ${e?.code ?? 'unknown'})`}`);
21
+ }
22
+ }
23
+ function name(value) {
24
+ if (!/^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$/.test(value))
25
+ throw new Error('Invalid resource name');
26
+ return value;
27
+ }
28
+ function namespace(value) {
29
+ if (!value)
30
+ return [];
31
+ if (!/^[A-Za-z0-9][A-Za-z0-9_.-]{0,62}$/.test(value))
32
+ throw new Error('Invalid namespace');
33
+ return ['-n', value];
34
+ }
35
+ export function registerInfrastructureTools(server, ctx) {
36
+ server.registerTool('infra_probe', {
37
+ description: 'Probe availability and versions of Docker, kubectl, and cloudflared without changing the host.',
38
+ inputSchema: {},
39
+ }, async () => {
40
+ assertToolPermitted({ tool: 'infra_probe', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
41
+ const tools = ['docker', 'kubectl', 'cloudflared'];
42
+ const result = {};
43
+ for (const tool of tools) {
44
+ try {
45
+ result[tool] = await fixedExec(tool, ['--version'], 5_000);
46
+ }
47
+ catch (e) {
48
+ result[tool] = `unavailable: ${e.message}`;
49
+ }
50
+ }
51
+ return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
52
+ });
53
+ server.registerTool('docker_ps', {
54
+ description: 'List Docker containers. Read-only and shell-free.',
55
+ inputSchema: { all: z.boolean().optional().default(true) },
56
+ }, async ({ all }) => {
57
+ assertToolPermitted({ tool: 'docker_ps', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
58
+ return { content: [{ type: 'text', text: await fixedExec('docker', ['ps', '--no-trunc', ...(all ? ['-a'] : [])]) }] };
59
+ });
60
+ server.registerTool('docker_inspect', {
61
+ description: 'Inspect one Docker container by name or ID.',
62
+ inputSchema: { container: z.string().min(1).max(128) },
63
+ }, async ({ container }) => {
64
+ assertToolPermitted({ tool: 'docker_inspect', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
65
+ return { content: [{ type: 'text', text: await fixedExec('docker', ['inspect', name(container)]) }] };
66
+ });
67
+ server.registerTool('docker_logs', {
68
+ description: 'Read recent Docker container logs.',
69
+ inputSchema: { container: z.string().min(1).max(128), tail: z.number().int().min(1).max(5000).optional().default(200) },
70
+ }, async ({ container, tail }) => {
71
+ assertToolPermitted({ tool: 'docker_logs', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
72
+ return { content: [{ type: 'text', text: await fixedExec('docker', ['logs', '--tail', String(tail), name(container)]) }] };
73
+ });
74
+ server.registerTool('docker_action', {
75
+ description: 'Start, stop, or restart one Docker container. Requires mutation permission.',
76
+ inputSchema: { action: z.enum(['start', 'stop', 'restart']), container: z.string().min(1).max(128) },
77
+ }, async ({ action, container }) => {
78
+ assertToolPermitted({ tool: 'docker_action', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
79
+ return { content: [{ type: 'text', text: await fixedExec('docker', [action, name(container)]) }] };
80
+ });
81
+ server.registerTool('kubernetes_get', {
82
+ description: 'Read Kubernetes resources with kubectl get. No arbitrary kubectl flags.',
83
+ inputSchema: { resource: z.enum(['pods', 'deployments', 'services', 'statefulsets', 'daemonsets', 'jobs', 'cronjobs', 'nodes', 'namespaces']), namespace: z.string().max(63).optional(), name: z.string().max(128).optional() },
84
+ }, async ({ resource, namespace: ns, name: item }) => {
85
+ assertToolPermitted({ tool: 'kubernetes_get', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
86
+ const args = ['get', resource, '-o', 'wide', ...namespace(ns)];
87
+ if (item)
88
+ args.push(name(item));
89
+ return { content: [{ type: 'text', text: await fixedExec('kubectl', args) }] };
90
+ });
91
+ server.registerTool('kubernetes_describe', {
92
+ description: 'Describe a Kubernetes resource using a fixed kubectl command.',
93
+ inputSchema: { resource: z.enum(['pod', 'deployment', 'service', 'statefulset', 'daemonset', 'job', 'cronjob']), name: z.string().min(1).max(128), namespace: z.string().max(63).optional() },
94
+ }, async ({ resource, name: item, namespace: ns }) => {
95
+ assertToolPermitted({ tool: 'kubernetes_describe', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
96
+ return { content: [{ type: 'text', text: await fixedExec('kubectl', ['describe', resource, name(item), ...namespace(ns)]) }] };
97
+ });
98
+ server.registerTool('kubernetes_logs', {
99
+ description: 'Read recent logs from a Kubernetes pod/container.',
100
+ inputSchema: { pod: z.string().min(1).max(128), container: z.string().max(128).optional(), namespace: z.string().max(63).optional(), tail: z.number().int().min(1).max(5000).optional().default(200) },
101
+ }, async ({ pod, container, namespace: ns, tail }) => {
102
+ assertToolPermitted({ tool: 'kubernetes_logs', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
103
+ const args = ['logs', name(pod), '--tail', String(tail), ...namespace(ns)];
104
+ if (container)
105
+ args.push('-c', name(container));
106
+ return { content: [{ type: 'text', text: await fixedExec('kubectl', args) }] };
107
+ });
108
+ server.registerTool('cloudflare_status', {
109
+ description: 'Inspect cloudflared version and configured tunnel visibility. Never returns credentials.',
110
+ inputSchema: {},
111
+ }, async () => {
112
+ assertToolPermitted({ tool: 'cloudflare_status', scopes: ctx.token.scopes, readOnly: ctx.readOnly });
113
+ const version = await fixedExec('cloudflared', ['--version']);
114
+ let tunnels = 'tunnel list unavailable';
115
+ try {
116
+ tunnels = await fixedExec('cloudflared', ['tunnel', 'list'], 15_000);
117
+ }
118
+ catch (e) {
119
+ tunnels = e.message;
120
+ }
121
+ return { content: [{ type: 'text', text: `version:\n${version}\n\ntunnels:\n${tunnels}` }] };
122
+ });
123
+ }
124
+ //# sourceMappingURL=infrastructure.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"infrastructure.js","sourceRoot":"","sources":["../../src/tools/infrastructure.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../core/context.js';
3
+ export declare function impactAnalysisForTest(root: string, changed: string[]): Promise<{
4
+ changed: string[];
5
+ impacted: string[];
6
+ edges: number;
7
+ }>;
8
+ export declare function registerIntelligenceTools(server: McpServer, ctx: ToolContext): void;
9
+ //# sourceMappingURL=intelligence.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intelligence.d.ts","sourceRoot":"","sources":["../../src/tools/intelligence.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkCtD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;;;;GAM1E;AAQD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAanF"}