@aigne/agent-runtime 1.12.0-beta.5

package/dist/agent-runners/team-modes/reflection.cjs

@@ -0,0 +1,155 @@
+const require_memory_archive = require('../memory-archive.cjs');
+const require_utils = require('./utils.cjs');
+
+//#region src/agent-runners/team-modes/reflection.ts
+const HARD_MAX_ITERATIONS = 50;
+function parseReviewerOutput(reply, isApprovedField) {
+	let obj;
+	if (typeof reply === "string") try {
+		obj = JSON.parse(reply);
+	} catch {
+		return {
+			approved: false,
+			feedback: reply
+		};
+	}
+	else if (reply && typeof reply === "object") obj = reply;
+	else return { approved: false };
+	return {
+		approved: !!obj[isApprovedField],
+		feedback: obj.feedback ?? obj
+	};
+}
+async function runReflection(opts) {
+	const { afs, actorPath, reviewerPath, session, inputKey, input, isApprovedField, hookChannel, runMember } = opts;
+	const maxIterations = Math.min(opts.maxIterations, HARD_MAX_ITERATIONS);
+	const returnLastOnMax = opts.returnLastOnMax;
+	const actorName = require_utils.memberName(actorPath);
+	const reviewerName = require_utils.memberName(reviewerPath);
+	const actorSession = require_utils.memberSession(session, actorPath, "actor");
+	const reviewerSession = require_utils.memberSession(session, reviewerPath, "reviewer");
+	let lastActorOutput;
+	let currentInput = { ...input };
+	let iteration = 0;
+	for (iteration = 1; iteration <= maxIterations; iteration++) {
+		const actorResult = await runMember(actorPath, currentInput, actorSession);
+		if (!actorResult.success) return {
+			success: false,
+			error: {
+				code: "TEAM_MEMBER_FAILED",
+				message: `Actor "${actorName}" failed at iteration ${iteration}`,
+				member: actorName
+			},
+			_meta: {
+				mode: "reflection",
+				iterations: iteration,
+				max_iterations_hit: false,
+				hook_events: hookChannel.drain()
+			}
+		};
+		lastActorOutput = require_utils.extractReply(actorResult);
+		const actorContent = require_memory_archive.toContentString(lastActorOutput);
+		const actorHash = require_memory_archive.contentHash(actorContent);
+		await require_memory_archive.tryRemember(afs, {
+			content: actorContent,
+			level: "observation",
+			layer: "execution",
+			anchors: [{
+				type: "topic",
+				values: [actorName],
+				confidence: 1
+			}, {
+				type: "topic",
+				values: ["reflection"],
+				confidence: 1
+			}],
+			meta: {
+				round: iteration,
+				role: "actor",
+				session,
+				output_hash: actorHash
+			}
+		});
+		hookChannel.emit("on_handoff", {
+			from: actorName,
+			to: reviewerName,
+			iteration,
+			session
+		});
+		const reviewerResult = await runMember(reviewerPath, { [inputKey]: typeof lastActorOutput === "string" ? lastActorOutput : JSON.stringify(lastActorOutput) }, reviewerSession);
+		if (!reviewerResult.success) return {
+			success: false,
+			error: {
+				code: "TEAM_MEMBER_FAILED",
+				message: `Reviewer "${reviewerName}" failed at iteration ${iteration}`,
+				member: reviewerName
+			},
+			_meta: {
+				mode: "reflection",
+				iterations: iteration,
+				max_iterations_hit: false,
+				hook_events: hookChannel.drain()
+			}
+		};
+		const reviewerReply = require_utils.extractReply(reviewerResult);
+		const { approved, feedback } = parseReviewerOutput(reviewerReply, isApprovedField);
+		await require_memory_archive.tryRemember(afs, {
+			content: require_memory_archive.toContentString(feedback ?? reviewerReply),
+			level: "observation",
+			layer: "execution",
+			anchors: [{
+				type: "topic",
+				values: [reviewerName],
+				confidence: 1
+			}, {
+				type: "topic",
+				values: ["reflection"],
+				confidence: 1
+			}],
+			meta: {
+				round: iteration,
+				role: "reviewer",
+				session,
+				target_hash: actorHash,
+				approved
+			}
+		});
+		if (approved) return {
+			success: true,
+			data: { result: lastActorOutput },
+			_meta: {
+				mode: "reflection",
+				iterations: iteration,
+				max_iterations_hit: false,
+				hook_events: hookChannel.drain()
+			}
+		};
+		currentInput = { [inputKey]: typeof feedback === "string" ? feedback : JSON.stringify(feedback) };
+	}
+	if (returnLastOnMax && lastActorOutput !== void 0) return {
+		success: true,
+		data: { result: lastActorOutput },
+		_meta: {
+			mode: "reflection",
+			iterations: maxIterations,
+			max_iterations_hit: true,
+			hook_events: hookChannel.drain()
+		}
+	};
+	return {
+		success: false,
+		error: {
+			code: "REFLECTION_MAX_ITERATIONS",
+			message: `Reflection did not converge within ${maxIterations} iterations`
+		},
+		_meta: {
+			mode: "reflection",
+			iterations: maxIterations,
+			max_iterations_hit: true,
+			hook_events: hookChannel.drain()
+		}
+	};
+}
+
+//#endregion
+exports.runReflection = runReflection;

package/dist/agent-runners/team-modes/reflection.mjs

@@ -0,0 +1,156 @@
+import { contentHash, toContentString, tryRemember } from "../memory-archive.mjs";
+import { extractReply, memberName, memberSession } from "./utils.mjs";
+
+//#region src/agent-runners/team-modes/reflection.ts
+const HARD_MAX_ITERATIONS = 50;
+function parseReviewerOutput(reply, isApprovedField) {
+	let obj;
+	if (typeof reply === "string") try {
+		obj = JSON.parse(reply);
+	} catch {
+		return {
+			approved: false,
+			feedback: reply
+		};
+	}
+	else if (reply && typeof reply === "object") obj = reply;
+	else return { approved: false };
+	return {
+		approved: !!obj[isApprovedField],
+		feedback: obj.feedback ?? obj
+	};
+}
+async function runReflection(opts) {
+	const { afs, actorPath, reviewerPath, session, inputKey, input, isApprovedField, hookChannel, runMember } = opts;
+	const maxIterations = Math.min(opts.maxIterations, HARD_MAX_ITERATIONS);
+	const returnLastOnMax = opts.returnLastOnMax;
+	const actorName = memberName(actorPath);
+	const reviewerName = memberName(reviewerPath);
+	const actorSession = memberSession(session, actorPath, "actor");
+	const reviewerSession = memberSession(session, reviewerPath, "reviewer");
+	let lastActorOutput;
+	let currentInput = { ...input };
+	let iteration = 0;
+	for (iteration = 1; iteration <= maxIterations; iteration++) {
+		const actorResult = await runMember(actorPath, currentInput, actorSession);
+		if (!actorResult.success) return {
+			success: false,
+			error: {
+				code: "TEAM_MEMBER_FAILED",
+				message: `Actor "${actorName}" failed at iteration ${iteration}`,
+				member: actorName
+			},
+			_meta: {
+				mode: "reflection",
+				iterations: iteration,
+				max_iterations_hit: false,
+				hook_events: hookChannel.drain()
+			}
+		};
+		lastActorOutput = extractReply(actorResult);
+		const actorContent = toContentString(lastActorOutput);
+		const actorHash = contentHash(actorContent);
+		await tryRemember(afs, {
+			content: actorContent,
+			level: "observation",
+			layer: "execution",
+			anchors: [{
+				type: "topic",
+				values: [actorName],
+				confidence: 1
+			}, {
+				type: "topic",
+				values: ["reflection"],
+				confidence: 1
+			}],
+			meta: {
+				round: iteration,
+				role: "actor",
+				session,
+				output_hash: actorHash
+			}
+		});
+		hookChannel.emit("on_handoff", {
+			from: actorName,
+			to: reviewerName,
+			iteration,
+			session
+		});
+		const reviewerResult = await runMember(reviewerPath, { [inputKey]: typeof lastActorOutput === "string" ? lastActorOutput : JSON.stringify(lastActorOutput) }, reviewerSession);
+		if (!reviewerResult.success) return {
+			success: false,
+			error: {
+				code: "TEAM_MEMBER_FAILED",
+				message: `Reviewer "${reviewerName}" failed at iteration ${iteration}`,
+				member: reviewerName
+			},
+			_meta: {
+				mode: "reflection",
+				iterations: iteration,
+				max_iterations_hit: false,
+				hook_events: hookChannel.drain()
+			}
+		};
+		const reviewerReply = extractReply(reviewerResult);
+		const { approved, feedback } = parseReviewerOutput(reviewerReply, isApprovedField);
+		await tryRemember(afs, {
+			content: toContentString(feedback ?? reviewerReply),
+			level: "observation",
+			layer: "execution",
+			anchors: [{
+				type: "topic",
+				values: [reviewerName],
+				confidence: 1
+			}, {
+				type: "topic",
+				values: ["reflection"],
+				confidence: 1
+			}],
+			meta: {
+				round: iteration,
+				role: "reviewer",
+				session,
+				target_hash: actorHash,
+				approved
+			}
+		});
+		if (approved) return {
+			success: true,
+			data: { result: lastActorOutput },
+			_meta: {
+				mode: "reflection",
+				iterations: iteration,
+				max_iterations_hit: false,
+				hook_events: hookChannel.drain()
+			}
+		};
+		currentInput = { [inputKey]: typeof feedback === "string" ? feedback : JSON.stringify(feedback) };
+	}
+	if (returnLastOnMax && lastActorOutput !== void 0) return {
+		success: true,
+		data: { result: lastActorOutput },
+		_meta: {
+			mode: "reflection",
+			iterations: maxIterations,
+			max_iterations_hit: true,
+			hook_events: hookChannel.drain()
+		}
+	};
+	return {
+		success: false,
+		error: {
+			code: "REFLECTION_MAX_ITERATIONS",
+			message: `Reflection did not converge within ${maxIterations} iterations`
+		},
+		_meta: {
+			mode: "reflection",
+			iterations: maxIterations,
+			max_iterations_hit: true,
+			hook_events: hookChannel.drain()
+		}
+	};
+}
+
+//#endregion
+export { runReflection };
+//# sourceMappingURL=reflection.mjs.map

package/dist/agent-runners/team-modes/reflection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection.mjs","names":[],"sources":["../../../src/agent-runners/team-modes/reflection.ts"],"sourcesContent":["import type { AFSRoot } from \"@aigne/afs\";\nimport type { HookChannel } from \"../hook-channel.js\";\nimport { contentHash, toContentString, tryRemember } from \"../memory-archive.js\";\nimport type { MemberRunFn } from \"./types.js\";\nimport { extractReply, memberName, memberSession } from \"./utils.js\";\n\nconst HARD_MAX_ITERATIONS = 50;\n\nexport interface ReflectionOptions {\n  afs?: AFSRoot;\n  actorPath: string;\n  reviewerPath: string;\n  session: string;\n  inputKey: string;\n  input: Record<string, unknown>;\n  isApprovedField: string;\n  maxIterations: number;\n  returnLastOnMax: boolean;\n  hookChannel: HookChannel;\n  runMember: MemberRunFn;\n}\n\nexport interface ReflectionResult {\n  success: boolean;\n  data?: Record<string, unknown>;\n  error?: { code: string; message: string; member?: string };\n  _meta: {\n    mode: \"reflection\";\n    iterations: number;\n    max_iterations_hit: boolean;\n    hook_events: any[];\n  };\n}\n\nfunction parseReviewerOutput(\n  reply: unknown,\n  isApprovedField: string,\n): { approved: boolean; feedback?: unknown } {\n  let obj: Record<string, unknown>;\n  if (typeof reply === \"string\") {\n    try {\n      obj = JSON.parse(reply);\n    } catch {\n      return { approved: false, feedback: reply };\n    }\n  } else if (reply && typeof reply === \"object\") {\n    obj = reply as Record<string, unknown>;\n  } else {\n    return { approved: false };\n  }\n\n  const approved = !!obj[isApprovedField];\n  return { approved, feedback: obj.feedback ?? obj };\n}\n\nexport async function runReflection(opts: ReflectionOptions): Promise<ReflectionResult> {\n  const {\n    afs,\n    actorPath,\n    reviewerPath,\n    session,\n    inputKey,\n    input,\n    isApprovedField,\n    hookChannel,\n    runMember,\n  } = opts;\n  const maxIterations = Math.min(opts.maxIterations, HARD_MAX_ITERATIONS);\n  const returnLastOnMax = opts.returnLastOnMax;\n\n  const actorName = memberName(actorPath);\n  const reviewerName = memberName(reviewerPath);\n  const actorSession = memberSession(session, actorPath, \"actor\");\n  const reviewerSession = memberSession(session, reviewerPath, \"reviewer\");\n\n  let lastActorOutput: unknown;\n  let currentInput: Record<string, unknown> = { ...input };\n  let iteration = 0;\n\n  for (iteration = 1; iteration <= maxIterations; iteration++) {\n    // Run actor\n    const actorResult = await runMember(actorPath, currentInput, actorSession);\n    if (!actorResult.success) {\n      return {\n        success: false,\n        error: {\n          code: \"TEAM_MEMBER_FAILED\",\n          message: `Actor \"${actorName}\" failed at iteration ${iteration}`,\n          member: actorName,\n        },\n        _meta: {\n          mode: \"reflection\",\n          iterations: iteration,\n          max_iterations_hit: false,\n          hook_events: hookChannel.drain(),\n        },\n      };\n    }\n\n    lastActorOutput = extractReply(actorResult);\n\n    // Archive actor output (fire-and-forget — /memory/.actions/remember).\n    const actorContent = toContentString(lastActorOutput);\n    const actorHash = contentHash(actorContent);\n    await tryRemember(afs, {\n      content: actorContent,\n      level: \"observation\",\n      layer: \"execution\",\n      anchors: [\n        { type: \"topic\", values: [actorName], confidence: 1 },\n        { type: \"topic\", values: [\"reflection\"], confidence: 1 },\n      ],\n      meta: {\n        round: iteration,\n        role: \"actor\",\n        session,\n        output_hash: actorHash,\n      },\n    });\n\n    // Emit on_handoff at iteration boundary (actor → reviewer)\n    hookChannel.emit(\"on_handoff\", {\n      from: actorName,\n      to: reviewerName,\n      iteration,\n      session,\n    });\n\n    // Run reviewer — only pass the actor's output, not internal metadata\n    const reviewerInput: Record<string, unknown> = {\n      [inputKey]:\n        typeof lastActorOutput === \"string\" ? lastActorOutput : JSON.stringify(lastActorOutput),\n    };\n    const reviewerResult = await runMember(reviewerPath, reviewerInput, reviewerSession);\n    if (!reviewerResult.success) {\n      return {\n        success: false,\n        error: {\n          code: \"TEAM_MEMBER_FAILED\",\n          message: `Reviewer \"${reviewerName}\" failed at iteration ${iteration}`,\n          member: reviewerName,\n        },\n        _meta: {\n          mode: \"reflection\",\n          iterations: iteration,\n          max_iterations_hit: false,\n          hook_events: hookChannel.drain(),\n        },\n      };\n    }\n\n    const reviewerReply = extractReply(reviewerResult);\n    const { approved, feedback } = parseReviewerOutput(reviewerReply, isApprovedField);\n\n    // Archive reviewer verdict (fire-and-forget), binding to actor via target_hash.\n    const reviewerContent = toContentString(feedback ?? reviewerReply);\n    await tryRemember(afs, {\n      content: reviewerContent,\n      level: \"observation\",\n      layer: \"execution\",\n      anchors: [\n        { type: \"topic\", values: [reviewerName], confidence: 1 },\n        { type: \"topic\", values: [\"reflection\"], confidence: 1 },\n      ],\n      meta: {\n        round: iteration,\n        role: \"reviewer\",\n        session,\n        target_hash: actorHash,\n        approved,\n      },\n    });\n\n    if (approved) {\n      return {\n        success: true,\n        data: { result: lastActorOutput },\n        _meta: {\n          mode: \"reflection\",\n          iterations: iteration,\n          max_iterations_hit: false,\n          hook_events: hookChannel.drain(),\n        },\n      };\n    }\n\n    // Feed reviewer feedback back to actor for next iteration\n    currentInput = {\n      [inputKey]: typeof feedback === \"string\" ? feedback : JSON.stringify(feedback),\n    };\n  }\n\n  // Max iterations hit\n  if (returnLastOnMax && lastActorOutput !== undefined) {\n    return {\n      success: true,\n      data: { result: lastActorOutput },\n      _meta: {\n        mode: \"reflection\",\n        iterations: maxIterations,\n        max_iterations_hit: true,\n        hook_events: hookChannel.drain(),\n      },\n    };\n  }\n\n  return {\n    success: false,\n    error: {\n      code: \"REFLECTION_MAX_ITERATIONS\",\n      message: `Reflection did not converge within ${maxIterations} iterations`,\n    },\n    _meta: {\n      mode: \"reflection\",\n      iterations: maxIterations,\n      max_iterations_hit: true,\n      hook_events: hookChannel.drain(),\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/agent-runners/team-modes/sequential.cjs

@@ -0,0 +1,63 @@
+const require_utils = require('./utils.cjs');
+const require_aggregates = require('./aggregates.cjs');
+
+//#region src/agent-runners/team-modes/sequential.ts
+async function runSequential(opts) {
+	const { members, session, inputKey, input, hookChannel, runMember } = opts;
+	let currentInput = { ...input };
+	let completedSteps = 0;
+	const agg = require_aggregates.emptyAggregates();
+	for (let i = 0; i < members.length; i++) {
+		const memberPath = members[i];
+		const name = require_utils.memberName(memberPath);
+		if (i > 0) {
+			const prevName = require_utils.memberName(members[i - 1]);
+			hookChannel.emit("on_handoff", {
+				from: prevName,
+				to: name,
+				session
+			});
+		}
+		const memberResult = await runMember(memberPath, currentInput, require_utils.memberSession(session, memberPath, i));
+		require_aggregates.mergeMemberMeta(agg, memberResult);
+		if (!memberResult.success) return {
+			success: false,
+			error: {
+				code: "TEAM_MEMBER_FAILED",
+				message: `Member "${name}" failed at step ${i}`,
+				member: name,
+				index: i
+			},
+			_meta: {
+				mode: "sequential",
+				members_run: i + 1,
+				completed_steps: completedSteps,
+				hook_events: hookChannel.drain(),
+				member_run_ids: agg.member_run_ids,
+				rounds: agg.rounds,
+				tokens_used: agg.tokens_used,
+				sub_runs: i + 1
+			}
+		};
+		completedSteps++;
+		const reply = require_utils.extractReply(memberResult);
+		currentInput = { [inputKey]: typeof reply === "string" ? reply : JSON.stringify(reply) };
+	}
+	return {
+		success: true,
+		data: { result: currentInput[inputKey] },
+		_meta: {
+			mode: "sequential",
+			members_run: members.length,
+			completed_steps: completedSteps,
+			hook_events: hookChannel.drain(),
+			member_run_ids: agg.member_run_ids,
+			rounds: agg.rounds,
+			tokens_used: agg.tokens_used,
+			sub_runs: members.length
+		}
+	};
+}
+
+//#endregion
+exports.runSequential = runSequential;

package/dist/agent-runners/team-modes/sequential.mjs

@@ -0,0 +1,64 @@
+import { extractReply, memberName, memberSession } from "./utils.mjs";
+import { emptyAggregates, mergeMemberMeta } from "./aggregates.mjs";
+
+//#region src/agent-runners/team-modes/sequential.ts
+async function runSequential(opts) {
+	const { members, session, inputKey, input, hookChannel, runMember } = opts;
+	let currentInput = { ...input };
+	let completedSteps = 0;
+	const agg = emptyAggregates();
+	for (let i = 0; i < members.length; i++) {
+		const memberPath = members[i];
+		const name = memberName(memberPath);
+		if (i > 0) {
+			const prevName = memberName(members[i - 1]);
+			hookChannel.emit("on_handoff", {
+				from: prevName,
+				to: name,
+				session
+			});
+		}
+		const memberResult = await runMember(memberPath, currentInput, memberSession(session, memberPath, i));
+		mergeMemberMeta(agg, memberResult);
+		if (!memberResult.success) return {
+			success: false,
+			error: {
+				code: "TEAM_MEMBER_FAILED",
+				message: `Member "${name}" failed at step ${i}`,
+				member: name,
+				index: i
+			},
+			_meta: {
+				mode: "sequential",
+				members_run: i + 1,
+				completed_steps: completedSteps,
+				hook_events: hookChannel.drain(),
+				member_run_ids: agg.member_run_ids,
+				rounds: agg.rounds,
+				tokens_used: agg.tokens_used,
+				sub_runs: i + 1
+			}
+		};
+		completedSteps++;
+		const reply = extractReply(memberResult);
+		currentInput = { [inputKey]: typeof reply === "string" ? reply : JSON.stringify(reply) };
+	}
+	return {
+		success: true,
+		data: { result: currentInput[inputKey] },
+		_meta: {
+			mode: "sequential",
+			members_run: members.length,
+			completed_steps: completedSteps,
+			hook_events: hookChannel.drain(),
+			member_run_ids: agg.member_run_ids,
+			rounds: agg.rounds,
+			tokens_used: agg.tokens_used,
+			sub_runs: members.length
+		}
+	};
+}
+
+//#endregion
+export { runSequential };
+//# sourceMappingURL=sequential.mjs.map

package/dist/agent-runners/team-modes/sequential.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequential.mjs","names":[],"sources":["../../../src/agent-runners/team-modes/sequential.ts"],"sourcesContent":["import type { HookChannel } from \"../hook-channel.js\";\nimport { emptyAggregates, type MemberAggregates, mergeMemberMeta } from \"./aggregates.js\";\nimport type { MemberRunFn } from \"./types.js\";\nimport { extractReply, memberName, memberSession } from \"./utils.js\";\n\nexport interface SequentialOptions {\n  members: string[];\n  session: string;\n  inputKey: string;\n  input: Record<string, unknown>;\n  hookChannel: HookChannel;\n  runMember: MemberRunFn;\n}\n\nexport interface SequentialResult {\n  success: boolean;\n  data?: Record<string, unknown>;\n  error?: { code: string; message: string; member?: string; index?: number };\n  _meta: {\n    mode: \"sequential\";\n    members_run: number;\n    completed_steps: number;\n    hook_events: any[];\n    member_run_ids: string[];\n    rounds: number;\n    tokens_used: number;\n    sub_runs: number;\n  };\n}\n\nexport async function runSequential(opts: SequentialOptions): Promise<SequentialResult> {\n  const { members, session, inputKey, input, hookChannel, runMember } = opts;\n\n  let currentInput: Record<string, unknown> = { ...input };\n  let completedSteps = 0;\n  const agg: MemberAggregates = emptyAggregates();\n\n  for (let i = 0; i < members.length; i++) {\n    const memberPath = members[i]!;\n    const name = memberName(memberPath);\n\n    if (i > 0) {\n      const prevName = memberName(members[i - 1]!);\n      hookChannel.emit(\"on_handoff\", {\n        from: prevName,\n        to: name,\n        session,\n      });\n    }\n\n    const memberResult = await runMember(\n      memberPath,\n      currentInput,\n      memberSession(session, memberPath, i),\n    );\n    mergeMemberMeta(agg, memberResult);\n\n    if (!memberResult.success) {\n      return {\n        success: false,\n        error: {\n          code: \"TEAM_MEMBER_FAILED\",\n          message: `Member \"${name}\" failed at step ${i}`,\n          member: name,\n          index: i,\n        },\n        _meta: {\n          mode: \"sequential\",\n          members_run: i + 1,\n          completed_steps: completedSteps,\n          hook_events: hookChannel.drain(),\n          member_run_ids: agg.member_run_ids,\n          rounds: agg.rounds,\n          tokens_used: agg.tokens_used,\n          sub_runs: i + 1,\n        },\n      };\n    }\n\n    completedSteps++;\n    const reply = extractReply(memberResult);\n    currentInput = { [inputKey]: typeof reply === \"string\" ? reply : JSON.stringify(reply) };\n  }\n\n  const lastReply = currentInput[inputKey];\n\n  return {\n    success: true,\n    data: { result: lastReply },\n    _meta: {\n      mode: \"sequential\",\n      members_run: members.length,\n      completed_steps: completedSteps,\n      hook_events: hookChannel.drain(),\n      member_run_ids: agg.member_run_ids,\n      rounds: agg.rounds,\n      tokens_used: agg.tokens_used,\n      sub_runs: members.length,\n    },\n  };\n}\n"],"mappings":";;;;AA8BA,eAAsB,cAAc,MAAoD;CACtF,MAAM,EAAE,SAAS,SAAS,UAAU,OAAO,aAAa,cAAc;CAEtE,IAAI,eAAwC,EAAE,GAAG,OAAO;CACxD,IAAI,iBAAiB;CACrB,MAAM,MAAwB,iBAAiB;AAE/C,MAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;EACvC,MAAM,aAAa,QAAQ;EAC3B,MAAM,OAAO,WAAW,WAAW;AAEnC,MAAI,IAAI,GAAG;GACT,MAAM,WAAW,WAAW,QAAQ,IAAI,GAAI;AAC5C,eAAY,KAAK,cAAc;IAC7B,MAAM;IACN,IAAI;IACJ;IACD,CAAC;;EAGJ,MAAM,eAAe,MAAM,UACzB,YACA,cACA,cAAc,SAAS,YAAY,EAAE,CACtC;AACD,kBAAgB,KAAK,aAAa;AAElC,MAAI,CAAC,aAAa,QAChB,QAAO;GACL,SAAS;GACT,OAAO;IACL,MAAM;IACN,SAAS,WAAW,KAAK,mBAAmB;IAC5C,QAAQ;IACR,OAAO;IACR;GACD,OAAO;IACL,MAAM;IACN,aAAa,IAAI;IACjB,iBAAiB;IACjB,aAAa,YAAY,OAAO;IAChC,gBAAgB,IAAI;IACpB,QAAQ,IAAI;IACZ,aAAa,IAAI;IACjB,UAAU,IAAI;IACf;GACF;AAGH;EACA,MAAM,QAAQ,aAAa,aAAa;AACxC,iBAAe,GAAG,WAAW,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,MAAM,EAAE;;AAK1F,QAAO;EACL,SAAS;EACT,MAAM,EAAE,QAJQ,aAAa,WAIF;EAC3B,OAAO;GACL,MAAM;GACN,aAAa,QAAQ;GACrB,iBAAiB;GACjB,aAAa,YAAY,OAAO;GAChC,gBAAgB,IAAI;GACpB,QAAQ,IAAI;GACZ,aAAa,IAAI;GACjB,UAAU,QAAQ;GACnB;EACF"}

package/dist/agent-runners/team-modes/utils.cjs

@@ -0,0 +1,39 @@
+
+//#region src/agent-runners/team-modes/utils.ts
+function memberName(memberPath) {
+	const parts = memberPath.replace(/\/$/, "").split("/");
+	return parts[parts.length - 1];
+}
+function sessionComponent(value) {
+	return value.replace(/[^A-Za-z0-9_.-]/g, "_").replace(/^\.+|\.+$/g, "") || "member";
+}
+function memberSession(teamSession, memberPath, discriminator) {
+	const parts = [teamSession, sessionComponent(memberName(memberPath))];
+	if (discriminator !== void 0) parts.push(sessionComponent(String(discriminator)));
+	return parts.join(".");
+}
+function extractReply(result) {
+	const data = result.data;
+	if (data?.result?.reply !== void 0) return data.result.reply;
+	if (data?.result !== void 0) return data.result;
+	return data;
+}
+async function runWithConcurrencyLimit(tasks, limit) {
+	const results = new Array(tasks.length);
+	let nextIndex = 0;
+	async function runNext() {
+		while (nextIndex < tasks.length) {
+			const idx = nextIndex++;
+			results[idx] = await tasks[idx]();
+		}
+	}
+	const workers = Array.from({ length: Math.min(limit, tasks.length) }, () => runNext());
+	await Promise.all(workers);
+	return results;
+}
+
+//#endregion
+exports.extractReply = extractReply;
+exports.memberName = memberName;
+exports.memberSession = memberSession;
+exports.runWithConcurrencyLimit = runWithConcurrencyLimit;

package/dist/agent-runners/team-modes/utils.mjs

@@ -0,0 +1,36 @@
+//#region src/agent-runners/team-modes/utils.ts
+function memberName(memberPath) {
+	const parts = memberPath.replace(/\/$/, "").split("/");
+	return parts[parts.length - 1];
+}
+function sessionComponent(value) {
+	return value.replace(/[^A-Za-z0-9_.-]/g, "_").replace(/^\.+|\.+$/g, "") || "member";
+}
+function memberSession(teamSession, memberPath, discriminator) {
+	const parts = [teamSession, sessionComponent(memberName(memberPath))];
+	if (discriminator !== void 0) parts.push(sessionComponent(String(discriminator)));
+	return parts.join(".");
+}
+function extractReply(result) {
+	const data = result.data;
+	if (data?.result?.reply !== void 0) return data.result.reply;
+	if (data?.result !== void 0) return data.result;
+	return data;
+}
+async function runWithConcurrencyLimit(tasks, limit) {
+	const results = new Array(tasks.length);
+	let nextIndex = 0;
+	async function runNext() {
+		while (nextIndex < tasks.length) {
+			const idx = nextIndex++;
+			results[idx] = await tasks[idx]();
+		}
+	}
+	const workers = Array.from({ length: Math.min(limit, tasks.length) }, () => runNext());
+	await Promise.all(workers);
+	return results;
+}
+
+//#endregion
+export { extractReply, memberName, memberSession, runWithConcurrencyLimit };
+//# sourceMappingURL=utils.mjs.map

package/dist/agent-runners/team-modes/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../../src/agent-runners/team-modes/utils.ts"],"sourcesContent":["import type { AFSExecResult } from \"@aigne/afs\";\n\nexport function memberName(memberPath: string): string {\n  const parts = memberPath.replace(/\\/$/, \"\").split(\"/\");\n  return parts[parts.length - 1]!;\n}\n\nfunction sessionComponent(value: string): string {\n  const cleaned = value.replace(/[^A-Za-z0-9_.-]/g, \"_\").replace(/^\\.+|\\.+$/g, \"\");\n  return cleaned || \"member\";\n}\n\nexport function memberSession(\n  teamSession: string,\n  memberPath: string,\n  discriminator?: string | number,\n): string {\n  const parts = [teamSession, sessionComponent(memberName(memberPath))];\n  if (discriminator !== undefined) parts.push(sessionComponent(String(discriminator)));\n  return parts.join(\".\");\n}\n\nexport function extractReply(result: AFSExecResult): unknown {\n  const data = (result as any).data;\n  if (data?.result?.reply !== undefined) return data.result.reply;\n  if (data?.result !== undefined) return data.result;\n  return data;\n}\n\nexport async function runWithConcurrencyLimit<T>(\n  tasks: (() => Promise<T>)[],\n  limit: number,\n): Promise<T[]> {\n  const results: T[] = new Array(tasks.length);\n  let nextIndex = 0;\n\n  async function runNext(): Promise<void> {\n    while (nextIndex < tasks.length) {\n      const idx = nextIndex++;\n      results[idx] = await tasks[idx]!();\n    }\n  }\n\n  const workers = Array.from({ length: Math.min(limit, tasks.length) }, () => runNext());\n  await Promise.all(workers);\n  return results;\n}\n"],"mappings":";AAEA,SAAgB,WAAW,YAA4B;CACrD,MAAM,QAAQ,WAAW,QAAQ,OAAO,GAAG,CAAC,MAAM,IAAI;AACtD,QAAO,MAAM,MAAM,SAAS;;AAG9B,SAAS,iBAAiB,OAAuB;AAE/C,QADgB,MAAM,QAAQ,oBAAoB,IAAI,CAAC,QAAQ,cAAc,GAAG,IAC9D;;AAGpB,SAAgB,cACd,aACA,YACA,eACQ;CACR,MAAM,QAAQ,CAAC,aAAa,iBAAiB,WAAW,WAAW,CAAC,CAAC;AACrE,KAAI,kBAAkB,OAAW,OAAM,KAAK,iBAAiB,OAAO,cAAc,CAAC,CAAC;AACpF,QAAO,MAAM,KAAK,IAAI;;AAGxB,SAAgB,aAAa,QAAgC;CAC3D,MAAM,OAAQ,OAAe;AAC7B,KAAI,MAAM,QAAQ,UAAU,OAAW,QAAO,KAAK,OAAO;AAC1D,KAAI,MAAM,WAAW,OAAW,QAAO,KAAK;AAC5C,QAAO;;AAGT,eAAsB,wBACpB,OACA,OACc;CACd,MAAM,UAAe,IAAI,MAAM,MAAM,OAAO;CAC5C,IAAI,YAAY;CAEhB,eAAe,UAAyB;AACtC,SAAO,YAAY,MAAM,QAAQ;GAC/B,MAAM,MAAM;AACZ,WAAQ,OAAO,MAAM,MAAM,MAAO;;;CAItC,MAAM,UAAU,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,OAAO,MAAM,OAAO,EAAE,QAAQ,SAAS,CAAC;AACtF,OAAM,QAAQ,IAAI,QAAQ;AAC1B,QAAO"}