@intent-systems/nexus 2026.1.5-3 → 2026.1.5-5

package/dist/routing/resolve-route.js

@@ -0,0 +1,144 @@
+import { buildAgentMainSessionKey, buildAgentPeerSessionKey, DEFAULT_ACCOUNT_ID, DEFAULT_AGENT_ID, DEFAULT_MAIN_KEY, normalizeAgentId, } from "./session-key.js";
+export { DEFAULT_ACCOUNT_ID, DEFAULT_AGENT_ID } from "./session-key.js";
+function normalizeToken(value) {
+    return (value ?? "").trim().toLowerCase();
+}
+function normalizeId(value) {
+    return (value ?? "").trim();
+}
+function normalizeAccountId(value) {
+    const trimmed = (value ?? "").trim();
+    return trimmed ? trimmed : DEFAULT_ACCOUNT_ID;
+}
+function matchesAccountId(match, actual) {
+    const trimmed = (match ?? "").trim();
+    if (!trimmed)
+        return actual === DEFAULT_ACCOUNT_ID;
+    if (trimmed === "*")
+        return true;
+    return trimmed === actual;
+}
+export function buildAgentSessionKey(params) {
+    const provider = normalizeToken(params.provider) || "unknown";
+    const peer = params.peer;
+    return buildAgentPeerSessionKey({
+        agentId: params.agentId,
+        mainKey: DEFAULT_MAIN_KEY,
+        channel: provider,
+        peerKind: peer?.kind ?? "dm",
+        peerId: peer ? normalizeId(peer.id) || "unknown" : null,
+    });
+}
+function listBindings(cfg) {
+    const bindings = cfg.routing?.bindings;
+    return Array.isArray(bindings) ? bindings : [];
+}
+function listAgents(cfg) {
+    const agents = cfg.routing?.agents;
+    return agents && typeof agents === "object" ? agents : undefined;
+}
+function resolveDefaultAgentId(cfg) {
+    const explicit = cfg.routing?.defaultAgentId?.trim();
+    if (explicit)
+        return explicit;
+    return DEFAULT_AGENT_ID;
+}
+function pickFirstExistingAgentId(cfg, agentId) {
+    const normalized = normalizeAgentId(agentId);
+    const agents = listAgents(cfg);
+    if (!agents)
+        return normalized;
+    if (Object.hasOwn(agents, normalized))
+        return normalized;
+    return normalizeAgentId(resolveDefaultAgentId(cfg));
+}
+function matchesChannel(match, channel) {
+    const key = normalizeToken(match?.channel);
+    if (!key)
+        return false;
+    return key === channel;
+}
+function matchesPeer(match, peer) {
+    const m = match?.peer;
+    if (!m)
+        return false;
+    const kind = normalizeToken(m.kind);
+    const id = normalizeId(m.id);
+    if (!kind || !id)
+        return false;
+    return kind === peer.kind && id === peer.id;
+}
+function matchesGuild(match, guildId) {
+    const id = normalizeId(match?.guildId);
+    if (!id)
+        return false;
+    return id === guildId;
+}
+function matchesTeam(match, teamId) {
+    const id = normalizeId(match?.teamId);
+    if (!id)
+        return false;
+    return id === teamId;
+}
+export function resolveAgentRoute(input) {
+    const provider = normalizeToken(input.provider ?? input.channel);
+    const accountId = normalizeAccountId(input.accountId);
+    const peer = input.peer
+        ? { kind: input.peer.kind, id: normalizeId(input.peer.id) }
+        : null;
+    const guildId = normalizeId(input.guildId);
+    const teamId = normalizeId(input.teamId);
+    const bindings = listBindings(input.cfg).filter((binding) => {
+        if (!binding || typeof binding !== "object")
+            return false;
+        if (!matchesChannel(binding.match, provider))
+            return false;
+        return matchesAccountId(binding.match?.accountId, accountId);
+    });
+    const choose = (agentId, matchedBy) => {
+        const resolvedAgentId = pickFirstExistingAgentId(input.cfg, agentId);
+        return {
+            agentId: resolvedAgentId,
+            provider,
+            accountId,
+            sessionKey: buildAgentSessionKey({
+                agentId: resolvedAgentId,
+                provider,
+                peer,
+            }),
+            mainSessionKey: buildAgentMainSessionKey({
+                agentId: resolvedAgentId,
+                mainKey: DEFAULT_MAIN_KEY,
+            }),
+            matchedBy,
+        };
+    };
+    if (peer) {
+        const peerMatch = bindings.find((b) => matchesPeer(b.match, peer));
+        if (peerMatch)
+            return choose(peerMatch.agentId, "binding.peer");
+    }
+    if (guildId) {
+        const guildMatch = bindings.find((b) => matchesGuild(b.match, guildId));
+        if (guildMatch)
+            return choose(guildMatch.agentId, "binding.guild");
+    }
+    if (teamId) {
+        const teamMatch = bindings.find((b) => matchesTeam(b.match, teamId));
+        if (teamMatch)
+            return choose(teamMatch.agentId, "binding.team");
+    }
+    const accountMatch = bindings.find((b) => b.match?.accountId?.trim() !== "*" &&
+        !b.match?.peer &&
+        !b.match?.guildId &&
+        !b.match?.teamId);
+    if (accountMatch)
+        return choose(accountMatch.agentId, "binding.account");
+    const anyAccountMatch = bindings.find((b) => b.match?.accountId?.trim() === "*" &&
+        !b.match?.peer &&
+        !b.match?.guildId &&
+        !b.match?.teamId);
+    if (anyAccountMatch)
+        return choose(anyAccountMatch.agentId, "binding.channel");
+    return choose(resolveDefaultAgentId(input.cfg), "default");
+}

package/dist/routing/session-key.js

@@ -0,0 +1,65 @@
+export const DEFAULT_AGENT_ID = "default";
+export const DEFAULT_MAIN_KEY = "main";
+export const DEFAULT_ACCOUNT_ID = "default";
+export function normalizeAgentId(value) {
+    const trimmed = (value ?? "").trim();
+    if (!trimmed)
+        return DEFAULT_AGENT_ID;
+    // Keep it path-safe + shell-friendly.
+    if (/^[a-z0-9][a-z0-9_-]{0,63}$/i.test(trimmed))
+        return trimmed;
+    // Best-effort fallback: collapse invalid characters to "-"
+    return (trimmed
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/^-+/, "")
+        .replace(/-+$/, "")
+        .slice(0, 64) || DEFAULT_AGENT_ID);
+}
+export function parseAgentSessionKey(sessionKey) {
+    const raw = (sessionKey ?? "").trim();
+    if (!raw)
+        return null;
+    const parts = raw.split(":").filter(Boolean);
+    if (parts.length < 3)
+        return null;
+    if (parts[0] !== "agent")
+        return null;
+    const agentId = parts[1]?.trim();
+    const rest = parts.slice(2).join(":");
+    if (!agentId || !rest)
+        return null;
+    return { agentId, rest };
+}
+export function resolveAgentIdFromSessionKey(sessionKey) {
+    const parsed = parseAgentSessionKey(sessionKey);
+    return normalizeAgentId(parsed?.agentId ?? DEFAULT_AGENT_ID);
+}
+export function isSubagentSessionKey(sessionKey) {
+    const raw = (sessionKey ?? "").trim();
+    if (!raw)
+        return false;
+    if (raw.toLowerCase().startsWith("subagent:"))
+        return true;
+    const parsed = parseAgentSessionKey(raw);
+    return Boolean((parsed?.rest ?? "").toLowerCase().startsWith("subagent:"));
+}
+export function buildAgentMainSessionKey(params) {
+    const agentId = normalizeAgentId(params.agentId);
+    const mainKey = (params.mainKey ?? DEFAULT_MAIN_KEY).trim() || DEFAULT_MAIN_KEY;
+    return `agent:${agentId}:${mainKey}`;
+}
+export function buildAgentPeerSessionKey(params) {
+    const peerKind = params.peerKind ?? "dm";
+    if (peerKind === "dm") {
+        return buildAgentMainSessionKey({
+            agentId: params.agentId,
+            mainKey: params.mainKey,
+        });
+    }
+    const provider = (params.channel ?? params.provider ?? "")
+        .trim()
+        .toLowerCase() || "unknown";
+    const peerId = (params.peerId ?? "").trim() || "unknown";
+    return `agent:${normalizeAgentId(params.agentId)}:${provider}:${peerKind}:${peerId}`;
+}

package/dist/sessions/send-policy.js

@@ -10,7 +10,7 @@ function normalizeMatchValue(raw) {
     const value = raw?.trim().toLowerCase();
     return value ? value : undefined;
 }
-function deriveProviderFromKey(key) {
+function deriveChannelFromKey(key) {
     if (!key)
         return undefined;
     const parts = key.split(":").filter(Boolean);
@@ -35,10 +35,10 @@ export function resolveSendPolicy(params) {
     const policy = params.cfg.session?.sendPolicy;
     if (!policy)
         return "allow";
-    const provider = normalizeMatchValue(params.provider) ??
+    const channel = normalizeMatchValue(params.provider) ??
         normalizeMatchValue(params.entry?.provider) ??
         normalizeMatchValue(params.entry?.lastProvider) ??
-        deriveProviderFromKey(params.sessionKey);
+        deriveChannelFromKey(params.sessionKey);
     const chatType = normalizeMatchValue(params.chatType ?? params.entry?.chatType) ??
         normalizeMatchValue(deriveChatTypeFromKey(params.sessionKey));
     const sessionKey = params.sessionKey ?? "";
@@ -48,10 +48,10 @@ export function resolveSendPolicy(params) {
             continue;
         const action = normalizeSendPolicy(rule.action) ?? "allow";
         const match = rule.match ?? {};
-        const matchProvider = normalizeMatchValue(match.provider);
+        const matchChannel = normalizeMatchValue(match.channel);
         const matchChatType = normalizeMatchValue(match.chatType);
         const matchPrefix = normalizeMatchValue(match.keyPrefix);
-        if (matchProvider && matchProvider !== provider)
+        if (matchChannel && matchChannel !== channel)
             continue;
         if (matchChatType && matchChatType !== chatType)
             continue;

package/dist/slack/monitor.js

@@ -27,6 +27,9 @@ function normalizeSlackSlug(raw) {
     const cleaned = dashed.replace(/[^a-z0-9#@._+-]+/g, "-");
     return cleaned.replace(/-{2,}/g, "-").replace(/^[-.]+|[-.]+$/g, "");
 }
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function normalizeSlackSlashCommandName(raw) {
     const trimmed = raw?.trim().toLowerCase() ?? "";
     if (!trimmed)
@@ -34,6 +37,24 @@ function normalizeSlackSlashCommandName(raw) {
     const stripped = trimmed.startsWith("/") ? trimmed.slice(1) : trimmed;
     return normalizeSlackSlug(stripped);
 }
+export function buildSlackSlashCommandMatcher(rawName) {
+    const normalized = normalizeSlackSlashCommandName(rawName);
+    const name = normalized || "nexus";
+    return new RegExp(`^/?${escapeRegExp(name)}$`, "i");
+}
+export function resolveSlackThreadTs(params) {
+    if (params.incomingThreadTs)
+        return params.incomingThreadTs;
+    if (params.replyToMode === "off")
+        return undefined;
+    if (!params.messageTs)
+        return undefined;
+    if (params.replyToMode === "all")
+        return params.messageTs;
+    if (!params.hasReplied)
+        return params.messageTs;
+    return undefined;
+}
 function normalizeAllowList(list) {
     return (list ?? []).map((entry) => String(entry).trim()).filter(Boolean);
 }
@@ -62,7 +83,7 @@ function allowListMatches(params) {
 function resolveSlackSlashCommandConfig(raw) {
     const rawName = raw?.name?.trim() || "nexus";
     const normalizedName = normalizeSlackSlashCommandName(rawName);
-    const name = normalizedName || "nexus";
+    const _name = normalizedName || "nexus";
     return {
         enabled: raw?.enabled === true,
         name: raw?.name?.trim() || "clawd",

package/dist/telegram/reaction-level.js

@@ -5,7 +5,8 @@ export function resolveTelegramReactionLevel(params) {
     const channelConfig = "channels" in params.cfg
         ? params.cfg.channels?.telegram
         : undefined;
-    const telegramCfg = channelConfig ?? params.cfg.telegram;
+    const telegramCfg = channelConfig ??
+        params.cfg.telegram;
     const level = (telegramCfg?.reactionLevel ?? "ack");
     switch (level) {
         case "off":

package/dist/utils/provider-utils.js

@@ -0,0 +1,28 @@
+/**
+ * Utility functions for provider-specific logic and capabilities.
+ */
+/**
+ * Returns true if the provider requires reasoning to be wrapped in tags
+ * (e.g. <think> and <final>) in the text stream, rather than using native
+ * API fields for reasoning/thinking.
+ */
+export function isReasoningTagProvider(provider) {
+    if (!provider)
+        return false;
+    const normalized = provider.trim().toLowerCase();
+    // Check for exact matches or known prefixes/substrings for reasoning providers
+    if (normalized === "ollama" ||
+        normalized === "google-gemini-cli" ||
+        normalized === "google-generative-ai") {
+        return true;
+    }
+    // Handle google-antigravity and its model variations (e.g. google-antigravity/gemini-3)
+    if (normalized.includes("google-antigravity")) {
+        return true;
+    }
+    // Handle Minimax (M2.1 is chatty/reasoning-like)
+    if (normalized.includes("minimax")) {
+        return true;
+    }
+    return false;
+}

package/dist/utils.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { resolveStateDir } from "./config/paths.js";
 import { logVerbose, shouldLogVerbose } from "./globals.js";
 export async function ensureDir(dir) {
     await fs.promises.mkdir(dir, { recursive: true });
@@ -147,7 +148,7 @@ export function resolveNexusRoot(env = process.env, homedir = os.homedir) {
         return resolveUserPath(override);
     return path.join(homedir(), "nexus");
 }
-// Nexus root directory containing home/, skills/, state/
+// Nexus root directory containing home/ and state/
 export const NEXUS_ROOT = resolveNexusRoot();
-// Managed skills directory (for NexusHub installs, etc.)
-export const MANAGED_SKILLS_DIR = path.join(NEXUS_ROOT, "skills");
+// Managed skills directory lives under state/
+export const MANAGED_SKILLS_DIR = path.join(resolveStateDir(), "skills");

package/dist/wizard/onboarding.js

@@ -10,12 +10,12 @@ import { applyAuthChoice } from "../commands/auth-choice.js";
 import { buildAuthChoiceOptions } from "../commands/auth-choice-options.js";
 import { healthCommand } from "../commands/health.js";
 import { applyAuthProfileConfig, applyMinimaxConfig, setAnthropicApiKey, writeOAuthCredentials, } from "../commands/onboard-auth.js";
-import { applyWizardMetadata, DEFAULT_WORKSPACE, detectBrowserOpenSupport, ensureWorkspaceAndSessions, formatControlUiSshHint, handleReset, openUrl, printWizardHeader, probeGatewayReachable, randomToken, resolveControlUiLinks, summarizeExistingConfig, } from "../commands/onboard-helpers.js";
+import { maybeSetupIdentityFromEve } from "../commands/onboard-eve-identity.js";
 import { setupGitHubSync } from "../commands/onboard-github.js";
+import { applyWizardMetadata, DEFAULT_WORKSPACE, detectBrowserOpenSupport, ensureWorkspaceAndSessions, formatControlUiSshHint, handleReset, openUrl, printWizardHeader, probeGatewayReachable, randomToken, resolveControlUiLinks, summarizeExistingConfig, } from "../commands/onboard-helpers.js";
 import { setupProviders } from "../commands/onboard-providers.js";
 import { promptRemoteGatewayConfig } from "../commands/onboard-remote.js";
 import { setupSkills } from "../commands/onboard-skills.js";
-import { maybeSetupIdentityFromEve } from "../commands/onboard-eve-identity.js";
 import { applyOpenAICodexModelDefault, OPENAI_CODEX_DEFAULT_MODEL, } from "../commands/openai-codex-model-default.js";
 import { ensureSystemdUserLingerInteractive } from "../commands/systemd-linger.js";
 import { CONFIG_PATH_NEXUS, readConfigFileSnapshot, resolveGatewayPort, writeConfigFile, } from "../config/config.js";
@@ -24,6 +24,7 @@ import { resolveGatewayProgramArguments } from "../daemon/program-args.js";
 import { resolveGatewayService } from "../daemon/service.js";
 import { ensureControlUiAssetsBuilt } from "../infra/control-ui-assets.js";
 import { defaultRuntime } from "../runtime.js";
+import { runTui } from "../tui/tui.js";
 import { resolveUserPath, sleep } from "../utils.js";
 async function warnIfModelConfigLooksOff(config, prompter) {
     const ref = resolveConfiguredModelRef({
@@ -61,6 +62,17 @@ export async function runOnboardingWizard(opts, runtime = defaultRuntime, prompt
     await prompter.intro("Nexus onboarding");
     const snapshot = await readConfigFileSnapshot();
     let baseConfig = snapshot.valid ? snapshot.config : {};
+    if (snapshot.exists && !snapshot.valid) {
+        await prompter.note(summarizeExistingConfig(baseConfig), "Invalid config");
+        if (snapshot.issues.length > 0) {
+            await prompter.note(snapshot.issues
+                .map((iss) => `- ${iss.path}: ${iss.message}`)
+                .join("\n"), "Config issues");
+        }
+        await prompter.outro("Fix config issues and rerun onboarding.");
+        runtime.exit(1);
+        return;
+    }
     if (snapshot.exists) {
         const title = snapshot.valid
             ? "Existing config detected"
@@ -104,15 +116,16 @@ export async function runOnboardingWizard(opts, runtime = defaultRuntime, prompt
     }
     const localPort = resolveGatewayPort(baseConfig);
     const localUrl = `ws://127.0.0.1:${localPort}`;
-    const localToken = process.env.NEXUS_GATEWAY_TOKEN ?? process.env.NEXUS_GATEWAY_TOKEN;
+    const _localToken = process.env.NEXUS_GATEWAY_TOKEN ?? process.env.NEXUS_GATEWAY_TOKEN;
     const configPassword = baseConfig.gateway?.auth?.password;
     const envPassword = process.env.NEXUS_GATEWAY_PASSWORD ?? process.env.NEXUS_GATEWAY_PASSWORD;
-    const primaryPassword = configPassword ?? envPassword;
-    let localProbe = await probeGatewayReachable({
+    const _primaryPassword = configPassword ?? envPassword;
+    const localProbe = await probeGatewayReachable({
         url: localUrl,
         token: process.env.NEXUS_GATEWAY_TOKEN ?? process.env.CLAWDBOT_GATEWAY_TOKEN,
         password: baseConfig.gateway?.auth?.password ??
-            process.env.NEXUS_GATEWAY_PASSWORD ?? process.env.CLAWDBOT_GATEWAY_PASSWORD,
+            process.env.NEXUS_GATEWAY_PASSWORD ??
+            process.env.CLAWDBOT_GATEWAY_PASSWORD,
     });
     const remoteUrl = baseConfig.gateway?.remote?.url?.trim() ?? "";
     const remoteProbe = remoteUrl
@@ -534,7 +547,9 @@ export async function runOnboardingWizard(opts, runtime = defaultRuntime, prompt
             const environment = {
                 PATH: process.env.PATH,
                 NEXUS_GATEWAY_TOKEN: gatewayToken,
-                NEXUS_LAUNCHD_LABEL: process.platform === "darwin" ? GATEWAY_LAUNCH_AGENT_LABEL : undefined,
+                NEXUS_LAUNCHD_LABEL: process.platform === "darwin"
+                    ? GATEWAY_LAUNCH_AGENT_LABEL
+                    : undefined,
             };
             await service.install({
                 env: process.env,
@@ -616,5 +631,12 @@ export async function runOnboardingWizard(opts, runtime = defaultRuntime, prompt
     await maybeSetupIdentityFromEve({ workspaceDir, prompter, runtime });
     // Set up GitHub sync for workspace portability
     await setupGitHubSync(workspaceDir, prompter, runtime);
+    const hatch = await prompter.confirm({
+        message: "Do you want to hatch your bot now?",
+        initialValue: false,
+    });
+    if (hatch) {
+        await runTui({ deliver: false, message: "Wake up, my friend!" });
+    }
     await prompter.outro("Onboarding complete.");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intent-systems/nexus",
-  "version": "2026.1.5-3",
+  "version": "2026.1.5-5",
   "description": "WhatsApp gateway CLI (Baileys web) with Pi RPC agent",
   "homepage": "https://github.com/Napageneral/nexus",
   "repository": {
@@ -13,36 +13,11 @@
     "nexus": "dist/entry.js"
   },
   "files": [
-    "dist/agents/**",
-    "dist/auto-reply/**",
-    "dist/browser/**",
-    "dist/canvas-host/**",
-    "dist/cli/**",
-    "dist/commands/**",
-    "dist/config/**",
-    "dist/control-ui/**",
-    "dist/cron/**",
-    "dist/daemon/**",
-    "dist/discord/**",
-    "dist/gateway/**",
-    "dist/hooks/**",
-    "dist/imessage/**",
-    "dist/infra/**",
-    "dist/macos/**",
-    "dist/media/**",
-    "dist/process/**",
-    "dist/sessions/**",
-    "dist/providers/**",
-    "dist/signal/**",
-    "dist/slack/**",
-    "dist/telegram/**",
-    "dist/tui/**",
-    "dist/web/**",
-    "dist/wizard/**",
-    "dist/*.js",
-    "dist/*.json",
+    "dist/**",
     "docs/**",
     "skills/**",
+    "patches/**",
+    "scripts/postinstall.js",
     "README.md",
     "README-header.png",
     "CHANGELOG.md",