mumucc 0.4.16 → 0.4.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mumucc",
-  "version": "0.4.16",
+  "version": "0.4.18",
   "description": "Open-source AI coding assistant CLI with multi-model support (Anthropic, OpenAI/GPT, DeepSeek, GLM, Ollama, etc.), MCP integration, agent swarms, and out-of-the-box developer experience.",
   "type": "module",
   "license": "MIT",

package/shims/globals.ts

@@ -4,7 +4,7 @@
  */
 
 ;(globalThis as any).MACRO = {
-  VERSION: '0.4.16-mumucc',
+  VERSION: '0.4.18-mumucc',
   VERSION_CHANGELOG: '{}',
   BUILD_TIME: new Date().toISOString(),
   PACKAGE_URL: 'https://github.com/mumuxsy/mumucc',

package/src/tools/AgentTool/AgentTool.tsx

@@ -104,6 +104,51 @@ function buildProfileDescription(): string {
   return `Optional profile override for this agent. Available profiles: ${profiles.map(profile => `'${profile.id}'`).join(', ')}.`
 }
 
+function getRecentUserMessagesText(
+  messages: MessageType[],
+  maxMessages = 4,
+): string {
+  return messages
+    .filter((m): m is Extract<MessageType, { type: 'user' }> => m.type === 'user')
+    .slice(-maxMessages)
+    .map(m => {
+      const content = m.message.content
+      if (typeof content === 'string') {
+        return content
+      }
+      if (Array.isArray(content)) {
+        return extractTextContent(content, '\n')
+      }
+      return ''
+    })
+    .join('\n')
+}
+
+function hasExplicitNoTeamRequest(text: string): boolean {
+  if (!text) return false
+  return (
+    /(不要|别|禁止|不允许|无需|不用).{0,8}(team|团队|swarm|teammate)/i.test(
+      text,
+    ) ||
+    /(no|without)\s+(team|swarm)/i.test(text)
+  )
+}
+
+function hasExplicitTeamRequest(text: string): boolean {
+  if (!text) return false
+  return /(team|团队|swarm|teammate|团队模式|多代理编队|调度团队)/i.test(text)
+}
+
+function hasExplicitNoBackgroundRequest(text: string): boolean {
+  if (!text) return false
+  return (
+    /(不要|别|禁止|不允许|无需|不用).{0,8}(挂后台|后台|异步|background)/i.test(
+      text,
+    ) ||
+    /(no|without)\s+background/i.test(text)
+  )
+}
+
 // Base input schema without multi-agent parameters
 const baseInputSchema = lazySchema(() => z.object({
   description: z.string().describe('A short (3-5 word) description of the task'),
@@ -282,19 +327,34 @@ export const AgentTool = buildTool({
     // Get app state for permission mode and agent filtering
     const appState = toolUseContext.getAppState();
     const permissionMode = appState.toolPermissionContext.mode;
+    const recentUserText = getRecentUserMessagesText(toolUseContext.messages);
+    const noTeamRequested = hasExplicitNoTeamRequest(recentUserText);
+    const teamRequested = hasExplicitTeamRequest(recentUserText);
+    const noBackgroundRequested = hasExplicitNoBackgroundRequest(recentUserText);
     // In-process teammates get a no-op setAppState; setAppStateForTasks
     // reaches the root store so task registration/progress/kill stay visible.
     const rootSetAppState = toolUseContext.setAppStateForTasks ?? toolUseContext.setAppState;
+    let effectiveRunInBackground = run_in_background;
+    let effectiveTeamName = team_name;
+    const teamModeAllowed = Boolean(appState.teamContext?.teamName) || (teamRequested && !noTeamRequested);
+
+    if (noBackgroundRequested) {
+      effectiveRunInBackground = false;
+    }
+    if (effectiveTeamName && !teamModeAllowed) {
+      logForDebugging(`[AgentTool] Ignoring team_name='${effectiveTeamName}' because team mode was not explicitly requested in recent user messages`);
+      effectiveTeamName = undefined;
+    }
 
     // Check if user is trying to use agent teams without access
-    if (team_name && !isAgentSwarmsEnabled()) {
+    if (effectiveTeamName && !isAgentSwarmsEnabled()) {
       throw new Error('Agent Teams is not yet available on your plan.');
     }
 
     // Teammates (in-process or tmux) passing `name` would trigger spawnTeammate()
     // below, but TeamFile.members is a flat array with one leadAgentId — nested
     // teammates land in the roster with no provenance and confuse the lead.
-    const explicitTeamName = team_name;
+    const explicitTeamName = effectiveTeamName;
     const teamName = explicitTeamName;
     if (isTeammate() && teamName && name) {
       throw new Error('Teammates cannot spawn other teammates — the team roster is flat. To spawn a subagent instead, omit the `name` parameter.');
@@ -302,7 +362,7 @@ export const AgentTool = buildTool({
     // In-process teammates cannot spawn background agents (their lifecycle is
     // tied to the leader's process). Tmux teammates are separate processes and
     // can manage their own background agents.
-    if (isInProcessTeammate() && teamName && run_in_background === true) {
+    if (isInProcessTeammate() && teamName && effectiveRunInBackground === true) {
       throw new Error('In-process teammates cannot spawn background agents. Use run_in_background=false for synchronous subagents.');
     }
 
@@ -491,7 +551,7 @@ export const AgentTool = buildTool({
       color: selectedAgent.color as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
       is_built_in_agent: isBuiltInAgent(selectedAgent),
       is_resume: false,
-      is_async: (run_in_background === true || selectedAgent.background === true) && !isBackgroundTasksDisabled,
+      is_async: (effectiveRunInBackground === true || selectedAgent.background === true) && !isBackgroundTasksDisabled,
       is_fork: isForkPath
     });
 
@@ -594,7 +654,7 @@ export const AgentTool = buildTool({
               agent_type: selectedAgent.agentType as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS
             }),
             scope: selectedAgent.memory as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS,
-            source: 'subagent' as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS
+      source: 'subagent' as AnalyticsMetadata_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS
           });
         }
 
@@ -613,7 +673,7 @@ export const AgentTool = buildTool({
       isBuiltInAgent: isBuiltInAgent(selectedAgent),
       startTime,
       agentType: selectedAgent.agentType,
-      isAsync: (run_in_background === true || selectedAgent.background === true) && !isBackgroundTasksDisabled
+      isAsync: (effectiveRunInBackground === true || selectedAgent.background === true) && !isBackgroundTasksDisabled
     };
 
     // Use inline env check instead of coordinatorModule to avoid circular
@@ -622,7 +682,7 @@ export const AgentTool = buildTool({
 
     // Fork subagent experiment: force ALL spawns async for a unified
     // <task-notification> interaction model (not just fork spawns — all of them).
-    const forceAsync = isForkSubagentEnabled();
+    const forceAsync = isForkPath && isForkSubagentEnabled();
 
     // Assistant mode: force all agents async. Synchronous subagents hold the
     // main loop's turn open until they complete — the daemon's inputQueue
@@ -632,7 +692,7 @@ export const AgentTool = buildTool({
     // <task-notification> re-entry there is handled by the else branch
     // below (registerAsyncAgentTask + notifyOnCompletion).
     const assistantForceAsync = feature('KAIROS') ? appState.kairosEnabled : false;
-    const shouldRunAsync = (run_in_background === true || selectedAgent.background === true || isCoordinator || forceAsync || assistantForceAsync || (proactiveModule?.isProactiveActive() ?? false)) && !isBackgroundTasksDisabled;
+    const shouldRunAsync = (effectiveRunInBackground === true || selectedAgent.background === true || isCoordinator || forceAsync || assistantForceAsync || (proactiveModule?.isProactiveActive() ?? false)) && !isBackgroundTasksDisabled;
     // Assemble the worker's tool pool independently of the parent's.
     // Workers always get their tools from assembleToolPool with their own
     // permission mode, so they aren't affected by the parent's tool

package/src/tools/AgentTool/prompt.ts

@@ -265,6 +265,8 @@ Usage notes:
       : ''
   }
 - To continue a previously spawned agent, use ${SEND_MESSAGE_TOOL_NAME} with the agent's ID or name as the \`to\` field. The agent resumes with its full context preserved. ${forkEnabled ? 'Each fresh Agent invocation with a subagent_type starts without context — provide a complete task description.' : 'Each Agent invocation starts fresh — provide a complete task description.'}
+- Do NOT use \`name\` or \`team_name\` unless the user explicitly asked for Team/team/swarm mode, or the current session is already inside a Team. For ordinary agent delegation, omit both fields.
+- If the user explicitly says not to use Team mode or not to run in background, you must respect that and keep the agent as a normal foreground subagent.
 - The agent's outputs should generally be trusted
 - Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.)${forkEnabled ? '' : ", since it is not aware of the user's intent"}
 - If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.

package/src/tools/TeamCreateTool/TeamCreateTool.ts

@@ -26,6 +26,7 @@ import {
 import { assignTeammateColor } from '../../utils/swarm/teammateLayoutManager.js'
 import {
   ensureTasksDir,
+  clearLeaderTeamName,
   resetTaskList,
   setLeaderTeamName,
 } from '../../utils/tasks.js'
@@ -163,9 +164,19 @@ export const TeamCreateTool: Tool<InputSchema, Output> = buildTool({
     const existingTeam = appState.teamContext?.teamName
 
     if (existingTeam) {
-      throw new Error(
-        `Already leading team "${existingTeam}". A leader can only manage one team at a time. Use TeamDelete to end the current team before creating a new one.`,
-      )
+      if (readTeamFile(existingTeam)) {
+        throw new Error(
+          `Already leading team "${existingTeam}". A leader can only manage one team at a time. Use TeamDelete to end the current team before creating a new one.`,
+        )
+      }
+
+      // Recover from a previously failed implicit spawn that populated
+      // AppState.teamContext before the team file was written.
+      clearLeaderTeamName()
+      setAppState(prev => ({
+        ...prev,
+        teamContext: undefined,
+      }))
     }
 
     // If team already exists, generate a unique name instead of failing

package/src/tools/shared/spawnMultiAgent.ts

@@ -24,7 +24,10 @@ import { getCwd } from '../../utils/cwd.js'
 import { logForDebugging } from '../../utils/debug.js'
 import { errorMessage } from '../../utils/errors.js'
 import { execFileNoThrow } from '../../utils/execFileNoThrow.js'
-import { parseUserSpecifiedModel } from '../../utils/model/model.js'
+import {
+  getDefaultMainLoopModel,
+  parseUserSpecifiedModel,
+} from '../../utils/model/model.js'
 import type { PermissionMode } from '../../utils/permissions/PermissionMode.js'
 import { isTmuxAvailable } from '../../utils/swarm/backends/detection.js'
 import {
@@ -52,8 +55,11 @@ import {
 import { buildInheritedEnvVars } from '../../utils/swarm/spawnUtils.js'
 import {
   readTeamFileAsync,
+  registerTeamForSessionCleanup,
   sanitizeAgentName,
   sanitizeName,
+  type TeamFile,
+  getTeamFilePath,
   writeTeamFileAsync,
 } from '../../utils/swarm/teamHelpers.js'
 import {
@@ -66,6 +72,7 @@ import {
 import { getHardcodedTeammateModelFallback } from '../../utils/swarm/teammateModel.js'
 import { registerTask } from '../../utils/task/framework.js'
 import { writeToMailbox } from '../../utils/teammateMailbox.js'
+import { ensureTasksDir, resetTaskList, setLeaderTeamName } from '../../utils/tasks.js'
 import type { CustomAgentDefinition } from '../AgentTool/loadAgentsDir.js'
 import { isCustomAgent } from '../AgentTool/loadAgentsDir.js'
 
@@ -102,6 +109,64 @@ export function resolveTeammateModel(
   return inputModel ?? getDefaultTeammateModel(leaderModel)
 }
 
+type EnsuredTeamContext = {
+  teamFile: TeamFile
+  teamFilePath: string
+}
+
+async function ensureTeamExistsForSpawn(
+  teamName: string,
+  context: ToolUseContext,
+): Promise<EnsuredTeamContext> {
+  const existing = await readTeamFileAsync(teamName)
+  if (existing) {
+    return {
+      teamFile: existing,
+      teamFilePath: getTeamFilePath(teamName),
+    }
+  }
+
+  const appState = context.getAppState()
+  const now = Date.now()
+  const leadAgentId = formatAgentId(TEAM_LEAD_NAME, teamName)
+  const leadModel = parseUserSpecifiedModel(
+    appState.mainLoopModelForSession ??
+      appState.mainLoopModel ??
+      getDefaultMainLoopModel(),
+  )
+  const taskListId = sanitizeName(teamName)
+
+  const teamFile: TeamFile = {
+    name: teamName,
+    createdAt: now,
+    leadAgentId,
+    leadSessionId: getSessionId(),
+    members: [
+      {
+        agentId: leadAgentId,
+        name: TEAM_LEAD_NAME,
+        agentType: TEAM_LEAD_NAME,
+        model: leadModel,
+        joinedAt: now,
+        tmuxPaneId: '',
+        cwd: getCwd(),
+        subscriptions: [],
+      },
+    ],
+  }
+
+  await writeTeamFileAsync(teamName, teamFile)
+  registerTeamForSessionCleanup(teamName)
+  await resetTaskList(taskListId)
+  await ensureTasksDir(taskListId)
+  setLeaderTeamName(taskListId)
+
+  return {
+    teamFile,
+    teamFilePath: getTeamFilePath(teamName),
+  }
+}
+
 // ============================================================================
 // Types
 // ============================================================================
@@ -328,6 +393,8 @@ async function handleSpawnSplitPane(
     )
   }
 
+  const ensuredTeam = await ensureTeamExistsForSpawn(teamName, context)
+
   // Generate unique name if duplicate exists in team
   const uniqueName = await generateUniqueTeammateName(name, teamName)
 
@@ -450,14 +517,15 @@ async function handleSpawnSplitPane(
   const windowName = insideTmux ? 'current' : 'swarm-view'
 
   // Track the teammate in AppState's teamContext with color
-  // If spawning without spawnTeam, set up the leader as team lead
   setAppState(prev => ({
     ...prev,
     teamContext: {
       ...prev.teamContext,
-      teamName: teamName ?? prev.teamContext?.teamName ?? 'default',
-      teamFilePath: prev.teamContext?.teamFilePath ?? '',
-      leadAgentId: prev.teamContext?.leadAgentId ?? '',
+      teamName,
+      teamFilePath:
+        prev.teamContext?.teamFilePath || ensuredTeam.teamFilePath,
+      leadAgentId:
+        prev.teamContext?.leadAgentId || ensuredTeam.teamFile.leadAgentId,
       teammates: {
         ...(prev.teamContext?.teammates || {}),
         [teammateId]: {
@@ -488,12 +556,7 @@ async function handleSpawnSplitPane(
   })
 
   // Register agent in the team file
-  const teamFile = await readTeamFileAsync(teamName)
-  if (!teamFile) {
-    throw new Error(
-      `Team "${teamName}" does not exist. Call spawnTeam first to create the team.`,
-    )
-  }
+  const teamFile = ensuredTeam.teamFile
   teamFile.members.push({
     agentId: teammateId,
     name: sanitizedName,
@@ -568,6 +631,8 @@ async function handleSpawnSeparateWindow(
     )
   }
 
+  const ensuredTeam = await ensureTeamExistsForSpawn(teamName, context)
+
   // Generate unique name if duplicate exists in team
   const uniqueName = await generateUniqueTeammateName(name, teamName)
 
@@ -668,9 +733,11 @@ async function handleSpawnSeparateWindow(
     ...prev,
     teamContext: {
       ...prev.teamContext,
-      teamName: teamName ?? prev.teamContext?.teamName ?? 'default',
-      teamFilePath: prev.teamContext?.teamFilePath ?? '',
-      leadAgentId: prev.teamContext?.leadAgentId ?? '',
+      teamName,
+      teamFilePath:
+        prev.teamContext?.teamFilePath || ensuredTeam.teamFilePath,
+      leadAgentId:
+        prev.teamContext?.leadAgentId || ensuredTeam.teamFile.leadAgentId,
       teammates: {
         ...(prev.teamContext?.teammates || {}),
         [teammateId]: {
@@ -702,12 +769,7 @@ async function handleSpawnSeparateWindow(
   })
 
   // Register agent in the team file
-  const teamFile = await readTeamFileAsync(teamName)
-  if (!teamFile) {
-    throw new Error(
-      `Team "${teamName}" does not exist. Call spawnTeam first to create the team.`,
-    )
-  }
+  const teamFile = ensuredTeam.teamFile
   teamFile.members.push({
     agentId: teammateId,
     name: sanitizedName,
@@ -863,6 +925,8 @@ async function handleSpawnInProcess(
     )
   }
 
+  const ensuredTeam = await ensureTeamExistsForSpawn(teamName, context)
+
   // Generate unique name if duplicate exists in team
   const uniqueName = await generateUniqueTeammateName(name, teamName)
 
@@ -940,39 +1004,22 @@ async function handleSpawnInProcess(
   }
 
   // Track the teammate in AppState's teamContext
-  // Auto-register leader if spawning without prior spawnTeam call
   setAppState(prev => {
-    const needsLeaderSetup = !prev.teamContext?.leadAgentId
-    const leadAgentId = needsLeaderSetup
-      ? formatAgentId(TEAM_LEAD_NAME, teamName)
-      : prev.teamContext!.leadAgentId
+    const leadAgentId =
+      prev.teamContext?.leadAgentId || ensuredTeam.teamFile.leadAgentId
 
-    // Build teammates map, including leader if needed for inbox polling
     const existingTeammates = prev.teamContext?.teammates || {}
-    const leadEntry = needsLeaderSetup
-      ? {
-          [leadAgentId]: {
-            name: TEAM_LEAD_NAME,
-            agentType: TEAM_LEAD_NAME,
-            color: assignTeammateColor(leadAgentId),
-            tmuxSessionName: 'in-process',
-            tmuxPaneId: 'leader',
-            cwd: getCwd(),
-            spawnedAt: Date.now(),
-          },
-        }
-      : {}
 
     return {
       ...prev,
       teamContext: {
         ...prev.teamContext,
-        teamName: teamName ?? prev.teamContext?.teamName ?? 'default',
-        teamFilePath: prev.teamContext?.teamFilePath ?? '',
+        teamName,
+        teamFilePath:
+          prev.teamContext?.teamFilePath || ensuredTeam.teamFilePath,
         leadAgentId,
         teammates: {
           ...existingTeammates,
-          ...leadEntry,
           [teammateId]: {
             name: sanitizedName,
             agentType: agent_type,
@@ -988,12 +1035,7 @@ async function handleSpawnInProcess(
   })
 
   // Register agent in the team file
-  const teamFile = await readTeamFileAsync(teamName)
-  if (!teamFile) {
-    throw new Error(
-      `Team "${teamName}" does not exist. Call spawnTeam first to create the team.`,
-    )
-  }
+  const teamFile = ensuredTeam.teamFile
   teamFile.members.push({
     agentId: teammateId,
     name: sanitizedName,