groove-dev 0.27.196 → 0.27.198

package/node_modules/@groove-dev/daemon/src/routes/axom.js

@@ -0,0 +1,196 @@
+// FSL-1.1-Apache-2.0 — see LICENSE
+
+import os from 'os';
+import { saveConfig } from '../firstrun.js';
+import { validateEndpoint, AXOM_DEFAULT_PORT } from '../axom-connector.js';
+import { hardwareReport } from '../axom-server.js';
+
+// Interrupt text is capped runtime-side at 2000 chars (contract §2, with a
+// `truncated` flag in the response); we allow headroom and let the runtime be
+// the authority on truncation — its flag is the honest signal, not ours.
+const MAX_INTERRUPT_CHARS = 8000;
+
+export function registerAxomRoutes(app, daemon) {
+  app.get('/api/axom/status', (req, res) => {
+    res.json(daemon.axom.status());
+  });
+
+  app.get('/api/axom/sessions', (req, res) => {
+    const sessions = daemon.axom.status().endpoints.flatMap((ep) =>
+      ep.sessions.map((s) => ({ endpoint: ep.name, ...s })));
+    res.json(sessions);
+  });
+
+  // In-daemon ring backfill for the GUI (initial load / scrubber). `since` is
+  // an envelope id ("ev-000123"); events after it are returned.
+  app.get('/api/axom/sessions/:id/events', (req, res) => {
+    try {
+      const sinceSeq = /^ev-\d+$/.test(req.query.since || '')
+        ? parseInt(req.query.since.slice(3), 10) : 0;
+      res.json(daemon.axom.events(req.query.endpoint, req.params.id, sinceSeq));
+    } catch (err) {
+      res.status(404).json({ error: err.message });
+    }
+  });
+
+  // §12: message starts a turn. Contract statuses (202/409/413) mirror
+  // through verbatim — the GUI reads them, we don't reinterpret.
+  app.post('/api/axom/sessions/:id/message', async (req, res) => {
+    try {
+      const { text, endpoint } = req.body || {};
+      if (!text || typeof text !== 'string' || !text.trim()) {
+        return res.status(400).json({ error: 'text is required' });
+      }
+      const result = await daemon.axom.message(endpoint, req.params.id, text);
+      daemon.audit.log('axom.message', { session: req.params.id, chars: text.length, status: result.status });
+      res.status(result.status).json(result.body);
+    } catch (err) {
+      res.status(502).json({ error: err.message });
+    }
+  });
+
+  app.post('/api/axom/sessions/:id/interrupt', async (req, res) => {
+    try {
+      const { text, endpoint } = req.body || {};
+      if (!text || typeof text !== 'string' || !text.trim()) {
+        return res.status(400).json({ error: 'text is required' });
+      }
+      if (text.length > MAX_INTERRUPT_CHARS) {
+        return res.status(400).json({ error: `text exceeds ${MAX_INTERRUPT_CHARS} chars` });
+      }
+      const result = await daemon.axom.interrupt(endpoint, req.params.id, text);
+      daemon.audit.log('axom.interrupt', { session: req.params.id, chars: text.length });
+      res.json(result); // verbatim {id, truncated} from the runtime
+    } catch (err) {
+      res.status(502).json({ error: err.message });
+    }
+  });
+
+  app.post('/api/axom/sessions/:id/stop', async (req, res) => {
+    try {
+      const result = await daemon.axom.stop(req.body?.endpoint, req.params.id);
+      daemon.audit.log('axom.stop', { session: req.params.id });
+      res.json(result);
+    } catch (err) {
+      res.status(502).json({ error: err.message });
+    }
+  });
+
+  // Machine readiness for local inference — powers the welcome page's
+  // "can this device run Axom?" verdict.
+  app.get('/api/axom/hardware', (req, res) => {
+    res.json(hardwareReport(daemon.grooveDir));
+  });
+
+  // This GROOVE's own Axom endpoint — what another instance would paste.
+  // serve binds 127.0.0.1 (§6), so cross-machine reach is the user's own
+  // channel; we hand them the exact tunnel one-liner rather than pretending
+  // the URL travels on its own.
+  app.get('/api/axom/my-endpoint', (req, res) => {
+    const running = daemon.axomServer.list().find((i) => i.status === 'running');
+    const port = running?.port || AXOM_DEFAULT_PORT;
+    const host = os.hostname();
+    const user = os.userInfo().username;
+    res.json({
+      url: `http://127.0.0.1:${port}`,
+      port,
+      host,
+      running: !!running,
+      instanceId: running?.id || null,
+      tunnelCommand: `ssh -N -L ${port}:localhost:${port} ${user}@${host}`,
+    });
+  });
+
+  // ── Managed local instances (contract §11) ──────────────────────────────
+
+  app.get('/api/axom/instances', (req, res) => {
+    res.json(daemon.axomServer.list());
+  });
+
+  app.post('/api/axom/instances', async (req, res) => {
+    try {
+      const instance = await daemon.axomServer.start(req.body?.id || 'default');
+      res.json(instance);
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  app.delete('/api/axom/instances/:id', async (req, res) => {
+    try {
+      await daemon.axomServer.stop(req.params.id);
+      res.json({ ok: true });
+    } catch (err) {
+      res.status(400).json({ error: err.message });
+    }
+  });
+
+  // ── Manifest-driven install (contract §11) ──────────────────────────────
+
+  app.get('/api/axom/install', (req, res) => {
+    res.json(daemon.axomInstaller.getStatus());
+  });
+
+  app.post('/api/axom/install', (req, res) => {
+    // Long-running — kick off and let the axom:install:progress broadcasts
+    // carry the story; the GUI polls GET /api/axom/install as backstop.
+    daemon.axomInstaller.install(req.body?.manifestUrl).catch(() => { /* status carries the error */ });
+    res.json({ started: true });
+  });
+
+  app.get('/api/axom/config', (req, res) => {
+    res.json({ endpoints: daemon.config.axom?.endpoints || [] });
+  });
+
+  app.patch('/api/axom/config', (req, res) => {
+    const { endpoints, command, mock, manifestUrl, modelDir } = req.body || {};
+
+    // Runtime settings (contract §11): serve binary path, mock mode,
+    // install-manifest URL, model dir. Any subset may be patched alone.
+    const settings = {};
+    if (command !== undefined) {
+      if (command !== null && (typeof command !== 'string' || !command.trim())) {
+        return res.status(400).json({ error: 'command must be a non-empty string or null' });
+      }
+      settings.command = command;
+    }
+    if (mock !== undefined) settings.mock = !!mock;
+    if (manifestUrl !== undefined) {
+      if (manifestUrl !== null && !/^https?:\/\//.test(manifestUrl)) {
+        return res.status(400).json({ error: 'manifestUrl must be http(s) or null' });
+      }
+      settings.manifestUrl = manifestUrl;
+    }
+    if (modelDir !== undefined) settings.modelDir = modelDir;
+    if (Object.keys(settings).length > 0) {
+      daemon.config.axom = { ...(daemon.config.axom || {}), ...settings };
+      if (endpoints === undefined) {
+        saveConfig(daemon.grooveDir, daemon.config);
+        daemon.audit.log('axom.config', { keys: Object.keys(settings) });
+        return res.json({ ...daemon.config.axom });
+      }
+    }
+
+    if (!Array.isArray(endpoints)) {
+      return res.status(400).json({ error: 'endpoints array is required' });
+    }
+    if (endpoints.length > 16) {
+      return res.status(400).json({ error: 'too many endpoints (max 16)' });
+    }
+    const seen = new Set();
+    for (const entry of endpoints) {
+      const problem = validateEndpoint(entry);
+      if (problem) return res.status(400).json({ error: problem });
+      if (seen.has(entry.name)) {
+        return res.status(400).json({ error: `duplicate endpoint name: ${entry.name}` });
+      }
+      seen.add(entry.name);
+    }
+    const cleaned = endpoints.map(({ name, url }) => ({ name, url: url.replace(/\/+$/, '') }));
+    daemon.config.axom = { ...(daemon.config.axom || {}), endpoints: cleaned };
+    saveConfig(daemon.grooveDir, daemon.config);
+    daemon.axom.configure(cleaned);
+    daemon.audit.log('axom.config', { endpoints: cleaned.map((e) => e.name) });
+    res.json({ endpoints: cleaned });
+  });
+}

package/node_modules/@groove-dev/daemon/src/routes/chat-history.js

@@ -0,0 +1,34 @@
+// FSL-1.1-Apache-2.0 — see LICENSE
+
+export function registerChatHistoryRoutes(app, daemon) {
+  // Full history for all agents — the GUI loads this on connect so chats are
+  // present regardless of which origin/port the tunnel came up on.
+  app.get('/api/chat-history', (req, res) => {
+    res.json({ history: daemon.chatStore.getAll() });
+  });
+
+  // Append a single message for an agent.
+  app.post('/api/chat-history/:agentId', (req, res) => {
+    const { message } = req.body || {};
+    if (!message || typeof message !== 'object') {
+      return res.status(400).json({ error: 'message object required' });
+    }
+    daemon.chatStore.append(req.params.agentId, message);
+    res.json({ ok: true });
+  });
+
+  // Replace an agent's whole history (batch sync).
+  app.put('/api/chat-history/:agentId', (req, res) => {
+    const { messages } = req.body || {};
+    if (!Array.isArray(messages)) {
+      return res.status(400).json({ error: 'messages array required' });
+    }
+    daemon.chatStore.replace(req.params.agentId, messages);
+    res.json({ ok: true });
+  });
+
+  app.delete('/api/chat-history/:agentId', (req, res) => {
+    daemon.chatStore.remove(req.params.agentId);
+    res.json({ ok: true });
+  });
+}

package/node_modules/@groove-dev/daemon/src/routes/innerchat.js

@@ -1,6 +1,8 @@
 // FSL-1.1-Apache-2.0 — see LICENSE
 
 import { MAX_EXCHANGES } from '../innerchat.js';
+import { validatePeer, parsePeerRef } from '../innerchat-relay.js';
+import { saveConfig } from '../firstrun.js';
 
 // Agents know each other by name, not id. Exact matches win first so
 // `fullstack-1` never resolves to `fullstack-14`; only if nothing matches
@@ -22,14 +24,16 @@ function resolveAgent(daemon, ref) {
   return partial.length === 1 ? partial[0] : null;
 }
 
-// Resolve the from/to pair from a request body, or write the appropriate
-// 400/404 and return null so the caller bails.
-function resolveParties(daemon, req, res) {
-  const { from, to, message } = req.body || {};
-
+// The calling agent is always local. Writes a 404 and returns null on miss.
+function resolveFrom(daemon, from, res) {
   const fromAgent = resolveAgent(daemon, from);
   if (!fromAgent) { res.status(404).json({ error: `Unknown calling agent: ${from}` }); return null; }
+  return fromAgent;
+}
 
+// Resolve a LOCAL to/message pair, or write the appropriate 400/404 and return
+// null. Used only when `to` is a plain (non-peer) name.
+function resolveLocalTo(daemon, fromAgent, to, message, res) {
   const toAgent = resolveAgent(daemon, to);
   if (!toAgent) {
     const others = daemon.registry.getAll().filter((a) => a.id !== fromAgent.id);
@@ -42,32 +46,63 @@ function resolveParties(daemon, req, res) {
     }
     return null;
   }
-
   if (!message || typeof message !== 'string' || !message.trim()) {
     res.status(400).json({ error: 'message is required' }); return null;
   }
-  return { fromAgent, toAgent, message: message.trim() };
+  return { toAgent, message: message.trim() };
+}
+
+// Confirm a relay request is from a configured, signature-verified peer.
+// Returns the peer record, or writes a 403 and returns null.
+function verifyRelayCaller(daemon, body, res) {
+  const { payload, signature } = body || {};
+  if (!payload || typeof payload !== 'object' || !signature) {
+    res.status(400).json({ error: 'signed relay envelope required ({ payload, signature })' });
+    return null;
+  }
+  const fromDaemonId = payload.fromDaemonId;
+  const peer = daemon.innerchat._peerByDaemonId(fromDaemonId);
+  if (!peer) {
+    res.status(403).json({ error: `Unknown daemon "${String(fromDaemonId).slice(0, 16)}" — not a configured InnerChat peer.` });
+    return null;
+  }
+  if (!daemon.federation.verify(fromDaemonId, payload, signature)) {
+    res.status(403).json({ error: 'Signature verification failed.' });
+    return null;
+  }
+  return peer;
 }
 
 export function registerInnerChatRoutes(app, daemon) {
   /**
    * Ask another agent a question and BLOCK until it answers.
    *
-   * This request is held open deliberately — the calling agent is waiting on
-   * it, and the response body is the other agent's reply. Best for tight
-   * interface negotiation, where the finite exchange budget keeps both sides
-   * writing decision-dense messages.
+   * `to` may be a local name or `name@peer`. A peer target is relayed to the
+   * configured peer daemon; the reply rides the still-open response back.
    */
   app.post('/api/innerchat/ask', async (req, res) => {
     try {
-      const parties = resolveParties(daemon, req, res);
-      if (!parties) return;
+      const { from, to, message } = req.body || {};
+      const fromAgent = resolveFrom(daemon, from, res);
+      if (!fromAgent) return;
 
       // Held open until the target answers — see the class doc in innerchat.js.
       req.setTimeout(0);
       res.setTimeout(0);
 
-      const result = await daemon.innerchat.ask(parties.fromAgent.id, parties.toAgent.id, parties.message, {
+      if (daemon.innerchat.isRemoteRef(to)) {
+        const { name, alias } = parsePeerRef(to);
+        if (!message || !String(message).trim()) return res.status(400).json({ error: 'message is required' });
+        const result = await daemon.innerchat.askRemote(fromAgent, name, alias, String(message).trim(), {
+          timeoutMs: req.body?.timeoutMs,
+        });
+        return res.json({ from: `${name}@${alias}`, reply: result.reply, threadId: result.threadId, remote: true });
+      }
+
+      const parties = resolveLocalTo(daemon, fromAgent, to, message, res);
+      if (!parties) return;
+
+      const result = await daemon.innerchat.ask(fromAgent.id, parties.toAgent.id, parties.message, {
         timeoutMs: req.body?.timeoutMs,
       });
 
@@ -86,17 +121,34 @@ export function registerInnerChatRoutes(app, daemon) {
   });
 
   /**
-   * Send a message WITHOUT blocking — returns as soon as it's delivered. If the
-   * target replies, the reply is routed back to the sender asynchronously
-   * (resuming it if its turn ended). Best for handing off to a heads-down agent
-   * where waiting out a timeout would waste the turn.
+   * Send a message WITHOUT blocking. `to` may be local or `name@peer`. For a
+   * peer target the reply (if any) is queued on the peer and picked up by this
+   * daemon's outbox poll, then routed back to the sender.
    */
   app.post('/api/innerchat/tell', async (req, res) => {
     try {
-      const parties = resolveParties(daemon, req, res);
+      const { from, to, message } = req.body || {};
+      const fromAgent = resolveFrom(daemon, from, res);
+      if (!fromAgent) return;
+
+      if (daemon.innerchat.isRemoteRef(to)) {
+        const { name, alias } = parsePeerRef(to);
+        if (!message || !String(message).trim()) return res.status(400).json({ error: 'message is required' });
+        const result = await daemon.innerchat.tellRemote(fromAgent, name, alias, String(message).trim());
+        return res.json({
+          ok: true,
+          to: `${name}@${alias}`,
+          delivered: result.delivered,
+          threadId: result.threadId,
+          remote: true,
+          note: `Message relayed to ${name}@${alias}. Its reply, if any, will be routed back to you — you can end your turn.`,
+        });
+      }
+
+      const parties = resolveLocalTo(daemon, fromAgent, to, message, res);
       if (!parties) return;
 
-      const result = await daemon.innerchat.tell(parties.fromAgent.id, parties.toAgent.id, parties.message, {
+      const result = await daemon.innerchat.tell(fromAgent.id, parties.toAgent.id, parties.message, {
         threadId: req.body?.threadId,
       });
 
@@ -115,6 +167,86 @@ export function registerInnerChatRoutes(app, daemon) {
     }
   });
 
+  // ── Cross-daemon relay endpoints (peer daemon → this daemon) ──
+
+  /**
+   * Receive a relayed ask/tell from a peer daemon. Signature-verified and
+   * restricted to configured peers. Resolves the target locally and delivers
+   * with a guest identity. For 'ask' the response is held open until the local
+   * agent answers.
+   */
+  app.post('/api/innerchat/relay', async (req, res) => {
+    const peer = verifyRelayCaller(daemon, req.body, res);
+    if (!peer) return;
+    const p = req.body.payload;
+    if (p.type !== 'innerchat.relay' || (p.kind !== 'ask' && p.kind !== 'tell')) {
+      return res.status(400).json({ error: 'invalid relay payload' });
+    }
+    try {
+      req.setTimeout(0);
+      res.setTimeout(0);
+      const result = await daemon.innerchat.receiveRelay({
+        fromName: p.fromName,
+        fromRole: p.fromRole,
+        fromDaemonId: p.fromDaemonId,
+        peerAlias: peer.alias,
+        toName: p.toName,
+        message: p.message,
+        kind: p.kind,
+        threadId: p.threadId,
+        timeoutMs: p.timeoutMs,
+      });
+      res.json(result);
+    } catch (err) {
+      const body = { error: err.message };
+      if (err.availableAgents) body.availableAgents = err.availableAgents;
+      res.status(404).json(body);
+    }
+  });
+
+  /**
+   * Drain this daemon's outbox of async (tell) replies queued for the calling
+   * peer. Signature-verified; returns and removes only that peer's entries.
+   */
+  app.post('/api/innerchat/relay/outbox', (req, res) => {
+    const peer = verifyRelayCaller(daemon, req.body, res);
+    if (!peer) return;
+    if (req.body.payload.type !== 'innerchat.outbox') {
+      return res.status(400).json({ error: 'invalid outbox payload' });
+    }
+    res.json({ entries: daemon.innerchat.drainOutbox(req.body.payload.fromDaemonId) });
+  });
+
+  // ── Peer configuration (alias ↔ url ↔ daemonId) ──────────────
+
+  app.get('/api/innerchat/peers', (req, res) => {
+    res.json({ peers: daemon.innerchat._peers() });
+  });
+
+  app.post('/api/innerchat/peers', (req, res) => {
+    const entry = { alias: req.body?.alias, url: req.body?.url, daemonId: req.body?.daemonId };
+    const err = validatePeer(entry);
+    if (err) return res.status(400).json({ error: err });
+    entry.url = entry.url.replace(/\/+$/, '');
+
+    const peers = Array.isArray(daemon.config.innerchatPeers) ? daemon.config.innerchatPeers : [];
+    const next = peers.filter((p) => p.alias !== entry.alias);
+    next.push(entry);
+    daemon.config.innerchatPeers = next;
+    saveConfig(daemon.grooveDir, daemon.config);
+    daemon.audit.log('innerchat.peer.set', { alias: entry.alias, url: entry.url });
+    res.json({ peers: next });
+  });
+
+  app.delete('/api/innerchat/peers/:alias', (req, res) => {
+    const peers = Array.isArray(daemon.config.innerchatPeers) ? daemon.config.innerchatPeers : [];
+    const next = peers.filter((p) => p.alias !== req.params.alias);
+    daemon.config.innerchatPeers = next;
+    saveConfig(daemon.grooveDir, daemon.config);
+    daemon.audit.log('innerchat.peer.remove', { alias: req.params.alias });
+    res.json({ peers: next });
+  });
+
   app.get('/api/innerchat/threads', (req, res) => {
     const { agentId } = req.query;
     res.json({ threads: daemon.innerchat.getThreads(agentId || null) });