@poncho-ai/cli 0.17.0 → 0.19.0

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   main
-} from "./chunk-GDB5X2OS.js";
+} from "./chunk-7P53QSP5.js";
 
 // src/cli.ts
 void main();

package/dist/index.d.ts

@@ -66,6 +66,7 @@ declare const mcpAdd: (workingDir: string, options: {
     name?: string;
     envVars?: string[];
     authBearerEnv?: string;
+    headers?: string[];
 }) => Promise<void>;
 declare const mcpList: (workingDir: string) => Promise<void>;
 declare const mcpRemove: (workingDir: string, name: string) => Promise<void>;

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   runTests,
   startDevServer,
   updateAgentGuidance
-} from "./chunk-GDB5X2OS.js";
+} from "./chunk-7P53QSP5.js";
 export {
   addSkill,
   buildCli,

package/dist/{run-interactive-ink-B6JJ33SN.js → run-interactive-ink-4KVVPMR3.js}

@@ -2,7 +2,7 @@ import {
   consumeFirstRunIntro,
   inferConversationTitle,
   resolveHarnessEnvironment
-} from "./chunk-GDB5X2OS.js";
+} from "./chunk-7P53QSP5.js";
 
 // src/run-interactive-ink.ts
 import * as readline from "readline";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/cli",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "CLI for building and deploying AI agents",
   "repository": {
     "type": "git",
@@ -27,9 +27,9 @@
     "react": "^19.2.4",
     "react-devtools-core": "^6.1.5",
     "yaml": "^2.8.1",
-    "@poncho-ai/harness": "0.17.0",
-    "@poncho-ai/messaging": "0.2.5",
-    "@poncho-ai/sdk": "1.2.0"
+    "@poncho-ai/harness": "0.19.0",
+    "@poncho-ai/messaging": "0.2.7",
+    "@poncho-ai/sdk": "1.4.0"
   },
   "devDependencies": {
     "@types/busboy": "^1.5.4",

package/src/index.ts

@@ -455,6 +455,10 @@ Connect remote MCP servers and expose their tools to the agent:
 # Add remote MCP server
 poncho mcp add --url https://mcp.example.com/github --name github --auth-bearer-env GITHUB_TOKEN
 
+# Server with custom headers (e.g. Arcade)
+poncho mcp add --url https://mcp.arcade.dev --name arcade \\
+  --auth-bearer-env ARCADE_API_KEY --header "Arcade-User-ID: user@example.com"
+
 # List configured servers
 poncho mcp list
 
@@ -536,14 +540,22 @@ export default {
       url: "https://mcp.example.com/github",
       auth: { type: "bearer", tokenEnv: "GITHUB_TOKEN" },
     },
+    // Custom headers for servers that require them (e.g. Arcade)
+    // { name: "arcade", url: "https://mcp.arcade.dev", auth: { type: "bearer", tokenEnv: "ARCADE_API_KEY" }, headers: { "Arcade-User-ID": "user@example.com" } },
   ],
   // Tool access: true (available), false (disabled), 'approval' (requires human approval)
   tools: {
+    list_directory: true,
+    read_file: true,
     write_file: true,           // gated by environment for writes
+    delete_file: 'approval',    // requires human approval
+    delete_directory: 'approval', // requires human approval
     send_email: 'approval',     // requires human approval
     byEnvironment: {
       production: {
         write_file: false,
+        delete_file: false,
+        delete_directory: false,
       },
       development: {
         send_email: true,       // skip approval in dev
@@ -626,6 +638,7 @@ Connect your agent to email so users can interact by sending emails:
    RESEND_API_KEY=re_...
    RESEND_WEBHOOK_SECRET=whsec_...
    RESEND_FROM=Agent <agent@yourdomain.com>
+   RESEND_REPLY_TO=support@yourdomain.com   # optional
    \`\`\`
 5. Add to \`poncho.config.js\`:
    \`\`\`javascript
@@ -1457,7 +1470,7 @@ export const createRequestHandler = async (options?: {
   // Pending subagent approvals: when a subagent hits an approval checkpoint,
   // we store a resolver here so the approval endpoint can signal the waiting runSubagent.
   type PendingSubagentApproval = {
-    resolve: (approved: boolean) => void;
+    resolve: (decidedApprovals: NonNullable<Conversation["pendingApprovals"]>) => void;
     childHarness: AgentHarness;
     checkpoint: NonNullable<Conversation["pendingApprovals"]>[number];
     childConversationId: string;
@@ -1578,84 +1591,86 @@ export const createRequestHandler = async (options?: {
           });
         }
         if (event.type === "tool:approval:checkpoint") {
-          // Persist checkpoint so the approval endpoint can find it
           const cpConv = await conversationStore.get(childConversationId);
           if (cpConv) {
-            const cpData: NonNullable<Conversation["pendingApprovals"]>[number] = {
-              approvalId: event.approvalId,
+            const allCpData: NonNullable<Conversation["pendingApprovals"]> = event.approvals.map(a => ({
+              approvalId: a.approvalId,
               runId: latestRunId,
-              tool: event.tool,
-              toolCallId: event.toolCallId,
-              input: event.input,
+              tool: a.tool,
+              toolCallId: a.toolCallId,
+              input: a.input,
               checkpointMessages: [...historyMessages, ...event.checkpointMessages],
               baseMessageCount: 0,
               pendingToolCalls: event.pendingToolCalls,
-            };
-            cpConv.pendingApprovals = [cpData];
+            }));
+            cpConv.pendingApprovals = allCpData;
             cpConv.updatedAt = Date.now();
             await conversationStore.update(cpConv);
 
-            // Wait for approval decision (signaled by the approval endpoint)
-            const approved = await new Promise<boolean>((resolve) => {
-              pendingSubagentApprovals.set(event.approvalId, {
-                resolve,
-                childHarness,
-                checkpoint: cpData,
-                childConversationId,
-                parentConversationId,
-              });
+            // Wait for all approval decisions (signaled by the approval endpoint
+            // once every entry in the batch has a decision)
+            const decidedApprovals = await new Promise<NonNullable<Conversation["pendingApprovals"]>>((resolve) => {
+              for (const cpData of allCpData) {
+                pendingSubagentApprovals.set(cpData.approvalId, {
+                  resolve,
+                  childHarness,
+                  checkpoint: cpData,
+                  childConversationId,
+                  parentConversationId,
+                });
+              }
             });
 
-            // Execute tool and resume the run
-            let toolResults: Array<{ callId: string; toolName: string; result?: unknown; error?: string }>;
-            if (approved) {
-              const toolContext = {
-                runId: cpData.runId,
-                agentId: identity.id,
-                step: 0,
-                workingDir,
-                parameters: {},
-                conversationId: childConversationId,
-              };
-              const execResults = await childHarness.executeTools(
-                [{ id: cpData.toolCallId!, name: cpData.tool, input: cpData.input }],
-                toolContext,
-              );
-              toolResults = execResults.map(r => ({
+            // Execute approved tools and collect results
+            const checkpointRef = allCpData[0]!;
+            const toolContext = {
+              runId: checkpointRef.runId,
+              agentId: identity.id,
+              step: 0,
+              workingDir,
+              parameters: {},
+              conversationId: childConversationId,
+            };
+
+            const approvalToolCallIds = new Set(decidedApprovals.map(a => a.toolCallId));
+            const callsToExecute: Array<{ id: string; name: string; input: Record<string, unknown> }> = [];
+            const deniedResults: Array<{ callId: string; toolName: string; error: string }> = [];
+
+            for (const a of decidedApprovals) {
+              if (a.decision === "approved" && a.toolCallId) {
+                callsToExecute.push({ id: a.toolCallId, name: a.tool, input: a.input });
+                const toolText = `- done \`${a.tool}\``;
+                toolTimeline.push(toolText);
+                currentTools.push(toolText);
+              } else if (a.toolCallId) {
+                deniedResults.push({ callId: a.toolCallId, toolName: a.tool, error: "Tool execution denied by user" });
+                const toolText = `- denied \`${a.tool}\``;
+                toolTimeline.push(toolText);
+                currentTools.push(toolText);
+              }
+            }
+
+            // Auto-approved tools that were deferred alongside approval-needing ones
+            const pendingToolCalls = checkpointRef.pendingToolCalls ?? [];
+            for (const tc of pendingToolCalls) {
+              if (!approvalToolCallIds.has(tc.id)) {
+                callsToExecute.push(tc);
+              }
+            }
+
+            let toolResults: Array<{ callId: string; toolName: string; result?: unknown; error?: string }> = [...deniedResults];
+            if (callsToExecute.length > 0) {
+              const execResults = await childHarness.executeTools(callsToExecute, toolContext);
+              toolResults.push(...execResults.map(r => ({
                 callId: r.callId,
                 toolName: r.tool,
                 result: r.output,
                 error: r.error,
-              }));
-              const toolText = `- done \`${cpData.tool}\``;
-              toolTimeline.push(toolText);
-              currentTools.push(toolText);
-            } else {
-              toolResults = [{
-                callId: cpData.toolCallId!,
-                toolName: cpData.tool,
-                error: "Tool execution denied by user",
-              }];
-              const toolText = `- denied \`${cpData.tool}\``;
-              toolTimeline.push(toolText);
-              currentTools.push(toolText);
-            }
-
-            broadcastEvent(childConversationId,
-              approved
-                ? { type: "tool:approval:granted", approvalId: event.approvalId }
-                : { type: "tool:approval:denied", approvalId: event.approvalId },
-            );
-
-            // Clear pending approval from conversation
-            const cpConv2 = await conversationStore.get(childConversationId);
-            if (cpConv2) {
-              cpConv2.pendingApprovals = [];
-              await conversationStore.update(cpConv2);
+              })));
             }
 
             // Resume the run -- process continuation events
-            const resumeMessages = [...cpData.checkpointMessages!];
+            const resumeMessages = [...checkpointRef.checkpointMessages!];
             for await (const resumeEvent of childHarness.continueFromToolResult({
               messages: resumeMessages,
               toolResults,
@@ -1980,16 +1995,16 @@ export const createRequestHandler = async (options?: {
         if (event.type === "tool:approval:checkpoint") {
           const conv = await conversationStore.get(conversationId);
           if (conv) {
-            conv.pendingApprovals = [{
-              approvalId: event.approvalId,
+            conv.pendingApprovals = event.approvals.map(a => ({
+              approvalId: a.approvalId,
               runId: latestRunId,
-              tool: event.tool,
-              toolCallId: event.toolCallId,
-              input: event.input,
+              tool: a.tool,
+              toolCallId: a.toolCallId,
+              input: a.input,
               checkpointMessages: [...fullCheckpointMessages, ...event.checkpointMessages],
               baseMessageCount: 0,
               pendingToolCalls: event.pendingToolCalls,
-            }];
+            }));
             conv.updatedAt = Date.now();
             await conversationStore.update(conv);
           }
@@ -2257,16 +2272,16 @@ export const createRequestHandler = async (options?: {
           if (event.type === "tool:approval:checkpoint") {
             await updateConversation((c) => {
               c.messages = buildMessages();
-              c.pendingApprovals = [{
-                approvalId: event.approvalId,
+              c.pendingApprovals = event.approvals.map(a => ({
+                approvalId: a.approvalId,
                 runId: latestRunId,
-                tool: event.tool,
-                toolCallId: event.toolCallId,
-                input: event.input,
+                tool: a.tool,
+                toolCallId: a.toolCallId,
+                input: a.input,
                 checkpointMessages: event.checkpointMessages,
                 baseMessageCount: historyMessages.length,
                 pendingToolCalls: event.pendingToolCalls,
-              }];
+              }));
             });
             checkpointedRun = true;
           }
@@ -2346,9 +2361,9 @@ export const createRequestHandler = async (options?: {
           waitUntil: waitUntilHook,
           ownerId: "local-owner",
         });
-        adapter.registerRoutes(messagingRouteRegistrar);
         try {
           await bridge.start();
+          adapter.registerRoutes(messagingRouteRegistrar);
           messagingBridges.push(bridge);
           console.log(`  Slack messaging enabled at /api/messaging/slack`);
         } catch (err) {
@@ -2361,6 +2376,7 @@ export const createRequestHandler = async (options?: {
           apiKeyEnv: channelConfig.apiKeyEnv,
           webhookSecretEnv: channelConfig.webhookSecretEnv,
           fromEnv: channelConfig.fromEnv,
+          replyToEnv: channelConfig.replyToEnv,
           allowedSenders: channelConfig.allowedSenders,
           mode: channelConfig.mode,
           allowedRecipients: channelConfig.allowedRecipients,
@@ -2372,9 +2388,9 @@ export const createRequestHandler = async (options?: {
           waitUntil: waitUntilHook,
           ownerId: "local-owner",
         });
-        adapter.registerRoutes(messagingRouteRegistrar);
         try {
           await bridge.start();
+          adapter.registerRoutes(messagingRouteRegistrar);
           messagingBridges.push(bridge);
           const adapterTools = adapter.getToolDefinitions?.() ?? [];
           if (adapterTools.length > 0) {
@@ -2399,6 +2415,10 @@ export const createRequestHandler = async (options?: {
   const authRequired = config?.auth?.required ?? false;
   const requireAuth = authRequired && authToken.length > 0;
 
+  if (requireAuth) {
+    sessionStore.setSigningKey(authToken);
+  }
+
   const webUiEnabled = config?.webUi !== false;
   const isProduction = resolveHarnessEnvironment() === "production";
   const secureCookies = isProduction;
@@ -2487,8 +2507,10 @@ export const createRequestHandler = async (options?: {
     }
 
     const cookies = parseCookies(request);
-    const sessionId = cookies.poncho_session;
-    const session = sessionId ? sessionStore.get(sessionId) : undefined;
+    const cookieValue = cookies.poncho_session;
+    const session = cookieValue
+      ? (sessionStore.get(cookieValue) ?? sessionStore.restoreFromSigned(cookieValue))
+      : undefined;
     const ownerId = session?.ownerId ?? "local-owner";
     const requiresCsrfValidation =
       request.method !== "GET" && request.method !== "HEAD" && request.method !== "OPTIONS";
@@ -2539,7 +2561,8 @@ export const createRequestHandler = async (options?: {
       }
       loginRateLimiter.registerSuccess(ip);
       const createdSession = sessionStore.create(ownerId);
-      setCookie(response, "poncho_session", createdSession.sessionId, {
+      const signedValue = sessionStore.signSession(createdSession);
+      setCookie(response, "poncho_session", signedValue ?? createdSession.sessionId, {
         httpOnly: true,
         secure: secureCookies,
         sameSite: "Lax",
@@ -2781,14 +2804,32 @@ export const createRequestHandler = async (options?: {
       // Check if this is a pending subagent approval (handled inline by runSubagent)
       const pendingSubagent = pendingSubagentApprovals.get(approvalId);
       if (pendingSubagent) {
-        pendingSubagentApprovals.delete(approvalId);
-        // Clear pendingApprovals from the subagent's conversation immediately
+        pendingSubagent.checkpoint.decision = approved ? "approved" : "denied";
+
+        broadcastEvent(pendingSubagent.childConversationId,
+          approved
+            ? { type: "tool:approval:granted", approvalId }
+            : { type: "tool:approval:denied", approvalId },
+        );
+
         const childConv = await conversationStore.get(pendingSubagent.childConversationId);
-        if (childConv && Array.isArray(childConv.pendingApprovals)) {
-          childConv.pendingApprovals = childConv.pendingApprovals.filter(pa => pa.approvalId !== approvalId);
+        const allApprovals = childConv?.pendingApprovals ?? [];
+        const allDecided = allApprovals.length > 0 && allApprovals.every(pa => pa.decision != null);
+
+        if (allDecided) {
+          // All approvals in the batch are decided — resolve the subagent
+          for (const pa of allApprovals) {
+            pendingSubagentApprovals.delete(pa.approvalId);
+          }
+          if (childConv) {
+            childConv.pendingApprovals = [];
+            await conversationStore.update(childConv);
+          }
+          pendingSubagent.resolve(allApprovals);
+        } else if (childConv) {
           await conversationStore.update(childConv);
         }
-        pendingSubagent.resolve(approved);
+
         writeJson(response, 200, { ok: true, approvalId, approved });
         return;
       }
@@ -2818,7 +2859,6 @@ export const createRequestHandler = async (options?: {
       const conversationId = foundConversation.conversationId;
 
       if (!foundApproval.checkpointMessages || !foundApproval.toolCallId) {
-        // Legacy approval without checkpoint data — cannot resume
         foundConversation.pendingApprovals = (foundConversation.pendingApprovals ?? [])
           .filter(a => a.approvalId !== approvalId);
         await conversationStore.update(foundConversation);
@@ -2829,55 +2869,82 @@ export const createRequestHandler = async (options?: {
         return;
       }
 
-      // Clear this approval from the conversation before resuming
-      foundConversation.pendingApprovals = (foundConversation.pendingApprovals ?? [])
-        .filter(a => a.approvalId !== approvalId);
-      await conversationStore.update(foundConversation);
+      // Record the decision on this approval entry
+      foundApproval.decision = approved ? "approved" : "denied";
 
-      // Initialize the event stream so the web UI can connect immediately
       broadcastEvent(conversationId,
         approved
           ? { type: "tool:approval:granted", approvalId }
           : { type: "tool:approval:denied", approvalId },
       );
 
-      // Resume the run asynchronously (tool execution + continuation)
+      const allApprovals = foundConversation.pendingApprovals ?? [];
+      const allDecided = allApprovals.length > 0 && allApprovals.every(a => a.decision != null);
+
+      if (!allDecided) {
+        // Still waiting for more decisions — persist and respond
+        await conversationStore.update(foundConversation);
+        writeJson(response, 200, { ok: true, approvalId, approved, batchComplete: false });
+        return;
+      }
+
+      // All approvals in the batch are decided — execute and resume
+      foundConversation.pendingApprovals = [];
+      await conversationStore.update(foundConversation);
+
+      // Use the first approval as the checkpoint reference (all share the same checkpoint data)
+      const checkpointRef = allApprovals[0]!;
+
       void (async () => {
-        let toolResults: Array<{ callId: string; toolName: string; result?: unknown; error?: string }>;
-        if (approved) {
-          const toolContext = {
-            runId: foundApproval.runId,
-            agentId: identity.id,
-            step: 0,
-            workingDir,
-            parameters: {},
-          };
-          const execResults = await harness.executeTools(
-            [{ id: foundApproval.toolCallId!, name: foundApproval.tool, input: foundApproval.input }],
-            toolContext,
-          );
-          toolResults = execResults.map(r => ({
+        const toolContext = {
+          runId: checkpointRef.runId,
+          agentId: identity.id,
+          step: 0,
+          workingDir,
+          parameters: {},
+        };
+
+        // Collect tool calls to execute: approved approval-gated tools + auto-approved deferred tools
+        const approvalToolCallIds = new Set(allApprovals.map(a => a.toolCallId));
+        const callsToExecute: Array<{ id: string; name: string; input: Record<string, unknown> }> = [];
+        const deniedResults: Array<{ callId: string; toolName: string; error: string }> = [];
+
+        for (const a of allApprovals) {
+          if (a.decision === "approved" && a.toolCallId) {
+            callsToExecute.push({ id: a.toolCallId, name: a.tool, input: a.input });
+          } else if (a.decision === "denied" && a.toolCallId) {
+            deniedResults.push({ callId: a.toolCallId, toolName: a.tool, error: "Tool execution denied by user" });
+          }
+        }
+
+        // Auto-approved tools that were deferred alongside the approval-needing ones
+        const pendingToolCalls = checkpointRef.pendingToolCalls ?? [];
+        for (const tc of pendingToolCalls) {
+          if (!approvalToolCallIds.has(tc.id)) {
+            callsToExecute.push(tc);
+          }
+        }
+
+        let toolResults: Array<{ callId: string; toolName: string; result?: unknown; error?: string }> = [...deniedResults];
+        if (callsToExecute.length > 0) {
+          const execResults = await harness.executeTools(callsToExecute, toolContext);
+          toolResults.push(...execResults.map(r => ({
             callId: r.callId,
             toolName: r.tool,
             result: r.output,
             error: r.error,
-          }));
-        } else {
-          toolResults = [{
-            callId: foundApproval.toolCallId!,
-            toolName: foundApproval.tool,
-            error: "Tool execution denied by user",
-          }];
+          })));
         }
+
         await resumeRunFromCheckpoint(
           conversationId,
           foundConversation!,
-          foundApproval!,
+          checkpointRef,
           toolResults,
         );
       })();
 
-      writeJson(response, 200, { ok: true, approvalId, approved });
+      writeJson(response, 200, { ok: true, approvalId, approved, batchComplete: true });
       return;
     }
 
@@ -3396,16 +3463,16 @@ export const createRequestHandler = async (options?: {
                   }]
                 : []),
             ];
-            conversation.pendingApprovals = [{
-              approvalId: event.approvalId,
+            conversation.pendingApprovals = event.approvals.map(a => ({
+              approvalId: a.approvalId,
               runId: latestRunId,
-              tool: event.tool,
-              toolCallId: event.toolCallId,
-              input: event.input,
+              tool: a.tool,
+              toolCallId: a.toolCallId,
+              input: a.input,
               checkpointMessages: event.checkpointMessages,
               baseMessageCount: historyMessages.length,
               pendingToolCalls: event.pendingToolCalls,
-            }];
+            }));
             conversation.updatedAt = Date.now();
             await conversationStore.update(conversation);
             checkpointedRun = true;
@@ -3753,11 +3820,14 @@ export const createRequestHandler = async (options?: {
   handler._cronJobs = cronJobs;
   handler._conversationStore = conversationStore;
 
-  // Recover stale subagent runs that were "running" when the server last stopped
+  // Recover stale subagent runs that were "running" when the server last stopped.
+  // Pass no ownerId so we scan across all owners (not just "local-owner").
   try {
-    const allConvs = await conversationStore.list();
-    for (const conv of allConvs) {
-      if (conv.subagentMeta?.status === "running") {
+    const allSummaries = await conversationStore.listSummaries();
+    const subagentSummaries = allSummaries.filter((s) => s.parentConversationId);
+    for (const s of subagentSummaries) {
+      const conv = await conversationStore.get(s.conversationId);
+      if (conv?.subagentMeta?.status === "running") {
         conv.subagentMeta.status = "stopped";
         conv.subagentMeta.error = { code: "SERVER_RESTART", message: "Interrupted by server restart" };
         conv.updatedAt = Date.now();
@@ -4535,6 +4605,7 @@ export const mcpAdd = async (
     name?: string;
     envVars?: string[];
     authBearerEnv?: string;
+    headers?: string[];
   },
 ): Promise<void> => {
   const config = (await loadPonchoConfig(workingDir)) ?? { mcp: [] };
@@ -4548,6 +4619,18 @@ export const mcpAdd = async (
   if (!options.url.startsWith("http://") && !options.url.startsWith("https://")) {
     throw new Error("Invalid MCP URL. Expected http:// or https://.");
   }
+  const parsedHeaders: Record<string, string> | undefined =
+    options.headers && options.headers.length > 0
+      ? Object.fromEntries(
+          options.headers.map((h) => {
+            const idx = h.indexOf(":");
+            if (idx < 1) {
+              throw new Error(`Invalid header format "${h}". Expected "Name: value".`);
+            }
+            return [h.slice(0, idx).trim(), h.slice(idx + 1).trim()];
+          }),
+        )
+      : undefined;
   const serverName = options.name ?? normalizeMcpName({ url: options.url });
   mcp.push({
     name: serverName,
@@ -4559,6 +4642,7 @@ export const mcpAdd = async (
           tokenEnv: options.authBearerEnv,
         }
       : undefined,
+    headers: parsedHeaders,
   });
 
   await writeConfigFile(workingDir, { ...config, mcp });
@@ -4605,8 +4689,10 @@ export const mcpList = async (workingDir: string): Promise<void> => {
   for (const entry of mcp) {
     const auth =
       entry.auth?.type === "bearer" ? `auth=bearer:${entry.auth.tokenEnv}` : "auth=none";
+    const headerKeys = entry.headers ? Object.keys(entry.headers) : [];
+    const headerInfo = headerKeys.length > 0 ? `, headers=${headerKeys.join(",")}` : "";
     process.stdout.write(
-      `- ${entry.name ?? entry.url} (remote: ${entry.url}, ${auth})\n`,
+      `- ${entry.name ?? entry.url} (remote: ${entry.url}, ${auth}${headerInfo})\n`,
     );
   }
 };
@@ -4933,6 +5019,10 @@ export const buildCli = (): Command => {
       all.push(value);
       return all;
     }, [] as string[])
+    .option("--header <header>", "custom header as 'Name: value' (repeatable)", (value, all: string[]) => {
+      all.push(value);
+      return all;
+    }, [] as string[])
     .action(
       async (
         options: {
@@ -4940,6 +5030,7 @@ export const buildCli = (): Command => {
           name?: string;
           authBearerEnv?: string;
           env: string[];
+          header: string[];
         },
       ) => {
         await mcpAdd(process.cwd(), {
@@ -4947,6 +5038,7 @@ export const buildCli = (): Command => {
           name: options.name,
           envVars: options.env,
           authBearerEnv: options.authBearerEnv,
+          headers: options.header,
         });
       },
     );