ruflo 3.6.12 → 3.6.13

package/src/ruvocal/src/lib/constants/routerExamples.ts

@@ -14,195 +14,119 @@ export type RouterExample = {
 	attachments?: RouterExampleAttachment[];
 };
 
+// RuFlo-themed router examples — shown on the empty-state welcome screen
+// when the user hasn't enabled the full MCP toolset. Keep these light enough
+// that even a model without tool-calling can answer (no explicit tool names).
 export const routerExamples: RouterExample[] = [
 	{
-		title: "HTML game",
-		prompt: "Code a minimal Flappy Bird game using HTML and Canvas",
+		title: "Build a coding swarm",
+		prompt: "Design a 5-agent coding swarm to refactor a Python CLI to TypeScript. Suggest topology, roles, and the order each agent should run.",
 		followUps: [
 			{
-				title: "README.md file",
-				prompt: "Create a comprehensive README.md for the Flappy Bird game project.",
+				title: "Add tests",
+				prompt: "Add a tester agent and a security-auditor. What should each one own?",
 			},
 			{
-				title: "CRT Screen",
-				prompt: "Add a CRT screen effect to the game",
+				title: "Trade-offs",
+				prompt: "Compare hierarchical vs mesh topology for this swarm.",
 			},
 			{
-				title: "Add power-ups",
-				prompt:
-					"Add collectible coins between pipes that award bonus points and a shield power-up that allows one collision.",
-			},
-			{
-				title: "Explain collision detection",
-				prompt:
-					"Explain the collision detection algorithm for the bird and pipes in simple terms with examples.",
-			},
-		],
-	},
-	{
-		title: "Weird painting",
-		prompt: "is this a real painting?",
-		attachments: [
-			{
-				src: "huggingchat/castle-example.jpg",
+				title: "Failure mode",
+				prompt: "What happens if the architect agent fails halfway through?",
 			},
 		],
 	},
 	{
-		title: "Landing page",
-		prompt:
-			"Build a responsive SaaS landing page for my AI coding assitant using Tailwind CSS. With a hero, features, testimonials, and pricing sections.",
+		title: "Memory & recall",
+		prompt: "Explain how RuFlo's persistent memory works across sessions, and give me a 3-step example of saving a preference and recalling it later.",
 		followUps: [
 			{
-				title: "Dark mode",
-				prompt: "Add dark mode and make it the default",
-			},
-			{
-				title: "Write blog post",
-				prompt: "Write a blog post introducing my service.",
-			},
-			{
-				title: "Translate to Italian",
-				prompt: "Translate only the text content displayed to users into Italian.",
+				title: "Namespaces",
+				prompt: "When should I use separate memory namespaces vs one shared namespace?",
 			},
 			{
-				title: "Architecture review",
-				prompt:
-					"Review the architecture and suggest improvements for scalability, SEO optimization, and performance.",
+				title: "Vector vs key",
+				prompt: "When should I use semantic search vs exact key retrieval?",
 			},
 		],
 	},
 	{
-		title: "Eminem song",
-		prompt:
-			"Write an Eminem-style rap battling AI taking over hip-hop, with two energetic verses and a catchy hook.",
+		title: "Plan a migration",
+		prompt: "Plan a zero-downtime Postgres schema migration. Use Goal-Oriented Action Planning to break it into phases with rollback points.",
 		followUps: [
 			{
-				title: "Psychological analysis",
-				prompt: "Provide a psychological analysis of Eminem's emotions in this song.",
-			},
-			{
-				title: "Wired Article",
-				prompt: "Write an article in the style of Wired explaining this Eminem release.",
-			},
-			{
-				title: "Roleplay",
-				prompt: "Roleplay as Eminem so I can discuss the song with him.",
+				title: "Risk scoring",
+				prompt: "Which phases are highest-risk and how would you mitigate them?",
 			},
 			{
-				title: "Translate to Spanish",
-				prompt: "Translate the rap lyrics to Spanish while maintaining the rhyme scheme and flow.",
+				title: "Verification",
+				prompt: "How would you verify each phase before proceeding?",
 			},
 		],
 	},
 	{
-		title: "Act as Yoda",
-		prompt: "Act as Yoda",
+		title: "Review a diff",
+		prompt: "What signals would you use to risk-score a code diff (size, files touched, hot paths) and how would you suggest reviewers?",
 		followUps: [
 			{
-				title: "Give advice",
-				prompt:
-					"Continue acting as Yoda and offer three pieces of life advice for staying focused under pressure.",
+				title: "Auto-classify",
+				prompt: "Classify a diff as feature/bugfix/refactor/docs from its file mix and message.",
 			},
 			{
-				title: "Explain the Force",
-				prompt:
-					"In Yoda's voice, explain the concept of the Force to a young padawan using modern language.",
-			},
-			{
-				title: "Plain English",
-				prompt:
-					"Rewrite the previous response from Yoda into plain English while keeping the same meaning.",
-			},
-			{
-				title: "Compare philosophies",
-				prompt:
-					"Compare Yoda's Jedi philosophy to Stoic philosophy from ancient Greece and explain the similarities and differences.",
+				title: "Security focus",
+				prompt: "Which patterns in a diff should trigger a security review?",
 			},
 		],
 	},
 	{
-		title: "Generate prompts",
-		prompt: `Generate 5 creative prompts Text-to-image prompts like: "Cyberpunk cityscape at night, neon lights, flying cars, rain-slicked streets, blade runner aesthetic, highly detailed`,
+		title: "Explain HNSW",
+		prompt: "Explain HNSW vector indexing in plain language, and why it's 150x-12,500x faster than brute-force similarity search at scale.",
 		followUps: [
 			{
-				title: "Turn into JSON",
-				prompt: `Generate a detailed JSON object for each prompt. Include fields for subjects (list of objects), scene (setting, environment, background details), actions (what's happening), style (artistic style or medium)`,
-			},
-			{
-				title: "Sci-fi portraits",
-				prompt:
-					"Produce five futuristic character portrait prompts with unique professions and settings.",
+				title: "Quantization",
+				prompt: "What does Int8 quantization buy you, and what's the trade-off?",
 			},
 			{
-				title: "Explain image generation",
-				prompt:
-					"Explain how text-to-image diffusion models work, covering the denoising process and how text prompts guide generation.",
+				title: "Use case",
+				prompt: "When would you reach for HNSW vs a relational keyword index?",
 			},
 		],
 	},
 	{
-		title: "Explain LLMs",
-		prompt:
-			"Explain how large language models based on transformers work, covering attention, embeddings, and training objectives.",
+		title: "Choose a topology",
+		prompt: "I have 12 agents to coordinate on a multi-step refactor. Compare hierarchical, mesh, hierarchical-mesh, and adaptive topologies — pick one and explain why.",
 		followUps: [
 			{
-				title: "Generate a Quiz",
-				prompt: "Craft a 5-question multiple-choice quiz to validate what I learned.",
-			},
-			{
-				title: "Compare to RNNs",
-				prompt:
-					"Compare transformer-based large language models to recurrent neural networks, focusing on training efficiency and capabilities.",
+				title: "Anti-drift",
+				prompt: "What's 'anti-drift' coordination and why does it matter for >8 agents?",
 			},
 			{
-				title: "Student summary",
-				prompt:
-					"Summarize the explanation of large language models for a high school student using relatable analogies.",
-			},
-			{
-				title: "Write a blog post",
-				prompt:
-					"Write a blog post about how transformers revolutionized NLP, targeting software engineers who are new to AI.",
+				title: "Consensus",
+				prompt: "Compare Raft, Byzantine, gossip, and CRDT consensus for this swarm.",
 			},
 		],
 	},
 	{
-		title: "Translate in Italian",
-		prompt: `Translate in Italian: Some are born great, some achieve greatness, and some have greatness thrust upon 'em`,
+		title: "Track a long task",
+		prompt: "I'm starting a 4-week migration. How should I structure horizon tracking, milestone checkpoints, and drift detection in RuFlo?",
 		followUps: [
 			{
-				title: "Back to English",
-				prompt:
-					"Translate the Italian version back into English while keeping Shakespeare's tone intact.",
-			},
-			{
-				title: "Explain choices",
-				prompt: "Explain your translation choices for each key phrase from the Italian version.",
-			},
-			{
-				title: "Modernize",
-				prompt:
-					"Modernize the Italian translation into contemporary informal Italian suitable for social media.",
-			},
-			{
-				title: "Teach me Italian",
-				prompt:
-					"Help me practice Italian by conversing about this Shakespeare quote, correcting my grammar when needed.",
+				title: "Resume after break",
+				prompt: "What state should be persisted so I can resume next week?",
 			},
 		],
 	},
 	{
-		title: "Pelican on a bicycle",
-		prompt: "Draw an SVG of a pelican riding a bicycle",
+		title: "Local WASM tools",
+		prompt: "What's the difference between the in-browser WASM MCP server and the cloud bridge MCP servers? When should I use each?",
 		followUps: [
 			{
-				title: "Add a top hat",
-				prompt: "Add a fancy top hat to the pelican and make it look distinguished",
+				title: "Privacy",
+				prompt: "Which tools never leave my browser?",
 			},
 			{
-				title: "Make it animated",
-				prompt: "Add CSS animations to make the bicycle wheels spin and the pelican's wings flap",
+				title: "Offline",
+				prompt: "What can RuFlo still do if my network drops?",
 			},
 		],
 	},

package/src/ruvocal/src/lib/constants/rvagentPresets.ts

@@ -0,0 +1,206 @@
+/**
+ * rvAgent MCP Server Presets
+ *
+ * Pre-configured server configurations for the rvagent-mcp server
+ * with different tool group combinations. These presets correspond
+ * to the tool groups defined in ADR-112.
+ *
+ * Tool Groups:
+ * - file: read, write, edit, ls, glob, grep
+ * - shell: execute, bash
+ * - memory: semantic_search, store, retrieve
+ * - agent: spawn, status, orchestrate
+ * - git: status, commit, diff, log
+ * - web: fetch, search
+ * - brain: search, share, vote (π Brain)
+ * - task: create, list, complete
+ * - core: ping, initialize (always included)
+ */
+
+export interface RvAgentPreset {
+	/** Unique identifier for the preset */
+	id: string;
+	/** Display name */
+	name: string;
+	/** Short description */
+	description: string;
+	/** Tool groups to enable */
+	groups: string[];
+	/** Default port (user can override) */
+	defaultPort: number;
+	/** Icon/emoji for display */
+	icon: string;
+	/** Recommended use cases */
+	useCases: string[];
+}
+
+/**
+ * Pre-configured rvagent-mcp presets for common use cases
+ */
+export const RVAGENT_PRESETS: RvAgentPreset[] = [
+	{
+		id: "all-tools",
+		name: "All Tools",
+		description: "Full access to all 46+ rvAgent tools",
+		groups: ["all"],
+		defaultPort: 9000,
+		icon: "🔧",
+		useCases: ["Development", "Testing", "Full automation"],
+	},
+	{
+		id: "file-shell",
+		name: "File & Shell",
+		description: "File operations and command execution",
+		groups: ["file", "shell"],
+		defaultPort: 9001,
+		icon: "📂",
+		useCases: ["Code editing", "Build scripts", "File management"],
+	},
+	{
+		id: "memory-agent",
+		name: "Memory & Agent",
+		description: "Vector memory and multi-agent orchestration",
+		groups: ["memory", "agent"],
+		defaultPort: 9002,
+		icon: "🧠",
+		useCases: ["Knowledge retrieval", "Agent coordination", "RAG"],
+	},
+	{
+		id: "git-web",
+		name: "Git & Web",
+		description: "Version control and web operations",
+		groups: ["git", "web"],
+		defaultPort: 9003,
+		icon: "🌐",
+		useCases: ["Code review", "Research", "Documentation"],
+	},
+	{
+		id: "brain-task",
+		name: "Brain & Tasks",
+		description: "π Brain integration and task management",
+		groups: ["brain", "task"],
+		defaultPort: 9004,
+		icon: "🎯",
+		useCases: ["Knowledge sharing", "Task tracking", "Collaboration"],
+	},
+	{
+		id: "dev-minimal",
+		name: "Dev Minimal",
+		description: "Essential development tools only",
+		groups: ["file", "shell", "git"],
+		defaultPort: 9005,
+		icon: "💻",
+		useCases: ["Quick edits", "Simple scripts", "Git operations"],
+	},
+	{
+		id: "research",
+		name: "Research Mode",
+		description: "Memory, web search, and brain tools",
+		groups: ["memory", "web", "brain"],
+		defaultPort: 9006,
+		icon: "🔬",
+		useCases: ["Research", "Knowledge discovery", "Analysis"],
+	},
+	{
+		id: "orchestration",
+		name: "Orchestration",
+		description: "Agent spawning and task coordination",
+		groups: ["agent", "task", "memory"],
+		defaultPort: 9007,
+		icon: "🎭",
+		useCases: ["Multi-agent workflows", "Complex tasks", "Automation"],
+	},
+];
+
+/**
+ * Get preset by ID
+ */
+export function getPresetById(id: string): RvAgentPreset | undefined {
+	return RVAGENT_PRESETS.find((p) => p.id === id);
+}
+
+/**
+ * Build the SSE URL for a preset
+ */
+export function buildPresetUrl(preset: RvAgentPreset, host = "localhost", port?: number): string {
+	const actualPort = port ?? preset.defaultPort;
+	return `http://${host}:${actualPort}/sse`;
+}
+
+/**
+ * Build CLI command to start the server with preset configuration
+ */
+export function buildPresetCliCommand(preset: RvAgentPreset, port?: number): string {
+	const actualPort = port ?? preset.defaultPort;
+	const groupsArg = preset.groups.includes("all") ? "--all" : `--groups ${preset.groups.join(",")}`;
+
+	return `rvagent-mcp --transport sse --port ${actualPort} ${groupsArg}`;
+}
+
+/**
+ * Get all available tool group names
+ */
+export const TOOL_GROUPS = [
+	"file",
+	"shell",
+	"memory",
+	"agent",
+	"git",
+	"web",
+	"brain",
+	"task",
+	"core",
+] as const;
+
+export type ToolGroupName = (typeof TOOL_GROUPS)[number];
+
+/**
+ * Tool group descriptions for UI display
+ */
+export const TOOL_GROUP_INFO: Record<ToolGroupName, { name: string; tools: string[]; icon: string }> = {
+	file: {
+		name: "File Operations",
+		tools: ["read_file", "write_file", "edit_file", "ls", "glob", "grep"],
+		icon: "📁",
+	},
+	shell: {
+		name: "Shell Execution",
+		tools: ["execute", "bash"],
+		icon: "💻",
+	},
+	memory: {
+		name: "Vector Memory",
+		tools: ["semantic_search", "store_memory", "retrieve_memory"],
+		icon: "🧠",
+	},
+	agent: {
+		name: "Multi-Agent",
+		tools: ["spawn_agent", "agent_status", "orchestrate"],
+		icon: "🤖",
+	},
+	git: {
+		name: "Version Control",
+		tools: ["git_status", "git_commit", "git_diff", "git_log"],
+		icon: "📦",
+	},
+	web: {
+		name: "Web Operations",
+		tools: ["web_fetch", "web_search"],
+		icon: "🌐",
+	},
+	brain: {
+		name: "π Brain",
+		tools: ["brain_search", "brain_share", "brain_vote"],
+		icon: "🧪",
+	},
+	task: {
+		name: "Task Management",
+		tools: ["create_task", "list_tasks", "complete_task"],
+		icon: "✅",
+	},
+	core: {
+		name: "Core Protocol",
+		tools: ["ping", "initialize", "tools/list"],
+		icon: "⚙️",
+	},
+};