@geravant/sinain 1.18.2 → 1.19.0

package/cli.js

@@ -81,6 +81,13 @@ switch (cmd) {
     await import("./install.js");
     break;
 
+  case "mcp": {
+    const sub = process.argv[3]; // install | list | remove
+    const { runMcpCli } = await import("./mcp-register.js");
+    await runMcpCli(sub, process.argv.slice(4));
+    break;
+  }
+
   case "export-knowledge":
     await exportKnowledge();
     break;
@@ -396,6 +403,9 @@ Usage:
   sinain export-knowledge      Export knowledge for transfer to another machine
   sinain import-knowledge <file>  Import knowledge from export file
   sinain install               Install OpenClaw plugin (server-side)
+  sinain mcp install           Register sinain MCP for your agents (Claude, Cursor, Codex, Goose, Junie)
+  sinain mcp list              Show MCP registration status across agents
+  sinain mcp remove <agent>    Unregister sinain MCP from one agent
 
 Start options:
   --no-sense                   Skip screen capture (sense_client)

package/onboard.js

@@ -12,6 +12,7 @@ import {
   stepApiKey, stepTranscription, stepGateway, stepPrivacy, stepModel,
   HOME, SINAIN_DIR, ENV_PATH, PKG_DIR, IS_WINDOWS, IS_MAC,
 } from "./config-shared.js";
+import { stepMcpInstall, detectMcpAgents } from "./mcp-register.js";
 
 // ── Header ──────────────────────────────────────────────────────────────────
 
@@ -138,7 +139,7 @@ export async function runOnboard(args = {}) {
     initialValue: "quickstart",
   }));
 
-  const totalSteps = flow === "quickstart" ? 2 : 5;
+  const totalSteps = flow === "quickstart" ? 2 : 6;
 
   // ── Collect vars ────────────────────────────────────────────────────────
 
@@ -180,7 +181,11 @@ export async function runOnboard(args = {}) {
 
     agentsPatch = {
       default: base.SINAIN_AGENT || "claude",
-      escalationMode: "off",
+      // No `escalationMode` written — lane (default agent) is the single
+      // source of truth for whether escalation runs. If the user picks a
+      // local agent (claude), the runtime's default mode ("rich" from
+      // config.ts) takes effect and registerBareAgent ensures lane and
+      // mode stay reconciled at boot.
     };
 
     if (enableGateway) {
@@ -207,9 +212,28 @@ export async function runOnboard(args = {}) {
       ].join("\n"),
       "QuickStart defaults",
     );
+
+    // QuickStart MCP install: a single confirm gated on at least one
+    // detected agent. Avoids interrupting users who don't have any
+    // MCP-aware agent installed. Re-runnable later via `sinain mcp install`.
+    try {
+      const detected = (await detectMcpAgents()).filter((a) => a.present);
+      if (detected.length > 0) {
+        const labels = detected.map((a) => a.label).join(", ");
+        const wantMcp = guard(await p.confirm({
+          message: `Detected ${labels} — register sinain MCP for them?`,
+          initialValue: true,
+        }));
+        if (wantMcp) {
+          await stepMcpInstall(base, "Connect MCP agents");
+        }
+      }
+    } catch (err) {
+      p.log.info(`Skipping MCP setup: ${err.message}`);
+    }
   } else {
-    // Advanced flow: steps 2-5
-    const transcription = await stepTranscription(base, "[2/5] Audio transcription");
+    // Advanced flow: steps 2-6 (MCP install is step 6)
+    const transcription = await stepTranscription(base, "[2/6] Audio transcription");
     vars.TRANSCRIPTION_BACKEND = transcription;
     p.log.success(`Using ${transcription === "openrouter" ? "cloud" : "local"} transcription.`);
 
@@ -245,7 +269,7 @@ export async function runOnboard(args = {}) {
 
     // stepGateway returns { envVars, agentsPatch }: tokens go to .env,
     // URLs + session + escalation mode go to agents.json's openclaw profile.
-    const gatewayResult = await stepGateway(base, "[3/5] OpenClaw gateway");
+    const gatewayResult = await stepGateway(base, "[3/6] OpenClaw gateway");
     Object.assign(vars, gatewayResult.envVars);
     Object.assign(agentsPatch, gatewayResult.agentsPatch);
     if (gatewayResult.agentsPatch.escalationMode === "off") {
@@ -254,17 +278,23 @@ export async function runOnboard(args = {}) {
       p.log.success("Gateway configured.");
     }
 
-    const privacy = await stepPrivacy(base, "[4/5] Privacy mode");
+    const privacy = await stepPrivacy(base, "[4/6] Privacy mode");
     vars.PRIVACY_MODE = privacy;
     p.log.success(`Privacy: ${privacy}.`);
 
-    const model = await stepModel(base, "[5/5] AI model for HUD analysis");
+    const model = await stepModel(base, "[5/6] AI model for HUD analysis");
     vars.AGENT_MODEL = model;
     p.log.success(`Model: ${model}.`);
 
     // Default agent goes into agents.json `default` field (was SINAIN_AGENT
     // env var). Overlay's chip selector lets the user switch at runtime.
     agentsPatch.default = base.SINAIN_AGENT || "claude";
+
+    // Step 6: register sinain MCP with locally-installed MCP-aware agents
+    // (Claude Code, Cursor, Codex, Goose, Junie, Claude Desktop). Detection
+    // is non-destructive — if no agents are installed, the step prints a
+    // skip note and returns. Idempotent across re-runs.
+    await stepMcpInstall(base, "[6/6] Connect MCP agents");
   }
 
   // ── Common defaults ───────────────────────────────────────────────────
@@ -397,9 +427,9 @@ if (flags.nonInteractive) {
   }
 
   writeEnv(vars);
-  // Default agent + escalation off + openclaw explicitly disabled. Gateway is
-  // opt-in via the interactive wizard (`sinain onboard`) or `sinain config`.
-  writeAgentsConfig({ default: "claude", escalationMode: "off", openclawProfile: null });
+  // Default agent + openclaw explicitly disabled. No escalation mode written
+  // — lane is the source of truth, registerBareAgent reconciles at boot.
+  writeAgentsConfig({ default: "claude", openclawProfile: null });
   console.log(c.green(`  Config written to ${ENV_PATH} + ~/.sinain/agents.json`));
   process.exit(0);
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geravant/sinain",
-  "version": "1.18.2",
+  "version": "1.19.0",
   "description": "Ambient intelligence that sees what you see, hears what you hear, and acts on your behalf",
   "type": "module",
   "bin": {

package/sinain-agent/agents.example.json

@@ -64,7 +64,7 @@
   },
 
   "escalation": {
-    "mode": "off",
+    "_comment": "Lane (the agent picked for escalation in agents.json `default` or via the overlay chip) is the source of truth for whether escalation runs. `mode` is intentionally omitted here — the runtime default (rich) applies, and registerBareAgent reconciles mode with lane at boot. Override `mode` only if you want to force selective/focus/off semantics.",
     "cooldownMs": 30000,
     "staleMs": 90000
   },

package/sinain-core/src/index.ts

@@ -734,6 +734,16 @@ async function main() {
     }
     wsHandler.updateState({ agents: { ...bareAgentState } });
     log(TAG, `bareagent register: available=[${clean.join(",")}] current=${current} → lanes esc=${bareAgentState.escalationAgent} spawn=${bareAgentState.spawnAgent}`);
+
+    // Lane is the source of truth for "is escalation active?". If a lane is
+    // set but mode is still "off" (e.g. an old wizard run wrote mode=off and
+    // the user has since picked an agent in the chip selector — or we just
+    // booted from agents.json with that combination), reconcile by promoting
+    // mode to match. Mirrors the existing set_agent → resumeEscalation flow,
+    // applied at register time so the boot-from-disk case isn't an exception.
+    if (bareAgentState.escalationAgent && config.escalationConfig.mode === "off") {
+      resumeEscalationInternal();
+    }
   }
 
   // ── Create HTTP + WS server ──

package/sinain-core/src/server.ts

@@ -60,7 +60,7 @@ let allFacts = [];
 async function loadFacts() {
   document.getElementById('status').textContent = 'Loading...';
   try {
-    const res = await fetch('/knowledge/entities?max=200');
+    const res = await fetch('/knowledge/entities?max=1000');
     const data = await res.json();
     allFacts = typeof data.entities === 'string' ? JSON.parse(data.entities) : data.entities;
     const domains = [...new Set(allFacts.map(f => f.domain).filter(Boolean))].sort();
@@ -440,7 +440,7 @@ export function createAppServer(deps: ServerDeps) {
 
       if (req.method === "GET" && url.pathname === "/knowledge/entities") {
         // List all entities in the knowledge graph
-        const max = Math.min(parseInt(url.searchParams.get("max") || "50"), 200);
+        const max = Math.min(parseInt(url.searchParams.get("max") || "50"), 1000);
         if (deps.listKnowledgeEntities) {
           try {
             const entities = await deps.listKnowledgeEntities(max);