@essentialai/cogent-plugin 3.13.0 → 3.14.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cogent",
-  "version": "3.13.0",
+  "version": "3.14.1",
   "description": "Inter-session communication bridge for Claude Code with Slack integration. Enables CC agents and Slack team members to communicate in real time.",
   "author": {
     "name": "Essential AI Solutions",

package/bridge/cogent-bridge.mjs

@@ -152,31 +152,33 @@ var init_detect = __esm({
 });
 
 // src/wizard/templates.ts
-function mcpJsonContent(npxPath) {
+function cogentEnv(mode) {
+  const env = {
+    COGENT_LOG_LEVEL: "info",
+    COGENT_TIMEOUT_MS: "300000"
+  };
+  if (mode === "local") env.COGENT_LOCAL = "1";
+  return env;
+}
+function mcpJsonContent(npxPath, mode = "cloud") {
   const config2 = {
     mcpServers: {
       "cogent": {
         command: npxPath,
         args: ["-y", "@essentialai/cogent-bridge"],
-        env: {
-          COGENT_LOG_LEVEL: "info",
-          COGENT_TIMEOUT_MS: "300000"
-        }
+        env: cogentEnv(mode)
       }
     }
   };
   return JSON.stringify(config2, null, 2) + "\n";
 }
-function mcpJsonMerge(existing, npxPath) {
+function mcpJsonMerge(existing, npxPath, mode = "cloud") {
   const parsed = JSON.parse(existing);
   if (!parsed.mcpServers) parsed.mcpServers = {};
   parsed.mcpServers["cogent"] = {
     command: npxPath,
     args: ["-y", "@essentialai/cogent-bridge"],
-    env: {
-      COGENT_LOG_LEVEL: "info",
-      COGENT_TIMEOUT_MS: "300000"
-    }
+    env: cogentEnv(mode)
   };
   return JSON.stringify(parsed, null, 2) + "\n";
 }
@@ -380,14 +382,14 @@ var init_scaffold_demo = __esm({
 // src/wizard/scaffold-real.ts
 import fs2 from "node:fs";
 import path2 from "node:path";
-function writeMcpJson(projectPath, npxPath) {
+function writeMcpJson(projectPath, npxPath, mode) {
   const filePath = path2.join(projectPath, ".mcp.json");
   if (fs2.existsSync(filePath)) {
     const existing = fs2.readFileSync(filePath, "utf-8");
-    fs2.writeFileSync(filePath, mcpJsonMerge(existing, npxPath), "utf-8");
+    fs2.writeFileSync(filePath, mcpJsonMerge(existing, npxPath, mode), "utf-8");
     return "modified";
   }
-  fs2.writeFileSync(filePath, mcpJsonContent(npxPath), "utf-8");
+  fs2.writeFileSync(filePath, mcpJsonContent(npxPath, mode), "utf-8");
   return "created";
 }
 function writeClaudeMd(projectPath, peerId, label, otherPeerId) {
@@ -408,7 +410,8 @@ function scaffoldReal(config2) {
   const created = [];
   const modified = [];
   const skipped = [];
-  const mcpA = writeMcpJson(config2.projectAPath, config2.npxPath);
+  const mode = config2.mode ?? "cloud";
+  const mcpA = writeMcpJson(config2.projectAPath, config2.npxPath, mode);
   const mcpAPath = path2.join(config2.projectAPath, ".mcp.json");
   if (mcpA === "created") created.push(mcpAPath);
   else modified.push(mcpAPath);
@@ -422,7 +425,7 @@ function scaffoldReal(config2) {
   if (claudeA === "created") created.push(claudeAPath);
   else if (claudeA === "modified") modified.push(claudeAPath);
   else skipped.push(claudeAPath);
-  const mcpB = writeMcpJson(config2.projectBPath, config2.npxPath);
+  const mcpB = writeMcpJson(config2.projectBPath, config2.npxPath, mode);
   const mcpBPath = path2.join(config2.projectBPath, ".mcp.json");
   if (mcpB === "created") created.push(mcpBPath);
   else modified.push(mcpBPath);
@@ -565,6 +568,11 @@ async function runWizard() {
       const idB = await ask(rl, "Peer ID for Project B:", defaultIdB);
       const defaultLabelB = "CC_" + path3.basename(pathB).replace(/[^a-zA-Z0-9]/g, "_");
       const labelB = await ask(rl, "Label for Project B:", defaultLabelB);
+      const modeIdx = await choose(rl, "How should these agents connect?", [
+        "Cloud \u2014 collaborate with remote agents over cogent.tools (recommended)",
+        "Local \u2014 offline, this machine only (self-hosted / local-LLM / air-gapped)"
+      ]);
+      const mode2 = modeIdx === 1 ? "local" : "cloud";
       heading("Configuring projects");
       const result = scaffoldReal({
         projectAPath: path3.resolve(pathA),
@@ -573,7 +581,8 @@ async function runWizard() {
         projectBPath: path3.resolve(pathB),
         projectBId: idB,
         projectBLabel: labelB,
-        npxPath
+        npxPath,
+        mode: mode2
       });
       printRealNextSteps(path3.resolve(pathA), idA, labelA, path3.resolve(pathB), idB, labelB, result);
     }
@@ -26380,8 +26389,8 @@ var init_stdio2 = __esm({
 // src/constants.ts
 import { createRequire } from "node:module";
 function resolveVersion() {
-  if ("3.13.0") {
-    return "3.13.0";
+  if ("3.14.1") {
+    return "3.14.1";
   }
   try {
     const require2 = createRequire(import.meta.url);
@@ -26528,6 +26537,12 @@ var init_npm_update_check = __esm({
 // src/config.ts
 import os3 from "node:os";
 import path6 from "node:path";
+function isLocalOptOut(value) {
+  if (value === void 0) return false;
+  return ["1", "true", "yes", "on", "enable", "enabled"].includes(
+    value.trim().toLowerCase()
+  );
+}
 function loadConfig(env = process.env) {
   const result = configSchema.safeParse(env);
   if (!result.success) {
@@ -26535,22 +26550,40 @@ function loadConfig(env = process.env) {
     throw new Error(`Invalid configuration:
 ${issues}`);
   }
-  _config = Object.freeze(result.data);
+  const data = { ...result.data };
+  if (isLocalOptOut(data.COGENT_LOCAL)) {
+    data.COGENT_ENDPOINT = void 0;
+  } else if (!data.COGENT_ENDPOINT) {
+    data.COGENT_ENDPOINT = DEFAULT_FREE_ENDPOINT;
+  }
+  _config = Object.freeze(data);
   return _config;
 }
 function getConfig() {
   if (!_config) throw new Error("Config not loaded. Call loadConfig() first.");
   return _config;
 }
-var import_zod2, defaultStatePath, configSchema, _config;
+var import_zod2, defaultStatePath, DEFAULT_FREE_ENDPOINT, configSchema, _config;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
     import_zod2 = __toESM(require_zod(), 1);
     defaultStatePath = path6.join(os3.homedir(), ".cogent");
+    DEFAULT_FREE_ENDPOINT = "https://cogent.tools";
     configSchema = import_zod2.z.object({
       COGENT_STATE_PATH: import_zod2.z.string().default(defaultStatePath),
+      // Relay URL for free (password) channels. **Zero-config default = the hosted FREE
+      // relay (cogent.tools)** — see the loadConfig() resolution below. A hand-rolled MCP
+      // config that OMITTED this used to silently run LOCAL and never reach any cloud
+      // channel (the marvin-coder confusion, 2026-08-06); defaulting it makes "cloud" the
+      // out-of-the-box mode. Opt OUT to local/offline mode with COGENT_LOCAL. An explicit
+      // value (a free self-host URL, or the Team URL for a custom Team agent) always wins.
       COGENT_ENDPOINT: import_zod2.z.string().optional(),
+      // **Local mode opt-out.** Set truthy (1/true/yes/on) to force LOCAL file-based state
+      // even when COGENT_ENDPOINT would otherwise default to the free relay. This is the
+      // switch for offline use, air-gapped/self-contained agents, and (upcoming) local-LLM
+      // operation where no cloud relay is wanted. When set, it wins over any COGENT_ENDPOINT.
+      COGENT_LOCAL: import_zod2.z.string().optional(),
       // Team (business) relay. cogent_join_session auto-routes here when an Org_ID is
       // supplied (free joins use COGENT_ENDPOINT). Default = the hosted Team relay; a
       // self-hosted Team deployment overrides it. No runtime flipping — the presence of
@@ -34372,9 +34405,9 @@ var init_peer = __esm({
       label: import_zod5.z.string().describe("Human-readable label"),
       registeredAt: import_zod5.z.string().datetime().describe("ISO 8601 registration timestamp"),
       lastSeenAt: import_zod5.z.string().datetime().describe("ISO 8601 last activity timestamp"),
-      platform: import_zod5.z.enum(["cc", "codex", "slack", "gchat", "web", "gemini", "whatsapp"]).optional().describe("Platform this peer belongs to"),
+      platform: import_zod5.z.enum(["cc", "codex", "slack", "gchat", "web", "gemini", "whatsapp", "telegram", "discord"]).optional().describe("Platform this peer belongs to"),
       type: import_zod5.z.enum(["agent", "human"]).optional().describe("Peer type: AI agent or human user"),
-      transport: import_zod5.z.enum(["ws", "slack-bot", "gchat-bot", "websocket", "whatsapp-cloud"]).optional().describe("Transport mechanism for this peer"),
+      transport: import_zod5.z.enum(["ws", "slack-bot", "gchat-bot", "websocket", "whatsapp-cloud", "telegram-bot", "discord-bot"]).optional().describe("Transport mechanism for this peer"),
       platformIdentity: import_zod5.z.record(import_zod5.z.string(), import_zod5.z.string()).optional().describe("Platform-specific identity fields (slackUserId, slackChannelId, etc.)"),
       workspaceId: import_zod5.z.string().optional().describe("Durable workspace identifier (Slice 5) \u2014 stable id not tied to the mutable cwd hint"),
       threadId: import_zod5.z.string().optional().describe("Durable thread/conversation identifier (Slice 5)"),
@@ -34400,7 +34433,7 @@ var init_message = __esm({
       durationMs: import_zod6.z.number().nullable().describe("Round-trip duration in ms"),
       success: import_zod6.z.boolean().describe("Whether delivery succeeded"),
       error: import_zod6.z.string().nullable().describe("Error message if delivery failed"),
-      originPlatform: import_zod6.z.enum(["cc", "codex", "slack", "gchat", "web", "gemini", "whatsapp"]).optional().describe("Platform that originated this message")
+      originPlatform: import_zod6.z.enum(["cc", "codex", "slack", "gchat", "web", "gemini", "whatsapp", "telegram", "discord"]).optional().describe("Platform that originated this message")
     });
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@essentialai/cogent-plugin",
-  "version": "3.13.0",
+  "version": "3.14.1",
   "description": "Cogent — Claude Code plugin (skills + slash-commands + MCP server) for the cross-agent comms fabric.",
   "author": { "name": "Essential AI Solutions Ltd.", "url": "https://essentialai.uk" },
   "homepage": "https://cogent.tools",