@within-7/minto 0.3.0 → 0.3.4

package/dist/tools/TaskGetTool/prompt.js

@@ -0,0 +1,28 @@
+const PROMPT = `Use this tool to retrieve a task by its ID from the task list.
+
+## When to Use This Tool
+
+- When you need the full description and context before starting work on a task
+- To understand task dependencies (what it blocks, what blocks it)
+- After being assigned a task, to get complete requirements
+
+## Output
+
+Returns full task details:
+- **subject**: Task title
+- **description**: Detailed requirements and context
+- **status**: 'pending', 'in_progress', or 'completed'
+- **blocks**: Tasks waiting on this one to complete
+- **blockedBy**: Tasks that must complete before this one can start
+
+## Tips
+
+- After fetching a task, verify its blockedBy list is empty before beginning work.
+- Use TaskList to see all tasks in summary form.
+`;
+const DESCRIPTION = "Get full details of a task by its ID";
+export {
+  DESCRIPTION,
+  PROMPT
+};
+//# sourceMappingURL=prompt.js.map

package/dist/tools/TaskGetTool/prompt.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/TaskGetTool/prompt.ts"],
+  "sourcesContent": ["export const PROMPT = `Use this tool to retrieve a task by its ID from the task list.\n\n## When to Use This Tool\n\n- When you need the full description and context before starting work on a task\n- To understand task dependencies (what it blocks, what blocks it)\n- After being assigned a task, to get complete requirements\n\n## Output\n\nReturns full task details:\n- **subject**: Task title\n- **description**: Detailed requirements and context\n- **status**: 'pending', 'in_progress', or 'completed'\n- **blocks**: Tasks waiting on this one to complete\n- **blockedBy**: Tasks that must complete before this one can start\n\n## Tips\n\n- After fetching a task, verify its blockedBy list is empty before beginning work.\n- Use TaskList to see all tasks in summary form.\n`\n\nexport const DESCRIPTION = 'Get full details of a task by its ID'\n"],
+  "mappings": "AAAO,MAAM,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuBf,MAAM,cAAc;",
+  "names": []
+}

package/dist/tools/TaskListTool/TaskListTool.js

@@ -0,0 +1,102 @@
+import { Box, Text } from "ink";
+import * as React from "react";
+import { z } from "zod";
+import { FallbackToolUseRejectedMessage } from "../../components/FallbackToolUseRejectedMessage.js";
+import { getTaskList, getTaskStatistics } from "../../services/taskStore.js";
+import { DESCRIPTION, PROMPT } from "./prompt.js";
+import { getTheme } from "../../utils/theme.js";
+const inputSchema = z.strictObject({});
+const TaskListTool = {
+  name: "TaskList",
+  async description() {
+    return DESCRIPTION;
+  },
+  async prompt() {
+    return PROMPT;
+  },
+  inputSchema,
+  userFacingName() {
+    return "List Tasks";
+  },
+  async isEnabled() {
+    return true;
+  },
+  isReadOnly() {
+    return true;
+  },
+  isConcurrencySafe() {
+    return true;
+  },
+  needsPermissions() {
+    return false;
+  },
+  renderToolUseMessage() {
+    return "";
+  },
+  renderToolUseRejectedMessage() {
+    return /* @__PURE__ */ React.createElement(FallbackToolUseRejectedMessage, null);
+  },
+  renderToolResultMessage(output) {
+    if (!output || !output.tasks) {
+      return /* @__PURE__ */ React.createElement(Box, { flexDirection: "row" }, /* @__PURE__ */ React.createElement(Text, null, "\xA0\xA0\u23BF \xA0"), /* @__PURE__ */ React.createElement(Text, null, "No tasks found"));
+    }
+    const { tasks, stats } = output;
+    if (tasks.length === 0) {
+      return /* @__PURE__ */ React.createElement(Box, { flexDirection: "row" }, /* @__PURE__ */ React.createElement(Text, null, "\xA0\xA0\u23BF \xA0"), /* @__PURE__ */ React.createElement(Text, { color: getTheme().secondaryText }, "No tasks in list"));
+    }
+    return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column" }, /* @__PURE__ */ React.createElement(Box, { flexDirection: "row" }, /* @__PURE__ */ React.createElement(Text, null, "\xA0\xA0\u23BF \xA0"), /* @__PURE__ */ React.createElement(Text, null, stats.total, " task(s): ", stats.pending, " pending, ", stats.inProgress, " ", "in progress, ", stats.completed, " completed")), tasks.slice(0, 5).map((task) => {
+      const statusColor = task.status === "completed" ? getTheme().success : task.status === "in_progress" ? getTheme().warning : getTheme().secondaryText;
+      return /* @__PURE__ */ React.createElement(Box, { key: task.id, flexDirection: "row", paddingLeft: 5 }, /* @__PURE__ */ React.createElement(Text, { color: statusColor }, "#", task.id), /* @__PURE__ */ React.createElement(Text, null, " "), /* @__PURE__ */ React.createElement(Text, null, task.subject.length > 40 ? task.subject.slice(0, 40) + "..." : task.subject), task.blockedBy && task.blockedBy.length > 0 && /* @__PURE__ */ React.createElement(Text, { color: getTheme().error }, " ", "(blocked by: ", task.blockedBy.join(", "), ")"));
+    }), tasks.length > 5 && /* @__PURE__ */ React.createElement(Box, { paddingLeft: 5 }, /* @__PURE__ */ React.createElement(Text, { color: getTheme().secondaryText }, "... and ", tasks.length - 5, " more")));
+  },
+  renderResultForAssistant(result) {
+    const { tasks, stats } = result;
+    if (tasks.length === 0) {
+      return "No tasks in the task list.";
+    }
+    const lines = [
+      `Task List (${stats.total} total: ${stats.pending} pending, ${stats.inProgress} in progress, ${stats.completed} completed):`,
+      ""
+    ];
+    for (const task of tasks) {
+      let line = `#${task.id} [${task.status}] ${task.subject}`;
+      if (task.owner) {
+        line += ` (owner: ${task.owner})`;
+      }
+      if (task.blockedBy && task.blockedBy.length > 0) {
+        line += ` (blocked by: ${task.blockedBy.join(", ")})`;
+      }
+      lines.push(line);
+    }
+    return lines.join("\n");
+  },
+  async *call() {
+    try {
+      const tasks = getTaskList();
+      const stats = getTaskStatistics();
+      const result = {
+        tasks,
+        stats
+      };
+      yield {
+        type: "result",
+        data: result,
+        resultForAssistant: this.renderResultForAssistant(result)
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+      yield {
+        type: "result",
+        data: {
+          tasks: [],
+          stats: { total: 0, pending: 0, inProgress: 0, completed: 0 }
+        },
+        resultForAssistant: `Error listing tasks: ${errorMessage}`
+      };
+    }
+  }
+};
+export {
+  TaskListTool
+};
+//# sourceMappingURL=TaskListTool.js.map

package/dist/tools/TaskListTool/TaskListTool.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/TaskListTool/TaskListTool.tsx"],
+  "sourcesContent": ["import { Box, Text } from 'ink'\nimport * as React from 'react'\nimport { z } from 'zod'\nimport { FallbackToolUseRejectedMessage } from '@components/FallbackToolUseRejectedMessage'\nimport { Tool } from '@tool'\nimport { getTaskList, getTaskStatistics } from '@services/taskStore'\nimport { DESCRIPTION, PROMPT } from './prompt'\nimport { getTheme } from '@utils/theme'\n\nconst inputSchema = z.strictObject({})\n\ntype TaskSummary = {\n  id: string\n  subject: string\n  status: 'pending' | 'in_progress' | 'completed'\n  owner?: string\n  blockedBy?: string[]\n}\n\ntype TaskListOutput = {\n  tasks: TaskSummary[]\n  stats: {\n    total: number\n    pending: number\n    inProgress: number\n    completed: number\n  }\n}\n\nexport const TaskListTool = {\n  name: 'TaskList',\n  async description() {\n    return DESCRIPTION\n  },\n  async prompt() {\n    return PROMPT\n  },\n  inputSchema,\n  userFacingName() {\n    return 'List Tasks'\n  },\n  async isEnabled() {\n    return true\n  },\n  isReadOnly() {\n    return true\n  },\n  isConcurrencySafe() {\n    return true\n  },\n  needsPermissions() {\n    return false\n  },\n  renderToolUseMessage() {\n    return ''\n  },\n  renderToolUseRejectedMessage() {\n    return <FallbackToolUseRejectedMessage />\n  },\n  renderToolResultMessage(output: TaskListOutput) {\n    if (!output || !output.tasks) {\n      return (\n        <Box flexDirection=\"row\">\n          <Text>&nbsp;&nbsp;\u23BF &nbsp;</Text>\n          <Text>No tasks found</Text>\n        </Box>\n      )\n    }\n\n    const { tasks, stats } = output\n\n    if (tasks.length === 0) {\n      return (\n        <Box flexDirection=\"row\">\n          <Text>&nbsp;&nbsp;\u23BF &nbsp;</Text>\n          <Text color={getTheme().secondaryText}>No tasks in list</Text>\n        </Box>\n      )\n    }\n\n    return (\n      <Box flexDirection=\"column\">\n        <Box flexDirection=\"row\">\n          <Text>&nbsp;&nbsp;\u23BF &nbsp;</Text>\n          <Text>\n            {stats.total} task(s): {stats.pending} pending, {stats.inProgress}{' '}\n            in progress, {stats.completed} completed\n          </Text>\n        </Box>\n        {tasks.slice(0, 5).map(task => {\n          const statusColor =\n            task.status === 'completed'\n              ? getTheme().success\n              : task.status === 'in_progress'\n                ? getTheme().warning\n                : getTheme().secondaryText\n\n          return (\n            <Box key={task.id} flexDirection=\"row\" paddingLeft={5}>\n              <Text color={statusColor}>#{task.id}</Text>\n              <Text> </Text>\n              <Text>\n                {task.subject.length > 40\n                  ? task.subject.slice(0, 40) + '...'\n                  : task.subject}\n              </Text>\n              {task.blockedBy && task.blockedBy.length > 0 && (\n                <Text color={getTheme().error}>\n                  {' '}\n                  (blocked by: {task.blockedBy.join(', ')})\n                </Text>\n              )}\n            </Box>\n          )\n        })}\n        {tasks.length > 5 && (\n          <Box paddingLeft={5}>\n            <Text color={getTheme().secondaryText}>\n              ... and {tasks.length - 5} more\n            </Text>\n          </Box>\n        )}\n      </Box>\n    )\n  },\n  renderResultForAssistant(result: TaskListOutput) {\n    const { tasks, stats } = result\n\n    if (tasks.length === 0) {\n      return 'No tasks in the task list.'\n    }\n\n    const lines: string[] = [\n      `Task List (${stats.total} total: ${stats.pending} pending, ${stats.inProgress} in progress, ${stats.completed} completed):`,\n      '',\n    ]\n\n    for (const task of tasks) {\n      let line = `#${task.id} [${task.status}] ${task.subject}`\n      if (task.owner) {\n        line += ` (owner: ${task.owner})`\n      }\n      if (task.blockedBy && task.blockedBy.length > 0) {\n        line += ` (blocked by: ${task.blockedBy.join(', ')})`\n      }\n      lines.push(line)\n    }\n\n    return lines.join('\\n')\n  },\n  async *call() {\n    try {\n      const tasks = getTaskList()\n      const stats = getTaskStatistics()\n\n      const result: TaskListOutput = {\n        tasks,\n        stats,\n      }\n\n      yield {\n        type: 'result',\n        data: result,\n        resultForAssistant: this.renderResultForAssistant(result),\n      }\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : 'Unknown error occurred'\n      yield {\n        type: 'result',\n        data: {\n          tasks: [],\n          stats: { total: 0, pending: 0, inProgress: 0, completed: 0 },\n        },\n        resultForAssistant: `Error listing tasks: ${errorMessage}`,\n      }\n    }\n  },\n} satisfies Tool<typeof inputSchema, TaskListOutput>\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/tools/TaskListTool/prompt.js

@@ -0,0 +1,27 @@
+const PROMPT = `Use this tool to list all tasks in the task list.
+
+## When to Use This Tool
+
+- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
+- To check overall progress on the project
+- To find tasks that are blocked and need dependencies resolved
+- After completing a task, to check for newly unblocked work or claim the next available task
+- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+
+## Output
+
+Returns a summary of each task:
+- **id**: Task identifier (use with TaskGet, TaskUpdate)
+- **subject**: Brief description of the task
+- **status**: 'pending', 'in_progress', or 'completed'
+- **owner**: Agent ID if assigned, empty if available
+- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+
+Use TaskGet with a specific task ID to view full details including description and comments.
+`;
+const DESCRIPTION = "List all tasks in the task list";
+export {
+  DESCRIPTION,
+  PROMPT
+};
+//# sourceMappingURL=prompt.js.map

package/dist/tools/TaskListTool/prompt.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/TaskListTool/prompt.ts"],
+  "sourcesContent": ["export const PROMPT = `Use this tool to list all tasks in the task list.\n\n## When to Use This Tool\n\n- To see what tasks are available to work on (status: 'pending', no owner, not blocked)\n- To check overall progress on the project\n- To find tasks that are blocked and need dependencies resolved\n- After completing a task, to check for newly unblocked work or claim the next available task\n- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones\n\n## Output\n\nReturns a summary of each task:\n- **id**: Task identifier (use with TaskGet, TaskUpdate)\n- **subject**: Brief description of the task\n- **status**: 'pending', 'in_progress', or 'completed'\n- **owner**: Agent ID if assigned, empty if available\n- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)\n\nUse TaskGet with a specific task ID to view full details including description and comments.\n`\n\nexport const DESCRIPTION = 'List all tasks in the task list'\n"],
+  "mappings": "AAAO,MAAM,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBf,MAAM,cAAc;",
+  "names": []
+}

package/dist/tools/TaskStopTool/TaskStopTool.js

@@ -0,0 +1,150 @@
+import { Box, Text } from "ink";
+import React from "react";
+import { z } from "zod";
+import { DESCRIPTION, PROMPT, TOOL_NAME } from "./prompt.js";
+import { BackgroundShellManager } from "../../utils/BackgroundShellManager.js";
+import {
+  getAgentTranscript,
+  interruptAgentTranscript
+} from "../../utils/agentTranscripts.js";
+import { SEMANTIC_COLORS } from "../../constants/colors.js";
+const inputSchema = z.strictObject({
+  task_id: z.string().describe("The ID of the background task to stop"),
+  shell_id: z.string().optional().describe("Deprecated: use task_id instead")
+});
+const TaskStopTool = {
+  name: TOOL_NAME,
+  async description() {
+    return DESCRIPTION;
+  },
+  userFacingName() {
+    return "Task Stop";
+  },
+  inputSchema,
+  isReadOnly() {
+    return false;
+  },
+  isConcurrencySafe() {
+    return true;
+  },
+  async isEnabled() {
+    return true;
+  },
+  needsPermissions() {
+    return false;
+  },
+  async prompt() {
+    return PROMPT;
+  },
+  renderToolUseMessage(input) {
+    const taskId = input.task_id || input.shell_id || "";
+    return `task_id: "${taskId}"`;
+  },
+  renderToolUseRejectedMessage() {
+    return /* @__PURE__ */ React.createElement(Box, { paddingLeft: 2 }, /* @__PURE__ */ React.createElement(Text, { color: SEMANTIC_COLORS.dim }, "Task stop request rejected"));
+  },
+  renderToolResultMessage(output) {
+    if (!output) {
+      return /* @__PURE__ */ React.createElement(Box, { paddingLeft: 2 }, /* @__PURE__ */ React.createElement(Text, null, "Task stop completed"));
+    }
+    const statusColor = output.success ? "green" : "red";
+    return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column", paddingLeft: 2 }, /* @__PURE__ */ React.createElement(Box, { flexDirection: "row" }, /* @__PURE__ */ React.createElement(Text, null, output.task_type === "agent" ? "Agent" : "Task", " "), /* @__PURE__ */ React.createElement(Text, { bold: true }, output.task_id), /* @__PURE__ */ React.createElement(Text, null, ": "), /* @__PURE__ */ React.createElement(Text, { color: statusColor }, output.success ? "stopped" : "failed")), !output.success && /* @__PURE__ */ React.createElement(Box, { marginTop: 1 }, /* @__PURE__ */ React.createElement(Text, { color: SEMANTIC_COLORS.dim }, output.message)));
+  },
+  renderResultForAssistant(output) {
+    return output.message;
+  },
+  async *call(input, _context) {
+    const taskId = input.task_id || input.shell_id;
+    if (!taskId) {
+      const output2 = {
+        success: false,
+        message: "Error: No task_id provided",
+        task_id: "",
+        task_type: "unknown"
+      };
+      yield {
+        type: "result",
+        data: output2,
+        resultForAssistant: this.renderResultForAssistant(output2)
+      };
+      return;
+    }
+    const transcript = getAgentTranscript(taskId);
+    if (transcript) {
+      if (transcript.status !== "running") {
+        const output3 = {
+          success: false,
+          message: `Error: Agent '${taskId}' is already ${transcript.status}`,
+          task_id: taskId,
+          task_type: "agent"
+        };
+        yield {
+          type: "result",
+          data: output3,
+          resultForAssistant: this.renderResultForAssistant(output3)
+        };
+        return;
+      }
+      const updated = interruptAgentTranscript(taskId);
+      const success = updated !== null && updated.status === "interrupted";
+      const output2 = {
+        success,
+        message: success ? `Successfully stopped agent '${taskId}'` : `Failed to stop agent '${taskId}'`,
+        task_id: taskId,
+        task_type: "agent"
+      };
+      yield {
+        type: "result",
+        data: output2,
+        resultForAssistant: this.renderResultForAssistant(output2)
+      };
+      return;
+    }
+    const manager = BackgroundShellManager.getInstance();
+    const shell = manager.get(taskId);
+    if (!shell) {
+      const output2 = {
+        success: false,
+        message: `Error: No task found with ID '${taskId}'. This could be a background shell or agent ID.`,
+        task_id: taskId,
+        task_type: "unknown"
+      };
+      yield {
+        type: "result",
+        data: output2,
+        resultForAssistant: this.renderResultForAssistant(output2)
+      };
+      return;
+    }
+    if (shell.status !== "running") {
+      const output2 = {
+        success: false,
+        message: `Error: Task '${taskId}' is already ${shell.status}`,
+        task_id: taskId,
+        task_type: "shell"
+      };
+      yield {
+        type: "result",
+        data: output2,
+        resultForAssistant: this.renderResultForAssistant(output2)
+      };
+      return;
+    }
+    const killed = manager.kill(taskId);
+    const output = {
+      success: killed,
+      message: killed ? `Successfully stopped background task '${taskId}'` : `Failed to stop background task '${taskId}'`,
+      task_id: taskId,
+      task_type: "shell"
+    };
+    yield {
+      type: "result",
+      data: output,
+      resultForAssistant: this.renderResultForAssistant(output)
+    };
+  }
+};
+export {
+  TaskStopTool
+};
+//# sourceMappingURL=TaskStopTool.js.map

package/dist/tools/TaskStopTool/TaskStopTool.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/TaskStopTool/TaskStopTool.tsx"],
+  "sourcesContent": ["/**\n * Task Stop Tool\n *\n * Stops a running background task by its ID.\n * Supports both background shell commands and agent tasks.\n */\n\nimport { Box, Text } from 'ink'\nimport React from 'react'\nimport { z } from 'zod'\nimport { Tool } from '@tool'\nimport { DESCRIPTION, PROMPT, TOOL_NAME } from './prompt'\nimport { BackgroundShellManager } from '@utils/BackgroundShellManager'\nimport {\n  getAgentTranscript,\n  interruptAgentTranscript,\n} from '@utils/agentTranscripts'\nimport { SEMANTIC_COLORS } from '@constants/colors'\n\nconst inputSchema = z.strictObject({\n  task_id: z.string().describe('The ID of the background task to stop'),\n  shell_id: z.string().optional().describe('Deprecated: use task_id instead'),\n})\n\ntype Output = {\n  success: boolean\n  message: string\n  task_id: string\n  task_type: 'shell' | 'agent' | 'unknown'\n}\n\nexport const TaskStopTool = {\n  name: TOOL_NAME,\n  async description() {\n    return DESCRIPTION\n  },\n  userFacingName() {\n    return 'Task Stop'\n  },\n  inputSchema,\n  isReadOnly() {\n    return false\n  },\n  isConcurrencySafe() {\n    return true\n  },\n  async isEnabled() {\n    return true\n  },\n  needsPermissions() {\n    return false // Stopping tasks doesn't require user permission\n  },\n  async prompt() {\n    return PROMPT\n  },\n  renderToolUseMessage(input: z.infer<typeof inputSchema>) {\n    const taskId = input.task_id || input.shell_id || ''\n    return `task_id: \"${taskId}\"`\n  },\n  renderToolUseRejectedMessage() {\n    return (\n      <Box paddingLeft={2}>\n        <Text color={SEMANTIC_COLORS.dim}>Task stop request rejected</Text>\n      </Box>\n    )\n  },\n  renderToolResultMessage(output: Output) {\n    if (!output) {\n      return (\n        <Box paddingLeft={2}>\n          <Text>Task stop completed</Text>\n        </Box>\n      )\n    }\n\n    const statusColor = output.success ? 'green' : 'red'\n\n    return (\n      <Box flexDirection=\"column\" paddingLeft={2}>\n        <Box flexDirection=\"row\">\n          <Text>{output.task_type === 'agent' ? 'Agent' : 'Task'} </Text>\n          <Text bold>{output.task_id}</Text>\n          <Text>: </Text>\n          <Text color={statusColor}>\n            {output.success ? 'stopped' : 'failed'}\n          </Text>\n        </Box>\n        {!output.success && (\n          <Box marginTop={1}>\n            <Text color={SEMANTIC_COLORS.dim}>{output.message}</Text>\n          </Box>\n        )}\n      </Box>\n    )\n  },\n  renderResultForAssistant(output: Output) {\n    return output.message\n  },\n  async *call(input: z.infer<typeof inputSchema>, _context: any) {\n    // Support deprecated shell_id parameter\n    const taskId = input.task_id || input.shell_id\n\n    if (!taskId) {\n      const output: Output = {\n        success: false,\n        message: 'Error: No task_id provided',\n        task_id: '',\n        task_type: 'unknown',\n      }\n      yield {\n        type: 'result',\n        data: output,\n        resultForAssistant: this.renderResultForAssistant(output),\n      }\n      return\n    }\n\n    // First, check if this is an agent transcript\n    const transcript = getAgentTranscript(taskId)\n    if (transcript) {\n      // Handle agent transcript\n      if (transcript.status !== 'running') {\n        const output: Output = {\n          success: false,\n          message: `Error: Agent '${taskId}' is already ${transcript.status}`,\n          task_id: taskId,\n          task_type: 'agent',\n        }\n        yield {\n          type: 'result',\n          data: output,\n          resultForAssistant: this.renderResultForAssistant(output),\n        }\n        return\n      }\n\n      // Interrupt the agent\n      const updated = interruptAgentTranscript(taskId)\n      const success = updated !== null && updated.status === 'interrupted'\n\n      const output: Output = {\n        success,\n        message: success\n          ? `Successfully stopped agent '${taskId}'`\n          : `Failed to stop agent '${taskId}'`,\n        task_id: taskId,\n        task_type: 'agent',\n      }\n\n      yield {\n        type: 'result',\n        data: output,\n        resultForAssistant: this.renderResultForAssistant(output),\n      }\n      return\n    }\n\n    // Fall back to background shell\n    const manager = BackgroundShellManager.getInstance()\n    const shell = manager.get(taskId)\n\n    if (!shell) {\n      const output: Output = {\n        success: false,\n        message: `Error: No task found with ID '${taskId}'. This could be a background shell or agent ID.`,\n        task_id: taskId,\n        task_type: 'unknown',\n      }\n      yield {\n        type: 'result',\n        data: output,\n        resultForAssistant: this.renderResultForAssistant(output),\n      }\n      return\n    }\n\n    if (shell.status !== 'running') {\n      const output: Output = {\n        success: false,\n        message: `Error: Task '${taskId}' is already ${shell.status}`,\n        task_id: taskId,\n        task_type: 'shell',\n      }\n      yield {\n        type: 'result',\n        data: output,\n        resultForAssistant: this.renderResultForAssistant(output),\n      }\n      return\n    }\n\n    // Kill the shell\n    const killed = manager.kill(taskId)\n\n    const output: Output = {\n      success: killed,\n      message: killed\n        ? `Successfully stopped background task '${taskId}'`\n        : `Failed to stop background task '${taskId}'`,\n      task_id: taskId,\n      task_type: 'shell',\n    }\n\n    yield {\n      type: 'result',\n      data: output,\n      resultForAssistant: this.renderResultForAssistant(output),\n    }\n  },\n} satisfies Tool<typeof inputSchema, Output>\n"],
+  "mappings": "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",
+  "names": ["output"]
+}

package/dist/tools/TaskStopTool/prompt.js

@@ -0,0 +1,15 @@
+const TOOL_NAME = "TaskStop";
+const DESCRIPTION = `Stops a running background task by its ID`;
+const PROMPT = `- Stops a running background task by its ID
+- Takes a task_id parameter identifying the task to stop
+- Returns a success or failure status
+- Use this tool when you need to terminate a long-running task
+- Task IDs can be obtained from BashTool when run_in_background is true, or from Task tool for agent tasks
+- Can only stop tasks that are currently running (not already completed or stopped)
+- Works with both background shells and agent tasks`;
+export {
+  DESCRIPTION,
+  PROMPT,
+  TOOL_NAME
+};
+//# sourceMappingURL=prompt.js.map

package/dist/tools/TaskStopTool/prompt.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/tools/TaskStopTool/prompt.ts"],
+  "sourcesContent": ["export const TOOL_NAME = 'TaskStop'\n\nexport const DESCRIPTION = `Stops a running background task by its ID`\n\nexport const PROMPT = `- Stops a running background task by its ID\n- Takes a task_id parameter identifying the task to stop\n- Returns a success or failure status\n- Use this tool when you need to terminate a long-running task\n- Task IDs can be obtained from BashTool when run_in_background is true, or from Task tool for agent tasks\n- Can only stop tasks that are currently running (not already completed or stopped)\n- Works with both background shells and agent tasks`\n"],
+  "mappings": "AAAO,MAAM,YAAY;AAElB,MAAM,cAAc;AAEpB,MAAM,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/tools/TaskTool/TaskTool.js

@@ -55,11 +55,17 @@ const inputSchema = z.object({
   model_name: z.string().optional().describe(
     "Optional: Specific model name to use for this task. If not provided, uses the default task model pointer."
   ),
+  model: z.enum(["sonnet", "opus", "haiku"]).optional().describe(
+    "Optional model hint for this agent. Maps to configured model pointers: sonnet\u2192main, opus\u2192reasoning, haiku\u2192quick. If not specified, uses the task model pointer. Prefer haiku for quick, straightforward tasks."
+  ),
   subagent_type: z.string().optional().describe(
     'The specialized agent type to use. MUST be an exact name from the available agents list in the tool description. Defaults to "general-purpose" if not specified.'
   ),
   resume: z.string().optional().describe(
     "Optional agent ID to resume from. If provided, the agent will continue from the previous execution transcript."
+  ),
+  max_turns: z.number().int().positive().optional().describe(
+    "Maximum number of agentic turns (API round-trips) before stopping. Used internally for warmup."
   )
   // run_in_background parameter removed - concurrent execution is automatic
 });
@@ -74,7 +80,15 @@ const TaskTool = {
     return `Launch a specialized agent to handle tasks autonomously. You MUST use an exact agent type name from this list: ${typesList}. Default to "general-purpose" if unsure.`;
   },
   inputSchema,
-  async *call({ description, prompt, model_name, subagent_type, resume }, {
+  async *call({
+    description,
+    prompt,
+    model_name,
+    model,
+    subagent_type,
+    resume,
+    max_turns
+  }, {
     abortController,
     options: { safeMode = false, forkNumber, messageLogName, verbose },
     readFileTimestamps,
@@ -147,6 +161,22 @@ ${prompt}`;
       }
       toolFilter = agentConfig.tools;
     }
+    if (model) {
+      const modelPointerMap = {
+        sonnet: "main",
+        // Use main model for standard tasks
+        opus: "reasoning",
+        // Use reasoning model for complex tasks
+        haiku: "quick"
+        // Use quick model for fast tasks
+      };
+      const pointerType = modelPointerMap[model] || "task";
+      const modelManager = getModelManager();
+      const resolvedModelName = modelManager.getModelName(pointerType);
+      if (resolvedModelName) {
+        effectiveModel = resolvedModelName;
+      }
+    }
     const messages = resumedTranscript ? [...resumedTranscript.messages] : [createUserMessage(effectivePrompt)];
     let tools = await getTaskTools(safeMode);
     if (toolFilter) {
@@ -249,6 +279,7 @@ IMPORTANT: You are currently running as ${modelToUse}. You do not need to consul
       queryOptions["temperature"] = temperature;
     }
     pushAgentContext(agentId);
+    let turnCount = 0;
     try {
       for await (const message of query(
         messages,
@@ -275,6 +306,15 @@ IMPORTANT: You are currently running as ${modelToUse}. You do not need to consul
         if (message.type !== "assistant") {
           continue;
         }
+        turnCount++;
+        if (max_turns && turnCount >= max_turns) {
+          debugLogger.info("TASK_AGENT_MAX_TURNS_REACHED", {
+            agentId,
+            turnCount,
+            max_turns
+          });
+          break;
+        }
         if (message.message.usage) {
           updateAgentTranscript(agentId, {
             tokenUsage: {