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.
- package/CHANGELOG.md +21 -0
- package/README.md +104 -2
- package/dist/core/agent-contracts.d.ts +57 -0
- package/dist/core/agent-contracts.d.ts.map +1 -0
- package/dist/core/agent-contracts.js +35 -0
- package/dist/core/agent-contracts.js.map +1 -0
- package/dist/core/agent-profiles.d.ts +11 -0
- package/dist/core/agent-profiles.d.ts.map +1 -0
- package/dist/core/agent-profiles.js +12 -0
- package/dist/core/agent-profiles.js.map +1 -0
- package/dist/core/automation-engine.d.ts +53 -0
- package/dist/core/automation-engine.d.ts.map +1 -0
- package/dist/core/automation-engine.js +310 -0
- package/dist/core/automation-engine.js.map +1 -0
- package/dist/core/autonomy.d.ts +11 -0
- package/dist/core/autonomy.d.ts.map +1 -0
- package/dist/core/autonomy.js +30 -0
- package/dist/core/autonomy.js.map +1 -0
- package/dist/core/capability-router.d.ts +16 -0
- package/dist/core/capability-router.d.ts.map +1 -0
- package/dist/core/capability-router.js +83 -0
- package/dist/core/capability-router.js.map +1 -0
- package/dist/core/config.js +1 -1
- package/dist/core/config.js.map +1 -1
- package/dist/core/context-engine.d.ts +75 -0
- package/dist/core/context-engine.d.ts.map +1 -0
- package/dist/core/context-engine.js +330 -0
- package/dist/core/context-engine.js.map +1 -0
- package/dist/core/context.d.ts +5 -0
- package/dist/core/context.d.ts.map +1 -1
- package/dist/core/context.js.map +1 -1
- package/dist/core/policy.d.ts.map +1 -1
- package/dist/core/policy.js +15 -5
- package/dist/core/policy.js.map +1 -1
- package/dist/core/project-profiles.d.ts +17 -0
- package/dist/core/project-profiles.d.ts.map +1 -0
- package/dist/core/project-profiles.js +32 -0
- package/dist/core/project-profiles.js.map +1 -0
- package/dist/core/recovery-engine.d.ts +37 -0
- package/dist/core/recovery-engine.d.ts.map +1 -0
- package/dist/core/recovery-engine.js +99 -0
- package/dist/core/recovery-engine.js.map +1 -0
- package/dist/core/security-analysis.d.ts +19 -0
- package/dist/core/security-analysis.d.ts.map +1 -0
- package/dist/core/security-analysis.js +39 -0
- package/dist/core/security-analysis.js.map +1 -0
- package/dist/core/task-engine.d.ts +76 -0
- package/dist/core/task-engine.d.ts.map +1 -0
- package/dist/core/task-engine.js +319 -0
- package/dist/core/task-engine.js.map +1 -0
- package/dist/server/app.d.ts +2 -1
- package/dist/server/app.d.ts.map +1 -1
- package/dist/server/app.js +117 -5
- package/dist/server/app.js.map +1 -1
- package/dist/server/run.d.ts.map +1 -1
- package/dist/server/run.js +15 -1
- package/dist/server/run.js.map +1 -1
- package/dist/tools/agent.d.ts +4 -0
- package/dist/tools/agent.d.ts.map +1 -0
- package/dist/tools/agent.js +16 -0
- package/dist/tools/agent.js.map +1 -0
- package/dist/tools/automation.d.ts +4 -0
- package/dist/tools/automation.d.ts.map +1 -0
- package/dist/tools/automation.js +87 -0
- package/dist/tools/automation.js.map +1 -0
- package/dist/tools/autonomous.d.ts +4 -0
- package/dist/tools/autonomous.d.ts.map +1 -0
- package/dist/tools/autonomous.js +82 -0
- package/dist/tools/autonomous.js.map +1 -0
- package/dist/tools/browser.d.ts +4 -0
- package/dist/tools/browser.d.ts.map +1 -0
- package/dist/tools/browser.js +99 -0
- package/dist/tools/browser.js.map +1 -0
- package/dist/tools/context.d.ts +4 -0
- package/dist/tools/context.d.ts.map +1 -0
- package/dist/tools/context.js +53 -0
- package/dist/tools/context.js.map +1 -0
- package/dist/tools/index.d.ts +1 -1
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/index.js +20 -2
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/infrastructure.d.ts +4 -0
- package/dist/tools/infrastructure.d.ts.map +1 -0
- package/dist/tools/infrastructure.js +124 -0
- package/dist/tools/infrastructure.js.map +1 -0
- package/dist/tools/intelligence.d.ts +9 -0
- package/dist/tools/intelligence.d.ts.map +1 -0
- package/dist/tools/intelligence.js +120 -0
- package/dist/tools/intelligence.js.map +1 -0
- package/dist/tools/planning.d.ts.map +1 -1
- package/dist/tools/planning.js +9 -0
- package/dist/tools/planning.js.map +1 -1
- package/dist/tools/plugin-host.d.ts +2 -0
- package/dist/tools/plugin-host.d.ts.map +1 -0
- package/dist/tools/plugin-host.js +54 -0
- package/dist/tools/plugin-host.js.map +1 -0
- package/dist/tools/plugin-network-blocker.cjs +39 -0
- package/dist/tools/plugins.d.ts.map +1 -1
- package/dist/tools/plugins.js +344 -30
- package/dist/tools/plugins.js.map +1 -1
- package/dist/tools/router.d.ts +4 -0
- package/dist/tools/router.d.ts.map +1 -0
- package/dist/tools/router.js +39 -0
- package/dist/tools/router.js.map +1 -0
- package/dist/tools/tasks.d.ts +4 -0
- package/dist/tools/tasks.d.ts.map +1 -0
- package/dist/tools/tasks.js +71 -0
- package/dist/tools/tasks.js.map +1 -0
- package/docs/ai/agent-architecture.md +145 -0
- package/docs/ai/decisions.md +119 -1
- 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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAqB,MAAM,4BAA4B,CAAC;AAE7L,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAC,iBAAiB,EAAC,gBAAgB,EAAC,eAAe,EAAC,mBAAmB,EAAC,mBAAmB,EAAC,mBAAmB,EAAC,oBAAoB,EAAC,sBAAsB,EAAC,sBAAsB,EAAC,kBAAkB,CAAC,CAAC,CAAC;AACjP,MAAM,EAAE,GAAG,CAAC,GAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvE,MAAM,MAAM,GAAG,CAAC,GAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,GAAG,EAAE,uBAAuB,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,GAAG,EAAE,uBAAuB,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,GAAG,EAAE,CAAC,CAAC;AAE1O,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,GAAgB;IACzE,MAAM,CAAC,YAAY,CAAC,mBAAmB,EAAE,EAAE,WAAW,EAAE,0EAA0E,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QAChK,mBAAmB,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzP,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,4EAA4E,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAC,MAAM,EAAC,YAAY,EAAC,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAC,KAAK,EAAC,QAAQ,EAAC,MAAM,EAAC,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QAC3S,mBAAmB,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACpL,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,YAAY,CAAC,sBAAsB,EAAE,EAAE,WAAW,EAAE,+EAA+E,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAC,QAAQ,EAAC,MAAM,EAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE,EAAE;QAC1lB,mBAAmB,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxG,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1H,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qCAAqC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvJ,IAAI,CAAC;YAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAAC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAAC,CAAC;QAChM,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACxL,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACxH,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,iDAAiD,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QACxI,mBAAmB,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACtI,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,YAAY,CAAC,sBAAsB,EAAE,EAAE,WAAW,EAAE,gCAAgC,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACtJ,mBAAmB,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxG,OAAO,kBAAkB,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrL,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,6CAA6C,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QACpI,mBAAmB,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAClI,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,WAAW,EAAE,0GAA0G,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QAC5N,mBAAmB,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpG,IAAI,GAAG,CAAC,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2CAA2C,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3H,MAAM,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChG,MAAM,QAAQ,GAAG,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,IAAI,QAAQ,KAAK,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,QAAQ,4FAA4F,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChN,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oEAAoE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChJ,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YACrF,IAAI,CAAC,GAAG,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACvE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9E,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YAC1E,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YAC5C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACtF,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,WAAW,EAAE,8DAA8D,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QAC9K,mBAAmB,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxG,qBAAqB,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC"}
|
|
@@ -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 @@
|
|
|
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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"}
|
package/dist/tools/index.d.ts
CHANGED
|
@@ -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;
|
|
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"}
|
package/dist/tools/index.js
CHANGED
|
@@ -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
|
}
|
package/dist/tools/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;
|
|
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"}
|