@aigne/agent-runtime 1.12.0-beta.5

package/dist/agent-runners/team-runner.cjs

@@ -0,0 +1,277 @@
+const require_memory_archive = require('./memory-archive.cjs');
+const require_hook_channel = require('./hook-channel.cjs');
+const require_scoped_afs = require('../program/scoped-afs.cjs');
+const require_iterate = require('./team-modes/iterate.cjs');
+const require_parallel = require('./team-modes/parallel.cjs');
+const require_reflection = require('./team-modes/reflection.cjs');
+const require_sequential = require('./team-modes/sequential.cjs');
+const require_agent_runner_registry = require('../program/agent-runner-registry.cjs');
+let ufo = require("ufo");
+let _aigne_afs = require("@aigne/afs");
+
+//#region src/agent-runners/team-runner.ts
+async function persistedHookPathSpread(afs, session, events) {
+	const path = await require_hook_channel.persistHookEvents(afs, session, events);
+	return path ? { hook_events_path: path } : {};
+}
+function createMemberRunner(context, handoffAppendix) {
+	const parentSessionId = require_scoped_afs.runnerSession(context.afs, context.session);
+	const parentScope = require_scoped_afs.resolveParentAgentScope({
+		afs: context.afs,
+		manifest: context.manifest,
+		session: parentSessionId
+	});
+	const baseSystemAppend = handoffAppendix ? context.systemAppend ? `${context.systemAppend}\n\n${handoffAppendix}` : handoffAppendix : context.systemAppend;
+	const teamInputKey = context.manifest.inputKey ?? "message";
+	/**
+	* B15 — bridge the task payload to the member's own `input_key`.
+	*
+	* Team-level input lives under the team's inputKey (e.g. `message`) or
+	* arrives pre-keyed from sequential/iterate pipelines. The member may
+	* declare a different inputKey (e.g. `topic`, `query`). Without this
+	* bridge, aiRunner would read `input[memberInputKey]` → undefined →
+	* agent-run throws `requires 'task' parameter as string`.
+	*/
+	function remapForMember(memberInput, memberInputKey) {
+		if (memberInputKey === teamInputKey) return memberInput;
+		if (memberInput[memberInputKey] !== void 0) return memberInput;
+		const taskValue = memberInput[teamInputKey] ?? memberInput.message ?? memberInput.task ?? memberInput.text;
+		if (taskValue === void 0) return memberInput;
+		return {
+			...memberInput,
+			[memberInputKey]: taskValue
+		};
+	}
+	return async (memberPath, input, session) => {
+		const agentYmlPath = (0, ufo.joinURL)((0, _aigne_afs.resolveMemberPath)(memberPath), "agent.yml");
+		let subManifestRaw;
+		try {
+			subManifestRaw = (await context.afs.read(agentYmlPath))?.data?.content ?? "";
+		} catch (err) {
+			return {
+				success: false,
+				error: {
+					code: "MEMBER_NOT_FOUND",
+					message: `Cannot load member agent.yml at ${agentYmlPath}: ${err instanceof Error ? err.message : String(err)}`,
+					member: memberPath
+				}
+			};
+		}
+		let subManifest;
+		try {
+			subManifest = (0, _aigne_afs.parseAgentManifest)(typeof subManifestRaw === "string" ? subManifestRaw : String(subManifestRaw ?? ""));
+		} catch (err) {
+			return {
+				success: false,
+				error: {
+					code: "MEMBER_MANIFEST_INVALID",
+					message: `Invalid agent.yml for member "${memberPath}": ${err instanceof Error ? err.message : String(err)}`,
+					member: memberPath
+				}
+			};
+		}
+		if (context.manifest.memory !== void 0 && subManifest.memory === void 0) subManifest = {
+			...subManifest,
+			memory: context.manifest.memory
+		};
+		let subAfs;
+		try {
+			subAfs = require_scoped_afs.projectForChild(parentScope, {
+				memberPath,
+				childManifest: subManifest,
+				session
+			});
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			return {
+				success: false,
+				error: {
+					code: message.split(":")[0] ?? "SCOPE_PROJECTION_ERROR",
+					message: `Cannot project scope for member "${memberPath}": ${message}`,
+					member: memberPath
+				}
+			};
+		}
+		const subContext = {
+			afs: subAfs,
+			mountPath: "/packages",
+			manifest: subManifest,
+			session,
+			parentSession: parentSessionId,
+			chain: context.chain,
+			systemAppend: baseSystemAppend
+		};
+		const memberInput = remapForMember(input, subManifest.inputKey ?? "message");
+		let result;
+		try {
+			result = await require_agent_runner_registry.getRunnerForType(subManifest.type)(memberInput, subContext);
+		} catch (err) {
+			return {
+				success: false,
+				error: {
+					code: "MEMBER_DISPATCH_ERROR",
+					message: `Member "${memberPath}" dispatch failed: ${err instanceof Error ? err.message : String(err)}`,
+					member: memberPath
+				}
+			};
+		}
+		return result;
+	};
+}
+async function runTeamAgent(input, context) {
+	const { manifest } = context;
+	const session = require_scoped_afs.runnerSession(context.afs, context.session);
+	const scopedAfs = require_scoped_afs.ensureScopeWithMounts(context.afs, {
+		session: session ?? "root",
+		manifestTools: require_scoped_afs.normalizeManifestTools(manifest),
+		scratchRetention: manifest.scratch ? "session" : "run",
+		budget: manifest.budget,
+		memory: manifest.memory
+	});
+	const scopedContext = {
+		...context,
+		afs: scopedAfs,
+		session
+	};
+	const mode = manifest.mode ?? "parallel";
+	const inputKey = manifest.inputKey ?? "message";
+	const hookChannel = require_hook_channel.createHookChannel();
+	let handoffAppendix;
+	if (require_memory_archive.isHandoffReadThroughEnabled(manifest.memory)) {
+		const domain = scopedAfs.scope?.memoryDomain;
+		if (domain) {
+			const formatted = require_memory_archive.formatRecallForPrompt(await require_memory_archive.recallForHandoff({
+				afs: scopedAfs,
+				domain
+			}));
+			if (formatted) handoffAppendix = formatted;
+		}
+	}
+	const runMember = createMemberRunner(scopedContext, handoffAppendix);
+	if (scopedContext.hookDispatcher && manifest.hooks?.onHandoff) hookChannel.subscribe((event) => {
+		if (event.name === "on_handoff") scopedContext.hookDispatcher.fireOnHandoff(event.from, event.to, event.iteration);
+	});
+	if (mode === "reflection") {
+		if (!manifest.actor || !manifest.reviewer) return {
+			success: false,
+			error: {
+				code: "REFLECTION_MISSING_ROLES",
+				message: "Reflection mode requires both actor and reviewer"
+			},
+			_meta: {
+				mode: "reflection",
+				hook_events: []
+			}
+		};
+		const result$1 = await require_reflection.runReflection({
+			afs: scopedAfs,
+			actorPath: manifest.actor,
+			reviewerPath: manifest.reviewer,
+			session: session ?? "default",
+			inputKey,
+			input,
+			isApprovedField: manifest.isApproved ?? "approved",
+			maxIterations: manifest.maxIterations ?? 5,
+			returnLastOnMax: manifest.returnLastOnMax ?? false,
+			hookChannel,
+			runMember
+		});
+		return {
+			success: result$1.success,
+			data: result$1.data,
+			error: result$1.error,
+			_meta: {
+				mode: "reflection",
+				iterations: result$1._meta.iterations,
+				max_iterations_hit: result$1._meta.max_iterations_hit,
+				hook_events: result$1._meta.hook_events,
+				...await persistedHookPathSpread(scopedAfs, session, result$1._meta.hook_events)
+			}
+		};
+	}
+	const members = manifest.members ?? [];
+	if (members.length === 0) return {
+		success: false,
+		error: {
+			code: "TEAM_NO_MEMBERS",
+			message: "Team has no members"
+		},
+		_meta: {
+			mode,
+			hook_events: []
+		}
+	};
+	const inputValue = input[inputKey];
+	if (Array.isArray(inputValue) && mode === "sequential") {
+		const result$1 = await require_iterate.runIterate({
+			members,
+			session: session ?? "default",
+			inputKey,
+			items: inputValue,
+			concurrency: manifest.concurrency,
+			runMember
+		});
+		return {
+			success: result$1.success,
+			data: result$1.data,
+			error: result$1.error,
+			_meta: {
+				mode: "iterate_on",
+				items_count: result$1._meta.items_count,
+				max_concurrency: result$1._meta.max_concurrency,
+				hook_events: result$1._meta.hook_events,
+				...await persistedHookPathSpread(scopedAfs, session, result$1._meta.hook_events)
+			}
+		};
+	}
+	if (mode === "sequential") {
+		const result$1 = await require_sequential.runSequential({
+			members,
+			session: session ?? "default",
+			inputKey,
+			input,
+			hookChannel,
+			runMember
+		});
+		return {
+			success: result$1.success,
+			data: result$1.data,
+			error: result$1.error,
+			_meta: {
+				mode: "sequential",
+				members_run: result$1._meta.members_run,
+				completed_steps: result$1._meta.completed_steps,
+				hook_events: result$1._meta.hook_events,
+				...await persistedHookPathSpread(scopedAfs, session, result$1._meta.hook_events),
+				member_run_ids: result$1._meta.member_run_ids,
+				rounds: result$1._meta.rounds,
+				tokens_used: result$1._meta.tokens_used,
+				sub_runs: result$1._meta.sub_runs
+			}
+		};
+	}
+	const result = await require_parallel.runParallel({
+		members,
+		session: session ?? "default",
+		input,
+		concurrency: manifest.concurrency,
+		runMember
+	});
+	return {
+		success: result.success,
+		data: result.data,
+		_meta: {
+			mode: "parallel",
+			sub_runs: result._meta.sub_runs,
+			max_concurrency: result._meta.max_concurrency,
+			hook_events: result._meta.hook_events,
+			...await persistedHookPathSpread(scopedAfs, session, result._meta.hook_events),
+			member_run_ids: result._meta.member_run_ids,
+			rounds: result._meta.rounds,
+			tokens_used: result._meta.tokens_used
+		}
+	};
+}
+
+//#endregion
+exports.runTeamAgent = runTeamAgent;

package/dist/agent-runners/team-runner.d.cts

@@ -0,0 +1,34 @@
+import { HookEvent } from "./hook-channel.cjs";
+import { RunnerContext } from "../program/agent-runner-registry.cjs";
+
+//#region src/agent-runners/team-runner.d.ts
+interface TeamRunnerResult {
+  success: boolean;
+  data?: Record<string, unknown>;
+  result?: Record<string, unknown>;
+  error?: {
+    code: string;
+    message: string;
+    member?: string;
+    index?: number;
+  };
+  _meta?: {
+    mode: string;
+    members_run?: number;
+    sub_runs?: number;
+    completed_steps?: number;
+    iterations?: number;
+    max_iterations_hit?: boolean;
+    max_concurrency?: number;
+    items_count?: number;
+    hook_events?: HookEvent[];
+    hook_events_path?: string;
+    member_run_ids?: string[];
+    rounds?: number;
+    tokens_used?: number;
+  };
+}
+declare function runTeamAgent(input: Record<string, unknown>, context: RunnerContext): Promise<TeamRunnerResult>;
+//#endregion
+export { TeamRunnerResult, runTeamAgent };
+//# sourceMappingURL=team-runner.d.cts.map

package/dist/agent-runners/team-runner.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-runner.d.cts","names":[],"sources":["../../src/agent-runners/team-runner.ts"],"mappings":";;;;UAiCiB,gBAAA;EACf,OAAA;EACA,IAAA,GAAO,MAAA;EACP,MAAA,GAAS,MAAA;EACT,KAAA;IAAU,IAAA;IAAc,OAAA;IAAiB,MAAA;IAAiB,KAAA;EAAA;EAC1D,KAAA;IACE,IAAA;IACA,WAAA;IACA,QAAA;IACA,eAAA;IACA,UAAA;IACA,kBAAA;IACA,eAAA;IACA,WAAA;IACA,WAAA,GAAc,SAAA;IACd,gBAAA;IACA,cAAA;IACA,MAAA;IACA,WAAA;EAAA;AAAA;AAAA,iBAkJkB,YAAA,CACpB,KAAA,EAAO,MAAA,mBACP,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,gBAAA"}

package/dist/agent-runners/team-runner.d.mts

@@ -0,0 +1,34 @@
+import { HookEvent } from "./hook-channel.mjs";
+import { RunnerContext } from "../program/agent-runner-registry.mjs";
+
+//#region src/agent-runners/team-runner.d.ts
+interface TeamRunnerResult {
+  success: boolean;
+  data?: Record<string, unknown>;
+  result?: Record<string, unknown>;
+  error?: {
+    code: string;
+    message: string;
+    member?: string;
+    index?: number;
+  };
+  _meta?: {
+    mode: string;
+    members_run?: number;
+    sub_runs?: number;
+    completed_steps?: number;
+    iterations?: number;
+    max_iterations_hit?: boolean;
+    max_concurrency?: number;
+    items_count?: number;
+    hook_events?: HookEvent[];
+    hook_events_path?: string;
+    member_run_ids?: string[];
+    rounds?: number;
+    tokens_used?: number;
+  };
+}
+declare function runTeamAgent(input: Record<string, unknown>, context: RunnerContext): Promise<TeamRunnerResult>;
+//#endregion
+export { TeamRunnerResult, runTeamAgent };
+//# sourceMappingURL=team-runner.d.mts.map

package/dist/agent-runners/team-runner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-runner.d.mts","names":[],"sources":["../../src/agent-runners/team-runner.ts"],"mappings":";;;;UAiCiB,gBAAA;EACf,OAAA;EACA,IAAA,GAAO,MAAA;EACP,MAAA,GAAS,MAAA;EACT,KAAA;IAAU,IAAA;IAAc,OAAA;IAAiB,MAAA;IAAiB,KAAA;EAAA;EAC1D,KAAA;IACE,IAAA;IACA,WAAA;IACA,QAAA;IACA,eAAA;IACA,UAAA;IACA,kBAAA;IACA,eAAA;IACA,WAAA;IACA,WAAA,GAAc,SAAA;IACd,gBAAA;IACA,cAAA;IACA,MAAA;IACA,WAAA;EAAA;AAAA;AAAA,iBAkJkB,YAAA,CACpB,KAAA,EAAO,MAAA,mBACP,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,gBAAA"}

package/dist/agent-runners/team-runner.mjs

@@ -0,0 +1,278 @@
+import { formatRecallForPrompt, isHandoffReadThroughEnabled, recallForHandoff } from "./memory-archive.mjs";
+import { createHookChannel, persistHookEvents } from "./hook-channel.mjs";
+import { ensureScopeWithMounts, normalizeManifestTools, projectForChild, resolveParentAgentScope, runnerSession } from "../program/scoped-afs.mjs";
+import { runIterate } from "./team-modes/iterate.mjs";
+import { runParallel } from "./team-modes/parallel.mjs";
+import { runReflection } from "./team-modes/reflection.mjs";
+import { runSequential } from "./team-modes/sequential.mjs";
+import { getRunnerForType } from "../program/agent-runner-registry.mjs";
+import { joinURL } from "ufo";
+import { parseAgentManifest, resolveMemberPath } from "@aigne/afs";
+
+//#region src/agent-runners/team-runner.ts
+async function persistedHookPathSpread(afs, session, events) {
+	const path = await persistHookEvents(afs, session, events);
+	return path ? { hook_events_path: path } : {};
+}
+function createMemberRunner(context, handoffAppendix) {
+	const parentSessionId = runnerSession(context.afs, context.session);
+	const parentScope = resolveParentAgentScope({
+		afs: context.afs,
+		manifest: context.manifest,
+		session: parentSessionId
+	});
+	const baseSystemAppend = handoffAppendix ? context.systemAppend ? `${context.systemAppend}\n\n${handoffAppendix}` : handoffAppendix : context.systemAppend;
+	const teamInputKey = context.manifest.inputKey ?? "message";
+	/**
+	* B15 — bridge the task payload to the member's own `input_key`.
+	*
+	* Team-level input lives under the team's inputKey (e.g. `message`) or
+	* arrives pre-keyed from sequential/iterate pipelines. The member may
+	* declare a different inputKey (e.g. `topic`, `query`). Without this
+	* bridge, aiRunner would read `input[memberInputKey]` → undefined →
+	* agent-run throws `requires 'task' parameter as string`.
+	*/
+	function remapForMember(memberInput, memberInputKey) {
+		if (memberInputKey === teamInputKey) return memberInput;
+		if (memberInput[memberInputKey] !== void 0) return memberInput;
+		const taskValue = memberInput[teamInputKey] ?? memberInput.message ?? memberInput.task ?? memberInput.text;
+		if (taskValue === void 0) return memberInput;
+		return {
+			...memberInput,
+			[memberInputKey]: taskValue
+		};
+	}
+	return async (memberPath, input, session) => {
+		const agentYmlPath = joinURL(resolveMemberPath(memberPath), "agent.yml");
+		let subManifestRaw;
+		try {
+			subManifestRaw = (await context.afs.read(agentYmlPath))?.data?.content ?? "";
+		} catch (err) {
+			return {
+				success: false,
+				error: {
+					code: "MEMBER_NOT_FOUND",
+					message: `Cannot load member agent.yml at ${agentYmlPath}: ${err instanceof Error ? err.message : String(err)}`,
+					member: memberPath
+				}
+			};
+		}
+		let subManifest;
+		try {
+			subManifest = parseAgentManifest(typeof subManifestRaw === "string" ? subManifestRaw : String(subManifestRaw ?? ""));
+		} catch (err) {
+			return {
+				success: false,
+				error: {
+					code: "MEMBER_MANIFEST_INVALID",
+					message: `Invalid agent.yml for member "${memberPath}": ${err instanceof Error ? err.message : String(err)}`,
+					member: memberPath
+				}
+			};
+		}
+		if (context.manifest.memory !== void 0 && subManifest.memory === void 0) subManifest = {
+			...subManifest,
+			memory: context.manifest.memory
+		};
+		let subAfs;
+		try {
+			subAfs = projectForChild(parentScope, {
+				memberPath,
+				childManifest: subManifest,
+				session
+			});
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			return {
+				success: false,
+				error: {
+					code: message.split(":")[0] ?? "SCOPE_PROJECTION_ERROR",
+					message: `Cannot project scope for member "${memberPath}": ${message}`,
+					member: memberPath
+				}
+			};
+		}
+		const subContext = {
+			afs: subAfs,
+			mountPath: "/packages",
+			manifest: subManifest,
+			session,
+			parentSession: parentSessionId,
+			chain: context.chain,
+			systemAppend: baseSystemAppend
+		};
+		const memberInput = remapForMember(input, subManifest.inputKey ?? "message");
+		let result;
+		try {
+			result = await getRunnerForType(subManifest.type)(memberInput, subContext);
+		} catch (err) {
+			return {
+				success: false,
+				error: {
+					code: "MEMBER_DISPATCH_ERROR",
+					message: `Member "${memberPath}" dispatch failed: ${err instanceof Error ? err.message : String(err)}`,
+					member: memberPath
+				}
+			};
+		}
+		return result;
+	};
+}
+async function runTeamAgent(input, context) {
+	const { manifest } = context;
+	const session = runnerSession(context.afs, context.session);
+	const scopedAfs = ensureScopeWithMounts(context.afs, {
+		session: session ?? "root",
+		manifestTools: normalizeManifestTools(manifest),
+		scratchRetention: manifest.scratch ? "session" : "run",
+		budget: manifest.budget,
+		memory: manifest.memory
+	});
+	const scopedContext = {
+		...context,
+		afs: scopedAfs,
+		session
+	};
+	const mode = manifest.mode ?? "parallel";
+	const inputKey = manifest.inputKey ?? "message";
+	const hookChannel = createHookChannel();
+	let handoffAppendix;
+	if (isHandoffReadThroughEnabled(manifest.memory)) {
+		const domain = scopedAfs.scope?.memoryDomain;
+		if (domain) {
+			const formatted = formatRecallForPrompt(await recallForHandoff({
+				afs: scopedAfs,
+				domain
+			}));
+			if (formatted) handoffAppendix = formatted;
+		}
+	}
+	const runMember = createMemberRunner(scopedContext, handoffAppendix);
+	if (scopedContext.hookDispatcher && manifest.hooks?.onHandoff) hookChannel.subscribe((event) => {
+		if (event.name === "on_handoff") scopedContext.hookDispatcher.fireOnHandoff(event.from, event.to, event.iteration);
+	});
+	if (mode === "reflection") {
+		if (!manifest.actor || !manifest.reviewer) return {
+			success: false,
+			error: {
+				code: "REFLECTION_MISSING_ROLES",
+				message: "Reflection mode requires both actor and reviewer"
+			},
+			_meta: {
+				mode: "reflection",
+				hook_events: []
+			}
+		};
+		const result$1 = await runReflection({
+			afs: scopedAfs,
+			actorPath: manifest.actor,
+			reviewerPath: manifest.reviewer,
+			session: session ?? "default",
+			inputKey,
+			input,
+			isApprovedField: manifest.isApproved ?? "approved",
+			maxIterations: manifest.maxIterations ?? 5,
+			returnLastOnMax: manifest.returnLastOnMax ?? false,
+			hookChannel,
+			runMember
+		});
+		return {
+			success: result$1.success,
+			data: result$1.data,
+			error: result$1.error,
+			_meta: {
+				mode: "reflection",
+				iterations: result$1._meta.iterations,
+				max_iterations_hit: result$1._meta.max_iterations_hit,
+				hook_events: result$1._meta.hook_events,
+				...await persistedHookPathSpread(scopedAfs, session, result$1._meta.hook_events)
+			}
+		};
+	}
+	const members = manifest.members ?? [];
+	if (members.length === 0) return {
+		success: false,
+		error: {
+			code: "TEAM_NO_MEMBERS",
+			message: "Team has no members"
+		},
+		_meta: {
+			mode,
+			hook_events: []
+		}
+	};
+	const inputValue = input[inputKey];
+	if (Array.isArray(inputValue) && mode === "sequential") {
+		const result$1 = await runIterate({
+			members,
+			session: session ?? "default",
+			inputKey,
+			items: inputValue,
+			concurrency: manifest.concurrency,
+			runMember
+		});
+		return {
+			success: result$1.success,
+			data: result$1.data,
+			error: result$1.error,
+			_meta: {
+				mode: "iterate_on",
+				items_count: result$1._meta.items_count,
+				max_concurrency: result$1._meta.max_concurrency,
+				hook_events: result$1._meta.hook_events,
+				...await persistedHookPathSpread(scopedAfs, session, result$1._meta.hook_events)
+			}
+		};
+	}
+	if (mode === "sequential") {
+		const result$1 = await runSequential({
+			members,
+			session: session ?? "default",
+			inputKey,
+			input,
+			hookChannel,
+			runMember
+		});
+		return {
+			success: result$1.success,
+			data: result$1.data,
+			error: result$1.error,
+			_meta: {
+				mode: "sequential",
+				members_run: result$1._meta.members_run,
+				completed_steps: result$1._meta.completed_steps,
+				hook_events: result$1._meta.hook_events,
+				...await persistedHookPathSpread(scopedAfs, session, result$1._meta.hook_events),
+				member_run_ids: result$1._meta.member_run_ids,
+				rounds: result$1._meta.rounds,
+				tokens_used: result$1._meta.tokens_used,
+				sub_runs: result$1._meta.sub_runs
+			}
+		};
+	}
+	const result = await runParallel({
+		members,
+		session: session ?? "default",
+		input,
+		concurrency: manifest.concurrency,
+		runMember
+	});
+	return {
+		success: result.success,
+		data: result.data,
+		_meta: {
+			mode: "parallel",
+			sub_runs: result._meta.sub_runs,
+			max_concurrency: result._meta.max_concurrency,
+			hook_events: result._meta.hook_events,
+			...await persistedHookPathSpread(scopedAfs, session, result._meta.hook_events),
+			member_run_ids: result._meta.member_run_ids,
+			rounds: result._meta.rounds,
+			tokens_used: result._meta.tokens_used
+		}
+	};
+}
+
+//#endregion
+export { runTeamAgent };
+//# sourceMappingURL=team-runner.mjs.map

package/dist/agent-runners/team-runner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-runner.mjs","names":["result"],"sources":["../../src/agent-runners/team-runner.ts"],"sourcesContent":["import type { AFSExecResult, AFSRoot } from \"@aigne/afs\";\nimport { parseAgentManifest, resolveMemberPath } from \"@aigne/afs\";\nimport { joinURL } from \"ufo\";\nimport { getRunnerForType, type RunnerContext } from \"../program/agent-runner-registry.js\";\nimport {\n  type AgentScope,\n  ensureScopeWithMounts,\n  normalizeManifestTools,\n  projectForChild,\n  resolveParentAgentScope,\n  runnerSession,\n} from \"../program/scoped-afs.js\";\nimport { createHookChannel, type HookEvent, persistHookEvents } from \"./hook-channel.js\";\nimport {\n  formatRecallForPrompt,\n  isHandoffReadThroughEnabled,\n  recallForHandoff,\n} from \"./memory-archive.js\";\nimport { runIterate } from \"./team-modes/iterate.js\";\nimport { runParallel } from \"./team-modes/parallel.js\";\nimport { runReflection } from \"./team-modes/reflection.js\";\nimport { runSequential } from \"./team-modes/sequential.js\";\nimport type { MemberRunFn } from \"./team-modes/types.js\";\n\nasync function persistedHookPathSpread(\n  afs: RunnerContext[\"afs\"],\n  session: string | undefined,\n  events: HookEvent[],\n): Promise<{ hook_events_path?: string }> {\n  const path = await persistHookEvents(afs, session, events);\n  return path ? { hook_events_path: path } : {};\n}\n\nexport interface TeamRunnerResult {\n  success: boolean;\n  data?: Record<string, unknown>;\n  result?: Record<string, unknown>;\n  error?: { code: string; message: string; member?: string; index?: number };\n  _meta?: {\n    mode: string;\n    members_run?: number;\n    sub_runs?: number;\n    completed_steps?: number;\n    iterations?: number;\n    max_iterations_hit?: boolean;\n    max_concurrency?: number;\n    items_count?: number;\n    hook_events?: HookEvent[];\n    hook_events_path?: string;\n    member_run_ids?: string[];\n    rounds?: number;\n    tokens_used?: number;\n  };\n}\n\nfunction createMemberRunner(context: RunnerContext, handoffAppendix?: string): MemberRunFn {\n  // Phase 5 — anchor the parent scope on the scope-carried session id so a\n  // child dispatched below sees the scope's session as its parentSession,\n  // not whatever legacy context field happened to be populated.\n  const parentSessionId = runnerSession(context.afs, context.session);\n  const parentScope = resolveParentAgentScope({\n    afs: context.afs,\n    manifest: context.manifest,\n    session: parentSessionId,\n  });\n\n  const baseSystemAppend = handoffAppendix\n    ? context.systemAppend\n      ? `${context.systemAppend}\\n\\n${handoffAppendix}`\n      : handoffAppendix\n    : context.systemAppend;\n\n  const teamInputKey = context.manifest.inputKey ?? \"message\";\n\n  /**\n   * B15 — bridge the task payload to the member's own `input_key`.\n   *\n   * Team-level input lives under the team's inputKey (e.g. `message`) or\n   * arrives pre-keyed from sequential/iterate pipelines. The member may\n   * declare a different inputKey (e.g. `topic`, `query`). Without this\n   * bridge, aiRunner would read `input[memberInputKey]` → undefined →\n   * agent-run throws `requires 'task' parameter as string`.\n   */\n  function remapForMember(\n    memberInput: Record<string, unknown>,\n    memberInputKey: string,\n  ): Record<string, unknown> {\n    if (memberInputKey === teamInputKey) return memberInput;\n    if (memberInput[memberInputKey] !== undefined) return memberInput;\n\n    const taskValue =\n      memberInput[teamInputKey] ?? memberInput.message ?? memberInput.task ?? memberInput.text;\n\n    if (taskValue === undefined) return memberInput;\n    return { ...memberInput, [memberInputKey]: taskValue };\n  }\n\n  return async (memberPath, input, session) => {\n    const runtimeMemberPath = resolveMemberPath(memberPath);\n    const agentYmlPath = joinURL(runtimeMemberPath, \"agent.yml\");\n\n    let subManifestRaw: unknown;\n    try {\n      const read = await context.afs.read!(agentYmlPath);\n      subManifestRaw = (read as any)?.data?.content ?? \"\";\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      return {\n        success: false,\n        error: {\n          code: \"MEMBER_NOT_FOUND\",\n          message: `Cannot load member agent.yml at ${agentYmlPath}: ${message}`,\n          member: memberPath,\n        },\n      } as unknown as AFSExecResult;\n    }\n\n    let subManifest: ReturnType<typeof parseAgentManifest>;\n    try {\n      subManifest = parseAgentManifest(\n        typeof subManifestRaw === \"string\" ? subManifestRaw : String(subManifestRaw ?? \"\"),\n      );\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      return {\n        success: false,\n        error: {\n          code: \"MEMBER_MANIFEST_INVALID\",\n          message: `Invalid agent.yml for member \"${memberPath}\": ${message}`,\n          member: memberPath,\n        },\n      } as unknown as AFSExecResult;\n    }\n\n    // Inherit team-level `memory:` into members so the child scope mounts\n    // `/memory/` and the AI runner's `wrapToolProgress` / handoff\n    // read-through gates see an enabled config. Member YAML must not declare\n    // `memory:` (scoped-afs invariant); we attach it at runtime so the\n    // invariant is preserved on disk while still propagating the team's\n    // archive + recall settings to the dispatched member.\n    if (context.manifest.memory !== undefined && subManifest.memory === undefined) {\n      subManifest = { ...subManifest, memory: context.manifest.memory };\n    }\n\n    let subAfs: AgentScope;\n    try {\n      subAfs = projectForChild(parentScope, {\n        memberPath,\n        childManifest: subManifest,\n        session,\n      });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      const code = message.split(\":\")[0] ?? \"SCOPE_PROJECTION_ERROR\";\n      return {\n        success: false,\n        error: {\n          code,\n          message: `Cannot project scope for member \"${memberPath}\": ${message}`,\n          member: memberPath,\n        },\n      } as unknown as AFSExecResult;\n    }\n\n    const subContext: RunnerContext = {\n      afs: subAfs as unknown as AFSRoot,\n      mountPath: \"/packages\",\n      manifest: subManifest,\n      session,\n      parentSession: parentSessionId,\n      chain: context.chain,\n      systemAppend: baseSystemAppend,\n    };\n\n    const memberInputKey = subManifest.inputKey ?? \"message\";\n    const memberInput = remapForMember(input, memberInputKey);\n\n    let result: AFSExecResult;\n    try {\n      const runner = getRunnerForType(subManifest.type);\n      result = await runner(memberInput, subContext);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      return {\n        success: false,\n        error: {\n          code: \"MEMBER_DISPATCH_ERROR\",\n          message: `Member \"${memberPath}\" dispatch failed: ${message}`,\n          member: memberPath,\n        },\n      } as unknown as AFSExecResult;\n    }\n\n    return result;\n  };\n}\n\nexport async function runTeamAgent(\n  input: Record<string, unknown>,\n  context: RunnerContext,\n): Promise<TeamRunnerResult> {\n  const { manifest } = context;\n  // Phase 5 — session id comes from scope first, legacy context only as\n  // fallback. Everything below reads `session` through this resolved value.\n  const session = runnerSession(context.afs, context.session);\n  // Bootstrap scope + /scratch/ mount when the caller hasn't already done\n  // so. Ensures hook-channel persistence lands in scope-local\n  // /scratch/hook-channel.jsonl rather than leaking into the parent's\n  // /modules/memory/runs/ tree.\n  const scopedAfs = ensureScopeWithMounts(context.afs, {\n    session: session ?? \"root\",\n    manifestTools: normalizeManifestTools(manifest),\n    scratchRetention: manifest.scratch ? \"session\" : \"run\",\n    budget: manifest.budget,\n    memory: manifest.memory,\n  }) as unknown as AFSRoot;\n  // Phase 5 — after `ensureScopeWithMounts`, the scoped AFS now carries a\n  // scope with `session` set. Downstream consumers (createMemberRunner,\n  // persistHookEvents) must see the resolved session through the scope.\n  const scopedContext: RunnerContext = { ...context, afs: scopedAfs, session };\n  const mode = manifest.mode ?? \"parallel\";\n  const inputKey = manifest.inputKey ?? \"message\";\n  const hookChannel = createHookChannel();\n\n  // G2 — single recall per team dispatch. Every member reuses the same\n  // appendix string rather than re-scanning memory N times under parallel\n  // fan-out. No-op when the team hasn't opted in or the scope has no\n  // resolvable memory domain.\n  let handoffAppendix: string | undefined;\n  if (isHandoffReadThroughEnabled(manifest.memory)) {\n    const domain = (scopedAfs as AgentScope).scope?.memoryDomain;\n    if (domain) {\n      const recalled = await recallForHandoff({ afs: scopedAfs, domain });\n      const formatted = formatRecallForPrompt(recalled);\n      if (formatted) handoffAppendix = formatted;\n    }\n  }\n\n  const runMember = createMemberRunner(scopedContext, handoffAppendix);\n\n  if (scopedContext.hookDispatcher && manifest.hooks?.onHandoff) {\n    hookChannel.subscribe((event) => {\n      if (event.name === \"on_handoff\") {\n        scopedContext.hookDispatcher!.fireOnHandoff(event.from, event.to, event.iteration);\n      }\n    });\n  }\n\n  if (mode === \"reflection\") {\n    if (!manifest.actor || !manifest.reviewer) {\n      return {\n        success: false,\n        error: {\n          code: \"REFLECTION_MISSING_ROLES\",\n          message: \"Reflection mode requires both actor and reviewer\",\n        },\n        _meta: { mode: \"reflection\", hook_events: [] },\n      };\n    }\n\n    const result = await runReflection({\n      afs: scopedAfs,\n      actorPath: manifest.actor,\n      reviewerPath: manifest.reviewer,\n      session: session ?? \"default\",\n      inputKey,\n      input,\n      isApprovedField: manifest.isApproved ?? \"approved\",\n      maxIterations: manifest.maxIterations ?? 5,\n      returnLastOnMax: manifest.returnLastOnMax ?? false,\n      hookChannel,\n      runMember,\n    });\n\n    const teamResult: TeamRunnerResult = {\n      success: result.success,\n      data: result.data,\n      error: result.error,\n      _meta: {\n        mode: \"reflection\",\n        iterations: result._meta.iterations,\n        max_iterations_hit: result._meta.max_iterations_hit,\n        hook_events: result._meta.hook_events,\n        ...(await persistedHookPathSpread(scopedAfs, session, result._meta.hook_events)),\n      },\n    };\n\n    return teamResult;\n  }\n\n  // Validate members for non-reflection modes\n  const members = manifest.members ?? [];\n  if (members.length === 0) {\n    return {\n      success: false,\n      error: { code: \"TEAM_NO_MEMBERS\", message: \"Team has no members\" },\n      _meta: { mode, hook_events: [] },\n    };\n  }\n\n  // Check if input is an array → iterate_on mode\n  const inputValue = input[inputKey];\n  if (Array.isArray(inputValue) && mode === \"sequential\") {\n    const result = await runIterate({\n      members,\n      session: session ?? \"default\",\n      inputKey,\n      items: inputValue,\n      concurrency: manifest.concurrency,\n      runMember,\n    });\n\n    return {\n      success: result.success,\n      data: result.data,\n      error: result.error,\n      _meta: {\n        mode: \"iterate_on\",\n        items_count: result._meta.items_count,\n        max_concurrency: result._meta.max_concurrency,\n        hook_events: result._meta.hook_events,\n        ...(await persistedHookPathSpread(scopedAfs, session, result._meta.hook_events)),\n      },\n    };\n  }\n\n  if (mode === \"sequential\") {\n    const result = await runSequential({\n      members,\n      session: session ?? \"default\",\n      inputKey,\n      input,\n      hookChannel,\n      runMember,\n    });\n\n    const teamResult: TeamRunnerResult = {\n      success: result.success,\n      data: result.data,\n      error: result.error,\n      _meta: {\n        mode: \"sequential\",\n        members_run: result._meta.members_run,\n        completed_steps: result._meta.completed_steps,\n        hook_events: result._meta.hook_events,\n        ...(await persistedHookPathSpread(scopedAfs, session, result._meta.hook_events)),\n        member_run_ids: result._meta.member_run_ids,\n        rounds: result._meta.rounds,\n        tokens_used: result._meta.tokens_used,\n        sub_runs: result._meta.sub_runs,\n      },\n    };\n\n    return teamResult;\n  }\n\n  // Default: parallel\n  const result = await runParallel({\n    members,\n    session: session ?? \"default\",\n    input,\n    concurrency: manifest.concurrency,\n    runMember,\n  });\n\n  const teamResult: TeamRunnerResult = {\n    success: result.success,\n    data: result.data,\n    _meta: {\n      mode: \"parallel\",\n      sub_runs: result._meta.sub_runs,\n      max_concurrency: result._meta.max_concurrency,\n      hook_events: result._meta.hook_events,\n      ...(await persistedHookPathSpread(scopedAfs, session, result._meta.hook_events)),\n      member_run_ids: result._meta.member_run_ids,\n      rounds: result._meta.rounds,\n      tokens_used: result._meta.tokens_used,\n    },\n  };\n\n  return teamResult;\n}\n"],"mappings":"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"}