@agentuity/opencode 1.0.18 → 1.0.20

package/src/plugin/hooks/compaction-utils.ts

@@ -70,13 +70,12 @@ export function buildCustomCompactionPrompt(mode: 'cadence' | 'regular'): string
 
 ## CRITICAL — Preserve These Verbatim
 1. The current task/objective (quote the user's original request exactly)
-2. All background task IDs (bg_xxx) with status, purpose, and session IDs
-3. Active planning state: current phase, completed phases, next steps, blockers
-4. ALL file paths being actively worked on (with role: created/modified/read)
-5. Key decisions made and their rationale
-6. Any corrections or gotchas discovered during the session
-7. Todo list state (what's done, in progress, pending)
-8. Descriptions of any images or attachments that appeared in conversation${cadenceSection}
+2. Active planning state: current phase, completed phases, next steps, blockers
+3. ALL file paths being actively worked on (with role: created/modified/read)
+4. Key decisions made and their rationale
+5. Any corrections or gotchas discovered during the session
+6. Todo list state (what's done, in progress, pending)
+7. Descriptions of any images or attachments that appeared in conversation${cadenceSection}
 
 ## Structure Your Summary As:
 
@@ -86,9 +85,6 @@ export function buildCustomCompactionPrompt(mode: 'cadence' | 'regular'): string
 ### Planning State
 [Phases with status. Include phase notes, not just titles.]
 
-### Background Tasks
-[bg_xxx: description → status (running/completed/errored). Include session IDs.]
-
 ### Key Context
 [Decisions, constraints, user preferences, corrections discovered]
 
@@ -104,7 +100,6 @@ export function buildCustomCompactionPrompt(mode: 'cadence' | 'regular'): string
 ## Rules
 - Use specific file paths, task IDs, phase names — NOT vague references.
 - State what tools returned, not just that they were called.
-- NEVER drop background task references — the agent MUST know what's still running.
 - Prefer completeness over brevity — this is the agent's entire working memory.`;
 }
 
@@ -267,7 +262,6 @@ export async function restoreCadenceStateFromKV(
 export function formatCompactionDiagnostics(stats: CompactionStats): string {
 	const parts: string[] = [];
 	if (stats.planningPhasesCount > 0) parts.push(`${stats.planningPhasesCount} planning phases`);
-	if (stats.backgroundTasksCount > 0) parts.push(`${stats.backgroundTasksCount} background tasks`);
 	if (stats.imageDescriptionsCount > 0) parts.push(`${stats.imageDescriptionsCount} image refs`);
 	if (stats.toolCallSummariesCount > 0) parts.push(`${stats.toolCallSummariesCount} tool calls`);
 

package/src/plugin/hooks/completion.ts

@@ -62,10 +62,8 @@ export function createCompletionHooks(ctx: PluginInput, _config: CoderConfig): C
 
 			const logLine = `Completion: agent=${start.agent} model=${start.model} duration=${durationSec}s`;
 
-			// Verbose local logging for immediate visibility
-			console.debug(`[agentuity-coder] ${logLine}`);
-
-			// Also send to the OpenCode log service
+			// Send to the OpenCode log service (never use console.* in a TUI context —
+			// raw stdout writes bypass the terminal renderer and corrupt the display)
 			ctx.client.app.log({
 				body: {
 					service: 'agentuity-coder',

package/src/plugin/hooks/params.ts

@@ -258,9 +258,6 @@ export class ModelFallbackTracker {
 			errorCode,
 			fallbackIndex,
 		});
-		console.debug(
-			`[ModelFallback] Recorded error for ${agentName}: model=${model} code=${errorCode} fallbackIndex=${fallbackIndex}`
-		);
 	}
 
 	/**

package/src/plugin/hooks/session-memory.ts

@@ -1,6 +1,5 @@
 import type { PluginInput } from '@opencode-ai/plugin';
 import type { CoderConfig } from '../../types';
-import type { BackgroundManager } from '../../background';
 import type { OpenCodeDBReader } from '../../sqlite';
 import type { CompactionStats } from '../../sqlite/types';
 import {
@@ -34,7 +33,6 @@ export interface SessionMemoryHooks {
 export function createSessionMemoryHooks(
 	ctx: PluginInput,
 	config: CoderConfig,
-	backgroundManager?: BackgroundManager,
 	dbReader?: OpenCodeDBReader
 ): SessionMemoryHooks {
 	const log = (msg: string) => {
@@ -188,40 +186,17 @@ After compaction:
 2. If planning is active, Memory should update planning.progress with this compaction
 3. Memory will apply inline reasoning if significant patterns/corrections emerged`;
 
-			// 4. Build background tasks section
-			const tasks = backgroundManager?.getTasksByParent(sessionId) ?? [];
-			let backgroundSection: string | null = null;
-
-			if (tasks.length > 0) {
-				const taskList = tasks
-					.map(
-						(t) =>
-							`- **${t.id}**: ${t.description || 'No description'} (session: ${t.sessionId ?? 'pending'}, status: ${t.status})`
-					)
-					.join('\n');
-
-				backgroundSection = `## Active Background Tasks
-
-This session has ${tasks.length} background task(s) running in separate sessions:
-${taskList}
-
-**CRITICAL:** Task IDs and session IDs persist across compaction - these tasks are still running.
-Use \`agentuity_background_output({ task_id: "..." })\` to check their status.`;
-			}
-
-			// 5. Combine everything into the full prompt
+			// 4. Combine everything into the full prompt
 			const sections: string[] = [];
 			if (instructions) sections.push(instructions);
 			sections.push(sessionStateSection);
-			if (backgroundSection) sections.push(backgroundSection);
 			if (planningState) sections.push(planningState);
 			if (imageDescs) sections.push(imageDescs);
 			if (toolSummaries) sections.push(toolSummaries);
 
-			// 6. Add diagnostics
+			// 5. Add diagnostics
 			const stats: CompactionStats = {
 				planningPhasesCount: countListItems(planningState),
-				backgroundTasksCount: tasks.length,
 				imageDescriptionsCount: countListItems(imageDescs),
 				toolCallSummariesCount: countListItems(toolSummaries),
 				estimatedTokens: Math.ceil(sections.join('\n\n').length / 4),
@@ -229,7 +204,7 @@ Use \`agentuity_background_output({ task_id: "..." })\` to check their status.`;
 			const diagnostics = formatCompactionDiagnostics(stats);
 			if (diagnostics) sections.push(diagnostics);
 
-			// 7. Enforce token budget
+			// 6. Enforce token budget
 			let fullPrompt = sections.join('\n\n');
 			const estimatedTokens = Math.ceil(fullPrompt.length / 4);
 			if (maxTokens > 0 && estimatedTokens > maxTokens) {
@@ -245,24 +220,19 @@ Use \`agentuity_background_output({ task_id: "..." })\` to check their status.`;
 				fullPrompt = trimmed.join('\n\n');
 			}
 
-			// 8. Set the full prompt or push to context
+			// 7. Set the full prompt or push to context
 			if (useCustomPrompt) {
 				output.prompt = fullPrompt;
 			} else {
 				output.context.push(fullPrompt);
 			}
 
-			// 9. Store pre-compaction snapshot to KV (fire-and-forget)
+			// 8. Store pre-compaction snapshot to KV (fire-and-forget)
 			if (useSnapshotToKV) {
 				storePreCompactionSnapshot(sessionId, {
 					timestamp: new Date().toISOString(),
 					sessionId,
 					planningState: planningState ? { raw: planningState } : undefined,
-					backgroundTasks: tasks.map((t) => ({
-						id: t.id,
-						description: t.description || 'No description',
-						status: t.status,
-					})),
 					branch,
 				}).catch(() => {}); // Fire and forget
 			}

package/src/plugin/plugin.ts

@@ -17,7 +17,6 @@ import { createCadenceHooks } from './hooks/cadence';
 import { createSessionMemoryHooks } from './hooks/session-memory';
 import { createCompletionHooks } from './hooks/completion';
 import type { AgentRole } from '../types';
-import { BackgroundManager } from '../background';
 import type { SessionTreeNode } from '../sqlite';
 import { OpenCodeDBReader } from '../sqlite';
 import { TmuxSessionManager } from '../tmux';
@@ -114,76 +113,18 @@ export async function createCoderPlugin(ctx: PluginInput): Promise<Hooks> {
 					}),
 			})
 		: undefined;
-	const backgroundManager = new BackgroundManager(
-		ctx,
-		coderConfig.background,
-		{
-			onSubagentSessionCreated: tmuxManager
-				? (event) => {
-						void tmuxManager.onSessionCreated(event);
-					}
-				: undefined,
-			onSubagentSessionDeleted: tmuxManager
-				? (event) => {
-						void tmuxManager.onSessionDeleted(event);
-					}
-				: undefined,
-			onShutdown: tmuxManager
-				? () => {
-						void tmuxManager.cleanup();
-					}
-				: undefined,
-		},
-		dbReader
-	);
-
-	// Recover any background tasks from previous sessions
-	// This allows tasks to survive plugin restarts
-	void backgroundManager
-		.recoverTasks()
-		.then((count) => {
-			if (count > 0) {
-				ctx.client.app.log({
-					body: {
-						service: 'agentuity-coder',
-						level: 'info',
-						message: `Recovered ${count} background task(s) from previous sessions`,
-					},
-				});
-			}
-		})
-		.catch((error) => {
-			ctx.client.app.log({
-				body: {
-					service: 'agentuity-coder',
-					level: 'warn',
-					message: `Failed to recover background tasks: ${error}`,
-				},
-			});
-		});
 
-	// Create hooks that need backgroundManager for task reference injection during compaction
-	const cadenceHooks = createCadenceHooks(
-		ctx,
-		coderConfig,
-		backgroundManager,
-		dbReader,
-		lastUserMessages
-	);
+	// Create hooks for session routing and compaction behavior
+	const cadenceHooks = createCadenceHooks(ctx, coderConfig, dbReader, lastUserMessages);
 
 	// Session memory hooks handle checkpointing and compaction for non-Cadence sessions
 	// Orchestration (deciding which module handles which session) happens below in the hooks
-	const sessionMemoryHooks = createSessionMemoryHooks(
-		ctx,
-		coderConfig,
-		backgroundManager,
-		dbReader
-	);
+	const sessionMemoryHooks = createSessionMemoryHooks(ctx, coderConfig, dbReader);
 
 	const configHandler = createConfigHandler(coderConfig);
 
 	// Create plugin tools using the @opencode-ai/plugin tool helper
-	const tools = createTools(backgroundManager, dbReader);
+	const tools = createTools(dbReader);
 
 	// Create a logger for shutdown handler
 	const shutdownLogger = (message: string) =>
@@ -195,7 +136,7 @@ export async function createCoderPlugin(ctx: PluginInput): Promise<Hooks> {
 			},
 		});
 
-	registerShutdownHandler(backgroundManager, tmuxManager, shutdownLogger, dbReader);
+	registerShutdownHandler(tmuxManager, shutdownLogger, dbReader);
 
 	// Show startup toast (fire and forget, don't block)
 	try {
@@ -245,10 +186,6 @@ export async function createCoderPlugin(ctx: PluginInput): Promise<Hooks> {
 			}
 		},
 		event: async (input) => {
-			const event = extractEventFromInput(input);
-			if (event) {
-				backgroundManager.handleEvent(event);
-			}
 			// Orchestrate: route to appropriate module based on session type
 			const sessionId = extractSessionIdFromEvent(input);
 			if (sessionId) {
@@ -628,7 +565,7 @@ $ARGUMENTS
 ## Lead-of-Leads (Parallel Work)
 If the task has **independent workstreams** that can run in parallel (e.g., "build auth, payments, and notifications"):
 1. Ask @Agentuity Coder Product to create PRD with workstreams
-2. Spawn child Leads via \`agentuity_background_task\` for each workstream
+2. Spawn child Leads using the \`task\` tool (issue multiple task calls in a single response for parallel work)
 3. Each child Lead claims a workstream, works autonomously, marks done when complete
 4. Monitor progress via PRD workstream status
 5. Do integration work when all children complete
@@ -674,170 +611,10 @@ function normalizeBaseDir(path: string): string {
 	return path.replace(/[\\/]+$/, '');
 }
 
-function createTools(
-	backgroundManager: BackgroundManager,
-	dbReader?: OpenCodeDBReader
-): Hooks['tool'] {
+function createTools(dbReader?: OpenCodeDBReader): Hooks['tool'] {
 	// Use the schema from @opencode-ai/plugin's tool helper to avoid Zod version mismatches
 	const s = tool.schema;
 
-	const backgroundTask = tool({
-		description: `Launch a task to run in the background. Use this for parallel execution of multiple independent tasks.
-
-IMPORTANT: Use this tool instead of the 'task' tool when:
-- You need to run multiple agents in parallel
-- Tasks are independent and don't need sequential execution
-- The user asks for "parallel", "background", or "concurrent" work`,
-		args: {
-			agent: s
-				.enum([
-					'lead',
-					'scout',
-					'builder',
-					'architect',
-					'reviewer',
-					'memory',
-					'expert',
-					'runner',
-					'product',
-					'monitor',
-				])
-				.describe('Agent role to run the task'),
-			task: s.string().describe('Task prompt to run in the background'),
-			description: s.string().optional().describe('Short description of the task'),
-		},
-		async execute(args, context) {
-			const parentSessionId = context.sessionID;
-			if (!parentSessionId) {
-				return JSON.stringify({
-					taskId: 'unknown',
-					status: 'error',
-					message: 'Missing session context for background task.',
-				});
-			}
-
-			const agentName = resolveAgentName(args.agent as AgentRole);
-			const bgTask = await backgroundManager.launch({
-				description: args.description ?? args.task,
-				prompt: args.task,
-				agent: agentName,
-				parentSessionId,
-				parentMessageId: context.messageID,
-			});
-			return JSON.stringify({
-				taskId: bgTask.id,
-				status: bgTask.status,
-				message:
-					bgTask.status === 'error'
-						? (bgTask.error ?? 'Failed to launch background task.')
-						: 'Background task launched.',
-			});
-		},
-	});
-
-	const backgroundOutput = tool({
-		description: 'Retrieve output for a background task.',
-		args: {
-			task_id: s.string().describe('Background task ID'),
-		},
-		async execute(args) {
-			const bgTask = backgroundManager.getTask(args.task_id);
-			if (!bgTask) {
-				return JSON.stringify({
-					taskId: args.task_id,
-					status: 'error',
-					error: 'Task not found.',
-				});
-			}
-			return JSON.stringify({
-				taskId: bgTask.id,
-				status: bgTask.status,
-				result: bgTask.result,
-				error: bgTask.error,
-			});
-		},
-	});
-
-	const backgroundCancel = tool({
-		description: 'Cancel a running background task.',
-		args: {
-			task_id: s.string().describe('Background task ID'),
-		},
-		async execute(args) {
-			const success = backgroundManager.cancel(args.task_id);
-			return JSON.stringify({
-				taskId: args.task_id,
-				success,
-				message: success ? 'Background task cancelled.' : 'Unable to cancel task.',
-			});
-		},
-	});
-
-	const backgroundInspect = tool({
-		description: `Inspect a background task to see its session messages and current state. Useful for debugging or checking what a child agent is doing.`,
-		args: {
-			task_id: s.string().describe('Background task ID to inspect'),
-		},
-		async execute(args) {
-			const inspection = await backgroundManager.inspectTask(args.task_id);
-			if (!inspection) {
-				return JSON.stringify({
-					taskId: args.task_id,
-					status: 'unknown',
-					found: false,
-					error: 'Task not found or session no longer exists.',
-				});
-			}
-
-			const messages = inspection.messages ?? [];
-			const enhanced =
-				inspection.messageCount !== undefined ||
-				inspection.activeTools !== undefined ||
-				inspection.todos !== undefined ||
-				inspection.costSummary !== undefined ||
-				inspection.childSessionCount !== undefined;
-
-			if (enhanced) {
-				return JSON.stringify({
-					taskId: inspection.taskId,
-					status: inspection.status,
-					found: true,
-					messageCount: inspection.messageCount ?? messages.length,
-					messages,
-					lastActivity: inspection.lastActivity,
-					activeTools: inspection.activeTools,
-					todos: inspection.todos,
-					costSummary: inspection.costSummary,
-					childSessionCount: inspection.childSessionCount,
-				});
-			}
-
-			// Extract last few messages for summary (fallback)
-			const lastMessages = messages
-				.slice(-3)
-				.map((m) => {
-					const parts = m.parts ?? [];
-					const textParts = parts.filter(
-						(p: unknown) => (p as { type?: string }).type === 'text'
-					);
-					return textParts
-						.map((p: unknown) => ((p as { text?: string }).text ?? '').slice(0, 200))
-						.join(' ')
-						.slice(0, 300);
-				})
-				.filter(Boolean);
-
-			return JSON.stringify({
-				taskId: inspection.taskId,
-				status: inspection.status,
-				found: true,
-				messageCount: messages.length,
-				lastMessages,
-				lastActivity: inspection.lastActivity,
-			});
-		},
-	});
-
 	const sessionDashboard = tool({
 		description:
 			'Inspect a parent session dashboard from the local OpenCode SQLite database. Useful for Lead-of-Leads monitoring and nested session visibility.',
@@ -1007,10 +784,6 @@ Returns the public URL that can be copied and used anywhere.`,
 	});
 
 	return {
-		agentuity_background_task: backgroundTask,
-		agentuity_background_output: backgroundOutput,
-		agentuity_background_cancel: backgroundCancel,
-		agentuity_background_inspect: backgroundInspect,
 		agentuity_session_dashboard: sessionDashboard,
 		agentuity_memory_share: memoryShare,
 	};
@@ -1032,20 +805,6 @@ function extractSessionIdFromEvent(input: unknown): string | undefined {
 	);
 }
 
-function resolveAgentName(role: AgentRole): string {
-	const agent = agents[role];
-	return agent?.displayName ?? role;
-}
-
-function extractEventFromInput(
-	input: unknown
-): { type: string; properties?: Record<string, unknown> } | undefined {
-	if (typeof input !== 'object' || input === null) return undefined;
-	const inp = input as { event?: { type?: string; properties?: Record<string, unknown> } };
-	if (!inp.event || typeof inp.event.type !== 'string') return undefined;
-	return { type: inp.event.type, properties: inp.event.properties };
-}
-
 function parseDisplayTitle(rawTitle: string): string {
 	try {
 		const parsed = JSON.parse(rawTitle);
@@ -1210,7 +969,6 @@ function isMemoryPath(path: string): boolean {
 }
 
 function registerShutdownHandler(
-	manager: BackgroundManager,
 	tmuxManager?: TmuxSessionManager,
 	logger?: (msg: string) => void,
 	dbReader?: OpenCodeDBReader
@@ -1238,14 +996,6 @@ function registerShutdownHandler(
 
 		log(`Shutdown triggered by ${signal ?? 'unknown'} signal`);
 
-		try {
-			log('Shutting down background manager...');
-			manager.shutdown();
-			log('Background manager shutdown complete');
-		} catch (error) {
-			log(`Background manager shutdown error: ${error}`);
-		}
-
 		if (tmuxManager) {
 			try {
 				log('Cleaning up tmux sessions...');

package/src/sqlite/types.ts

@@ -142,7 +142,6 @@ export interface DBToolCallSummary {
 /** Stats about what compaction preserved */
 export interface CompactionStats {
 	planningPhasesCount: number;
-	backgroundTasksCount: number;
 	imageDescriptionsCount: number;
 	toolCallSummariesCount: number;
 	estimatedTokens: number;
@@ -153,7 +152,6 @@ export interface PreCompactionSnapshot {
 	timestamp: string;
 	sessionId: string;
 	planningState?: Record<string, unknown>;
-	backgroundTasks?: Array<{ id: string; description: string; status: string }>;
 	imageDescriptions?: string[];
 	toolCallSummaries?: string[];
 	cadenceState?: Record<string, unknown>;

package/src/tmux/manager.ts

@@ -52,7 +52,7 @@ export interface TmuxSessionManagerCallbacks {
 }
 
 /**
- * Manages tmux panes for background agents.
+ * Manages tmux panes for agent sessions.
  *
  * Architecture:
  * 1. QUERY: Get actual tmux pane state (source of truth)
@@ -106,8 +106,8 @@ export class TmuxSessionManager {
 	}
 
 	/**
-	 * Handle a new background session being created
-	 * This is called by BackgroundManager when a background task starts
+	 * Handle a new subagent session being created
+	 * This is called when a delegated session starts
 	 *
 	 * Operations are queued to prevent race conditions when multiple sessions
 	 * are created rapidly.
@@ -251,7 +251,7 @@ export class TmuxSessionManager {
 	/**
 	 * Handle a session being deleted
 	 *
-	 * Explicitly kills the pane when a background session completes.
+	 * Explicitly kills the pane when a subagent session completes.
 	 * We can't rely on `opencode attach` exiting because it's an interactive
 	 * terminal that keeps running even after the session goes idle.
 	 *

package/src/tmux/types.ts

@@ -29,11 +29,11 @@ export interface WindowState {
 	windowWidth: number;
 	windowHeight: number;
 	mainPane: TmuxPaneInfo | null; // The pane running the main agent
-	agentPanes: TmuxPaneInfo[]; // Panes for background agents
+	agentPanes: TmuxPaneInfo[]; // Panes for subagent sessions
 }
 
 /**
- * Tracked session for a background agent in tmux
+ * Tracked session for a subagent in tmux
  */
 export interface TrackedSession {
 	sessionId: string; // OpenCode session ID

package/src/tools/index.ts

@@ -1,9 +1,2 @@
-export {
-	createBackgroundTools,
-	BackgroundTaskArgsSchema,
-	BackgroundOutputArgsSchema,
-	BackgroundCancelArgsSchema,
-	type BackgroundTaskArgs,
-	type BackgroundOutputArgs,
-	type BackgroundCancelArgs,
-} from './background';
+// Tools are registered directly in plugin/plugin.ts
+export {};

package/src/types.ts

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import type { BackgroundTaskConfig } from './background/types';
 import type { SkillsConfig } from './skills/types';
 import type { TmuxConfig } from './tmux/types';
 
@@ -11,7 +10,6 @@ export type {
 	ToolDefinition,
 } from '@opencode-ai/plugin';
 
-export type { BackgroundTaskConfig } from './background/types';
 export type { SkillsConfig, LoadedSkill, SkillMetadata, SkillScope } from './skills';
 export type { TmuxConfig } from './tmux/types';
 
@@ -28,7 +26,6 @@ export const AgentRoleSchema = z.enum([
 	'expert-ops',
 	'runner',
 	'product',
-	'monitor',
 ]);
 export type AgentRole = z.infer<typeof AgentRoleSchema>;
 
@@ -184,20 +181,11 @@ export interface CoderConfig {
 	disabledMcps?: string[];
 	/** CLI command patterns to block for security (e.g., 'cloud secrets', 'auth token') */
 	blockedCommands?: string[];
-	background?: BackgroundTaskConfig;
 	skills?: SkillsConfig;
 	tmux?: TmuxConfig;
 	compaction?: CompactionConfig;
 }
 
-export const BackgroundTaskConfigSchema = z.object({
-	enabled: z.boolean(),
-	defaultConcurrency: z.number(),
-	staleTimeoutMs: z.number(),
-	providerConcurrency: z.record(z.string(), z.number()).optional(),
-	modelConcurrency: z.record(z.string(), z.number()).optional(),
-});
-
 export const SkillsConfigSchema = z.object({
 	enabled: z.boolean(),
 	paths: z.array(z.string()).optional(),
@@ -225,7 +213,6 @@ export const CoderConfigSchema = z.object({
 	org: z.string().optional(),
 	disabledMcps: z.array(z.string()).optional(),
 	blockedCommands: z.array(z.string()).optional(),
-	background: BackgroundTaskConfigSchema.optional(),
 	skills: SkillsConfigSchema.optional(),
 	tmux: TmuxConfigSchema.optional(),
 	compaction: CompactionConfigSchema.optional(),

package/dist/agents/monitor.d.ts

@@ -1,4 +0,0 @@
-import type { AgentDefinition } from './types';
-export declare const MONITOR_SYSTEM_PROMPT = "# BackgroundMonitor Agent\n\nYou are an auto-launched background task monitor. You were spawned automatically when Lead started background tasks. Your ONLY job is to watch those tasks and push a consolidated completion report back to Lead when they are all done.\n\n**Lead is not polling. Lead is not watching. You are the eyes. Lead trusts you to report.**\n\n## How You Discover Tasks\n\nYou receive a parent session ID in your prompt. Use it to discover all sibling tasks:\n\n```\nagentuity_session_dashboard({ session_id: \"<parentSessionId>\" })\n```\n\nThis is scoped to child sessions of that parent only \u2014 it does not expose unrelated sessions.\nFrom the dashboard, extract the task IDs (bg_xxx format) from session titles.\nThen use `agentuity_background_output({ task_id: \"bg_xxx\" })` to get status + progress for each.\n\nIgnore sessions that are other Monitor instances \u2014 their `displayTitle` will be \"Monitor background tasks\". Filter these out when processing the dashboard results.\n\n## Progress Signal\n\n`agentuity_background_output` now returns a `progress` object on running tasks:\n\n```json\n{\n  \"status\": \"running\",\n  \"progress\": {\n    \"toolCalls\": 21,\n    \"lastTool\": \"read\",\n    \"lastToolSec\": 12,\n    \"activeTools\": 1\n  }\n}\n```\n\n- `toolCalls`: total tool calls completed \u2014 growing means active work\n- `lastTool`: name of the most recently completed tool\n- `lastToolSec`: seconds since last tool activity \u2014 <300 with growth means healthy\n- `activeTools`: tool calls currently in-flight\n\nA task is **stuck** only if `lastToolSec > 300` AND `activeTools === 0` AND `toolCalls` has not grown between checks.\n\n## Check Cadence \u2014 CRITICAL\n\n**You MUST wait at least 20 seconds between each check cycle.** This is a hard requirement, not a suggestion.\n\n- Minimum 20 seconds between checks \u2014 count them, do not rush\n- Maximum 10 check cycles total (covers ~3-4 minutes of typical work)\n- After EACH check, output: \"\u23F3 Waiting 20 seconds before next check...\" \u2014 this helps you pace yourself\n- Scout tasks typically take 3\u20138 minutes \u2014 be patient, checking faster does NOT make them complete faster\n- Excessive polling wastes tokens and provides no benefit\n\nFor each poll cycle (track cycle number starting at 1):\n1. Check each task ID with `agentuity_background_output({ task_id: \"bg_xxx\" })`\n2. Track the status of each task\n3. If any task is still \"pending\" or \"running\" **and cycle < 10**, wait 20 seconds and poll again\n4. When all tasks are \"completed\" or \"error\" **OR cycle reaches 10**, generate the final report\n\n## When Tasks Are Stuck\n\nIf a task shows `lastToolSec > 300` AND `activeTools === 0`:\n1. Call `agentuity_background_inspect({ task_id: \"bg_xxx\" })` for a full view\n2. Include what you found in your final report under \"Stuck Tasks\"\n3. Do NOT cancel the task \u2014 report it to Lead for a decision\n\n## Completion Condition\n\nAll work tasks are done when every non-monitor task is `completed`, `error`, or `cancelled`.\n\n## Final Report Format\n\nWhen all tasks are done (or after 20 cycles), output exactly this:\n\n```markdown\n## [ALL BACKGROUND TASKS COMPLETE]\n\n- **bg_xxx** (completed): [first 100 chars of result]\n- **bg_yyy** (error): [error message]\n- **bg_zzz** (completed): [first 100 chars of result]\n\n### Results\n\n**bg_xxx:**\n[full result text]\n\n**bg_yyy (error):**\n[error]\n```\n\nIf tasks are still running after 10 cycles, use \"## [BACKGROUND TASKS STILL RUNNING]\" as the header and list the stuck ones with their last known progress.\n\n## Timeout Errors\n\n- **Timeout errors** (\"Background task timed out (no activity).\") often occur when the model is\n  generating a long text response without making tool calls. These are server-side inactivity\n  timeouts, not true failures \u2014 the model was still working but appeared idle to the server.\n- If a task errors with a timeout, note this in your report. It may be worth retrying.\n\n## What You Do NOT Do\n\n- \u274C Interpret or analyze task results beyond summarizing\n- \u274C Make decisions about next steps\n- \u274C Cancel tasks (ever)\n- \u274C Interact with the user\n- \u274C Modify any files\n- \u274C Call other agents\n- \u274C Use tools other than agentuity_background_output, agentuity_background_inspect, and agentuity_session_dashboard\n\nYou are a patient, focused watcher. When work is done, you report. Nothing more.\n\n## Example Workflow\n\nGiven task: \"Monitor these tasks: bg_abc123, bg_def456\"\n\n1. Call agentuity_background_output for bg_abc123\n2. Call agentuity_background_output for bg_def456\n3. If any status is \"pending\" or \"running\" and cycle < 10, wait 20 seconds\n4. Repeat steps 1-3 until all complete or 10 cycles reached\n5. Output final report\n\n## Waiting Between Polls\n\nSince you cannot use setTimeout, after checking all tasks and finding some still running, you MUST output:\n\n\"\u23F3 Waiting 20 seconds before next check... (cycle 3/10)\"\n\nThen poll again. The conversation history serves as your \"timer\" \u2014 each response and check adds natural delay. Do NOT skip the waiting message.\n\n**After 10 cycles:** Report final status even if tasks are still running, noting which tasks did not complete within the monitoring window.\n";
-export declare const monitorAgent: AgentDefinition;
-//# sourceMappingURL=monitor.d.ts.map

package/dist/agents/monitor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/agents/monitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,qBAAqB,muKAkIjC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eA0B1B,CAAC"}