@atlasharness/atlascode 0.1.65 → 0.1.66

package/dist/cli.js

@@ -37092,7 +37092,7 @@ function formatAgentLine(agent) {
 function getPrompt(agents) {
   const list = agents.length > 0 ? agents.map(formatAgentLine).join(`
 `) : "- general-purpose: General-purpose agent for researching and executing multi-step tasks.";
-  return "Launch a subagent to run a self-contained task in an isolated context. " + "Provide a short description (3-5 words) and a fully self-contained prompt " + "(the subagent cannot see this conversation). " + "Be cost-aware about delegating: prefer to do the work inline in this " + "conversation for a small task with a known, bounded target (a single-file " + "edit, a quick lookup, a change you can finish without broad exploration) — " + "spawning a subagent has overhead. Delegate when the task is genuinely " + "parallelizable or would otherwise flood this context with material you do " + "not need to keep (a broad multi-file search, an isolated multi-step " + "implementation, or independent work that can run alongside your own). Keep " + "each delegated brief narrow and evidence-focused: name the exact goal, the " + "files or area, and the expected deliverable rather than a broad " + '"figure this out." Because the subagent cannot see this conversation, its ' + "prompt must be fully self-contained — state every constraint, file, and " + "reporting requirement it needs. " + "Set run_in_background to true to launch a subagent that runs while you " + "continue working in this conversation; you will receive a task-notification " + "when it completes. Use this only for genuinely parallel work, not to defer " + "a result you need before you can proceed. " + `Available agent types and the tools they have access to:
+  return "Launch a subagent to run a self-contained task in an isolated context. " + "Provide a short description (3-5 words) and a fully self-contained prompt " + "(the subagent cannot see this conversation). " + "Be cost-aware about delegating: prefer to do the work inline in this " + "conversation for a small task with a known, bounded target (a single-file " + "edit, a quick lookup, a change you can finish without broad exploration) — " + "spawning a subagent has overhead. Delegate when the task is genuinely " + "parallelizable or would otherwise flood this context with material you do " + "not need to keep (a broad multi-file search, an isolated multi-step " + "implementation, or independent work that can run alongside your own). Keep " + "each delegated brief narrow and evidence-focused: name the exact goal, the " + "files or area, and the expected deliverable rather than a broad " + '"figure this out." Because the subagent cannot see this conversation, its ' + "prompt must be fully self-contained — state every constraint, file, and " + "reporting requirement it needs. " + "Subagents run in the background by default; you will receive a " + "task-notification when one completes — do not poll or sleep waiting for " + "it. Set run_in_background to false only when you need the result before " + "you can proceed. Use background for genuinely parallel work, not to defer " + "a result you need immediately. " + `Available agent types and the tools they have access to:
 ${list}
 ` + `The ${AGENT_TOOL_NAME} tool runs the subagent and returns its final result ` + "when it completes; act on that result once it is returned. " + "Do not predict or assume what the subagent will find — wait for its " + "returned result and act on what it actually reports.";
 }
@@ -37204,8 +37204,44 @@ var init_runAgent = __esm(() => {
   init_localAgentTask();
 });
 
+// src/engine/tools/agent/backgroundTracker.ts
+function trackBackgroundAgent(p) {
+  const handled = p.then(() => {}, () => {});
+  pendingBackgroundAgents.add(handled);
+  handled.finally(() => {
+    pendingBackgroundAgents.delete(handled);
+  });
+}
+function hasPendingBackgroundAgents() {
+  return pendingBackgroundAgents.size > 0;
+}
+async function drainPendingBackgroundAgents(signal) {
+  if (pendingBackgroundAgents.size === 0)
+    return;
+  const promises = Array.from(pendingBackgroundAgents);
+  if (signal?.aborted)
+    return;
+  await Promise.allSettled(promises);
+}
+function resetBackgroundAgentTracker() {
+  pendingBackgroundAgents.clear();
+}
+var pendingBackgroundAgents;
+var init_backgroundTracker = __esm(() => {
+  pendingBackgroundAgents = new Set;
+});
+
 // src/engine/tools/agent/AgentTool.ts
 import { randomUUID as randomUUID5 } from "crypto";
+function isAgentBackgroundByDefault() {
+  return !isEnvTruthy(process.env.ATLAS_AGENT_DEFAULT_FOREGROUND);
+}
+function shouldRunInBackground(runInBg) {
+  if (isAgentBackgroundByDefault()) {
+    return runInBg !== false;
+  }
+  return !!runInBg;
+}
 function resolveAgentDefinition(subagentType, agents) {
   if (!subagentType)
     return GENERAL_PURPOSE_AGENT;
@@ -37229,6 +37265,8 @@ var init_AgentTool = __esm(() => {
   init_coordinator();
   init_task2();
   init_localAgentTask();
+  init_shared();
+  init_backgroundTracker();
   AGENT_TOOL_INPUT_SCHEMA = {
     type: "object",
     properties: {
@@ -37311,9 +37349,9 @@ var init_AgentTool = __esm(() => {
       const allowFanOut = isCoordinatorMode() && childSpawnDepth < MAX_WORKER_SPAWN_DEPTH;
       const resolvedTools = resolveAgentTools(agentDefinition, availableTools, allowFanOut).resolvedTools;
       const agentId = "agent-" + randomUUID5();
-      if (input.run_in_background) {
+      if (shouldRunInBackground(input.run_in_background)) {
         const outputFile = getTaskOutputPath(agentId);
-        runAsyncAgentLifecycle({
+        const bgPromise = runAsyncAgentLifecycle({
           agentDefinition,
           prompt: input.prompt,
           tools: resolvedTools,
@@ -37333,6 +37371,7 @@ var init_AgentTool = __esm(() => {
             error: err instanceof Error ? err.message : String(err)
           });
         });
+        trackBackgroundAgent(bgPromise);
         return {
           data: {
             status: "async_launched",
@@ -51681,6 +51720,7 @@ var init_agent = __esm(() => {
   init_forkSubagent();
   init_agentToolUtils();
   init_prompt();
+  init_backgroundTracker();
 });
 
 // src/engine/tools/bash/bashPrompt.ts
@@ -86946,6 +86986,7 @@ async function runHeadless(inputPrompt, options) {
     }
     cronScheduler.stop();
     await drainToOutput();
+    await drainPendingBackgroundAgents(abortController.signal);
   } catch (error) {
     cronScheduler.stop();
     logForDebugging2(headlessErrorLine(error), { level: "error" });
@@ -180344,6 +180385,7 @@ __export(exports_engineCompat, {
   dequeueAllMatching: () => dequeueAllMatching,
   dequeuePendingNotification: () => dequeuePendingNotification,
   doesMessageExistInSession: () => doesMessageExistInSession,
+  drainPendingBackgroundAgents: () => drainPendingBackgroundAgents,
   drainPendingMessages: () => drainPendingMessages,
   drainSdkEvents: () => drainSdkEvents,
   emitTaskTerminatedSdk: () => emitTaskTerminatedSdk,
@@ -180511,6 +180553,7 @@ __export(exports_engineCompat, {
   hasForegroundTasks: () => hasForegroundTasks,
   hasMetInitializationThreshold: () => hasMetInitializationThreshold,
   hasMetUpdateThreshold: () => hasMetUpdateThreshold,
+  hasPendingBackgroundAgents: () => hasPendingBackgroundAgents,
   hasPendingNotifications: () => hasPendingNotifications,
   hasSessionMessagesCache: () => hasSessionMessagesCache,
   hasWorkingInProcessTeammates: () => hasWorkingInProcessTeammates,
@@ -180693,6 +180736,7 @@ __export(exports_engineCompat, {
   renderableSearchText: () => renderableSearchText,
   reportAutoCompactCircuitFailures: () => reportAutoCompactCircuitFailures,
   resetAutoCompactCircuitForTesting: () => resetAutoCompactCircuitForTesting,
+  resetBackgroundAgentTracker: () => resetBackgroundAgentTracker,
   resetBuiltinCommandNamesSourceForTesting: () => resetBuiltinCommandNamesSourceForTesting,
   resetCheckInState: () => resetCheckInState,
   resetCommandQueue: () => resetCommandQueue,
@@ -180801,6 +180845,7 @@ __export(exports_engineCompat, {
   tokenCountWithEstimation: () => tokenCountWithEstimation,
   toolResultSearchText: () => toolResultSearchText,
   toolUseSearchText: () => toolUseSearchText,
+  trackBackgroundAgent: () => trackBackgroundAgent,
   truncateHeadForPTLRetry: () => truncateHeadForPTLRetry,
   tryAcquireSchedulerLock: () => tryAcquireSchedulerLock,
   tryReactiveCompact: () => tryReactiveCompact,
@@ -276301,8 +276346,8 @@ ${whenNotToUseSection}
 Usage notes:
 - Always include a short description (3-5 words) summarizing what the agent will do${concurrencyNote}
 - When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.${!isEnvTruthy2(process.env.ATLAS_DISABLE_BACKGROUND_TASKS) && !isInProcessTeammate3() && !forkEnabled ? `
-- You can optionally run agents in the background using the run_in_background parameter. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead.
-- **Foreground vs background**: Use foreground (default) when you need the agent's results before you can proceed — e.g., research agents whose findings inform your next steps. Use background when you have genuinely independent work to do in parallel.` : ""}
+- Agents run in the background by default. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead.
+- **Foreground vs background**: Agents run in the background by default. Use foreground (set run_in_background to false) when you need the agent's results before you can proceed — e.g., research agents whose findings inform your next steps. Use background when you have genuinely independent work to do in parallel.` : ""}
 - To continue a previously spawned agent, use ${SEND_MESSAGE_TOOL_NAME3} 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."}
 - 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"}
@@ -276327,6 +276372,15 @@ var init_prompt13 = __esm(() => {
 });
 
 // src/tui/tools/AgentTool/AgentTool.ts
+function isAgentBackgroundByDefault2() {
+  return !isEnvTruthy2(process.env.ATLAS_AGENT_DEFAULT_FOREGROUND);
+}
+function shouldRunInBackground2(runInBg) {
+  if (isAgentBackgroundByDefault2()) {
+    return runInBg !== false;
+  }
+  return !!runInBg;
+}
 function resolveAgentDefinition2(subagentType, agents) {
   if (!subagentType)
     return GENERAL_PURPOSE_AGENT2;
@@ -276359,6 +276413,7 @@ var init_AgentTool2 = __esm(() => {
   init_prompt13();
   init_runAgent2();
   init_UI9();
+  init_envUtils2();
   inputSchema13 = lazySchema2(() => object({
     description: string2().describe("A short (3-5 word) description of the task"),
     prompt: string2().describe("The task for the agent to perform"),
@@ -276428,7 +276483,7 @@ var init_AgentTool2 = __esm(() => {
     },
     async call(args, context, canUseTool, parentMessage, onProgress) {
       const agents = getBuiltInAgents2();
-      const isAsync = !!args.run_in_background;
+      const isAsync = shouldRunInBackground2(args.run_in_background);
       const agentId = createAgentId(args.description);
       const parentModel = context && context.options && (context.options.mainLoopModel || context.options.model) || "small";
       logForDebugging3("[AGENT] launching agent, type=" + (args.subagent_type ?? (isForkSubagentEnabled2() ? "fork" : "general-purpose")));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlasharness/atlascode",
-  "version": "0.1.65",
+  "version": "0.1.66",
   "description": "AtlasCode \u2014 Coding Agent for the domestic computing ecosystem (Ascend NPU + domestic LLM backends)",
   "bin": {
     "atlas": "dist/cli.js",