multicorn-shield 1.9.3 → 1.9.5

package/CHANGELOG.md

@@ -9,6 +9,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Bump `version` in `package.json` before publishing to npm.
 
+## [1.9.5] - 2026-05-13
+
+### Fixed
+
+- CLI "Try it" prompt now suggests a real tool call instead of metadata discovery
+- Duplicate "Add a new agent alongside these" menu option removed
+
+### Changed
+
+- CLI "Try it" prompt matches dashboard example: "Use the {agent} MCP server to list my GitHub repositories"
+
+## [1.9.4] - 2026-05-13
+
+### Fixed
+
+- Double "Bearer" prefix in Codex CLI hosted proxy TOML snippet (was outputting `Bearer Bearer mcs_...`)
+- Codex CLI hosted proxy now auto-writes MCP server config to `~/.codex/config.toml` instead of asking users to paste manually
+- PreToolUse hook now prints the consent/approval URL to stderr so users know where to approve
+
+### Changed
+
+- Codex CLI hosted proxy next-steps updated: "Restart Codex CLI to load the new MCP server config"
+- Added copy-pasteable "Try it out" prompt to Codex CLI hosted proxy next-steps
+
 ## [1.9.3] - 2026-05-13
 
 ### Fixed

package/dist/multicorn-proxy.js

@@ -947,6 +947,68 @@ function getCodexCliHooksInstallDir() {
 function getCodexConfigTomlPath() {
   return join(homedir(), ".codex", "config.toml");
 }
+function escapeTomlDoubleQuotedScalar(value) {
+  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function stripCodexMcpServerTomlBlocks(content, serverKey) {
+  const lines = content.split(/\r?\n/);
+  const mainHeader = `[mcp_servers.${serverKey}]`;
+  const headersHeader = `[mcp_servers.${serverKey}.http_headers]`;
+  const out = [];
+  let state = "idle";
+  for (const line of lines) {
+    const t = line.trim();
+    if (state === "idle") {
+      if (t === mainHeader || t === headersHeader) {
+        state = t === headersHeader ? "skip_headers" : "skip_main";
+        continue;
+      }
+      out.push(line);
+    } else if (state === "skip_main") {
+      if (t.startsWith("[") && t.endsWith("]")) {
+        if (t === headersHeader) {
+          state = "skip_headers";
+        } else {
+          state = "idle";
+          out.push(line);
+        }
+      }
+    } else {
+      if (t.startsWith("[") && t.endsWith("]")) {
+        state = "idle";
+        out.push(line);
+      }
+    }
+  }
+  return out.join("\n").trimEnd();
+}
+async function mergeCodexHostedMcpIntoToml(shortName, proxyUrl, apiKey) {
+  const configPath = getCodexConfigTomlPath();
+  let existing = "";
+  try {
+    existing = await readFile(configPath, "utf8");
+  } catch (err) {
+    if (!(isErrnoException(err) && err.code === "ENOENT")) {
+      const detail = err instanceof Error ? err.message : String(err);
+      throw new Error(`Could not read Codex CLI config at ${configPath}: ${detail}`);
+    }
+  }
+  const stripped = stripCodexMcpServerTomlBlocks(existing, shortName);
+  const urlEsc = escapeTomlDoubleQuotedScalar(proxyUrl);
+  const tokenEsc = escapeTomlDoubleQuotedScalar(apiKey);
+  const block = `[mcp_servers.${shortName}]
+url = "${urlEsc}"
+
+[mcp_servers.${shortName}.http_headers]
+Authorization = "Bearer ${tokenEsc}"
+`;
+  const trimmedBase = stripped.trimEnd();
+  const full = (trimmedBase.length > 0 ? `${trimmedBase}
+
+` : "") + block;
+  await mkdir(dirname(configPath), { recursive: true });
+  await writeFile(configPath, full, SECRET_JSON_FILE_OPTIONS);
+}
 function getCodexHooksJsonPath() {
   return join(homedir(), ".codex", "hooks.json");
 }
@@ -2153,7 +2215,20 @@ async function applyHostedProxyMcpConfig(platform, proxyUrl, shortName, apiKey,
         printHostedProxyJsonParseWarning(join(workspacePath, "opencode.json"));
       }
     } else if (platform === "codex-cli") {
-      printPlatformSnippet(platform, proxyUrl, shortName, apiKey);
+      let codexTomlWritten = false;
+      try {
+        await mergeCodexHostedMcpIntoToml(shortName, proxyUrlWithKeyWhenNeeded, apiKey);
+        codexTomlWritten = true;
+        process.stderr.write(
+          style.green("\u2713 ") + "MCP server config written to " + style.cyan(getCodexConfigTomlPath()) + "\n"
+        );
+      } catch (err) {
+        process.stderr.write(
+          `${style.yellow("!")} Could not auto-write config: ${err instanceof Error ? err.message : String(err)}
+`
+        );
+      }
+      printPlatformSnippet(platform, proxyUrl, shortName, apiKey, codexTomlWritten);
       return;
     } else if (platform === "continue-dev") {
       result = await mergeContinueHostedMcp(
@@ -2279,7 +2354,7 @@ async function mergeGooseConfig(shortName, proxyUrl, apiKey) {
   writeMcpAddedLine(shortName, filePath);
   return "ok";
 }
-function printPlatformSnippet(platform, routingToken, shortName, apiKey) {
+function printPlatformSnippet(platform, routingToken, shortName, apiKey, codexCliTomlWritten) {
   const hostedInlinePlatforms = /* @__PURE__ */ new Set([
     "cursor",
     "claude-desktop",
@@ -2393,11 +2468,12 @@ mcpServers:
       2
     );
   } else if (platform === "codex-cli") {
+    const bearerToken = authHeader.startsWith("Bearer ") ? authHeader.slice("Bearer ".length) : authHeader;
     snippetText = `[mcp_servers.${shortName}]
 url = "${urlInSnippet}"
 
 [mcp_servers.${shortName}.http_headers]
-Authorization = "Bearer ${authHeader}"
+Authorization = "Bearer ${bearerToken}"
 `;
   } else {
     const urlKey = platform === "windsurf" ? "serverUrl" : "url";
@@ -2443,11 +2519,15 @@ Authorization = "Bearer ${authHeader}"
       ) + "\n\n"
     );
   } else if (platform === "codex-cli") {
-    process.stderr.write(
-      "\n" + style.dim(
-        "Add this to ~/.codex/config.toml (create the file if it does not exist). Restart Codex CLI after saving."
-      ) + "\n\n"
-    );
+    if (codexCliTomlWritten === true) {
+      process.stderr.write("\n" + style.dim("Added to ~/.codex/config.toml:") + "\n\n");
+    } else {
+      process.stderr.write(
+        "\n" + style.dim(
+          "Add this to ~/.codex/config.toml (create the file if it does not exist). Restart Codex CLI after saving."
+        ) + "\n\n"
+      );
+    }
   } else if (platform === "github-copilot") {
     process.stderr.write(
       "\n" + style.dim(
@@ -2723,15 +2803,7 @@ You have ${String(agentsForPlatform.length)} agent(s) connected for ${selectedLa
 `);
       }
       process.stderr.write("\n" + style.bold("What would you like to do?") + "\n");
-      const actionIdx = await arrowSelect(
-        [
-          "Add a new agent alongside these",
-          "Replace an existing agent",
-          "Skip - choose a different platform"
-        ],
-        ask,
-        "Action"
-      );
+      const actionIdx = await arrowSelect(INIT_EXISTING_AGENTS_PLATFORM_ACTIONS, ask, "Action");
       if (actionIdx === 2) {
         continue;
       }
@@ -3241,11 +3313,6 @@ You have ${String(agentsForPlatform.length)} agent(s) connected for ${selectedLa
             apiKey,
             initWorkspacePath
           );
-          process.stderr.write(
-            "\n" + style.dim(
-              "Add the TOML snippet above to ~/.codex/config.toml. Restart Codex CLI after saving."
-            ) + "\n"
-          );
           configuredAgents.push({
             selection,
             platform: selectedPlatform,
@@ -3582,8 +3649,9 @@ You have ${String(agentsForPlatform.length)} agent(s) connected for ${selectedLa
       );
     }
     if (codexHostedConfigured) {
+      const codexLabel = mcpPromptLabel2("codex-cli");
       blocks.push(
-        "\n" + style.bold("Codex CLI (hosted)") + "\n  \u2192 Restart Codex CLI after saving config.toml\n  \u2192 Verify it's connected: run /mcp in Codex CLI to see your active MCP servers\n  \u2192 Try it: make a request that uses an MCP tool through Shield\n"
+        "\n" + style.bold("Codex CLI (hosted)") + "\n  \u2192 Restart Codex CLI to load the new MCP server config\n  \u2192 Verify it's connected: run /mcp in Codex CLI to see your active MCP servers\n  \u2192 Try it - paste this into Codex:\n    Use the " + codexLabel + " MCP server to list my GitHub repositories\n"
       );
     }
     if (configuredPlatforms.has("other-mcp")) {
@@ -3605,7 +3673,7 @@ You have ${String(agentsForPlatform.length)} agent(s) connected for ${selectedLa
   }
   return lastConfig;
 }
-var SECRET_JSON_FILE_OPTIONS, style, BANNER, NativePluginPrerequisiteMissingError, CONFIG_DIR, CONFIG_PATH, OPENCLAW_CONFIG_PATH, ANSI_PATTERN, UPSTREAM_AUTH_KNOWN_SCHEME_WITH_PAYLOAD, OPENCLAW_MIN_VERSION, INIT_WIZARD_PLATFORM_REGISTRY, INIT_WIZARD_MENU_SECTIONS, INIT_WIZARD_SELECTION_MAX, PLATFORM_BY_SELECTION, HOSTED_PROXY_PLATFORMS_WITH_URL_KEY, OPENCODE_CONFIG_SCHEMA_URL, DEFAULT_SHIELD_API_BASE_URL;
+var SECRET_JSON_FILE_OPTIONS, style, BANNER, NativePluginPrerequisiteMissingError, CONFIG_DIR, CONFIG_PATH, OPENCLAW_CONFIG_PATH, ANSI_PATTERN, UPSTREAM_AUTH_KNOWN_SCHEME_WITH_PAYLOAD, OPENCLAW_MIN_VERSION, INIT_WIZARD_PLATFORM_REGISTRY, INIT_WIZARD_MENU_SECTIONS, INIT_WIZARD_SELECTION_MAX, INIT_EXISTING_AGENTS_PLATFORM_ACTIONS, PLATFORM_BY_SELECTION, HOSTED_PROXY_PLATFORMS_WITH_URL_KEY, OPENCODE_CONFIG_SCHEMA_URL, DEFAULT_SHIELD_API_BASE_URL;
 var init_config = __esm({
   "src/proxy/config.ts"() {
     init_consent();
@@ -3706,6 +3774,11 @@ var init_config = __esm({
       ];
     })();
     INIT_WIZARD_SELECTION_MAX = INIT_WIZARD_PLATFORM_REGISTRY.length;
+    INIT_EXISTING_AGENTS_PLATFORM_ACTIONS = [
+      "Add a new agent alongside these",
+      "Replace an existing agent",
+      "Skip - choose a different platform"
+    ];
     PLATFORM_BY_SELECTION = Object.fromEntries(
       INIT_WIZARD_PLATFORM_REGISTRY.map((e, i) => [i + 1, e.slug])
     );
@@ -4662,7 +4735,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "multicorn-shield",
-      version: "1.9.3",
+      version: "1.9.5",
       description: "The control layer for AI agents: permissions, consent, spending limits, and audit logging.",
       license: "MIT",
       author: "Multicorn AI Pty Ltd",

package/dist/multicorn-shield.js

@@ -961,6 +961,68 @@ function getCodexCliHooksInstallDir() {
 function getCodexConfigTomlPath() {
   return join(homedir(), ".codex", "config.toml");
 }
+function escapeTomlDoubleQuotedScalar(value) {
+  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function stripCodexMcpServerTomlBlocks(content, serverKey) {
+  const lines = content.split(/\r?\n/);
+  const mainHeader = `[mcp_servers.${serverKey}]`;
+  const headersHeader = `[mcp_servers.${serverKey}.http_headers]`;
+  const out = [];
+  let state = "idle";
+  for (const line of lines) {
+    const t = line.trim();
+    if (state === "idle") {
+      if (t === mainHeader || t === headersHeader) {
+        state = t === headersHeader ? "skip_headers" : "skip_main";
+        continue;
+      }
+      out.push(line);
+    } else if (state === "skip_main") {
+      if (t.startsWith("[") && t.endsWith("]")) {
+        if (t === headersHeader) {
+          state = "skip_headers";
+        } else {
+          state = "idle";
+          out.push(line);
+        }
+      }
+    } else {
+      if (t.startsWith("[") && t.endsWith("]")) {
+        state = "idle";
+        out.push(line);
+      }
+    }
+  }
+  return out.join("\n").trimEnd();
+}
+async function mergeCodexHostedMcpIntoToml(shortName, proxyUrl, apiKey) {
+  const configPath = getCodexConfigTomlPath();
+  let existing = "";
+  try {
+    existing = await readFile(configPath, "utf8");
+  } catch (err) {
+    if (!(isErrnoException(err) && err.code === "ENOENT")) {
+      const detail = err instanceof Error ? err.message : String(err);
+      throw new Error(`Could not read Codex CLI config at ${configPath}: ${detail}`);
+    }
+  }
+  const stripped = stripCodexMcpServerTomlBlocks(existing, shortName);
+  const urlEsc = escapeTomlDoubleQuotedScalar(proxyUrl);
+  const tokenEsc = escapeTomlDoubleQuotedScalar(apiKey);
+  const block = `[mcp_servers.${shortName}]
+url = "${urlEsc}"
+
+[mcp_servers.${shortName}.http_headers]
+Authorization = "Bearer ${tokenEsc}"
+`;
+  const trimmedBase = stripped.trimEnd();
+  const full = (trimmedBase.length > 0 ? `${trimmedBase}
+
+` : "") + block;
+  await mkdir(dirname(configPath), { recursive: true });
+  await writeFile(configPath, full, SECRET_JSON_FILE_OPTIONS);
+}
 function getCodexHooksJsonPath() {
   return join(homedir(), ".codex", "hooks.json");
 }
@@ -1554,6 +1616,11 @@ var INIT_WIZARD_MENU_SECTIONS = (() => {
   ];
 })();
 var INIT_WIZARD_SELECTION_MAX = INIT_WIZARD_PLATFORM_REGISTRY.length;
+var INIT_EXISTING_AGENTS_PLATFORM_ACTIONS = [
+  "Add a new agent alongside these",
+  "Replace an existing agent",
+  "Skip - choose a different platform"
+];
 var PLATFORM_BY_SELECTION = Object.fromEntries(
   INIT_WIZARD_PLATFORM_REGISTRY.map((e, i) => [i + 1, e.slug])
 );
@@ -2246,7 +2313,20 @@ async function applyHostedProxyMcpConfig(platform, proxyUrl, shortName, apiKey,
         printHostedProxyJsonParseWarning(join(workspacePath, "opencode.json"));
       }
     } else if (platform === "codex-cli") {
-      printPlatformSnippet(platform, proxyUrl, shortName, apiKey);
+      let codexTomlWritten = false;
+      try {
+        await mergeCodexHostedMcpIntoToml(shortName, proxyUrlWithKeyWhenNeeded, apiKey);
+        codexTomlWritten = true;
+        process.stderr.write(
+          style.green("\u2713 ") + "MCP server config written to " + style.cyan(getCodexConfigTomlPath()) + "\n"
+        );
+      } catch (err) {
+        process.stderr.write(
+          `${style.yellow("!")} Could not auto-write config: ${err instanceof Error ? err.message : String(err)}
+`
+        );
+      }
+      printPlatformSnippet(platform, proxyUrl, shortName, apiKey, codexTomlWritten);
       return;
     } else if (platform === "continue-dev") {
       result = await mergeContinueHostedMcp(
@@ -2372,7 +2452,7 @@ async function mergeGooseConfig(shortName, proxyUrl, apiKey) {
   writeMcpAddedLine(shortName, filePath);
   return "ok";
 }
-function printPlatformSnippet(platform, routingToken, shortName, apiKey) {
+function printPlatformSnippet(platform, routingToken, shortName, apiKey, codexCliTomlWritten) {
   const hostedInlinePlatforms = /* @__PURE__ */ new Set([
     "cursor",
     "claude-desktop",
@@ -2486,11 +2566,12 @@ mcpServers:
       2
     );
   } else if (platform === "codex-cli") {
+    const bearerToken = authHeader.startsWith("Bearer ") ? authHeader.slice("Bearer ".length) : authHeader;
     snippetText = `[mcp_servers.${shortName}]
 url = "${urlInSnippet}"
 
 [mcp_servers.${shortName}.http_headers]
-Authorization = "Bearer ${authHeader}"
+Authorization = "Bearer ${bearerToken}"
 `;
   } else {
     const urlKey = platform === "windsurf" ? "serverUrl" : "url";
@@ -2536,11 +2617,15 @@ Authorization = "Bearer ${authHeader}"
       ) + "\n\n"
     );
   } else if (platform === "codex-cli") {
-    process.stderr.write(
-      "\n" + style.dim(
-        "Add this to ~/.codex/config.toml (create the file if it does not exist). Restart Codex CLI after saving."
-      ) + "\n\n"
-    );
+    if (codexCliTomlWritten === true) {
+      process.stderr.write("\n" + style.dim("Added to ~/.codex/config.toml:") + "\n\n");
+    } else {
+      process.stderr.write(
+        "\n" + style.dim(
+          "Add this to ~/.codex/config.toml (create the file if it does not exist). Restart Codex CLI after saving."
+        ) + "\n\n"
+      );
+    }
   } else if (platform === "github-copilot") {
     process.stderr.write(
       "\n" + style.dim(
@@ -2817,15 +2902,7 @@ You have ${String(agentsForPlatform.length)} agent(s) connected for ${selectedLa
 `);
       }
       process.stderr.write("\n" + style.bold("What would you like to do?") + "\n");
-      const actionIdx = await arrowSelect(
-        [
-          "Add a new agent alongside these",
-          "Replace an existing agent",
-          "Skip - choose a different platform"
-        ],
-        ask,
-        "Action"
-      );
+      const actionIdx = await arrowSelect(INIT_EXISTING_AGENTS_PLATFORM_ACTIONS, ask, "Action");
       if (actionIdx === 2) {
         continue;
       }
@@ -3335,11 +3412,6 @@ You have ${String(agentsForPlatform.length)} agent(s) connected for ${selectedLa
             apiKey,
             initWorkspacePath
           );
-          process.stderr.write(
-            "\n" + style.dim(
-              "Add the TOML snippet above to ~/.codex/config.toml. Restart Codex CLI after saving."
-            ) + "\n"
-          );
           configuredAgents.push({
             selection,
             platform: selectedPlatform,
@@ -3676,8 +3748,9 @@ You have ${String(agentsForPlatform.length)} agent(s) connected for ${selectedLa
       );
     }
     if (codexHostedConfigured) {
+      const codexLabel = mcpPromptLabel2("codex-cli");
       blocks.push(
-        "\n" + style.bold("Codex CLI (hosted)") + "\n  \u2192 Restart Codex CLI after saving config.toml\n  \u2192 Verify it's connected: run /mcp in Codex CLI to see your active MCP servers\n  \u2192 Try it: make a request that uses an MCP tool through Shield\n"
+        "\n" + style.bold("Codex CLI (hosted)") + "\n  \u2192 Restart Codex CLI to load the new MCP server config\n  \u2192 Verify it's connected: run /mcp in Codex CLI to see your active MCP servers\n  \u2192 Try it - paste this into Codex:\n    Use the " + codexLabel + " MCP server to list my GitHub repositories\n"
       );
     }
     if (configuredPlatforms.has("other-mcp")) {
@@ -4585,7 +4658,7 @@ async function restoreClaudeDesktopMcpFromBackup() {
 
 // package.json
 var package_default = {
-  version: "1.9.3"};
+  version: "1.9.5"};
 
 // src/package-meta.ts
 var PACKAGE_VERSION = package_default.version;

package/dist/shield-extension.js

@@ -22517,7 +22517,7 @@ async function writeExtensionBackup(claudeDesktopConfigPath, mcpServers) {
 
 // package.json
 var package_default = {
-  version: "1.9.3"};
+  version: "1.9.5"};
 
 // src/package-meta.ts
 var PACKAGE_VERSION = package_default.version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multicorn-shield",
-  "version": "1.9.3",
+  "version": "1.9.5",
   "description": "The control layer for AI agents: permissions, consent, spending limits, and audit logging.",
   "license": "MIT",
   "author": "Multicorn AI Pty Ltd",

package/plugins/codex-cli/hooks/scripts/pre-tool-use.cjs

@@ -164,7 +164,7 @@ function openBrowser(url) {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-async function pollApprovalStatus(config, approvalId) {
+async function pollApprovalStatus(config, approvalId, consentLink) {
   let lastProgressWrite = Date.now();
   for (let i = 0; i < MAX_APPROVAL_POLLS; i++) {
     if (i > 0) {
@@ -172,9 +172,8 @@ async function pollApprovalStatus(config, approvalId) {
     }
     const now = Date.now();
     if (now - lastProgressWrite >= 3e4) {
-      process.stderr.write(
-        "[Shield] Waiting for approval... (open the consent screen in your browser)\n",
-      );
+      process.stderr.write(`[Shield] Waiting for approval... ${consentLink}
+`);
       lastProgressWrite = now;
     }
     let statusCode;
@@ -235,13 +234,16 @@ async function handlePendingWithConsentAndPoll(
   actionType,
   approvalsUrl,
 ) {
+  const consentLink = consentUrl(config.baseUrl, config.agentName, service, actionType);
+  process.stderr.write(`[Shield] Action requires approval. Open: ${consentLink}
+`);
   if (hasConsentMarker(config.agentName)) {
     process.stderr.write(
       `[Shield] Waiting for approval (up to 5 min)...
   Approve in the Shield dashboard: ${approvalsUrl}
 `,
     );
-    const approved2 = await pollApprovalStatus(config, approvalId);
+    const approved2 = await pollApprovalStatus(config, approvalId, consentLink);
     if (approved2) {
       process.exit(0);
     }
@@ -251,13 +253,12 @@ async function handlePendingWithConsentAndPoll(
     );
     process.exit(0);
   }
-  const url = consentUrl(config.baseUrl, config.agentName, service, actionType);
   writeConsentMarker(config.agentName);
-  openBrowser(url);
+  openBrowser(consentLink);
   process.stderr.write(
     "[Shield] Opening Shield consent screen... Waiting for approval (up to 5 min).\n",
   );
-  const approved = await pollApprovalStatus(config, approvalId);
+  const approved = await pollApprovalStatus(config, approvalId, consentLink);
   if (approved) {
     process.exit(0);
   }