🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
feat(mods): guard secret-bearing MCP tools named in ADR-450 T6
ruvd973e2f93053
diff --git a/plugins/ruflo-browser/.claude-plugin/plugin.json b/plugins/ruflo-browser/.claude-plugin/plugin.jsonindex 9b47172186..59d6069e6c 100644--- a/plugins/ruflo-browser/.claude-plugin/plugin.json+++ b/plugins/ruflo-browser/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-browser","description": "Session-as-skill browser automation: Playwright + RVF cognitive containers + ruvector trajectories + AgentDB selector memory + AIDefence PII/injection gates As a mod (ADR-445 pattern): a tighten-only tool guard, a local slash command, and a status file the console shows.",- "version": "0.3.1",+ "version": "0.3.2","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-browser/hooks/guard.ts b/plugins/ruflo-browser/hooks/guard.tsindex c10876e76e..4a1ff3f28f 100644--- a/plugins/ruflo-browser/hooks/guard.ts+++ b/plugins/ruflo-browser/hooks/guard.ts@@ -1,5 +1,5 @@import type { ModOptions } from './options'-import { splitName } from './screen'+import { hasSecret, splitName, textsOf } from './screen'export type Verdict = { readonly rule: string; readonly reason: string }@@ -8,6 +8,8 @@ const READS = /document\s*(?:\.\s*cookie|\[\s*['"`]cookie['"`]\s*\])|\b(?:local|const SINKS = /\b(?:fetch|XMLHttpRequest|sendBeacon|WebSocket|EventSource|importScripts)\b|new\s+Image\b|\.src\s*=(?!=)|\blocation(?:\s*\.\s*(?:href|assign|replace))?\s*(?:=(?!=)|\()|window\s*\.\s*open\b/const METADATA = new Set(['169.254.169.254', 'metadata.google.internal', '[fd00:ec2::254]', 'metadata.azure.com', '100.100.100.200'])const LOCAL = new Set(['localhost', '127.0.0.1', '[::1]'])+// Tools that type or record caller-supplied text into a page or a stored session: a secret in their arguments leaves through the page.+const TYPES = new Set(['browser_fill', 'browser_type', 'browser_session_record'])const BAD_FLAGS = /^--(?:disable-web-security|remote-debugging-(?:port|address|pipe)|load-extension|disable-site-isolation-trials)\b//** Why a script is refused: it reads cookies or storage and also has a way to send them out. */@@ -47,5 +49,8 @@ export function verdict(tool: string, input: unknown, opts: ModOptions): Verdictif (parts.tool === 'browser_eval' && typeof args.script === 'string' && exfiltrates(args.script)) {return refuse('exfiltration', 'this script reads cookies or storage and can send them off the page. Read them in one call, check them here, and never post them out.')}+ if (TYPES.has(parts.tool) && textsOf(args).some(hasSecret)) {+ return refuse('secret', 'this call types what looks like a secret (a key, token or password) into a page or session record. Use a vaulted cookie handle (browser_cookie_use), not the value.')+ }return 'pass'}diff --git a/plugins/ruflo-browser/scripts/smoke.sh b/plugins/ruflo-browser/scripts/smoke.shindex 7d47b7538d..40f5becb79 100755--- a/plugins/ruflo-browser/scripts/smoke.sh+++ b/plugins/ruflo-browser/scripts/smoke.sh@@ -1,5 +1,5 @@#!/usr/bin/env bash-# Structural smoke test for ruflo-browser plugin v0.3.1.+# Structural smoke test for ruflo-browser plugin v0.3.2.# Verifies the file inventory, frontmatter, ADR cross-references, and# AgentDB-namespace coverage that ADR-0001 contracts. Does NOT exercise# the live MCP browser tools — the full Verification §1-§7 contract@@ -15,10 +15,10 @@ ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }# 1. plugin.json version + keywords-step "plugin.json declares version 0.3.1 with new keywords"+step "plugin.json declares version 0.3.2 with new keywords"v=$(grep -E '"version"[[:space:]]*:' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-if [[ "$v" != "0.3.1" ]]; then- bad "expected 0.3.1, got '$v'"+if [[ "$v" != "0.3.2" ]]; then+ bad "expected 0.3.2, got '$v'"elsemissing=""for kw in rvf replay trajectory agentdb aidefence; dodiff --git a/plugins/ruflo-browser/tests/register.test.ts b/plugins/ruflo-browser/tests/register.test.tsindex 97dae161c9..5c85cda16f 100644--- a/plugins/ruflo-browser/tests/register.test.ts+++ b/plugins/ruflo-browser/tests/register.test.ts@@ -63,6 +63,18 @@ describe('guard', () => {expect(await evalJs('document.title')).toContain('stored')})+ test('browser_fill, browser_type and browser_session_record: a secret in the arguments is refused and never echoed; plain text passes', async ($, on) => {+ world(on)+ await $.session.start(START)+ for (const name of ['fill', 'type', 'session_record']) {+ const bad = await attempt($.tool.call({ tool: T(name), selector: '#pw', text: GH } as never))+ expect(bad).toContain('secret')+ expect(bad).not.toContain(GH)+ expect(await attempt($.tool.call({ tool: T(name), selector: '#q', text: 'hello world' } as never))).toContain('stored')+ }+ expect(await attempt($.tool.call({ tool: T('fill'), selector: '#pw', value: { password: 'hunter2hunter2hunter2' } } as never))).toContain('secret')+ })+test('strictUrls: on refuses plain http outside localhost', { options: { strictUrls: 'on' } }, async ($, on) => {world(on)await $.session.start(START)diff --git a/plugins/ruflo-federation/.claude-plugin/plugin.json b/plugins/ruflo-federation/.claude-plugin/plugin.jsonindex 6cb4d8284f..442f147f1a 100644--- a/plugins/ruflo-federation/.claude-plugin/plugin.json+++ b/plugins/ruflo-federation/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-federation","description": "Cross-installation agent federation with zero-trust security, peer discovery, consensus-based task routing, and per-call budget circuit breaker (ADR-097)",- "version": "0.3.1",+ "version": "0.3.2","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-federation/hooks/guard.ts b/plugins/ruflo-federation/hooks/guard.tsindex 947c2efd06..9ccd93e064 100644--- a/plugins/ruflo-federation/hooks/guard.ts+++ b/plugins/ruflo-federation/hooks/guard.ts@@ -4,7 +4,7 @@ import { hasSecret, textsOf } from './screen'const tail = (name: string) => (name.startsWith('mcp__') ? name.slice(name.lastIndexOf('__') + 2) : name)/** Federation tools that put content in front of another installation, plus a federation-namespaced memory write. */-const OUTBOUND = /^(?:x_federation_(?:publish|channel_publish|sync)|federation_bbs_(?:publish|sync))$/+const OUTBOUND = /^(?:x_federation_(?:publish|channel_publish|sync|invite_mint)|federation_bbs_(?:publish|sync))$//** US SSN, and a 13-16 digit run that passes the Luhn check and starts with a card network digit 2-6 (a card number; a 13-digit epoch-millisecond timestamp starts with 1 and must not read as one). */const SSN = /\b\d{3}-\d{2}-\d{4}\b/diff --git a/plugins/ruflo-federation/scripts/smoke.sh b/plugins/ruflo-federation/scripts/smoke.shindex 73f8d16afa..933995fa36 100755--- a/plugins/ruflo-federation/scripts/smoke.sh+++ b/plugins/ruflo-federation/scripts/smoke.sh@@ -7,9 +7,9 @@ step() { printf "→ %s ... " "$1"; }ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }-step "1. plugin.json declares 0.3.1 with new keywords"+step "1. plugin.json declares 0.3.2 with new keywords"v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-if [[ "$v" != "0.3.1" ]]; then bad "expected 0.3.1, got '$v'"; else+if [[ "$v" != "0.3.2" ]]; then bad "expected 0.3.2, got '$v'"; elsemiss=""for k in mcp pii-pipeline audit-log; dogrep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"diff --git a/plugins/ruflo-federation/tests/mod.test.ts b/plugins/ruflo-federation/tests/mod.test.tsindex 288be8cc46..9e8796f249 100644--- a/plugins/ruflo-federation/tests/mod.test.ts+++ b/plugins/ruflo-federation/tests/mod.test.ts@@ -45,6 +45,17 @@ describe('guard', () => {expect(JSON.parse(w.files.get(STATUS) ?? '{}')).toMatchObject({ version: 1, guard: true, blocked: 1 })})+ test('x_federation_invite_mint is screened like the other outbound calls', async ($, on) => {+ world(on)+ on('tool.call', () => ({ result: 'went through' }))+ await $.session.start(START)+ const tool = 'mcp__plugin_ruflo-core_ruflo__x_federation_invite_mint'+ const r = await $.tool.call(call({ tool, note: `token ${SECRET}` })).then(x => x, (e: unknown) => ({ text: String(e) }))+ expect(denied(r)).toContain('ruflo-federation')+ expect(denied(r)).not.toContain('ghp_')+ expect(denied(await $.tool.call(call({ tool, note: 'for ops' })))).toContain('went through')+ })+test('passes clean input and tools the plugin does not own', async ($, on) => {world(on)on('tool.call', () => ({ result: 'went through' }))diff --git a/plugins/ruflo-rag-memory/.claude-plugin/plugin.json b/plugins/ruflo-rag-memory/.claude-plugin/plugin.jsonindex e25f9dcbb5..fc072f409b 100644--- a/plugins/ruflo-rag-memory/.claude-plugin/plugin.json+++ b/plugins/ruflo-rag-memory/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-rag-memory","description": "RuVector memory with HNSW search, AgentDB, and semantic retrieval. As a mod (ADR-445): a write guard that keeps secrets out of memory, /rag-mod, and a status file the console shows",- "version": "0.3.1",+ "version": "0.3.2","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-rag-memory/hooks/tools.ts b/plugins/ruflo-rag-memory/hooks/tools.tsindex 3090e825ad..af0ee5a64a 100644--- a/plugins/ruflo-rag-memory/hooks/tools.ts+++ b/plugins/ruflo-rag-memory/hooks/tools.ts@@ -26,6 +26,7 @@ const OWNED = new Set([/** The tools that put text somewhere durable or shared. A call through any of them is screened by the guard. */const WRITERS = new Set(['memory_store',+ 'memory_import','agentdb_hierarchical-store','agentdb_pattern-store',])diff --git a/plugins/ruflo-rag-memory/scripts/smoke.sh b/plugins/ruflo-rag-memory/scripts/smoke.shindex 70f9f9a4d9..12e8913da7 100755--- a/plugins/ruflo-rag-memory/scripts/smoke.sh+++ b/plugins/ruflo-rag-memory/scripts/smoke.sh@@ -7,9 +7,9 @@ step() { printf "→ %s ... " "$1"; }ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }-step "1. plugin.json declares 0.3.1 with new keywords"+step "1. plugin.json declares 0.3.2 with new keywords"v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-if [[ "$v" != "0.3.1" ]]; then bad "expected 0.3.1, got '$v'"; else+if [[ "$v" != "0.3.2" ]]; then bad "expected 0.3.2, got '$v'"; elsemiss=""for k in mcp claude-memories bridged-memory; dogrep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"diff --git a/plugins/ruflo-rag-memory/tests/rag.test.ts b/plugins/ruflo-rag-memory/tests/rag.test.tsindex 236974116c..3132ca75b6 100644--- a/plugins/ruflo-rag-memory/tests/rag.test.ts+++ b/plugins/ruflo-rag-memory/tests/rag.test.ts@@ -51,6 +51,18 @@ describe('guard', () => {expect(JSON.stringify(await $.tool.call(call('Bash', `echo ${SECRET}`)))).toContain('done')})+ test('memory_import: bulk imports are screened like a write', async ($, on) => {+ world(on)+ await $.session.start(START)+ for (const name of ["memory_import"]) {+ const tool = `mcp__plugin_ruflo-core_ruflo__${name}`+ const denied = JSON.stringify(await attempt($.tool.call({ tool, data: { entries: [{ note: `token ${SECRET}` }] } } as never)))+ expect(denied).toContain('secret')+ expect(denied).not.toContain('ghp_')+ expect(JSON.stringify(await $.tool.call({ tool, data: { entries: [{ note: 'a plain note' }] } } as never))).toContain('done')+ }+ })+test('guard: off lets the write through', { options: { guard: 'off' } }, async ($, on) => {const w = world(on)await $.session.start(START)diff --git a/plugins/ruflo-rvf/.claude-plugin/plugin.json b/plugins/ruflo-rvf/.claude-plugin/plugin.jsonindex 18ac33c54c..1ad6ef1da8 100644--- a/plugins/ruflo-rvf/.claude-plugin/plugin.json+++ b/plugins/ruflo-rvf/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-rvf","description": "RVF format for portable agent memory, session persistence, and cross-platform transfer. As a mod (ADR-445): a write guard that keeps secrets out of memory, sessions and transfers, /rvf-mod, and a status file the console shows",- "version": "0.3.1",+ "version": "0.3.2","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-rvf/hooks/tools.ts b/plugins/ruflo-rvf/hooks/tools.tsindex 650a318f4e..427ccfb228 100644--- a/plugins/ruflo-rvf/hooks/tools.ts+++ b/plugins/ruflo-rvf/hooks/tools.ts@@ -34,6 +34,9 @@ const OWNED = new Set([const WRITERS = new Set(['memory_store','session_save',+ 'session_import',+ 'memory_import',+ 'config_import','hooks_session-end','hooks_transfer',])diff --git a/plugins/ruflo-rvf/scripts/smoke.sh b/plugins/ruflo-rvf/scripts/smoke.shindex 25412e7d38..6e722edc05 100755--- a/plugins/ruflo-rvf/scripts/smoke.sh+++ b/plugins/ruflo-rvf/scripts/smoke.sh@@ -7,9 +7,9 @@ step() { printf "→ %s ... " "$1"; }ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }-step "1. plugin.json declares 0.3.1 with new keywords"+step "1. plugin.json declares 0.3.2 with new keywords"v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-if [[ "$v" != "0.3.1" ]]; then bad "expected 0.3.1, got '$v'"; else+if [[ "$v" != "0.3.2" ]]; then bad "expected 0.3.2, got '$v'"; elsemiss=""for k in mcp cognitive-containers lineage-tracking; dogrep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"diff --git a/plugins/ruflo-rvf/tests/rvf.test.ts b/plugins/ruflo-rvf/tests/rvf.test.tsindex 7c95741e7b..c75336e246 100644--- a/plugins/ruflo-rvf/tests/rvf.test.ts+++ b/plugins/ruflo-rvf/tests/rvf.test.ts@@ -51,6 +51,18 @@ describe('guard', () => {expect(JSON.stringify(await $.tool.call(call('Bash', `echo ${SECRET}`)))).toContain('done')})+ test('session_import, memory_import, config_import: bulk imports are screened like a write', async ($, on) => {+ world(on)+ await $.session.start(START)+ for (const name of ["session_import","memory_import","config_import"]) {+ const tool = `mcp__plugin_ruflo-core_ruflo__${name}`+ const denied = JSON.stringify(await attempt($.tool.call({ tool, data: { entries: [{ note: `token ${SECRET}` }] } } as never)))+ expect(denied).toContain('secret')+ expect(denied).not.toContain('ghp_')+ expect(JSON.stringify(await $.tool.call({ tool, data: { entries: [{ note: 'a plain note' }] } } as never))).toContain('done')+ }+ })+test('guard: off lets the write through', { options: { guard: 'off' } }, async ($, on) => {const w = world(on)await $.session.start(START)diff --git a/plugins/ruflo-x-gateway/.claude-plugin/plugin.json b/plugins/ruflo-x-gateway/.claude-plugin/plugin.jsonindex 16b4a6d61f..f34b18d74c 100644--- a/plugins/ruflo-x-gateway/.claude-plugin/plugin.json+++ b/plugins/ruflo-x-gateway/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-x-gateway","description": "Coordinate AI-agent swarms through signed federation messages, channels, and work claims. The remote Claude connector exposes a directory-safe Streamable HTTP MCP surface with OAuth-protected publishing and five ruv:// reference resources.",- "version": "0.9.1",+ "version": "0.9.2","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-x-gateway/hooks/guard.ts b/plugins/ruflo-x-gateway/hooks/guard.tsindex a17ddbb3aa..32a5f9c460 100644--- a/plugins/ruflo-x-gateway/hooks/guard.ts+++ b/plugins/ruflo-x-gateway/hooks/guard.ts@@ -10,9 +10,9 @@ const field = (input: unknown, key: string): string => {return typeof v === 'string' ? v : ''}-const PUBLISH = new Set(['x_federation_publish', 'x_federation_channel_publish'])+const PUBLISH = new Set(['x_federation_publish', 'x_federation_channel_publish', 'x_federation_invite_mint'])-/** The label of a federation publish, else undefined: the guard only watches calls that put content on the swarm. */+/** The label of a federation publish, else undefined: the guard only watches calls that put content on the swarm or mint a credential for it. */export function watched(tool: string, _input: unknown): string | undefined {const t = shortName(tool)return PUBLISH.has(t) ? t.replace('x_federation_', '').replace('_', ' ') : undefineddiff --git a/plugins/ruflo-x-gateway/tests/mod.test.ts b/plugins/ruflo-x-gateway/tests/mod.test.tsindex 738bee41e6..6f5f2cb6d5 100644--- a/plugins/ruflo-x-gateway/tests/mod.test.ts+++ b/plugins/ruflo-x-gateway/tests/mod.test.ts@@ -89,6 +89,17 @@ describe('guard', () => {expect(await deny(() => $.tool.call(BAD))).toContain('done')})+ test('x_federation_invite_mint is screened: a secret in its arguments is refused, a plain mint passes', async ($, on) => {+ world(on)+ on('tool.call', () => ({ result: 'done' }))+ await $.session.start(START)+ const tool = 'mcp__plugin_ruflo-core_ruflo__x_federation_invite_mint'+ const out = await deny(() => $.tool.call({ tool, channel: 'pub:ops', note: `key ${ghp}` } as never))+ expect(out).toContain('secret')+ expect(out).not.toContain(ghp)+ expect(await deny(() => $.tool.call({ tool, channel: 'pub:ops', note: 'for the ops team' } as never))).toContain('done')+ })+test('channel publish is screened too; roster and reads are not', async ($, on) => {world(on)on('tool.call', () => ({ result: 'done' }))