@nomix-ai/nomix-harness 0.2.6 → 0.2.7

package/node_modules/@nomix-ai/nomix-experimental-agent-team/lib/index.js

@@ -0,0 +1,1728 @@
+import { Service } from "@nomix-ai/cordis";
+import z from "@nomix-ai/schemastery";
+import { inspect } from "node:util";
+import { HarnessError, createUserMessage } from "@nomix-ai/nomix-llm";
+import { z as z$1 } from "zod";
+import { SessionId } from "@nomix-ai/nomix-session";
+import { randomUUID } from "node:crypto";
+import { foldSubagentDescriptor } from "@nomix-ai/nomix-subagent";
+//#region lib/types/error.js
+/** Typed Agent Teams failures. */
+/** Stable failure raised by the Team domain. */
+var TeamError = class extends HarnessError {
+	constructor(message, code, options) {
+		super(message, code, options);
+		this.name = "TeamError";
+	}
+};
+/**
+* Render an arbitrary thrown value without replacing the original rejection.
+* @param error - caught value used in a diagnostic or durable failure record.
+* @returns one bounded single-line description.
+*/
+function errorMessage(error) {
+	if (error instanceof Error) return error.message;
+	if (typeof error === "string") return error;
+	return inspect(error, {
+		breakLength: Infinity,
+		compact: true,
+		depth: 4
+	});
+}
+//#endregion
+//#region lib/types/activity.js
+/** One-shot Team change waiters independent of durable state projection. */
+/** Owns current Team change waiters and releases each at most once. */
+var TeamActivity = class {
+	waiters = /* @__PURE__ */ new Map();
+	closed = false;
+	/**
+	* Wait for one later Team-domain or member-status change.
+	* @param id - Team whose next edge wakes the caller.
+	* @param timeoutMs - bounded wait duration from ten seconds through one hour.
+	* @param signal - caller cancellation for this wait only.
+	* @returns whether the wait ended by timeout.
+	*/
+	async wait(id, timeoutMs, signal) {
+		if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1e4 || timeoutMs > 36e5) throw new TeamError("timeoutMs must be an integer from 10000 through 3600000", "TEAM_INVALID_TIMEOUT");
+		signal.throwIfAborted();
+		if (this.closed) return { timedOut: false };
+		return { timedOut: !await new Promise((resolve, reject) => {
+			let waiters = this.waiters.get(id);
+			if (waiters === void 0) {
+				waiters = /* @__PURE__ */ new Set();
+				this.waiters.set(id, waiters);
+			}
+			let settled = false;
+			const finish = (settle) => {
+				/* v8 ignore next -- timeout, abort, and notification may race after one winner removes the others. */
+				if (settled) return;
+				settled = true;
+				clearTimeout(timer);
+				signal.removeEventListener("abort", onAbort);
+				waiters.delete(waiter);
+				if (waiters.size === 0) this.waiters.delete(id);
+				settle();
+			};
+			const onAbort = () => {
+				finish(() => {
+					const reason = signal.reason;
+					reject(reason instanceof Error ? reason : new TeamError(`wait_agent aborted: ${errorMessage(reason)}`, "TEAM_WAIT_ABORTED"));
+				});
+			};
+			const waiter = { resolve: () => {
+				finish(() => {
+					resolve(true);
+				});
+			} };
+			waiters.add(waiter);
+			const timer = setTimeout(() => {
+				finish(() => {
+					resolve(false);
+				});
+			}, timeoutMs);
+			signal.addEventListener("abort", onAbort, { once: true });
+			/* v8 ignore next -- requires an abort in the synchronous gap between the pre-check and listener registration. */
+			if (signal.aborted) onAbort();
+		}) };
+	}
+	/**
+	* Wake and remove every current waiter for one Team.
+	* @param id - Team whose current waiters observe the change.
+	*/
+	notify(id) {
+		const waiters = this.waiters.get(id);
+		if (waiters === void 0) return;
+		this.waiters.delete(id);
+		for (const waiter of waiters) waiter.resolve();
+	}
+	/** Close admission and wake every current waiter during runtime disposal. */
+	close() {
+		this.closed = true;
+		for (const waiters of this.waiters.values()) for (const waiter of waiters) waiter.resolve();
+		this.waiters.clear();
+	}
+};
+//#endregion
+//#region lib/types/types.js
+/** Public Agent Teams identities, durable records, and service request values. */
+/**
+* Brand one root Session identity as its implicit Team identity.
+* @param id - Root Session identity.
+* @returns the same string branded as a Team identity.
+*/
+function TeamId(id) {
+	return id;
+}
+/**
+* Brand a validated task id.
+* @param id - Team-local task identity.
+* @returns the same string branded as a Team task identity.
+*/
+function TeamTaskId(id) {
+	return id;
+}
+/**
+* Brand a generated peer-message id.
+* @param id - Durable mailbox message identity.
+* @returns the same string branded as a Team message identity.
+*/
+function TeamMessageId(id) {
+	return id;
+}
+//#endregion
+//#region lib/types/task-graph.js
+/** Complete dependency validation for current Team task snapshots. */
+/** Package-private task dependency failure retained for command error mapping. */
+var TeamTaskGraphError = class extends Error {
+	violation;
+	/**
+	* @param message - concrete invalid dependency relation.
+	* @param violation - stable relation category used by Team commands.
+	*/
+	constructor(message, violation) {
+		super(message);
+		this.violation = violation;
+		this.name = "TeamTaskGraphError";
+	}
+};
+/**
+* Validate the complete active task graph after replacing one candidate snapshot.
+* @param current - current task snapshots before the candidate event.
+* @param candidate - new or next-revision task snapshot.
+* @throws {TeamTaskGraphError} when an active dependency is missing, duplicated, self-referential, or cyclic.
+*/
+function assertTaskGraphCandidate(current, candidate) {
+	const tasks = new Map(current);
+	tasks.set(candidate.id, candidate);
+	for (const task of tasks.values()) {
+		if (task.status === "deleted") continue;
+		const seen = /* @__PURE__ */ new Set();
+		for (const blockerId of task.blockedBy) {
+			if (blockerId === task.id) throw new TeamTaskGraphError(`team task "${task.id}" cannot block itself`, "cycle");
+			if (seen.has(blockerId)) throw new TeamTaskGraphError(`team task "${task.id}" repeats blocker "${blockerId}"`, "duplicate");
+			const blocker = tasks.get(blockerId);
+			if (blocker === void 0 || blocker.status === "deleted") throw new TeamTaskGraphError(`blocker task "${blockerId}" for "${task.id}" is missing or deleted`, "missing");
+			seen.add(blockerId);
+		}
+	}
+	const visiting = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	const visit = (id) => {
+		if (visiting.has(id)) throw new TeamTaskGraphError(`task dependency cycle includes "${id}"`, "cycle");
+		if (visited.has(id)) return;
+		const task = tasks.get(id);
+		if (task === void 0 || task.status === "deleted") return;
+		visiting.add(id);
+		for (const blockerId of task.blockedBy) visit(blockerId);
+		visiting.delete(id);
+		visited.add(id);
+	};
+	for (const task of tasks.values()) visit(task.id);
+}
+//#endregion
+//#region lib/types/fold.js
+/** Strict replay fold for Agent Teams log-only events. */
+const nonNegativeSafeInteger = z$1.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
+const positiveSafeInteger = nonNegativeSafeInteger.min(1);
+const sessionIdSchema = z$1.string().min(1).transform((value) => SessionId(value));
+const teamIdSchema = z$1.string().min(1).transform((value) => TeamId(value));
+const numericTaskIdPattern = /^task-(\d+)$/u;
+const teamTaskIdSchema = z$1.string().min(1).refine((value) => {
+	const match = numericTaskIdPattern.exec(value);
+	return match === null || Number.isSafeInteger(Number(match[1]));
+}, { message: "numeric task id suffix must be a safe integer" }).transform((value) => TeamTaskId(value));
+const teamMessageIdSchema = z$1.string().min(1).transform((value) => TeamMessageId(value));
+const coreContentBlockTypes = new Set([
+	"text",
+	"reasoning",
+	"image",
+	"tool-call",
+	"tool-result"
+]);
+const imageAttachmentSchema = z$1.object({
+	attachmentId: z$1.string().min(1),
+	mediaType: z$1.enum([
+		"image/png",
+		"image/jpeg",
+		"image/webp",
+		"image/gif"
+	]),
+	bytes: nonNegativeSafeInteger,
+	width: positiveSafeInteger,
+	height: positiveSafeInteger,
+	name: z$1.string().optional()
+}).strict();
+const contentBlockSchema = z$1.lazy(() => z$1.union([
+	z$1.object({
+		type: z$1.literal("text"),
+		text: z$1.string()
+	}).strict(),
+	z$1.object({
+		type: z$1.literal("reasoning"),
+		text: z$1.string()
+	}).strict(),
+	z$1.object({
+		type: z$1.literal("image"),
+		attachment: imageAttachmentSchema
+	}).strict(),
+	z$1.object({
+		type: z$1.literal("tool-call"),
+		id: z$1.string().min(1),
+		name: z$1.string(),
+		arguments: z$1.string()
+	}).strict(),
+	z$1.object({
+		type: z$1.literal("tool-result"),
+		toolCallId: z$1.string().min(1),
+		content: z$1.array(contentBlockSchema),
+		isError: z$1.boolean().optional()
+	}).strict(),
+	z$1.object({ type: z$1.string().min(1) }).loose().refine((block) => !coreContentBlockTypes.has(block.type), { message: "known content block types must match their declared fields" })
+]));
+const teamMemberSnapshotSchema = z$1.object({
+	id: sessionIdSchema,
+	name: z$1.string(),
+	description: z$1.string(),
+	provider: z$1.string(),
+	context: z$1.enum(["fresh", "fork"]),
+	phase: z$1.enum([
+		"provisioning",
+		"active",
+		"failed"
+	]),
+	error: z$1.string().optional()
+}).strict();
+const teamTaskSnapshotSchema = z$1.object({
+	id: teamTaskIdSchema,
+	revision: positiveSafeInteger,
+	subject: z$1.string(),
+	description: z$1.string(),
+	status: z$1.enum([
+		"pending",
+		"in_progress",
+		"completed",
+		"deleted"
+	]),
+	ownerId: sessionIdSchema.optional(),
+	blockedBy: z$1.array(teamTaskIdSchema),
+	writeScopes: z$1.array(z$1.string())
+}).strict();
+const teamMessageSnapshotSchema = z$1.object({
+	id: teamMessageIdSchema,
+	senderId: sessionIdSchema,
+	senderName: z$1.string(),
+	targetId: sessionIdSchema,
+	delivery: z$1.enum(["quiet", "wakeup"]),
+	content: z$1.array(contentBlockSchema)
+}).strict();
+const teamEventSelectorSchema = z$1.object({
+	version: nonNegativeSafeInteger,
+	teamId: teamIdSchema
+}).loose();
+const teamMemberEventSchema = z$1.object({
+	version: z$1.literal(1),
+	teamId: teamIdSchema,
+	member: teamMemberSnapshotSchema
+}).strict();
+const teamTaskEventSchema = z$1.object({
+	version: z$1.literal(1),
+	teamId: teamIdSchema,
+	task: teamTaskSnapshotSchema
+}).strict();
+const teamMessageQueuedEventSchema = z$1.object({
+	version: z$1.literal(1),
+	teamId: teamIdSchema,
+	message: teamMessageSnapshotSchema
+}).strict();
+const teamMessageDeliveredEventSchema = z$1.object({
+	version: z$1.literal(1),
+	teamId: teamIdSchema,
+	messageId: teamMessageIdSchema,
+	targetId: sessionIdSchema
+}).strict();
+/**
+* Construct an empty Team fold for one root Session.
+* @param rootId - Session whose TeamId selects applicable records.
+* @returns mutable empty replay state.
+*/
+function emptyTeamFoldState(rootId) {
+	return {
+		id: TeamId(rootId),
+		members: /* @__PURE__ */ new Map(),
+		memberIdsByName: /* @__PURE__ */ new Map(),
+		tasks: /* @__PURE__ */ new Map(),
+		messages: /* @__PURE__ */ new Map(),
+		delivered: /* @__PURE__ */ new Set(),
+		nextTaskNumber: 1
+	};
+}
+/**
+* Test whether a Session event belongs to the Team domain.
+* @param event - candidate Session event.
+* @returns whether the event has a Team-owned type.
+*/
+function isTeamEvent(event) {
+	return event.type === "team/member" || event.type === "team/task" || event.type === "team/message/queued" || event.type === "team/message/delivered";
+}
+/** Decode one persisted Team value and retain the schema failure as its cause. */
+function parsePersisted(type, schema, value) {
+	try {
+		return schema.parse(value);
+	} catch (error) {
+		throw new Error(`persisted Agent Teams ${type} payload is invalid`, { cause: error });
+	}
+}
+/** Decode the complete current-version payload selected by one Team event type. */
+function parseCurrentTeamEvent(event) {
+	switch (event.type) {
+		case "team/member": return {
+			...event,
+			data: parsePersisted(event.type, teamMemberEventSchema, event.data)
+		};
+		case "team/task": return {
+			...event,
+			data: parsePersisted(event.type, teamTaskEventSchema, event.data)
+		};
+		case "team/message/queued": return {
+			...event,
+			data: parsePersisted(event.type, teamMessageQueuedEventSchema, event.data)
+		};
+		case "team/message/delivered": return {
+			...event,
+			data: parsePersisted(event.type, teamMessageDeliveredEventSchema, event.data)
+		};
+		/* v8 ignore next 2 -- TeamEventType is closed and every member is handled above. */
+		default: return event;
+	}
+}
+/**
+* Apply one event, ignoring Team records inherited by a different root fork.
+* @param state - mutable Team replay state.
+* @param event - next contiguous Session event.
+*/
+function applyTeamEvent(state, event) {
+	if (!isTeamEvent(event)) return;
+	const selector = parsePersisted(event.type, teamEventSelectorSchema, event.data);
+	if (selector.version !== 1) {
+		if (selector.teamId !== state.id) return;
+		throw new Error(`unsupported Agent Teams event version ${String(selector.version)}`);
+	}
+	const decoded = parseCurrentTeamEvent(event);
+	if (decoded.data.teamId !== state.id) return;
+	switch (decoded.type) {
+		case "team/member": {
+			const member = decoded.data.member;
+			const prior = state.members.get(member.id);
+			const named = state.memberIdsByName.get(member.name);
+			if (named !== void 0 && named !== member.id) throw new Error(`teammate name "${member.name}" is reused by another member`);
+			if (prior === void 0) {
+				if (member.phase !== "provisioning") throw new Error(`teammate "${member.name}" must begin provisioning`);
+				state.memberIdsByName.set(member.name, member.id);
+			} else {
+				if (prior.name !== member.name || prior.provider !== member.provider || prior.context !== member.context) throw new Error(`teammate "${member.id}" changed immutable identity fields`);
+				if (prior.phase !== "provisioning" || member.phase === "provisioning") throw new Error(`teammate "${member.name}" has an invalid ${prior.phase} -> ${member.phase} transition`);
+			}
+			state.members.set(member.id, member);
+			break;
+		}
+		case "team/task": {
+			const task = decoded.data.task;
+			const prior = state.tasks.get(task.id);
+			if (prior === void 0 && task.revision !== 1) throw new Error(`team task "${task.id}" must begin at revision 1`);
+			if (prior !== void 0 && task.revision !== prior.revision + 1) throw new Error(`team task "${task.id}" revision is not contiguous`);
+			assertTaskGraphCandidate(state.tasks, task);
+			const match = numericTaskIdPattern.exec(task.id);
+			if (match !== null) {
+				const number = Number(match[1]);
+				state.nextTaskNumber = Math.max(state.nextTaskNumber, number === Number.MAX_SAFE_INTEGER ? number : number + 1);
+			}
+			state.tasks.set(task.id, task);
+			break;
+		}
+		case "team/message/queued": {
+			const message = decoded.data.message;
+			if (state.messages.has(message.id)) throw new Error(`team message "${message.id}" was queued twice`);
+			state.messages.set(message.id, message);
+			break;
+		}
+		case "team/message/delivered": {
+			const queued = state.messages.get(decoded.data.messageId);
+			if (queued === void 0) throw new Error(`team message "${decoded.data.messageId}" was delivered before queueing`);
+			if (queued.targetId !== decoded.data.targetId) throw new Error(`team message "${decoded.data.messageId}" target changed`);
+			if (state.delivered.has(decoded.data.messageId)) throw new Error(`team message "${decoded.data.messageId}" was delivered twice`);
+			state.delivered.add(decoded.data.messageId);
+			break;
+		}
+		/* v8 ignore next 2 -- TeamEventType is closed and every member is handled above. */
+		default: return;
+	}
+}
+/**
+* Replay one root Session into its current Team state.
+* @param rootId - root Session identity selecting Team-owned records.
+* @param events - complete contiguous Session log.
+* @returns mutable replay state at the end of the log.
+*/
+function foldTeam(rootId, events) {
+	const state = emptyTeamFoldState(rootId);
+	for (const event of events) applyTeamEvent(state, event);
+	return state;
+}
+//#endregion
+//#region lib/types/journal.js
+/** Serialized Team transactions over the exact live Lead Session log. */
+/** Owns per-Lead transaction order and committed Team event publication. */
+var TeamJournal = class {
+	ctx;
+	onCommit;
+	tails = /* @__PURE__ */ new Map();
+	/**
+	* @param ctx - Team service context with the injected Session service.
+	* @param onCommit - synchronous notification after the Team event flush succeeds.
+	*/
+	constructor(ctx, onCommit) {
+		this.ctx = ctx;
+		this.onCommit = onCommit;
+	}
+	/**
+	* Fold authoritative Team state for one exact live Lead.
+	* @param root - exact live Team Lead.
+	* @returns current replay state selected by the Lead Team id.
+	*/
+	state(root) {
+		return foldTeam(root.id, root.session.events);
+	}
+	/**
+	* Serialize one Lead's asynchronous mutation operation.
+	* @param rootId - Lead Session identity selecting the transaction queue.
+	* @param operation - complete read-check-append operation.
+	* @returns the operation result.
+	*/
+	async transact(rootId, operation) {
+		const run = (this.tails.get(rootId) ?? Promise.resolve()).then(operation, operation);
+		const tail = run.then(() => void 0, () => void 0);
+		this.tails.set(rootId, tail);
+		try {
+			return await run;
+		} finally {
+			if (this.tails.get(rootId) === tail) this.tails.delete(rootId);
+		}
+	}
+	/**
+	* Append and checkpoint one root-owned Team event before publication.
+	* @param root - exact live Lead whose Session owns the event.
+	* @param type - Team event discriminant.
+	* @param data - payload correlated with the event type.
+	*/
+	async appendAndFlush(root, type, data) {
+		root.session.append.bind(root.session)(type, data);
+		await this.ctx.sessions.flush(root.session);
+		this.onCommit(root);
+	}
+};
+//#endregion
+//#region lib/types/lifecycle.js
+/** Shared admission cutoff and bounded settlement for the Team runtime. */
+/** Owns the single Team runtime cancellation fact and disposal timeout. */
+var TeamRuntimeLifecycle = class {
+	disposalTimeoutMs;
+	controller = new AbortController();
+	/**
+	* @param disposalTimeoutMs - maximum wait for one disposal settlement operation.
+	*/
+	constructor(disposalTimeoutMs) {
+		this.disposalTimeoutMs = disposalTimeoutMs;
+	}
+	/** Signal aborted exactly when Team runtime admission closes. */
+	get signal() {
+		return this.controller.signal;
+	}
+	/** Whether Team runtime admission is closed. */
+	get disposed() {
+		return this.signal.aborted;
+	}
+	/** The exact cancellation reason used to distinguish expected disposal rejection. */
+	get reason() {
+		return this.signal.reason;
+	}
+	/** Whether a rejection is the runtime cancellation, directly or through an Error cause chain. */
+	isCancellation(reason) {
+		const seen = /* @__PURE__ */ new Set();
+		let current = reason;
+		while (!seen.has(current)) {
+			if (this.disposed && current === this.reason) return true;
+			if (this.disposed && current instanceof TeamError && current.code === "TEAM_DISPOSED") return true;
+			if (!(current instanceof Error)) return false;
+			seen.add(current);
+			current = current.cause;
+		}
+		return false;
+	}
+	/** Close Team runtime admission and cancel admitted interruptible work. */
+	close() {
+		this.controller.abort(new TeamError("Agent Teams service disposed", "TEAM_DISPOSED"));
+	}
+	/**
+	* Await admitted operations and retain failures other than runtime cancellation.
+	* @param operations - admitted operations captured after the admission cutoff.
+	* @param failures - aggregate destination for unexpected rejection or timeout.
+	*/
+	async settle(operations, failures) {
+		if (operations.length === 0) return;
+		try {
+			const outcomes = await this.withTimeout(Promise.allSettled(operations));
+			for (const outcome of outcomes) if (outcome.status === "rejected" && !this.isCancellation(outcome.reason)) failures.push(outcome.reason);
+		} catch (error) {
+			failures.push(error);
+		}
+	}
+	/**
+	* Bound one runtime settlement operation.
+	* @param operation - settlement that may otherwise block HMR or process shutdown.
+	* @returns the operation result.
+	*/
+	async withTimeout(operation) {
+		let timer;
+		const timeout = new Promise((_resolve, reject) => {
+			timer = setTimeout(() => {
+				reject(new TeamError(`Agent Teams runtime disposal exceeded ${this.disposalTimeoutMs}ms`, "TEAM_DISPOSAL_TIMEOUT"));
+			}, this.disposalTimeoutMs);
+		});
+		try {
+			return await Promise.race([operation, timeout]);
+		} finally {
+			clearTimeout(timer);
+		}
+	}
+};
+//#endregion
+//#region lib/types/session-message.js
+/** Durable Session-message acceptance checks shared by provisioning and mailbox recovery. */
+/** Fold the durable inbox suffix into the messages still awaiting a claim. */
+function pendingInboxMessages(events) {
+	const inbox = {
+		"next-turn": [],
+		"next-step": []
+	};
+	for (const event of events) {
+		if (event.type !== "agent/inbox/spliced") continue;
+		inbox[event.data.target].splice(event.data.start, event.data.removedCount ?? 0, ...event.data.inserted);
+	}
+	return [...inbox["next-turn"], ...inbox["next-step"]];
+}
+/**
+* Test whether one message is model-visible or still durably pending.
+* @param events - one Session's non-inherited event suffix.
+* @param predicate - identity check for the accepted message.
+* @returns whether history or the current inbox contains a match.
+*/
+function messageAccepted(events, predicate) {
+	return events.some((event) => event.type === "user/message" && predicate(event.data)) || pendingInboxMessages(events).some(predicate);
+}
+//#endregion
+//#region lib/types/validation.js
+/** Input normalization shared by Team roster and task commands. */
+/**
+* Normalize one required human-authored string.
+* @param value - raw input value.
+* @param field - diagnostic field name.
+* @param maxLength - maximum normalized character count.
+* @returns trimmed non-empty text.
+*/
+function requiredText(value, field, maxLength) {
+	const text = value.trim();
+	if (text.length === 0) throw new TeamError(`${field} must be non-empty`, "TEAM_INVALID_ARGUMENT");
+	if (text.length > maxLength) throw new TeamError(`${field} exceeds ${maxLength} characters`, "TEAM_INVALID_ARGUMENT");
+	return text;
+}
+/**
+* Normalize one workspace-relative path prefix without treating it as a lock.
+* @param value - user-authored path prefix.
+* @returns normalized slash-separated prefix.
+*/
+function writeScope(value) {
+	const normalized = value.replaceAll("\\", "/").replace(/^\.\//u, "").replace(/\/+$/u, "");
+	const segments = normalized.split("/");
+	if (normalized.length === 0 || normalized.startsWith("/") || /^[a-z]:/iu.test(normalized) || segments.some((segment) => segment.length === 0 || segment === "." || segment === "..")) throw new TeamError(`invalid workspace-relative write scope ${JSON.stringify(value)}`, "TEAM_INVALID_WRITE_SCOPE");
+	return normalized;
+}
+//#endregion
+//#region lib/types/roster.js
+/** Team membership, continuable-child provisioning, and roster-owned teardown. */
+const MEMBER_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
+/**
+* Resolve one active Team member by model-facing name, including the Lead pseudo-row.
+* @param root - exact live Team Lead.
+* @param state - current Team fold.
+* @param rawName - candidate member name.
+* @returns resolved durable id and normalized name.
+*/
+function resolveActiveMember(root, state, rawName) {
+	const name = rawName.trim();
+	if (name === "lead") return {
+		id: root.id,
+		name
+	};
+	const id = state.memberIdsByName.get(name);
+	const member = id === void 0 ? void 0 : state.members.get(id);
+	if (member === void 0 || member.phase !== "active") throw new TeamError(`active teammate "${name}" not found`, "TEAM_MEMBER_NOT_FOUND");
+	return {
+		id: member.id,
+		name
+	};
+}
+/** Owns Team identities and the lifecycle of rostered continuable children. */
+var TeamRoster = class {
+	ctx;
+	journal;
+	lifecycle;
+	maxMembers;
+	inFlightCreations = /* @__PURE__ */ new Set();
+	/**
+	* @param ctx - Team service context with Agent, Session, persistence, and subagent services.
+	* @param journal - authoritative Lead-log transaction owner.
+	* @param lifecycle - shared Team runtime admission cutoff.
+	* @param maxMembers - maximum immutable roster entries per Team.
+	*/
+	constructor(ctx, journal, lifecycle, maxMembers) {
+		this.ctx = ctx;
+		this.journal = journal;
+		this.lifecycle = lifecycle;
+		this.maxMembers = maxMembers;
+	}
+	/**
+	* Resolve one exact live Agent's Team role.
+	* @param agent - exact live Agent used as the authority credential.
+	* @returns its root, Team identity, role, and model-facing name.
+	*/
+	membership(agent) {
+		const membership = this.tryMembership(agent);
+		if (membership === void 0) throw new TeamError(`agent "${agent.id}" is not a member of an active Agent Team`, "TEAM_NOT_MEMBER");
+		return membership;
+	}
+	/**
+	* Resolve a caller without throwing for scoped installation and lifecycle observers.
+	* @param agent - candidate exact live Agent.
+	* @returns Team membership, or undefined for non-Team subagents and stale identities.
+	*/
+	tryMembership(agent) {
+		if (this.ctx.agents.get(agent.id) !== agent) return void 0;
+		try {
+			const parentId = agent.session.header.parentSession;
+			if (parentId !== void 0) {
+				const root = this.ctx.agents.get(parentId);
+				if (root !== void 0) {
+					const member = this.journal.state(root).members.get(agent.id);
+					if (member?.phase === "active" || member?.phase === "provisioning") return {
+						root,
+						id: TeamId(root.id),
+						role: "teammate",
+						name: member.name
+					};
+					if (this.subagentDescriptor(agent)) return void 0;
+					return {
+						root: agent,
+						id: TeamId(agent.id),
+						role: "lead",
+						name: "lead"
+					};
+				}
+			}
+			if (this.subagentDescriptor(agent)) return void 0;
+			return {
+				root: agent,
+				id: TeamId(agent.id),
+				role: "lead",
+				name: "lead"
+			};
+		} catch {
+			return;
+		}
+	}
+	/**
+	* List the runtime-enriched roster visible to one Team member.
+	* @param membership - exact caller membership resolved by this roster.
+	* @returns Lead and teammate rows in creation order.
+	*/
+	list(membership) {
+		const { root } = membership;
+		const state = this.journal.state(root);
+		const result = [{
+			id: root.id,
+			name: "lead",
+			role: "lead",
+			status: root.status,
+			...root.options.model === void 0 ? {} : { model: root.options.model },
+			diagnostics: []
+		}];
+		for (const member of state.members.values()) {
+			const live = this.ctx.agents.get(member.id);
+			const model = live?.options.model ?? root.options.model;
+			result.push({
+				id: member.id,
+				name: member.name,
+				role: "teammate",
+				status: member.phase === "failed" ? "failed" : member.phase === "provisioning" ? "provisioning" : live?.status ?? "inactive",
+				description: member.description,
+				provider: member.provider,
+				context: member.context,
+				...model === void 0 ? {} : { model },
+				diagnostics: member.error === void 0 ? [] : [member.error]
+			});
+		}
+		return result;
+	}
+	/**
+	* Create one named, continuable direct child of the Team Lead.
+	* @param caller - exact live Lead Agent.
+	* @param request - immutable name, description, prompt, context mode, provider, and cancellation.
+	* @returns the active roster row.
+	*/
+	async spawn(caller, request) {
+		if (this.lifecycle.disposed) throw new TeamError("Agent Teams service is disposing", "TEAM_DISPOSED");
+		const operation = this.spawnAdmitted(caller, request);
+		this.inFlightCreations.add(operation);
+		try {
+			return await operation;
+		} finally {
+			this.inFlightCreations.delete(operation);
+		}
+	}
+	/**
+	* Return admitted creation operations captured for ordered disposal.
+	* @returns detached snapshot ordered only by Set insertion.
+	*/
+	pendingCreations() {
+		return [...this.inFlightCreations];
+	}
+	/**
+	* Reconcile provisioning state when one Team member Session starts.
+	* @param agent - newly started exact live Agent.
+	* @param signal - shared runtime cancellation.
+	*/
+	async recoverFor(agent, signal) {
+		signal.throwIfAborted();
+		const membership = this.tryMembership(agent);
+		if (membership?.role === "lead") await this.reconcileProvisioning(membership.root, signal);
+	}
+	/**
+	* Interrupt one live teammate turn without clearing its pending inbox.
+	* @param caller - exact live Lead Agent.
+	* @param targetName - durable teammate name.
+	* @returns the target status sampled before cancellation.
+	*/
+	interrupt(caller, targetName) {
+		const membership = this.membership(caller);
+		if (membership.role !== "lead") throw new TeamError("only the Team Lead can interrupt teammates", "TEAM_LEAD_REQUIRED");
+		const state = this.journal.state(membership.root);
+		const target = resolveActiveMember(membership.root, state, targetName);
+		if (target.id === membership.root.id) throw new TeamError("the Team Lead cannot interrupt itself", "TEAM_INVALID_TARGET");
+		const live = this.ctx.agents.get(target.id);
+		if (live === void 0) return { previousStatus: "inactive" };
+		const previousStatus = live.status;
+		this.ctx.subagents.interrupt(target.id, {
+			kind: "ancestor",
+			agent: caller
+		});
+		return { previousStatus };
+	}
+	/**
+	* Group exact live roster children by their current Lead for runtime teardown.
+	* @returns each live Lead and the roster child ids currently in the Agent registry.
+	*/
+	liveChildrenByRoot() {
+		const teams = /* @__PURE__ */ new Map();
+		for (const agent of this.ctx.agents.list()) {
+			const rootId = agent.session.header.parentSession;
+			if (rootId === void 0) continue;
+			const root = this.ctx.agents.get(rootId);
+			if (root === void 0 || !this.journal.state(root).members.has(agent.id)) continue;
+			const children = teams.get(root) ?? [];
+			children.push(agent.id);
+			teams.set(root, children);
+		}
+		return teams;
+	}
+	/**
+	* Release exact teammate Activations through the continuation lifecycle owner.
+	* @param root - exact live Team Lead authorizing release.
+	* @param childIds - selected roster child ids.
+	*/
+	async stopTeammates(root, childIds) {
+		await this.lifecycle.withTimeout(this.ctx.subagents.drainContinuableChildren(root, childIds));
+	}
+	/** Perform one creation admitted before the Team runtime disposal cutoff. */
+	async spawnAdmitted(caller, request) {
+		const membership = this.membership(caller);
+		if (membership.role !== "lead") throw new TeamError("only the Team Lead can create teammates", "TEAM_LEAD_REQUIRED");
+		const signal = AbortSignal.any([request.signal, this.lifecycle.signal]);
+		signal.throwIfAborted();
+		const root = membership.root;
+		const name = this.memberName(request.name);
+		const description = requiredText(request.description, "description", 200);
+		const childId = SessionId(randomUUID());
+		const member = {
+			id: childId,
+			name,
+			description,
+			provider: requiredText(request.provider, "provider", 200),
+			context: request.context,
+			phase: "provisioning"
+		};
+		await this.journal.transact(root.id, async () => {
+			const state = this.journal.state(root);
+			if (state.memberIdsByName.has(name)) throw new TeamError(`teammate name "${name}" was already used in this Team`, "TEAM_MEMBER_NAME_TAKEN");
+			if (state.members.size >= this.maxMembers) throw new TeamError(`Team member limit ${this.maxMembers} reached`, "TEAM_MEMBER_LIMIT");
+			await this.journal.appendAndFlush(root, "team/member", {
+				version: 1,
+				teamId: TeamId(root.id),
+				member
+			});
+		});
+		let started;
+		try {
+			started = await this.ctx.subagents.startContinuable({
+				childId,
+				provider: request.provider,
+				label: description,
+				request: {
+					prompt: request.prompt,
+					parent: root
+				},
+				signal
+			});
+			await this.checkpointInitialPrompt(childId, started.messageId, signal);
+		} catch (error) {
+			const failed = {
+				...member,
+				phase: "failed",
+				error: errorMessage(error)
+			};
+			try {
+				const phase = await this.settleProvisioning(root, failed);
+				await this.stopTeammates(root, [childId]);
+				if (phase === "active") throw new TeamError(`teammate "${name}" became active while its creator reported failure`, "TEAM_PROVISIONING_CONFLICT", { cause: error });
+			} catch (recordError) {
+				throw new AggregateError([error, recordError], "teammate creation and durable failure recording both failed");
+			}
+			throw error;
+		}
+		const active = {
+			...member,
+			phase: "active"
+		};
+		if (await this.settleProvisioning(root, active) === "failed") {
+			const conflict = new TeamError(`teammate "${name}" was reconciled as failed while creation was in progress`, "TEAM_PROVISIONING_CONFLICT");
+			try {
+				await this.stopTeammates(root, [childId]);
+			} catch (cleanupError) {
+				/* v8 ignore next -- requires the independently tested HMR settlement conflict and cleanup failure together. */
+				throw new AggregateError([conflict, cleanupError], "provisioning conflict cleanup failed");
+			}
+			throw conflict;
+		}
+		return { member: this.memberView(active) };
+	}
+	/** Flush the accepted initial inbox item before the Lead can commit `active`. */
+	async checkpointInitialPrompt(childId, messageId, signal) {
+		while (true) {
+			signal.throwIfAborted();
+			const session = this.ctx.sessions.get(childId);
+			if (session === void 0) {
+				const stored = await this.ctx.sessionPersistence.inspect(childId, signal);
+				if (messageAccepted(stored.events.slice(stored.meta.seedLength ?? 0), (message) => message.id === messageId)) return;
+				throw new TeamError(`teammate "${childId}" initial prompt was not durably accepted`, "TEAM_PROVISIONING_CONFLICT");
+			}
+			const progress = Promise.withResolvers();
+			progress.promise.catch(() => void 0);
+			const stopEvent = this.ctx.on("session/event", (candidate) => {
+				if (candidate === session) progress.resolve();
+			});
+			const stopDisposed = this.ctx.on("session/disposed", (candidate) => {
+				if (candidate === session) progress.resolve();
+			});
+			const onAbort = () => {
+				const reason = signal.reason;
+				progress.reject(reason instanceof Error ? reason : new TeamError(`teammate creation aborted: ${errorMessage(reason)}`, "TEAM_DISPOSED"));
+			};
+			signal.addEventListener("abort", onAbort, { once: true });
+			try {
+				signal.throwIfAborted();
+				await this.ctx.sessions.flush(session);
+				if (messageAccepted(session.events.slice(session.header.seedLength ?? 0), (message) => message.id === messageId)) return;
+				if (this.ctx.sessions.get(childId) !== session) continue;
+				await progress.promise;
+			} finally {
+				signal.removeEventListener("abort", onAbort);
+				stopDisposed();
+				stopEvent();
+			}
+		}
+	}
+	/** Settle provisioning-only members from their independently durable child Sessions. */
+	async reconcileProvisioning(root, signal) {
+		const provisioning = [...this.journal.state(root).members.values()].filter((member) => member.phase === "provisioning");
+		for (const member of provisioning) {
+			signal.throwIfAborted();
+			if (this.ctx.agents.get(member.id) !== void 0) continue;
+			let phase = "failed";
+			let failure = "provisioning did not leave a resumable child Session";
+			try {
+				const loaded = await this.ctx.sessionPersistence.inspect(member.id, signal);
+				const suffix = loaded.events.slice(loaded.meta.seedLength ?? 0);
+				const descriptor = foldSubagentDescriptor(suffix);
+				const acceptedInitialPrompt = messageAccepted(suffix, (message) => message.source.kind === "user");
+				if (loaded.meta.parentSession === root.id && descriptor?.mode === "continuable" && descriptor.provider === member.provider && acceptedInitialPrompt) phase = "active";
+				else failure = "persisted child Session does not match the provisioned continuation";
+			} catch (error) {
+				failure = `child Session recovery failed: ${errorMessage(error)}`;
+			}
+			signal.throwIfAborted();
+			await this.journal.transact(root.id, async () => {
+				signal.throwIfAborted();
+				const current = this.journal.state(root).members.get(member.id);
+				if (current?.phase !== "provisioning") return;
+				const settled = {
+					...current,
+					phase,
+					...phase === "failed" ? { error: failure } : {}
+				};
+				await this.journal.appendAndFlush(root, "team/member", {
+					version: 1,
+					teamId: TeamId(root.id),
+					member: settled
+				});
+			});
+		}
+	}
+	/** Build one runtime member row after successful creation. */
+	memberView(member) {
+		const live = this.ctx.agents.get(member.id);
+		return {
+			id: member.id,
+			name: member.name,
+			role: "teammate",
+			status: live?.status ?? "inactive",
+			description: member.description,
+			provider: member.provider,
+			context: member.context,
+			...live?.options.model === void 0 ? {} : { model: live.options.model },
+			diagnostics: []
+		};
+	}
+	/** Validate a never-reused model-facing teammate name. */
+	memberName(value) {
+		if (!MEMBER_NAME.test(value) || value.length > 64 || value === "lead") throw new TeamError("teammate name must be lower-kebab-case, at most 64 characters, and not \"lead\"", "TEAM_INVALID_MEMBER_NAME");
+		return value;
+	}
+	/** Append one terminal provisioning edge unless recovery already settled it. */
+	async settleProvisioning(root, terminal) {
+		return this.journal.transact(root.id, async () => {
+			const current = this.journal.state(root).members.get(terminal.id);
+			/* v8 ignore next 3 -- the append-only provisioning event is committed by this operation before settlement. */
+			if (current === void 0) throw new TeamError(`provisioned teammate "${terminal.id}" disappeared`, "TEAM_PROVISIONING_CONFLICT");
+			if (current.phase !== "provisioning") return current.phase;
+			await this.journal.appendAndFlush(root, "team/member", {
+				version: 1,
+				teamId: TeamId(root.id),
+				member: terminal
+			});
+			return terminal.phase === "active" ? "active" : "failed";
+		});
+	}
+	/** Whether a Session's own suffix identifies a provider-owned subagent child. */
+	subagentDescriptor(agent) {
+		return foldSubagentDescriptor(agent.session.events.slice(agent.session.header.seedLength ?? 0)) !== void 0;
+	}
+};
+//#endregion
+//#region lib/types/mailbox.js
+/** Durable Team mailbox admission, target-local dispatch, acknowledgement, and recovery. */
+/** Owns every process-local state transition for the durable Team mailbox. */
+var TeamMailbox = class {
+	ctx;
+	journal;
+	roster;
+	lifecycle;
+	maxPendingMessagesPerMember;
+	maxMessageBytes;
+	dispatchTails = /* @__PURE__ */ new Map();
+	activeDispatches = /* @__PURE__ */ new Map();
+	inFlightMessages = /* @__PURE__ */ new Set();
+	inFlightDispatches = /* @__PURE__ */ new Set();
+	/**
+	* @param ctx - Team service context with Agent, Session, persistence, and subagent services.
+	* @param journal - authoritative Lead-log transaction owner.
+	* @param roster - Team membership and member-name resolver.
+	* @param lifecycle - shared Team runtime admission cutoff.
+	* @param maxPendingMessagesPerMember - per-target queued-minus-delivered limit.
+	* @param maxMessageBytes - maximum complete sender-framed delivery size.
+	*/
+	constructor(ctx, journal, roster, lifecycle, maxPendingMessagesPerMember, maxMessageBytes) {
+		this.ctx = ctx;
+		this.journal = journal;
+		this.roster = roster;
+		this.lifecycle = lifecycle;
+		this.maxPendingMessagesPerMember = maxPendingMessagesPerMember;
+		this.maxMessageBytes = maxMessageBytes;
+	}
+	/**
+	* Queue one durable peer message, then attempt immediate delivery.
+	* @param caller - exact live sending Team member.
+	* @param request - target name, content, scheduling mode, and pre-queue cancellation.
+	* @returns durable message identity and immediate-delivery observation.
+	*/
+	async send(caller, request) {
+		if (this.lifecycle.disposed) throw new TeamError("Agent Teams service is disposing", "TEAM_DISPOSED");
+		const operation = this.sendAdmitted(caller, {
+			...request,
+			signal: AbortSignal.any([request.signal, this.lifecycle.signal])
+		});
+		return await this.trackDispatch(operation);
+	}
+	/**
+	* Observe target-side durable receipts and checkpoint their Lead-log acknowledgement.
+	* @param session - exact target Session receiving the event.
+	* @param event - newly appended Session event.
+	*/
+	observeSessionEvent(session, event) {
+		if (this.lifecycle.disposed || event.type !== "user/message" || event.data.source.kind !== "team-message") return;
+		const source = event.data.source;
+		const acknowledgement = Promise.resolve().then(async () => {
+			const root = this.ctx.agents.get(SessionId(source.teamId));
+			if (root !== void 0) await this.checkpointDelivered(root, session, source.messageId);
+		}).catch((error) => {
+			this.ctx.logger.warn(`Team message "${source.messageId}" acknowledgement failed: ${errorMessage(error)}`);
+		});
+		this.trackDispatch(acknowledgement);
+	}
+	/**
+	* Retry durable pending messages relevant to one started Team member.
+	* @param agent - newly started exact live Agent.
+	* @param signal - shared runtime cancellation.
+	*/
+	async recoverFor(agent, signal) {
+		signal.throwIfAborted();
+		const membership = this.roster.tryMembership(agent);
+		if (membership === void 0) return;
+		const state = this.journal.state(membership.root);
+		const messages = [...state.messages.values()].filter((message) => !state.delivered.has(message.id) && (membership.role === "lead" || message.targetId === agent.id));
+		for (const message of messages) {
+			signal.throwIfAborted();
+			if (membership.role === "lead" && message.delivery === "quiet" && message.targetId !== membership.root.id && this.ctx.agents.get(message.targetId) === void 0) continue;
+			await this.tryDispatch(membership.root, message, signal);
+		}
+	}
+	/**
+	* Return admitted dispatch and acknowledgement operations captured for disposal.
+	* @returns detached snapshot ordered only by Set insertion.
+	*/
+	pendingDispatches() {
+		return [...this.inFlightDispatches];
+	}
+	/** Queue and dispatch one mailbox item admitted before the disposal cutoff. */
+	async sendAdmitted(caller, request) {
+		const membership = this.roster.membership(caller);
+		request.signal.throwIfAborted();
+		const root = membership.root;
+		const content = structuredClone(request.content);
+		const queued = await this.journal.transact(root.id, async () => {
+			request.signal.throwIfAborted();
+			const state = this.journal.state(root);
+			const target = resolveActiveMember(root, state, request.target);
+			if (target.id === caller.id) throw new TeamError("a Team member cannot message itself", "TEAM_SELF_MESSAGE");
+			const pendingForTarget = [...state.messages.values()].filter((candidate) => candidate.targetId === target.id && !state.delivered.has(candidate.id)).length;
+			if (pendingForTarget >= this.maxPendingMessagesPerMember) throw new TeamError(`teammate "${target.name}" has ${pendingForTarget} pending messages`, "TEAM_MAILBOX_FULL");
+			const queued = {
+				id: TeamMessageId(`team-message-${randomUUID()}`),
+				senderId: caller.id,
+				senderName: membership.name,
+				targetId: target.id,
+				delivery: request.delivery,
+				content
+			};
+			if (Buffer.byteLength(JSON.stringify(this.deliveryContent(queued)), "utf8") > this.maxMessageBytes) throw new TeamError(`team message exceeds ${this.maxMessageBytes} bytes`, "TEAM_MESSAGE_TOO_LARGE");
+			await this.journal.appendAndFlush(root, "team/message/queued", {
+				version: 1,
+				teamId: TeamId(root.id),
+				message: queued
+			});
+			return {
+				message: queued,
+				dispatch: this.tryDispatch(root, queued, request.signal)
+			};
+		});
+		const accepted = await queued.dispatch;
+		return {
+			messageId: queued.message.id,
+			status: accepted ? "accepted" : "queued"
+		};
+	}
+	/** Attempt one queued message exactly once in this process at a time. */
+	tryDispatch(root, message, signal) {
+		if (this.lifecycle.disposed) return Promise.resolve(false);
+		if (this.inFlightMessages.has(message.id)) return Promise.resolve(false);
+		this.inFlightMessages.add(message.id);
+		const operation = this.trackDispatch(this.tryDispatchAdmitted(root, message, AbortSignal.any([signal, this.lifecycle.signal])));
+		const forget = () => {
+			this.inFlightMessages.delete(message.id);
+		};
+		operation.then(forget, forget);
+		return operation;
+	}
+	/** Track one dispatch transaction through delivery admission or contained failure. */
+	trackDispatch(operation) {
+		this.inFlightDispatches.add(operation);
+		operation.then(() => {
+			this.inFlightDispatches.delete(operation);
+		}, () => {
+			this.inFlightDispatches.delete(operation);
+		});
+		return operation;
+	}
+	/** Attempt one queued message admitted before the service lifecycle cutoff. */
+	async tryDispatchAdmitted(root, message, signal) {
+		const active = this.activeDispatches.get(message.targetId);
+		const live = message.targetId === root.id ? root : this.ctx.agents.get(message.targetId);
+		if (active !== void 0 && live !== void 0 && message.delivery === "quiet" && this.messagePrecedes(root, message.id, active.id)) return await this.dispatchOnce(root, message, signal);
+		return await this.serializeDispatch(message, () => this.dispatchOnce(root, message, signal));
+	}
+	/** Serialize delivery admission for one durable target in queued order. */
+	async serializeDispatch(message, operation) {
+		const targetId = message.targetId;
+		const prior = this.dispatchTails.get(targetId) ?? Promise.resolve();
+		const dispatch = async () => {
+			this.activeDispatches.set(targetId, message);
+			try {
+				return await operation();
+			} finally {
+				this.activeDispatches.delete(targetId);
+			}
+		};
+		/* v8 ignore next -- dispatch tails absorb rejection, so the recovery callback is a fail-safe backstop. */
+		const run = prior.then(dispatch, dispatch);
+		/* v8 ignore next -- dispatchOnce contains delivery failures and serializeDispatch itself does not throw. */
+		const tail = run.then(() => void 0, () => void 0);
+		this.dispatchTails.set(targetId, tail);
+		try {
+			return await run;
+		} finally {
+			if (this.dispatchTails.get(targetId) === tail) this.dispatchTails.delete(targetId);
+		}
+	}
+	/** Attempt one queued delivery after target-local ordering admits it. */
+	async dispatchOnce(root, message, signal) {
+		try {
+			const target = message.targetId === root.id ? root : this.ctx.agents.get(message.targetId);
+			if (target !== void 0 && this.targetRecorded(target.session, message.id)) return await this.checkpointDelivered(root, target.session, message.id);
+			const source = {
+				kind: "team-message",
+				teamId: TeamId(root.id),
+				messageId: message.id,
+				senderId: message.senderId,
+				senderName: message.senderName
+			};
+			const content = this.deliveryContent(message);
+			if (message.targetId === root.id) {
+				const input = createUserMessage({
+					content,
+					source
+				});
+				if (message.delivery === "wakeup") {
+					root.followup(input);
+					return await this.checkpointDelivered(root, root.session, message.id);
+				}
+				root.inject(input);
+				return await this.checkpointDelivered(root, root.session, message.id);
+			}
+			if (message.delivery === "quiet") {
+				if (target === void 0) return false;
+				target.inject(createUserMessage({
+					content,
+					source
+				}));
+				return await this.checkpointDelivered(root, target.session, message.id);
+			}
+			if (target === void 0) {
+				const recorded = await this.persistedTargetRecorded(message.targetId, message.id, signal);
+				if (recorded === void 0) return false;
+				if (recorded) {
+					await this.markDelivered(root, message.id, message.targetId);
+					return true;
+				}
+			}
+			await this.ctx.subagents.followup(root, message.targetId, content, {
+				source,
+				signal
+			});
+			return target === void 0 ? true : await this.checkpointDelivered(root, target.session, message.id);
+		} catch (error) {
+			this.ctx.logger.warn(`team message "${message.id}" remains queued: ${errorMessage(error)}`);
+			return false;
+		}
+	}
+	/** Whether `left` was durably queued before `right` in one Lead log. */
+	messagePrecedes(root, left, right) {
+		const ids = [...this.journal.state(root).messages.keys()];
+		return ids.indexOf(left) < ids.indexOf(right);
+	}
+	/** Flush one live target receipt before the Lead records its delivered edge. */
+	async checkpointDelivered(root, target, messageId) {
+		await this.ctx.sessions.flush(target);
+		if (!this.targetRecorded(target, messageId)) return false;
+		await this.markDelivered(root, messageId, target.id);
+		return true;
+	}
+	/** Record delivery unless the acknowledgement already exists. */
+	async markDelivered(root, messageId, targetId) {
+		await this.journal.transact(root.id, async () => {
+			const state = this.journal.state(root);
+			if (state.delivered.has(messageId)) return;
+			const queued = state.messages.get(messageId);
+			if (queued === void 0 || queued.targetId !== targetId) return;
+			await this.journal.appendAndFlush(root, "team/message/delivered", {
+				version: 1,
+				teamId: TeamId(root.id),
+				messageId,
+				targetId
+			});
+		});
+	}
+	/** Whether a target Session already contains the durable message identity. */
+	targetRecorded(session, messageId) {
+		return messageAccepted(session.events.slice(session.header.seedLength ?? 0), (message) => message.source.kind === "team-message" && message.source.messageId === messageId);
+	}
+	/** Frame peer content with stable sender and message identity for the receiving model. */
+	deliveryContent(message) {
+		return [{
+			type: "text",
+			text: `Team message ${message.id} from ${message.senderName}:`
+		}, ...structuredClone(message.content)];
+	}
+	/** Inspect an inactive target before cold resume; uncertainty keeps the mailbox queued. */
+	async persistedTargetRecorded(targetId, messageId, signal) {
+		try {
+			const stored = await this.ctx.sessionPersistence.inspect(targetId, signal);
+			return messageAccepted(stored.events.slice(stored.meta.seedLength ?? 0), (message) => message.source.kind === "team-message" && message.source.messageId === messageId);
+		} catch (error) {
+			this.ctx.logger.warn(`cannot inspect Team message target "${targetId}": ${errorMessage(error)}`);
+			return;
+		}
+	}
+};
+//#endregion
+//#region lib/types/task-board.js
+/** Shared Team task DAG commands and runtime-enriched views. */
+/** Whether two normalized file or directory prefixes overlap on path components. */
+function scopesOverlap(left, right) {
+	return left === right || left.startsWith(`${right}/`) || right.startsWith(`${left}/`);
+}
+const TASK_GRAPH_ERROR_CODES = {
+	missing: "TEAM_TASK_NOT_FOUND",
+	duplicate: "TEAM_INVALID_ARGUMENT",
+	cycle: "TEAM_TASK_DEPENDENCY_CYCLE"
+};
+/** Owns Team task limits, authorization, transitions, and derived views. */
+var TeamTaskBoard = class {
+	journal;
+	maxTasks;
+	/**
+	* @param journal - authoritative Lead-log transaction owner.
+	* @param maxTasks - maximum non-deleted tasks retained by one Team.
+	*/
+	constructor(journal, maxTasks) {
+		this.journal = journal;
+		this.maxTasks = maxTasks;
+	}
+	/**
+	* Create one unowned pending task in the Team Lead log.
+	* @param membership - exact caller membership resolved by the Team roster.
+	* @param request - task text, blockers, and advisory write scopes.
+	* @returns the revision-one task view.
+	*/
+	async create(membership, request) {
+		const { root } = membership;
+		return this.journal.transact(root.id, async () => {
+			const state = this.journal.state(root);
+			if ([...state.tasks.values()].filter((task) => task.status !== "deleted").length >= this.maxTasks) throw new TeamError(`Team task limit ${this.maxTasks} reached`, "TEAM_TASK_LIMIT");
+			const id = TeamTaskId(`task-${state.nextTaskNumber}`);
+			if (state.tasks.has(id)) throw new TeamError("Team task id space exhausted", "TEAM_TASK_LIMIT");
+			const task = {
+				id,
+				revision: 1,
+				subject: requiredText(request.subject, "subject", 200),
+				description: requiredText(request.description, "description", 16384),
+				status: "pending",
+				blockedBy: this.dependencies(request.blockedBy ?? [], state),
+				writeScopes: this.writeScopes(request.writeScopes ?? [])
+			};
+			this.assertTaskGraph(state, task);
+			await this.journal.appendAndFlush(root, "team/task", {
+				version: 1,
+				teamId: TeamId(root.id),
+				task
+			});
+			return this.taskView(root, state, task);
+		});
+	}
+	/**
+	* Return one task, including a deleted tombstone.
+	* @param membership - exact caller membership resolved by the Team roster.
+	* @param id - Team-local task identity.
+	* @returns the latest task value and derived readiness diagnostics.
+	*/
+	get(membership, id) {
+		const { root } = membership;
+		const state = this.journal.state(root);
+		const task = state.tasks.get(id);
+		if (task === void 0) throw new TeamError(`team task "${id}" not found`, "TEAM_TASK_NOT_FOUND");
+		return this.taskView(root, state, task);
+	}
+	/**
+	* List current non-deleted tasks in numeric creation order.
+	* @param membership - exact caller membership resolved by the Team roster.
+	* @returns detached current task views.
+	*/
+	list(membership) {
+		const { root } = membership;
+		const state = this.journal.state(root);
+		return [...state.tasks.values()].filter((task) => task.status !== "deleted").map((task) => this.taskView(root, state, task));
+	}
+	/**
+	* Compare-and-set one authorized task transition.
+	* @param caller - exact live Team member authorizing the mutation.
+	* @param membership - caller role and exact live Lead.
+	* @param request - task identity, expected revision, action, and action fields.
+	* @returns the committed next task revision.
+	*/
+	async update(caller, membership, request) {
+		const root = membership.root;
+		return this.journal.transact(root.id, async () => {
+			const state = this.journal.state(root);
+			const current = state.tasks.get(request.taskId);
+			if (current === void 0) throw new TeamError(`team task "${request.taskId}" not found`, "TEAM_TASK_NOT_FOUND");
+			if (current.revision !== request.expectedRevision) throw new TeamError(`stale team task "${current.id}" revision ${request.expectedRevision}; current revision is ${current.revision}`, "TEAM_TASK_STALE_REVISION");
+			if (current.status === "deleted") throw new TeamError(`team task "${current.id}" is deleted`, "TEAM_TASK_DELETED");
+			const lead = membership.role === "lead";
+			const owner = current.ownerId === caller.id;
+			const authorizeOwner = () => {
+				if (!lead && !owner) throw new TeamError("task mutation requires its owner or Team Lead", "TEAM_TASK_UNAUTHORIZED");
+			};
+			let next;
+			switch (request.action) {
+				case "claim":
+					if (current.ownerId !== void 0 && current.ownerId !== caller.id) throw new TeamError(`team task "${current.id}" is owned by another member`, "TEAM_TASK_ALREADY_CLAIMED");
+					if (current.status !== "pending" || !this.taskReady(state, current)) throw new TeamError(`team task "${current.id}" is not ready to claim`, "TEAM_TASK_BLOCKED");
+					next = {
+						...current,
+						status: "in_progress",
+						ownerId: caller.id
+					};
+					break;
+				case "release":
+					authorizeOwner();
+					if (current.status !== "in_progress") throw new TeamError("only an in-progress task can be released", "TEAM_TASK_INVALID_TRANSITION");
+					next = this.withoutOwner({
+						...current,
+						status: "pending"
+					});
+					break;
+				case "edit":
+					authorizeOwner();
+					if (request.subject === void 0 && request.description === void 0 && request.writeScopes === void 0) throw new TeamError("task edit requires subject, description, or write_scopes", "TEAM_INVALID_ARGUMENT");
+					next = {
+						...current,
+						...request.subject === void 0 ? {} : { subject: requiredText(request.subject, "subject", 200) },
+						...request.description === void 0 ? {} : { description: requiredText(request.description, "description", 16384) },
+						...request.writeScopes === void 0 ? {} : { writeScopes: this.writeScopes(request.writeScopes) }
+					};
+					break;
+				case "set_dependencies":
+					authorizeOwner();
+					if (request.blockedBy === void 0) throw new TeamError("set_dependencies requires blocked_by", "TEAM_INVALID_ARGUMENT");
+					next = {
+						...current,
+						blockedBy: this.dependencies(request.blockedBy, state, current.id)
+					};
+					break;
+				case "complete":
+					authorizeOwner();
+					if (current.status !== "in_progress") throw new TeamError("only an in-progress task can complete", "TEAM_TASK_INVALID_TRANSITION");
+					next = {
+						...current,
+						status: "completed"
+					};
+					break;
+				case "reopen":
+					authorizeOwner();
+					if (current.status !== "completed") throw new TeamError("only a completed task can reopen", "TEAM_TASK_INVALID_TRANSITION");
+					next = this.withoutOwner({
+						...current,
+						status: "pending"
+					});
+					break;
+				case "reassign": {
+					if (!lead) throw new TeamError("only the Team Lead can reassign tasks", "TEAM_LEAD_REQUIRED");
+					if (current.status !== "pending" && current.status !== "in_progress") throw new TeamError("only a pending or in-progress task can be reassigned", "TEAM_TASK_INVALID_TRANSITION");
+					if (request.owner === void 0 || request.owner.trim().length === 0) {
+						next = this.withoutOwner({
+							...current,
+							status: "pending"
+						});
+						break;
+					}
+					if (!this.taskReady(state, current)) throw new TeamError(`team task "${current.id}" is blocked`, "TEAM_TASK_BLOCKED");
+					const assignee = resolveActiveMember(root, state, request.owner);
+					next = {
+						...current,
+						status: "in_progress",
+						ownerId: assignee.id
+					};
+					break;
+				}
+				case "delete": {
+					authorizeOwner();
+					const dependent = [...state.tasks.values()].find((task) => task.status !== "deleted" && task.id !== current.id && task.blockedBy.includes(current.id));
+					if (dependent !== void 0) throw new TeamError(`team task "${current.id}" still blocks "${dependent.id}"`, "TEAM_TASK_HAS_DEPENDENTS");
+					next = {
+						...current,
+						status: "deleted"
+					};
+					break;
+				}
+				/* v8 ignore next 2 -- TeamTaskAction is closed and every member is handled above. */
+				default: throw new TeamError(`unsupported task action ${String(request.action)}`, "TEAM_INVALID_ARGUMENT");
+			}
+			const task = {
+				...next,
+				revision: current.revision + 1
+			};
+			this.assertTaskGraph(state, task);
+			await this.journal.appendAndFlush(root, "team/task", {
+				version: 1,
+				teamId: TeamId(root.id),
+				task
+			});
+			return this.taskView(root, state, task);
+		});
+	}
+	/** Validate and de-duplicate dependency ids against the current task graph. */
+	dependencies(values, state, self) {
+		const seen = /* @__PURE__ */ new Set();
+		const result = [];
+		for (const id of values) {
+			if (id === self) throw new TeamError("a team task cannot block itself", "TEAM_TASK_DEPENDENCY_CYCLE");
+			if (seen.has(id)) throw new TeamError(`duplicate blocker "${id}"`, "TEAM_INVALID_ARGUMENT");
+			const task = state.tasks.get(id);
+			if (task === void 0 || task.status === "deleted") throw new TeamError(`blocker task "${id}" not found`, "TEAM_TASK_NOT_FOUND");
+			seen.add(id);
+			result.push(id);
+		}
+		return result;
+	}
+	/** Normalize and de-duplicate task write scopes. */
+	writeScopes(values) {
+		return [...new Set(values.map(writeScope))];
+	}
+	/** Map shared task-graph validation onto stable command error codes. */
+	assertTaskGraph(state, candidate) {
+		try {
+			assertTaskGraphCandidate(state.tasks, candidate);
+		} catch (error) {
+			/* v8 ignore next -- the shared validator is the only statement in the try and throws this exact error. */
+			if (!(error instanceof TeamTaskGraphError)) throw error;
+			throw new TeamError(error.message, TASK_GRAPH_ERROR_CODES[error.violation], { cause: error });
+		}
+	}
+	/** Whether all current blockers completed. */
+	taskReady(state, task) {
+		return task.blockedBy.every((id) => state.tasks.get(id)?.status === "completed");
+	}
+	/** Remove an optional owner field under exactOptionalPropertyTypes. */
+	withoutOwner(task) {
+		const { ownerId: _ownerId, ...without } = task;
+		return without;
+	}
+	/**
+	* Build one task view with owner name, readiness, and advisory write overlaps.
+	* A committing caller may pass its pre-append fold because `task` supplies the
+	* new value explicitly; owner names, blocker readiness, and other task scopes
+	* do not change when that snapshot is appended.
+	*/
+	taskView(root, state, task) {
+		const ownerName = task.ownerId === void 0 ? void 0 : task.ownerId === root.id ? "lead" : state.members.get(task.ownerId)?.name;
+		const warnings = /* @__PURE__ */ new Set();
+		for (const other of state.tasks.values()) {
+			if (other.id === task.id || other.status !== "in_progress") continue;
+			if (task.writeScopes.some((left) => other.writeScopes.some((right) => scopesOverlap(left, right)))) warnings.add(`write scopes overlap with ${other.id}`);
+		}
+		return {
+			id: task.id,
+			revision: task.revision,
+			subject: task.subject,
+			description: task.description,
+			status: task.status,
+			blockedBy: structuredClone(task.blockedBy),
+			writeScopes: structuredClone(task.writeScopes),
+			...ownerName === void 0 ? {} : { ownerName },
+			ready: task.status === "pending" && this.taskReady(state, task),
+			writeScopeWarnings: [...warnings]
+		};
+	}
+};
+//#endregion
+//#region lib/types/index.js
+/** Agent Teams service façade over roster, mailbox, task, and runtime lifecycle owners. */
+const DEFAULT_MAX_MEMBERS = 8;
+const DEFAULT_MAX_TASKS = 256;
+const DEFAULT_MAX_PENDING_MESSAGES = 64;
+const DEFAULT_MAX_MESSAGE_BYTES = 65536;
+const DEFAULT_DISPOSAL_TIMEOUT_MS = 5e3;
+/** Validate one positive safe-integer deployment limit. */
+function positiveLimit(name, value) {
+	if (!Number.isSafeInteger(value) || value < 1) throw new TeamError(`${name} must be a positive safe integer`, "TEAM_INVALID_CONFIG");
+	return value;
+}
+/** Agent Teams service backed by the exact live Lead Session log. */
+var TeamService = class extends Service {
+	static inject = [
+		"agents",
+		"sessions",
+		"sessionPersistence",
+		"subagents"
+	];
+	static Config = z.object({
+		maxMembers: z.number().step(1).min(1).default(DEFAULT_MAX_MEMBERS),
+		maxTasks: z.number().step(1).min(1).default(DEFAULT_MAX_TASKS),
+		maxPendingMessagesPerMember: z.number().step(1).min(1).default(DEFAULT_MAX_PENDING_MESSAGES),
+		maxMessageBytes: z.number().step(1).min(1).default(DEFAULT_MAX_MESSAGE_BYTES),
+		disposalTimeoutMs: z.number().step(1).min(1).default(DEFAULT_DISPOSAL_TIMEOUT_MS)
+	});
+	/** Validated deployment limits used by every Team operation. */
+	config;
+	activity;
+	lifecycle;
+	journal;
+	roster;
+	mailbox;
+	tasks;
+	constructor(ctx, config = {}) {
+		super(ctx, "agentTeams");
+		this.config = {
+			maxMembers: positiveLimit("maxMembers", config.maxMembers ?? DEFAULT_MAX_MEMBERS),
+			maxTasks: positiveLimit("maxTasks", config.maxTasks ?? DEFAULT_MAX_TASKS),
+			maxPendingMessagesPerMember: positiveLimit("maxPendingMessagesPerMember", config.maxPendingMessagesPerMember ?? DEFAULT_MAX_PENDING_MESSAGES),
+			maxMessageBytes: positiveLimit("maxMessageBytes", config.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES),
+			disposalTimeoutMs: positiveLimit("disposalTimeoutMs", config.disposalTimeoutMs ?? DEFAULT_DISPOSAL_TIMEOUT_MS)
+		};
+		this.activity = new TeamActivity();
+		this.lifecycle = new TeamRuntimeLifecycle(this.config.disposalTimeoutMs);
+		this.journal = new TeamJournal(ctx, (root) => {
+			this.activity.notify(TeamId(root.id));
+		});
+		this.roster = new TeamRoster(ctx, this.journal, this.lifecycle, this.config.maxMembers);
+		this.mailbox = new TeamMailbox(ctx, this.journal, this.roster, this.lifecycle, this.config.maxPendingMessagesPerMember, this.config.maxMessageBytes);
+		this.tasks = new TeamTaskBoard(this.journal, this.config.maxTasks);
+		ctx.on("session/event", (session, event) => {
+			this.mailbox.observeSessionEvent(session, event);
+		});
+		ctx.on("agent/session-start", ({ agent }) => {
+			this.scheduleRecovery(agent);
+		});
+		ctx.on("agent/status", ({ agent }) => {
+			const membership = this.roster.tryMembership(agent);
+			if (membership !== void 0) this.activity.notify(membership.id);
+		});
+		ctx.effect(() => () => this.disposeRuntime(), "agentTeams.runtimeLifecycle()");
+		for (const agent of ctx.agents.list()) this.scheduleRecovery(agent);
+	}
+	/**
+	* Resolve one exact live Agent's Team role.
+	* @param agent - exact live Agent used as the authority credential.
+	* @returns its root, Team identity, role, and model-facing name.
+	*/
+	membership(agent) {
+		return this.roster.membership(agent);
+	}
+	/**
+	* List the runtime-enriched roster visible to one Team member.
+	* @param agent - exact live Team member.
+	* @returns Lead and teammate rows in creation order.
+	*/
+	listMembers(agent) {
+		return this.roster.list(this.roster.membership(agent));
+	}
+	/**
+	* Create one named, continuable direct child of the Team Lead.
+	* @param caller - exact live Lead Agent.
+	* @param request - immutable name, description, prompt, context mode, provider, and cancellation.
+	* @returns the active roster row.
+	*/
+	async spawnTeammate(caller, request) {
+		return await this.roster.spawn(caller, request);
+	}
+	/**
+	* Queue one durable peer message, then attempt immediate delivery.
+	* @param caller - exact live sending Team member.
+	* @param request - target name, content, scheduling mode, and pre-queue cancellation.
+	* @returns durable message identity and immediate-delivery observation.
+	*/
+	async sendMessage(caller, request) {
+		return await this.mailbox.send(caller, request);
+	}
+	/**
+	* Create one unowned pending task in the Team Lead log.
+	* @param caller - exact live Team member creating the task.
+	* @param request - task text, blockers, and advisory write scopes.
+	* @returns the revision-one task view.
+	*/
+	async createTask(caller, request) {
+		return await this.tasks.create(this.roster.membership(caller), request);
+	}
+	/**
+	* Return one task, including a deleted tombstone.
+	* @param caller - exact live Team member reading the task.
+	* @param id - Team-local task identity.
+	* @returns the latest task value and derived readiness diagnostics.
+	*/
+	getTask(caller, id) {
+		return this.tasks.get(this.roster.membership(caller), id);
+	}
+	/**
+	* List current non-deleted tasks in numeric creation order.
+	* @param caller - exact live Team member reading the board.
+	* @returns detached current task views.
+	*/
+	listTasks(caller) {
+		return this.tasks.list(this.roster.membership(caller));
+	}
+	/**
+	* Compare-and-set one authorized task transition.
+	* @param caller - exact live Team member authorizing the mutation.
+	* @param request - task identity, expected revision, action, and action fields.
+	* @returns the committed next task revision.
+	*/
+	async updateTask(caller, request) {
+		return await this.tasks.update(caller, this.roster.membership(caller), request);
+	}
+	/**
+	* Wait for the next Team-domain or member-status change.
+	* @param caller - exact live Team member waiting for activity.
+	* @param timeoutMs - bounded wait duration from ten seconds through one hour.
+	* @param signal - caller cancellation for the wait only.
+	* @returns one observed change or a timeout result.
+	*/
+	async waitForChange(caller, timeoutMs, signal) {
+		const membership = this.roster.membership(caller);
+		return await this.activity.wait(membership.id, timeoutMs, signal);
+	}
+	/**
+	* Interrupt one live teammate turn without clearing its pending inbox.
+	* @param caller - exact live Lead Agent.
+	* @param targetName - durable teammate name.
+	* @returns the target status sampled before cancellation.
+	*/
+	interrupt(caller, targetName) {
+		return this.roster.interrupt(caller, targetName);
+	}
+	/**
+	* Resolve a caller without throwing, used by scoped-tool installation and observers.
+	* @param agent - candidate exact live Agent.
+	* @returns Team membership, or undefined for non-Team subagents and stale identities.
+	*/
+	tryMembership(agent) {
+		return this.roster.tryMembership(agent);
+	}
+	/** Queue one contained recovery pass after publication has unwound. */
+	scheduleRecovery(agent) {
+		queueMicrotask(() => {
+			if (this.lifecycle.disposed) return;
+			this.recoverFor(agent).catch((error) => {
+				if (this.lifecycle.disposed) return;
+				this.ctx.logger.warn(`Agent Teams recovery for "${agent.id}" failed: ${errorMessage(error)}`);
+			});
+		});
+	}
+	/** Reconcile roster provisioning before retrying that member's pending mailbox. */
+	async recoverFor(agent) {
+		await this.roster.recoverFor(agent, this.lifecycle.signal);
+		await this.mailbox.recoverFor(agent, this.lifecycle.signal);
+	}
+	/** Stop Team-owned live branches and release every waiter before service disposal completes. */
+	async disposeRuntime() {
+		this.lifecycle.close();
+		this.activity.close();
+		const failures = [];
+		await this.lifecycle.settle(this.roster.pendingCreations(), failures);
+		await this.lifecycle.settle(this.mailbox.pendingDispatches(), failures);
+		for (const [root, childIds] of this.roster.liveChildrenByRoot()) try {
+			await this.roster.stopTeammates(root, childIds);
+		} catch (error) {
+			failures.push(error);
+		}
+		if (failures.length > 0) throw new AggregateError(failures, "Agent Teams runtime disposal failed");
+	}
+};
+//#endregion
+export { TeamError, TeamId, TeamMessageId, TeamService, TeamService as default, TeamTaskId, foldTeam };