@atlasharness/atlascode 0.1.64 → 0.1.65

package/dist/cli.js

@@ -37092,9 +37092,9 @@ 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. " + `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. " + "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:
 ${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.";
+` + `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.";
 }
 var init_prompt = () => {};
 
@@ -37136,9 +37136,72 @@ async function runAgent(args) {
     turns: loopResult.turns
   };
 }
+function wrapPermissionGateForBackground(gate, onNeedsInput) {
+  if (!gate)
+    return;
+  return async (tool, input, callContext) => {
+    const verdict = await gate(tool, input, callContext);
+    if (verdict.ask) {
+      onNeedsInput({
+        toolName: tool.name,
+        reason: verdict.reason
+      });
+    }
+    return verdict;
+  };
+}
+async function runAsyncAgentLifecycle(args) {
+  const { description, toolUseId, signal, agentId } = args;
+  const wrappedCheckPermission = wrapPermissionGateForBackground(args.checkPermission, (req) => {
+    enqueueAgentNotification({
+      taskId: agentId,
+      description,
+      status: "needs_input",
+      inputRequest: `Permission required for ${req.toolName}${req.reason ? `: ${req.reason}` : ""}`,
+      ...toolUseId ? { toolUseId } : {}
+    });
+  });
+  try {
+    const { result } = await runAgent({
+      ...args,
+      checkPermission: wrappedCheckPermission
+    });
+    const finalMessage = result.content.map((b) => b.text).join("");
+    enqueueAgentNotification({
+      taskId: agentId,
+      description,
+      status: "completed",
+      finalMessage: finalMessage || undefined,
+      usage: {
+        totalTokens: result.totalTokens,
+        toolUses: result.totalToolUseCount,
+        durationMs: result.totalDurationMs
+      },
+      ...toolUseId ? { toolUseId } : {}
+    });
+  } catch (err) {
+    if (signal?.aborted) {
+      enqueueAgentNotification({
+        taskId: agentId,
+        description,
+        status: "killed",
+        ...toolUseId ? { toolUseId } : {}
+      });
+      return;
+    }
+    enqueueAgentNotification({
+      taskId: agentId,
+      description,
+      status: "failed",
+      error: err instanceof Error ? err.message : String(err),
+      ...toolUseId ? { toolUseId } : {}
+    });
+  }
+}
 var init_runAgent = __esm(() => {
   init_query2();
   init_agentToolUtils();
+  init_localAgentTask();
 });
 
 // src/engine/tools/agent/AgentTool.ts
@@ -37164,6 +37227,8 @@ var init_AgentTool = __esm(() => {
   init_prompt();
   init_runAgent();
   init_coordinator();
+  init_task2();
+  init_localAgentTask();
   AGENT_TOOL_INPUT_SCHEMA = {
     type: "object",
     properties: {
@@ -37182,6 +37247,10 @@ var init_AgentTool = __esm(() => {
       model: {
         enum: ["small", "premium", "fast"],
         description: "Optional model override for this agent. Takes precedence over the agent definition's model. If omitted, inherits from the parent."
+      },
+      run_in_background: {
+        type: "boolean",
+        description: "Set to true to run this agent in the background. You will be notified when it completes."
       }
     },
     required: ["description", "prompt"]
@@ -37218,6 +37287,13 @@ var init_AgentTool = __esm(() => {
 ` + text
         };
       }
+      if (c && c.status === "async_launched") {
+        return {
+          type: "tool_result",
+          tool_use_id: toolUseID,
+          content: "[agent launched in background] agentId=" + (c.agentId ?? "") + " output=" + (c.outputFile ?? "")
+        };
+      }
       return {
         type: "tool_result",
         tool_use_id: toolUseID,
@@ -37235,6 +37311,38 @@ 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) {
+        const outputFile = getTaskOutputPath(agentId);
+        runAsyncAgentLifecycle({
+          agentDefinition,
+          prompt: input.prompt,
+          tools: resolvedTools,
+          modelProvider,
+          parentRole,
+          overrideRole: input.model,
+          agentId,
+          spawnDepth: childSpawnDepth,
+          signal: ctx.signal,
+          checkPermission: ctx.checkPermission,
+          description: input.description
+        }).catch((err) => {
+          enqueueAgentNotification({
+            taskId: agentId,
+            description: input.description,
+            status: "failed",
+            error: err instanceof Error ? err.message : String(err)
+          });
+        });
+        return {
+          data: {
+            status: "async_launched",
+            agentId,
+            description: input.description,
+            prompt: input.prompt,
+            outputFile
+          }
+        };
+      }
       const { result } = await runAgent({
         agentDefinition,
         prompt: input.prompt,
@@ -79621,24 +79729,27 @@ function enqueueAgentNotification({
   usage,
   toolUseId,
   worktreePath,
-  worktreeBranch
+  worktreeBranch,
+  inputRequest
 }) {
-  let shouldEnqueue = false;
-  updateTaskState(taskId, setAppState, (task) => {
-    if (task.notified) {
-      return task;
+  if (setAppState && status !== "needs_input") {
+    let shouldEnqueue = false;
+    updateTaskState(taskId, setAppState, (task) => {
+      if (task.notified) {
+        return task;
+      }
+      shouldEnqueue = true;
+      return {
+        ...task,
+        notified: true
+      };
+    });
+    if (!shouldEnqueue) {
+      return;
     }
-    shouldEnqueue = true;
-    return {
-      ...task,
-      notified: true
-    };
-  });
-  if (!shouldEnqueue) {
-    return;
   }
   const escapedDescription = escapeXml(description);
-  const summary = status === "completed" ? `Agent "${escapedDescription}" completed` : status === "failed" ? `Agent "${escapedDescription}" failed: ${escapeXml(error || "Unknown error")}` : `Agent "${escapedDescription}" was stopped`;
+  const summary = status === "completed" ? `Agent "${escapedDescription}" completed` : status === "failed" ? `Agent "${escapedDescription}" failed: ${escapeXml(error || "Unknown error")}` : status === "killed" ? `Agent "${escapedDescription}" was stopped` : status === "needs_input" ? `Agent "${escapedDescription}" needs input: ${escapeXml(inputRequest || "Permission request or question pending")}` : `Agent "${escapedDescription}" ${escapeXml(status)}`;
   const outputPath = getTaskOutputPath(taskId);
   const toolUseIdLine = toolUseId ? `
 <${TOOL_USE_ID_TAG}>${escapeXml(toolUseId)}</${TOOL_USE_ID_TAG}>` : "";
@@ -180621,6 +180732,7 @@ __export(exports_engineCompat, {
   roughTokenCountEstimationForContent: () => roughTokenCountEstimationForContent,
   roughTokenCountEstimationForMessages: () => roughTokenCountEstimationForMessages,
   runAgent: () => runAgent,
+  runAsyncAgentLifecycle: () => runAsyncAgentLifecycle,
   runCleanupFunctions: () => runCleanupFunctions2,
   runHooksStream: () => runHooksStream,
   runPostCompactCleanup: () => runPostCompactCleanup,
@@ -180712,6 +180824,7 @@ __export(exports_engineCompat, {
   waitForSessionMemoryExtraction: () => waitForSessionMemoryExtraction,
   waitForTeammatesToBecomeIdle: () => waitForTeammatesToBecomeIdle,
   worktreeBranchName: () => worktreeBranchName,
+  wrapPermissionGateForBackground: () => wrapPermissionGateForBackground,
   writeCronTasks: () => writeCronTasks,
   writeToMailbox: () => writeToMailbox
 });
@@ -275861,7 +275974,7 @@ function extractPartialResult(messages) {
   }
   return;
 }
-async function runAsyncAgentLifecycle({
+async function runAsyncAgentLifecycle2({
   taskId,
   abortController,
   makeStream,
@@ -311132,7 +311245,7 @@ async function resumeAgentBackground({
     invocationEmitted: false
   };
   const wrapWithCwd = (fn) => resumedWorktreePath ? runWithCwdOverride(resumedWorktreePath, fn) : fn();
-  runWithAgentContext(asyncAgentContext, () => wrapWithCwd(() => runAsyncAgentLifecycle({
+  runWithAgentContext(asyncAgentContext, () => wrapWithCwd(() => runAsyncAgentLifecycle2({
     taskId: agentBackgroundTask.agentId,
     abortController: agentBackgroundTask.abortController,
     makeStream: (onCacheSafeParams) => runAgent2({
@@ -321060,6 +321173,10 @@ function buildAgentLoopParams(m) {
       toolUseContext: m.toolUseContext
     }),
     toolContext: m.toolUseContext,
+    hasPendingBackgroundTasks: () => {
+      const tasks = m.toolUseContext?.getAppState?.()?.tasks;
+      return tasks ? hasNonTerminalTasks(tasks) : false;
+    },
     hooks: createLoopHooks({
       options: {
         sessionId: getSessionId(),
@@ -321091,6 +321208,7 @@ function buildAgentLoopParams(m) {
 var init_agentLoopDeps = __esm(() => {
   init_modelprovider2();
   init_engine();
+  init_Task();
   init_settings3();
   init_shared();
   init_bootstrap();
@@ -425283,6 +425401,9 @@ import { randomBytes as randomBytes22 } from "crypto";
 function isTerminalTaskStatus2(status) {
   return status === "completed" || status === "failed" || status === "killed";
 }
+function hasNonTerminalTasks(tasks) {
+  return Object.values(tasks).some((t) => !isTerminalTaskStatus2(t.status));
+}
 function getTaskIdPrefix(type) {
   return TASK_ID_PREFIXES[type] ?? "x";
 }

package/package.json

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