feat: exposition outils mutants Phase 2 + câblage par phase (v0.12.0)

registry.listAllTools expose les outils mutants (contrôle délégué au
gatekeeper). Prompt système phase-aware. index.ts branche Phase 1
(read-only + ReadOnlyGuard) ou Phase 2 (tous outils + GatekeeperGuard sur
table assets, alerte sur tentative bloquée). Build + 35 tests verts.

Palier de risque : privilégié (active la capacité d'écriture) — gardé
derrière CHLOVA_PHASE=2 + gatekeeper ; aucune mutation réelle sans review.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Kantin-Petit
2026-06-23 01:29:58 +02:00
parent 93d93bef0e
commit 48aa75d95e
4 changed files with 101 additions and 29 deletions
+41 -14
View File
@@ -2,7 +2,10 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
import type { Logger } from "pino";
import type { ToolHandle, ToolSpec } from "../agent/types.js";
import { isReadOnly, resolveRiskTier } from "./readonly-filter.js";
import { isReadOnly, resolveRiskTier, type McpToolLike } from "./readonly-filter.js";
/** Forme d'un outil telle que renvoyée par listTools (sous-ensemble utilisé). */
type McpTool = McpToolLike & { description?: string; inputSchema?: unknown };
/**
* Registry MCP : connecte les serveurs MCP configurés (n8n, Portainer), liste
@@ -43,22 +46,48 @@ export class McpRegistry {
}
/**
* Liste les outils LECTURE SEULE de tous les serveurs, sous forme de
* ToolHandle exécutables. Les outils non read-only sont écartés ET journalisés.
* Liste les outils LECTURE SEULE de tous les serveurs (Phase 1).
* Les outils non read-only sont écartés ET journalisés.
*/
async listReadOnlyTools(): Promise<ToolHandle[]> {
const handles: ToolHandle[] = [];
const handles = await this.collect((tool, srv) => {
if (!isReadOnly(tool)) {
this.logger.debug(
{ server: srv, tool: tool.name },
"outil non read-only écarté (Phase 1)",
);
return false;
}
return true;
});
this.logger.info({ count: handles.length }, "outils read-only exposés");
return handles;
}
/**
* Liste TOUS les outils (lecture seule + mutants) sous forme de ToolHandle
* (Phase 2). Le contrôle d'exécution est délégué au Gatekeeper via le Guard :
* les outils mutants sont exposés mais ne s'exécutent qu'après review.
*/
async listAllTools(): Promise<ToolHandle[]> {
const handles = await this.collect(() => true);
const writable = handles.filter((h) => h.spec.riskTier === "privileged").length;
this.logger.info(
{ count: handles.length, privileged: writable },
"outils exposés (Phase 2, mutants sous gatekeeper)",
);
return handles;
}
/** Construit les ToolHandle des serveurs, en gardant ceux qui passent `keep`. */
private async collect(
keep: (tool: McpTool, server: string) => boolean,
): Promise<ToolHandle[]> {
const handles: ToolHandle[] = [];
for (const srv of this.servers) {
const { tools } = await srv.client.listTools();
for (const tool of tools) {
if (!isReadOnly(tool)) {
this.logger.debug(
{ server: srv.name, tool: tool.name },
"outil non read-only écarté (Phase 1)",
);
continue;
}
if (!keep(tool, srv.name)) continue;
const spec: ToolSpec = {
name: `${srv.name}.${tool.name}`,
@@ -68,7 +97,7 @@ export class McpRegistry {
properties: {},
},
server: srv.name,
readOnly: true,
readOnly: isReadOnly(tool),
riskTier: resolveRiskTier(tool),
};
@@ -83,8 +112,6 @@ export class McpRegistry {
});
}
}
this.logger.info({ count: handles.length }, "outils read-only exposés");
return handles;
}