agent-worker 0.14.0 → 0.15.0

package/dist/context-CdcZpO-0.mjs

@@ -0,0 +1,4 @@
+import { A as MENTION_PATTERN, B as formatProposal, C as DefaultDocumentStore, D as MemoryStorage, E as FileStorage, F as createResourceRef, G as getAgentId, H as createLogTool, I as extractMentions, K as EventLog, L as generateResourceId, M as RESOURCE_PREFIX, N as RESOURCE_SCHEME, O as ContextProviderImpl, P as calculatePriority, R as shouldUseResource, S as DefaultResourceStore, T as DefaultChannelStore, U as formatInbox, V as formatProposalList, W as formatToolParams, _ as FileContextProvider, b as resolveContextDir, j as MESSAGE_LENGTH_THRESHOLD, k as CONTEXT_DEFAULTS, v as createFileContextProvider, w as DefaultInboxStore, x as DefaultStatusStore, y as getDefaultContextDir, z as createContextMCPServer } from "./cli/index.mjs";
+import { n as createMemoryContextProvider, t as MemoryContextProvider } from "./memory-provider-ZLOKyCxA.mjs";
+
+export { createFileContextProvider };

package/dist/create-tool-gcUuI1FD.mjs

@@ -0,0 +1,32 @@
+import { jsonSchema, tool } from "ai";
+
+//#region src/agent/tools/create-tool.ts
+/**
+* Type-safe wrapper for AI SDK tool() with JSON Schema.
+*
+* The AI SDK's tool() function has complex generic types that don't align
+* with jsonSchema() return types. This utility absorbs the necessary casts
+* in one place instead of scattering `as unknown` across every tool file.
+*/
+/**
+* Create an AI SDK tool with a plain JSON Schema object.
+*
+* Usage:
+* ```ts
+* const myTool = createTool({
+*   description: "Do something",
+*   schema: { type: "object", properties: { name: { type: "string" } }, required: ["name"] },
+*   execute: async (args) => { ... },
+* });
+* ```
+*/
+function createTool(config) {
+	return tool({
+		description: config.description,
+		inputSchema: jsonSchema(config.schema),
+		execute: config.execute
+	});
+}
+
+//#endregion
+export { createTool as t };

package/dist/index.d.mts

@@ -6,7 +6,7 @@ import { BashToolkit, CreateBashToolOptions, createBashTool } from "bash-tool";
  * Model Translation Maps — Single Source of Truth
  *
  * All backend-specific model naming and translation logic lives here.
- * Both `backends/types.ts` and `workflow/controller/types.ts` re-export from this module.
+ * Both `backends/types.ts` and `workflow/loop/types.ts` re-export from this module.
  */
 /** Backend type (union of all supported backends) */
 type BackendType = "default" | "claude" | "cursor" | "codex" | "opencode" | "mock";
@@ -48,10 +48,6 @@ interface Backend {
     version?: string;
     model?: string;
   };
-  /** Set up workspace directory with MCP config for workflow isolation */
-  setWorkspace?(workspaceDir: string, mcpConfig: {
-    mcpServers: Record<string, unknown>;
-  }): void;
   /** Abort any running operations and cleanup resources */
   abort?(): void;
 }
@@ -516,13 +512,6 @@ declare class ClaudeCodeBackend implements Backend {
   private options;
   private currentAbort?;
   constructor(options?: ClaudeCodeOptions);
-  /**
-   * Set up workspace directory with MCP config
-   * Claude uses --mcp-config flag, so we just write the config file
-   */
-  setWorkspace(workspaceDir: string, mcpConfig: {
-    mcpServers: Record<string, unknown>;
-  }): void;
   send(message: string, options?: {
     system?: string;
   }): Promise<BackendResponse>;
@@ -533,10 +522,6 @@ declare class ClaudeCodeBackend implements Backend {
     model?: string;
   };
   private buildArgs;
-  /**
-   * Set MCP config path (for workflow integration)
-   */
-  setMcpConfigPath(path: string): void;
   /**
    * Abort any running claude process
    */
@@ -562,13 +547,6 @@ declare class CodexBackend implements Backend {
   readonly type: "codex";
   private options;
   constructor(options?: CodexOptions);
-  /**
-   * Set up workspace directory with MCP config
-   * Creates .codex/config.yaml in the workspace with MCP server config
-   */
-  setWorkspace(workspaceDir: string, mcpConfig: {
-    mcpServers: Record<string, unknown>;
-  }): void;
   send(message: string, _options?: {
     system?: string;
   }): Promise<BackendResponse>;
@@ -605,13 +583,6 @@ declare class CursorBackend implements Backend {
    */
   private resolvedStyle;
   constructor(options?: CursorOptions);
-  /**
-   * Set up workspace directory with MCP config
-   * Creates .cursor/mcp.json in the workspace
-   */
-  setWorkspace(workspaceDir: string, mcpConfig: {
-    mcpServers: Record<string, unknown>;
-  }): void;
   send(message: string, _options?: {
     system?: string;
   }): Promise<BackendResponse>;
@@ -681,8 +652,8 @@ declare class SdkBackend implements Backend {
  * Mock AI Backend for testing
  *
  * In single-agent mode, provides a simple echo send().
- * In workflow mode, the controller handles MCP tool orchestration
- * via the mock runner strategy (controller/mock-runner.ts).
+ * In workflow mode, the loop handles MCP tool orchestration
+ * via the mock runner strategy (loop/mock-runner.ts).
  */
 declare class MockAIBackend implements Backend {
   private debugLog?;
@@ -914,4 +885,4 @@ declare function buildGitUrl(spec: ImportSpec): string;
  */
 declare function getSpecDisplayName(spec: ImportSpec): string;
 //#endregion
-export { type AgentMessage, type AgentResponse, AgentWorker as AgentSession, AgentWorker, type AgentWorkerConfig as AgentSessionConfig, type AgentWorkerConfig, type ApprovalCheck, type Backend, type BackendConfig, type BackendOptions, type BackendResponse, type BackendType, type BashToolkit, type BashToolsOptions, ClaudeCodeBackend, type ClaudeCodeOptions, CodexBackend, type CodexOptions, type CreateBashToolOptions, CursorBackend, type CursorOptions, FEEDBACK_PROMPT, FRONTIER_MODELS, type FeedbackEntry, type FeedbackToolOptions, type FeedbackToolResult, type GitProvider, type ImportSpec, type ImportedSkill, type MessageStatus, MockAIBackend, type PendingApproval, SUPPORTED_PROVIDERS, SdkBackend, type SdkBackendOptions, type SendOptions, type SessionConfig, type SessionState, SkillImporter, type SkillMetadata, SkillsProvider, type StepInfo, type SupportedProvider, type TokenUsage, type ToolCall, type ToolInfo, type Transcript, buildGitUrl, checkBackends, createBackend, createBashTool, createBashTools, createBashToolsFromDirectory, createBashToolsFromFiles, createFeedbackTool, createMockBackend, createModel, createModelAsync, createSkillsTool, getSpecDisplayName, listBackends, parseImportSpec };
+export { type AgentMessage, type AgentResponse, AgentWorker, type AgentWorkerConfig, type ApprovalCheck, type Backend, type BackendConfig, type BackendOptions, type BackendResponse, type BackendType, type BashToolkit, type BashToolsOptions, ClaudeCodeBackend, type ClaudeCodeOptions, CodexBackend, type CodexOptions, type CreateBashToolOptions, CursorBackend, type CursorOptions, FEEDBACK_PROMPT, FRONTIER_MODELS, type FeedbackEntry, type FeedbackToolOptions, type FeedbackToolResult, type GitProvider, type ImportSpec, type ImportedSkill, type MessageStatus, MockAIBackend, type PendingApproval, SUPPORTED_PROVIDERS, SdkBackend, type SdkBackendOptions, type SendOptions, type SessionConfig, type SessionState, SkillImporter, type SkillMetadata, SkillsProvider, type StepInfo, type SupportedProvider, type TokenUsage, type ToolCall, type ToolInfo, type Transcript, buildGitUrl, checkBackends, createBackend, createBashTool, createBashTools, createBashToolsFromDirectory, createBashToolsFromFiles, createFeedbackTool, createMockBackend, createModel, createModelAsync, createSkillsTool, getSpecDisplayName, listBackends, parseImportSpec };

package/dist/index.mjs

@@ -1,10 +1,11 @@
-import { F as createModelWithProvider, M as SUPPORTED_PROVIDERS, N as createModel, P as createModelAsync, a as createMockBackend, d as CodexBackend, f as ClaudeCodeBackend, i as MockAIBackend, j as FRONTIER_MODELS, n as createBackend, o as SdkBackend, r as listBackends, t as checkBackends, u as CursorBackend } from "./backends-C6WBIn9H.mjs";
-import { ToolLoopAgent, jsonSchema, stepCountIs, tool } from "ai";
+import { F as createModelWithProvider, M as SUPPORTED_PROVIDERS, N as createModel, P as createModelAsync, a as createMockBackend, d as CodexBackend, f as ClaudeCodeBackend, i as MockAIBackend, j as FRONTIER_MODELS, n as createBackend, o as SdkBackend, r as listBackends, t as checkBackends, u as CursorBackend } from "./backends-C7pQwuAx.mjs";
+import { t as createTool } from "./create-tool-gcUuI1FD.mjs";
+import { ToolLoopAgent, stepCountIs } from "ai";
 import { createBashTool } from "bash-tool";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join, normalize } from "node:path";
-import { parse } from "yaml";
 import { mkdir, readFile, readdir, rm, stat } from "node:fs/promises";
+import { parse } from "yaml";
 import { z } from "zod";
 import { tmpdir } from "node:os";
 import { spawn } from "node:child_process";
@@ -479,41 +480,41 @@ async function createBashTools(options = {}) {
 	const { includeReadFile = true, includeWriteFile = true, ...bashOptions } = options;
 	const toolkit = await createBashTool(bashOptions);
 	const tools = {};
-	tools.bash = tool({
+	tools.bash = createTool({
 		description: "Execute bash commands in a sandboxed environment. Returns stdout, stderr, and exit code.",
-		inputSchema: jsonSchema({
+		schema: {
 			type: "object",
 			properties: { command: {
 				type: "string",
 				description: "The bash command to execute"
 			} },
 			required: ["command"]
-		}),
+		},
 		execute: async (args) => {
 			const bashTool = toolkit.tools.bash;
 			if (!bashTool?.execute) throw new Error("Bash tool not available");
 			return bashTool.execute(args, {});
 		}
 	});
-	if (includeReadFile) tools.readFile = tool({
+	if (includeReadFile) tools.readFile = createTool({
 		description: "Read the contents of a file from the sandbox filesystem.",
-		inputSchema: jsonSchema({
+		schema: {
 			type: "object",
 			properties: { path: {
 				type: "string",
 				description: "The path to the file to read"
 			} },
 			required: ["path"]
-		}),
+		},
 		execute: async (args) => {
 			const readFileTool = toolkit.tools.readFile;
 			if (!readFileTool?.execute) throw new Error("ReadFile tool not available");
 			return readFileTool.execute(args, {});
 		}
 	});
-	if (includeWriteFile) tools.writeFile = tool({
+	if (includeWriteFile) tools.writeFile = createTool({
 		description: "Write content to a file in the sandbox filesystem. Creates parent directories if needed.",
-		inputSchema: jsonSchema({
+		schema: {
 			type: "object",
 			properties: {
 				path: {
@@ -526,7 +527,7 @@ async function createBashTools(options = {}) {
 				}
 			},
 			required: ["path", "content"]
-		}),
+		},
 		execute: async (args) => {
 			const writeFileTool = toolkit.tools.writeFile;
 			if (!writeFileTool?.execute) throw new Error("WriteFile tool not available");
@@ -595,9 +596,9 @@ function createFeedbackTool(options = {}) {
 	const { onFeedback, maxEntries = 50 } = options;
 	const entries = [];
 	return {
-		tool: tool({
+		tool: createTool({
 			description: "Report a workflow improvement need. Use when you hit something inconvenient — a missing tool, an awkward step, or a capability you wished you had.",
-			inputSchema: jsonSchema({
+			schema: {
 				type: "object",
 				properties: {
 					target: {
@@ -627,7 +628,7 @@ function createFeedbackTool(options = {}) {
 					"type",
 					"description"
 				]
-			}),
+			},
 			execute: async (args) => {
 				const validTypes = [
 					"missing",
@@ -663,7 +664,7 @@ const frontmatterSchema = z.object({
 	description: z.string().min(1).max(1024),
 	license: z.string().optional(),
 	compatibility: z.string().max(500).optional(),
-	metadata: z.record(z.string()).optional(),
+	metadata: z.record(z.string(), z.string()).optional(),
 	"allowed-tools": z.string().optional()
 });
 var SkillsProvider = class {
@@ -817,9 +818,9 @@ var SkillsProvider = class {
 * Create a Skills tool as an AI SDK tool() object
 */
 function createSkillsTool(provider) {
-	return tool({
+	return createTool({
 		description: "Interact with available agent skills. Use \"list\" to see all skills with their descriptions, \"view\" to read a complete SKILL.md file, \"readFile\" to read files within a skill directory (e.g., references/, scripts/, assets/).",
-		inputSchema: jsonSchema({
+		schema: {
 			type: "object",
 			properties: {
 				operation: {
@@ -841,7 +842,7 @@ function createSkillsTool(provider) {
 				}
 			},
 			required: ["operation"]
-		}),
+		},
 		execute: async (args) => {
 			const operation = args.operation;
 			const skillName = args.skillName;
@@ -1107,4 +1108,4 @@ var SkillImporter = class {
 };
 
 //#endregion
-export { AgentWorker as AgentSession, AgentWorker, ClaudeCodeBackend, CodexBackend, CursorBackend, FEEDBACK_PROMPT, FRONTIER_MODELS, MockAIBackend, SUPPORTED_PROVIDERS, SdkBackend, SkillImporter, SkillsProvider, buildGitUrl, checkBackends, createBackend, createBashTool, createBashTools, createBashToolsFromDirectory, createBashToolsFromFiles, createFeedbackTool, createMockBackend, createModel, createModelAsync, createSkillsTool, getSpecDisplayName, listBackends, parseImportSpec };
+export { AgentWorker, ClaudeCodeBackend, CodexBackend, CursorBackend, FEEDBACK_PROMPT, FRONTIER_MODELS, MockAIBackend, SUPPORTED_PROVIDERS, SdkBackend, SkillImporter, SkillsProvider, buildGitUrl, checkBackends, createBackend, createBashTool, createBashTools, createBashToolsFromDirectory, createBashToolsFromFiles, createFeedbackTool, createMockBackend, createModel, createModelAsync, createSkillsTool, getSpecDisplayName, listBackends, parseImportSpec };

package/dist/{memory-provider-0nuDxzYQ.mjs → memory-provider-ZLOKyCxA.mjs}

@@ -1,16 +1,21 @@
-import { S as ContextProviderImpl, x as MemoryStorage } from "./cli/index.mjs";
+import { C as DefaultDocumentStore, D as MemoryStorage, O as ContextProviderImpl, S as DefaultResourceStore, T as DefaultChannelStore, w as DefaultInboxStore, x as DefaultStatusStore } from "./cli/index.mjs";
 
 //#region src/workflow/context/memory-provider.ts
 /**
 * In-memory ContextProvider for testing.
-* All domain logic is inherited from ContextProviderImpl;
+* All domain logic is in the composed stores;
 * this class adds test helpers for inspection and cleanup.
 */
 var MemoryContextProvider = class extends ContextProviderImpl {
 	memoryStorage;
 	constructor(validAgents) {
 		const storage = new MemoryStorage();
-		super(storage, validAgents);
+		const channel = new DefaultChannelStore(storage, validAgents);
+		const inbox = new DefaultInboxStore(channel, storage);
+		const documents = new DefaultDocumentStore(storage);
+		const resources = new DefaultResourceStore(storage);
+		const status = new DefaultStatusStore(storage);
+		super(channel, inbox, documents, resources, status, validAgents);
 		this.memoryStorage = storage;
 	}
 	/** Get underlying MemoryStorage (for testing) */

package/dist/{runner-DV86expc.mjs → runner-DB-b57iZ.mjs}

@@ -1,6 +1,7 @@
-import "./backends-C6WBIn9H.mjs";
-import { B as EventLog, N as createContextMCPServer, _ as createFileContextProvider, g as FileContextProvider, h as runWithHttp, i as createSilentLogger, n as createWiredController, r as createChannelLogger, s as checkWorkflowIdle } from "./cli/index.mjs";
-import { n as createMemoryContextProvider } from "./memory-provider-0nuDxzYQ.mjs";
+import "./backends-C7pQwuAx.mjs";
+import "./create-tool-gcUuI1FD.mjs";
+import { K as EventLog, _ as FileContextProvider, g as runWithHttp, i as createSilentLogger, n as createWiredLoop, r as createChannelLogger, s as checkWorkflowIdle, v as createFileContextProvider, z as createContextMCPServer } from "./cli/index.mjs";
+import { n as createMemoryContextProvider } from "./memory-provider-ZLOKyCxA.mjs";
 import { existsSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
@@ -31,11 +32,18 @@ function resolveExpression(expression, context) {
 		const varName = expression.slice(4);
 		return context.env?.[varName] ?? process.env[varName];
 	}
+	if (expression.startsWith("params.")) {
+		const paramName = expression.slice(7);
+		return context.params?.[paramName];
+	}
 	if (expression.startsWith("workflow.")) {
 		const field = expression.slice(9);
 		if (field === "name") return context.workflow?.name;
 		if (field === "tag") return context.workflow?.tag;
-		if (field === "instance") return context.workflow?.instance || context.workflow?.tag;
+		return;
+	}
+	if (expression.startsWith("source.")) {
+		if (expression.slice(7) === "dir") return context.source?.dir;
 		return;
 	}
 	const value = context[expression];
@@ -44,15 +52,16 @@ function resolveExpression(expression, context) {
 /**
 * Create a context from workflow metadata
 */
-function createContext(workflowName, tag, taskOutputs = {}) {
+function createContext(workflowName, tag, taskOutputs = {}, params, sourceDir) {
 	return {
 		...taskOutputs,
 		env: process.env,
 		workflow: {
 			name: workflowName,
-			tag,
-			instance: tag
-		}
+			tag
+		},
+		params,
+		source: sourceDir ? { dir: sourceDir } : void 0
 	};
 }
 
@@ -354,8 +363,8 @@ function createWorkflowProvider(workflow, _workflowName, tag) {
 * 4. Runs setup commands
 */
 async function initWorkflow(config) {
-	const { workflow, workflowName: workflowNameParam, tag: tagParam, instance, onMention, debugLog, feedback: feedbackEnabled } = config;
-	const workflowName = workflowNameParam ?? instance ?? "global";
+	const { workflow, workflowName: workflowNameParam, tag: tagParam, onMention, debugLog, feedback: feedbackEnabled, params: paramValues } = config;
+	const workflowName = workflowNameParam ?? "global";
 	const tag = tagParam ?? "main";
 	const logger = config.logger ?? createSilentLogger();
 	const startTime = Date.now();
@@ -407,7 +416,7 @@ async function initWorkflow(config) {
 	});
 	logger.debug(`MCP server: ${httpMcpServer.url}`);
 	const setupResults = {};
-	const context = createContext(workflow.name, tag, setupResults);
+	const context = createContext(workflow.name, tag, setupResults, paramValues, workflow.sourceDir);
 	if (workflow.setup && workflow.setup.length > 0) {
 		logger.info("Running setup...");
 		for (const task of workflow.setup) try {
@@ -425,7 +434,6 @@ async function initWorkflow(config) {
 	const interpolatedKickoff = workflow.kickoff ? interpolate(workflow.kickoff, context, (msg) => logger.warn(msg)) : void 0;
 	const runtime = {
 		name: workflow.name,
-		instance: instance ?? `${workflowName}:${tag}`,
 		contextDir,
 		projectDir,
 		contextProvider,
@@ -477,15 +485,15 @@ async function runSetupTask(task, context, logger) {
 	}
 }
 /**
-* Run a workflow with agent controllers
+* Run a workflow with agent loops
 *
 * All output flows through the channel. The channel watcher (display layer)
 * filters what to show: --debug includes kind="debug" entries.
 */
-async function runWorkflowWithControllers(config) {
-	const { workflow, workflowName: workflowNameParam, tag: tagParam, instance, debug = false, log = console.log, mode = "run", pollInterval = 5e3, createBackend, feedback: feedbackEnabled } = config;
+async function runWorkflowWithLoops(config) {
+	const { workflow, workflowName: workflowNameParam, tag: tagParam, debug = false, log = console.log, mode = "run", pollInterval = 5e3, createBackend, feedback: feedbackEnabled, params: paramValues } = config;
 	const startTime = Date.now();
-	const workflowName = workflowNameParam ?? instance ?? "global";
+	const workflowName = workflowNameParam ?? "global";
 	const tag = tagParam ?? "main";
 	try {
 		const { contextProvider, contextDir, persistent } = createWorkflowProvider(workflow, workflowName, tag);
@@ -497,33 +505,32 @@ async function runWorkflowWithControllers(config) {
 		});
 		logger.info(`Running workflow: ${workflow.name}`);
 		logger.info(`Agents: ${Object.keys(workflow.agents).join(", ")}`);
-		logger.debug("Starting workflow with controllers", {
+		logger.debug("Starting workflow with loops", {
 			mode,
-			instance,
 			pollInterval
 		});
-		const controllers = /* @__PURE__ */ new Map();
+		const loops = /* @__PURE__ */ new Map();
 		logger.debug("Initializing workflow runtime...");
 		const runtime = await initWorkflow({
 			workflow,
-			instance,
 			startAgent: async () => {},
 			logger,
 			contextProvider,
 			contextDir,
 			persistent,
 			onMention: (from, target, entry) => {
-				const controller = controllers.get(target);
-				if (controller) {
+				const loop = loops.get(target);
+				if (loop) {
 					const preview = entry.content.length > 80 ? entry.content.slice(0, 80) + "..." : entry.content;
-					logger.debug(`@mention: ${from} → @${target} (state=${controller.state}): ${preview}`);
-					controller.wake();
-				} else logger.debug(`@mention: ${from} → @${target} (no controller found!)`);
+					logger.debug(`@mention: ${from} → @${target} (state=${loop.state}): ${preview}`);
+					loop.wake();
+				} else logger.debug(`@mention: ${from} → @${target} (no loop found!)`);
 			},
 			debugLog: (msg) => {
 				logger.debug(msg);
 			},
-			feedback: feedbackEnabled
+			feedback: feedbackEnabled,
+			params: paramValues
 		});
 		logger.debug("Runtime initialized", {
 			agentNames: runtime.agentNames,
@@ -532,11 +539,11 @@ async function runWorkflowWithControllers(config) {
 		logger.info("Starting agents...");
 		for (const agentName of runtime.agentNames) {
 			const agentDef = workflow.agents[agentName];
-			logger.debug(`Creating controller for ${agentName}`, {
+			logger.debug(`Creating loop for ${agentName}`, {
 				backend: agentDef.backend,
 				model: agentDef.model
 			});
-			const { controller, backend } = createWiredController({
+			const { loop, backend } = createWiredLoop({
 				name: agentName,
 				agent: agentDef,
 				runtime,
@@ -546,16 +553,16 @@ async function runWorkflowWithControllers(config) {
 				logger: logger.child(agentName)
 			});
 			logger.debug(`Using backend: ${backend.type} for ${agentName}`);
-			controllers.set(agentName, controller);
-			await controller.start();
-			logger.debug(`Controller started: ${agentName}`);
+			loops.set(agentName, loop);
+			await loop.start();
+			logger.debug(`Loop started: ${agentName}`);
 		}
 		logger.debug("Sending kickoff message...");
 		await runtime.sendKickoff();
 		logger.debug("Kickoff sent");
 		let channelWatcher;
 		if (!config.headless) if (config.prettyDisplay) {
-			const { startPrettyDisplay } = await import("./display-pretty-BCJq5v9d.mjs");
+			const { startPrettyDisplay } = await import("./display-pretty-Kyd40DEF.mjs");
 			channelWatcher = startPrettyDisplay({
 				contextProvider: runtime.contextProvider,
 				agentNames: runtime.agentNames,
@@ -577,12 +584,12 @@ async function runWorkflowWithControllers(config) {
 			logger.debug("Running in \"run\" mode, waiting for completion...");
 			let idleCheckCount = 0;
 			while (true) {
-				const isIdle = await checkWorkflowIdle(controllers, runtime.contextProvider);
+				const isIdle = await checkWorkflowIdle(loops, runtime.contextProvider);
 				idleCheckCount++;
 				if (idleCheckCount % 10 === 0) {
-					const states = [...controllers.entries()].map(([n, c]) => `${n}=${c.state}`).join(", ");
+					const states = [...loops.entries()].map(([n, c]) => `${n}=${c.state}`).join(", ");
 					logger.debug(`Idle check #${idleCheckCount}: ${states}`);
-					for (const [agentName] of controllers) {
+					for (const [agentName] of loops) {
 						const inbox = await runtime.contextProvider.getInbox(agentName);
 						if (inbox.length > 0) {
 							const unseenCount = inbox.filter((m) => !m.seen).length;
@@ -602,7 +609,7 @@ async function runWorkflowWithControllers(config) {
 				await sleep(1e3);
 			}
 			channelWatcher?.stop();
-			await shutdownControllers(controllers, logger);
+			await shutdownLoops(loops, logger);
 			await runtime.shutdown();
 			logger.debug(`Workflow finished in ${Date.now() - startTime}ms`);
 			return {
@@ -621,10 +628,10 @@ async function runWorkflowWithControllers(config) {
 			duration: Date.now() - startTime,
 			mcpUrl: runtime.mcpUrl,
 			contextProvider: runtime.contextProvider,
-			controllers,
+			loops,
 			shutdown: async () => {
 				channelWatcher?.stop();
-				await shutdownControllers(controllers, logger);
+				await shutdownLoops(loops, logger);
 				await runtime.shutdown();
 			},
 			getFeedback: runtime.getFeedback
@@ -641,16 +648,16 @@ async function runWorkflowWithControllers(config) {
 	}
 }
 /**
-* Gracefully shutdown all controllers
+* Gracefully shutdown all loops
 */
-async function shutdownControllers(controllers, logger) {
-	logger.debug("Stopping controllers...");
-	const stopPromises = [...controllers.values()].map(async (controller) => {
-		await controller.stop();
-		logger.debug(`Stopped controller: ${controller.name}`);
+async function shutdownLoops(loops, logger) {
+	logger.debug("Stopping loops...");
+	const stopPromises = [...loops.values()].map(async (loop) => {
+		await loop.stop();
+		logger.debug(`Stopped loop: ${loop.name}`);
 	});
 	await Promise.all(stopPromises);
-	logger.debug("All controllers stopped");
+	logger.debug("All loops stopped");
 }
 /**
 * Sleep helper
@@ -660,4 +667,4 @@ function sleep(ms) {
 }
 
 //#endregion
-export { createWorkflowProvider, initWorkflow, interpolate as n, runWorkflowWithControllers, shutdownControllers, createContext as t };
+export { createWorkflowProvider, initWorkflow, interpolate as n, runWorkflowWithLoops, shutdownLoops, createContext as t };