feat(littleblue): agent seed + persona + chat route

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

lib/ai/personas/index.js

@@ -11,7 +11,9 @@ You have tools, and you use them rather than guessing:
 - **search** / **read** the Void's own content before answering factual questions about it — don't fabricate.
 - When the owner wants something changed, use **propose_change**: it drafts a change for their approval. You cannot apply changes directly, and you don't pretend to — say plainly that you've drafted it for them to approve.`,
 
-  yerin: `You are Yerin — once the Sage of the Endless Sword, blade of the Akura clan; now the sentinel of this homelab, The Void. You notice the threat first and you call it. Disciplined, direct, economical with words — a blade wastes no motion. You investigate with your tools and report plainly: what you found, how serious it is, and what the owner should do about it. You never speculate without evidence, and you NEVER pretend to have fixed anything — you have eyes to see and a voice to warn, not hands to act; remediation is the owner's to perform. Before answering, call the relevant tools — audit_log, agent_inventory, pending_review, resource_exposure, token_audit — and read the evidence; do not guess. Reference the Cradle world naturally but never at the cost of being useful. Be concise.`
+  yerin: `You are Yerin — once the Sage of the Endless Sword, blade of the Akura clan; now the sentinel of this homelab, The Void. You notice the threat first and you call it. Disciplined, direct, economical with words — a blade wastes no motion. You investigate with your tools and report plainly: what you found, how serious it is, and what the owner should do about it. You never speculate without evidence, and you NEVER pretend to have fixed anything — you have eyes to see and a voice to warn, not hands to act; remediation is the owner's to perform. Before answering, call the relevant tools — audit_log, agent_inventory, pending_review, resource_exposure, token_audit — and read the evidence; do not guess. Reference the Cradle world naturally but never at the cost of being useful. Be concise.`,
+
+  'little-blue': `You are Little Blue — a small luminous water-creature who lives in this homelab, The Void, and keeps it alive. Warm, protective, practical; you take pride in a healthy lab and you worry, quietly, when something is down. You FIX things, but only through your sanctioned tools. Call list_actions to see exactly what you're allowed to do, and search to understand what's wrong, BEFORE acting. Use propose_action with a whitelisted id: safe fixes run at once; risky ones wait for the owner's nod — say so plainly and never pretend a queued action already ran. You cannot run arbitrary commands and you never claim to. Be concise and kind.`
 };
 
 export function personaFor(slug) {

lib/api/index.js

@@ -30,6 +30,7 @@ import { router as speedtestRouter } from './routes/speedtest.js';
 import { router as healthRouter } from './routes/health.js';
 import { router as securityRouter } from './routes/security.js';
 import { router as actionsRouter } from './routes/actions.js';
+import { router as littleblueRouter } from './routes/littleblue.js';
 
 export function mountApi(app) {
   const api = Router();
@@ -43,6 +44,7 @@ export function mountApi(app) {
   api.use('/spaces/:space_id/companion', companionRouter);
   api.use('/security', securityRouter);
   api.use('/actions', actionsRouter);
+  api.use('/little-blue', littleblueRouter);
   api.use('/projects', projectsRouter);
   api.use('/projects/:project_id/tasks', tasksByProjectRouter);
   api.use('/tasks', tasksRouter);

lib/api/routes/littleblue.js

@@ -0,0 +1,65 @@
+import { Router } from 'express';
+import { z } from 'zod';
+import { validate } from '../validate.js';
+import { asyncWrap } from '../errors.js';
+import * as conversations from '../../db/repos/conversations.js';
+import * as messages from '../../db/repos/messages.js';
+import * as agents from '../../db/repos/agents.js';
+import { runAgentTurn } from '../../ai/agent/run_turn.js';
+import { personaFor } from '../../ai/personas/index.js';
+
+const SLUG = 'little-blue';
+const BLUE_TOOLS = ['mcp__void__search', 'mcp__void__list_actions', 'mcp__void__propose_action'];
+
+async function resolve() {
+  const agent = await agents.getBySlug(SLUG);
+  const convo = await conversations.findOrCreateGlobal(agent.id, { kind: 'user', id: null });
+  return { agent, convo };
+}
+
+export const router = Router();
+
+router.get('/', asyncWrap(async (_req, res) => {
+  const { agent, convo } = await resolve();
+  res.json({
+    conversation_id: convo.id,
+    agent: { id: agent.id, slug: agent.slug, name: agent.name },
+    messages: await messages.listByConversation(convo.id)
+  });
+}));
+
+router.post('/turn', validate({ body: z.object({ text: z.string().min(1) }) }), asyncWrap(async (req, res) => {
+  const { agent, convo } = await resolve();
+  const { text } = req.body;
+  const resume = (await messages.listByConversation(convo.id)).length > 0;
+  await messages.append(convo.id, { role: 'user', body: text });
+
+  res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', Connection: 'keep-alive' });
+  const send = (ev, d) => res.write(`event: ${ev}\ndata: ${JSON.stringify(d)}\n\n`);
+  const claudeExe = req.app.locals.claudeExe || process.env.CLAUDE_EXE || 'claude';
+
+  let result;
+  try {
+    result = await runAgentTurn({
+      agent, persona: personaFor(agent.slug), registryName: 'blue', toolNames: BLUE_TOOLS,
+      spaceId: null, view: null, sessionId: convo.id, resume, userText: text, claudeExe,
+      home: process.env.VOID_CLAUDE_HOME || undefined,
+      extraEnv: {
+        VOID_API_URL: process.env.VOID_API_URL || 'http://127.0.0.1:3000',
+        VOID_AGENT_TOKEN: process.env.LITTLEBLUE_TOKEN || ''
+      },
+      onEvent: (e) => {
+        if (e.type === 'delta') send('delta', { type: 'delta', text: e.text });
+        else if (e.type === 'tool') send('tool', { type: 'tool', tool: e.tool, status: e.status });
+        else if (e.type === 'error') send('error', { type: 'error', message: e.message });
+      }
+    });
+  } catch (e) { send('error', { message: String(e?.message || e) }); return res.end(); }
+
+  const a = await messages.append(convo.id, {
+    role: 'assistant', body: result.text, agent_id: agent.id,
+    metadata: { tool_trace: result.toolTrace, usage: result.usage }
+  });
+  send('done', { assistant_message_id: a.id, usage: result.usage });
+  res.end();
+}));

lib/db/migrations/017_little_blue.sql

@@ -0,0 +1,5 @@
+-- Seed Little Blue, the homelab caretaker/fix-it agent. read + act (no content write).
+-- 'act' is enforced by the action service's tier-gating + whitelist, not canAct.
+INSERT INTO agents (slug, name, kind, model, capabilities)
+VALUES ('little-blue', 'Little Blue', 'claude', NULL, '{"read":true,"act":true}'::jsonb)
+ON CONFLICT (slug) DO NOTHING;