aec-agent 1.0.3 → 1.0.4

package/dist/components/group-hub/group-hub.d.ts

@@ -0,0 +1,117 @@
+import type { Session } from "../../kernel/types.js";
+import { type GroupPresencePayload } from "../event-handler/events.js";
+import type { EventBus } from "../event-handler/types.js";
+import type { GroupMessageStore, GroupStore } from "../persistence-hub/types/group-store.js";
+import type { MessageStore } from "../persistence-hub/types/message-store.js";
+import type { SessionStore } from "../persistence-hub/types/session-store.js";
+import type { SubagentScopes } from "../multi-agent-orchestration/agent/subagent-manager/types.js";
+import { GroupTurns, type GroupAgentHost } from "./group-turns.js";
+import { type Group, type GroupDefinition, type GroupMemberRunner, type GroupMessage, type GroupPatch, type GroupSendOptions, type GroupSendRequest, type GroupTurnResult } from "./types.js";
+export interface GroupHubDeps {
+    eventBus: EventBus;
+    /** Resolved on every call, so `AgentCore.usePersistence()` can swap the stores. */
+    getStore: () => GroupStore;
+    getMessages: () => GroupMessageStore;
+    getSessions: () => SessionStore;
+    /** The members' conversation stores — a deleted group session takes its member sessions' messages with it. */
+    getMemberMessages?: () => MessageStore[];
+    /** The agents members can be (AgentCore.agents). */
+    getAgents: () => GroupAgentHost | undefined;
+    /** The host's runner for member turns (AgentCore.useGroupRunner). */
+    getRunner: () => GroupMemberRunner | undefined;
+}
+/** Where a member session belongs. */
+export interface GroupMemberSessionRef {
+    groupId: string;
+    groupSessionId: string;
+    agentId: string;
+}
+/**
+ * Group chats (A-106) — several agents in one conversation. Owns:
+ *  - the groups (PersistenceHub.groups): create, change, delete, with validation (A-107)
+ *    and a note in the open session for membership and settings changes (A-113);
+ *  - their sessions (SessionStore, metadata.source "group") and threads
+ *    (PersistenceHub.groupMessages), and each member's private session per group session;
+ *  - group turns (GroupTurns): who answers (A-108), lead routing and rounds (A-109),
+ *    guard rails (A-112), stop and retry (A-115).
+ * It emits group:* events; hosts stream them to the thread's viewers. A deleted agent leaves
+ * every group (agent:removed).
+ */
+export declare class GroupHub {
+    private deps;
+    private readonly thread;
+    private readonly turns;
+    private unsubscribes;
+    constructor(deps: GroupHubDeps);
+    /** Spawn scopes of group leads while they lead a turn (AgentDeps.subagentScopes). */
+    get scopes(): SubagentScopes;
+    list(): Promise<Group[]>;
+    get(groupId: string): Promise<Group | null>;
+    /** Create a group. Throws GroupError ("invalid_argument", "unknown_agent"). */
+    create(definition: GroupDefinition): Promise<Group>;
+    /**
+     * Change a group; omitted fields stay. With `noteIn` (a session of the group, usually the
+     * one the user has open), the changes are written there as notes ("RFI Desk now leads.").
+     */
+    update(groupId: string, patch: GroupPatch, options?: {
+        noteIn?: string;
+    }): Promise<Group>;
+    /** Delete a group with all its sessions and their threads. Stops running turns first. */
+    delete(groupId: string): Promise<void>;
+    /** Start a session of the group. */
+    startSession(groupId: string, options?: {
+        title?: string;
+    }): Promise<Session>;
+    /** The group's sessions, most recently active first. */
+    listSessions(groupId: string): Promise<Session[]>;
+    /** One of the group's sessions, or null. */
+    getSession(groupId: string, sessionId: string): Promise<Session | null>;
+    /** Rename or pin a session. Throws GroupError "not_found". */
+    updateSession(groupId: string, sessionId: string, fields: {
+        title?: string;
+        pinned?: boolean;
+    }): Promise<Session>;
+    /** Delete a session: its thread, its member sessions (and their messages) and the session. */
+    deleteSession(groupId: string, sessionId: string): Promise<void>;
+    /** The session's thread, in order; `afterSeq` keeps only later messages. */
+    messages(groupId: string, sessionId: string, options?: {
+        afterSeq?: number;
+    }): Promise<GroupMessage[]>;
+    /**
+     * Every current member's private session in a group session, created when missing — a host
+     * attaches its approval channel to each before a turn streams.
+     */
+    memberSessions(groupId: string, sessionId: string): Promise<Array<{
+        agentId: string;
+        sessionId: string;
+    }>>;
+    /** Where a member session belongs (hosts route its approvals to the group's thread), or null. */
+    memberSessionOf(sessionId: string): Promise<GroupMemberSessionRef | null>;
+    /**
+     * Send a user message to a group session and run the group turn it sets off; resolves
+     * when every member is done. Its progress streams as group:* events. Throws GroupError
+     * before anything runs ("busy" while another turn runs in the session).
+     */
+    send(groupId: string, sessionId: string, request: GroupSendRequest, options?: GroupSendOptions): Promise<GroupTurnResult>;
+    /** Run a member's answer again, in place. */
+    retry(groupId: string, sessionId: string, messageId: string, options?: GroupSendOptions): Promise<GroupTurnResult>;
+    /** Stop the session's running turn, or one member of it. False when nothing was running. */
+    stop(sessionId: string, agentId?: string): boolean;
+    isBusy(sessionId: string): boolean;
+    /** What each member of the session's running turn is doing (empty when idle). */
+    presence(sessionId: string): GroupPresencePayload[];
+    /** Every running group turn, with who is doing what. */
+    running(): ReturnType<GroupTurns["running"]>;
+    /** Stop every running turn and stop listening. */
+    dispose(): void;
+    private require;
+    private sessionOf;
+    /** A-107: the definition checked and normalized. */
+    private validate;
+    /** The notes a change leaves in the thread. */
+    private describeChange;
+    /** agent:removed — the agent leaves every group; a lead hands over to the next member. */
+    private removeAgentEverywhere;
+    private changed;
+}
+//# sourceMappingURL=group-hub.d.ts.map

package/dist/components/group-hub/group-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-hub.d.ts","sourceRoot":"","sources":["../../../src/components/group-hub/group-hub.ts"],"names":[],"mappings":"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"}

package/dist/components/group-hub/group-hub.js

@@ -0,0 +1,334 @@
+import { randomUUID } from "node:crypto";
+import { GroupError } from "../../kernel/errors/group-error.js";
+import { SDKEventType } from "../event-handler/events.js";
+import { GroupTurns } from "./group-turns.js";
+import { GroupThread } from "./thread.js";
+import { GROUP_TEXT_LIMITS, isGroupSession, } from "./types.js";
+const REPLY_MODES = ["lead", "all", "mention"];
+const MEMBER_VIEWS = ["full", "addressed"];
+/**
+ * Group chats (A-106) — several agents in one conversation. Owns:
+ *  - the groups (PersistenceHub.groups): create, change, delete, with validation (A-107)
+ *    and a note in the open session for membership and settings changes (A-113);
+ *  - their sessions (SessionStore, metadata.source "group") and threads
+ *    (PersistenceHub.groupMessages), and each member's private session per group session;
+ *  - group turns (GroupTurns): who answers (A-108), lead routing and rounds (A-109),
+ *    guard rails (A-112), stop and retry (A-115).
+ * It emits group:* events; hosts stream them to the thread's viewers. A deleted agent leaves
+ * every group (agent:removed).
+ */
+export class GroupHub {
+    deps;
+    thread;
+    turns;
+    unsubscribes = [];
+    constructor(deps) {
+        this.deps = deps;
+        this.thread = new GroupThread({ eventBus: deps.eventBus, getMessages: deps.getMessages, getSessions: deps.getSessions });
+        this.turns = new GroupTurns({
+            eventBus: deps.eventBus,
+            thread: this.thread,
+            getSessions: deps.getSessions,
+            getAgents: deps.getAgents,
+            getRunner: deps.getRunner,
+        });
+        this.unsubscribes.push(deps.eventBus.on(SDKEventType.AgentRemoved, (e) => this.removeAgentEverywhere(e.payload.agentId).catch((err) => {
+            console.warn(`[group] could not remove agent ${e.payload.agentId} from its groups:`, errorMessage(err));
+        })));
+    }
+    /** Spawn scopes of group leads while they lead a turn (AgentDeps.subagentScopes). */
+    get scopes() {
+        return { get: (sessionId) => this.turns.get(sessionId) };
+    }
+    // ---------------------------------------------------------------------------
+    // Groups
+    // ---------------------------------------------------------------------------
+    async list() {
+        return this.deps.getStore().list();
+    }
+    async get(groupId) {
+        return this.deps.getStore().get(groupId);
+    }
+    /** Create a group. Throws GroupError ("invalid_argument", "unknown_agent"). */
+    async create(definition) {
+        const now = new Date().toISOString();
+        const group = { ...this.validate(definition), id: randomUUID(), createdAt: now, updatedAt: now };
+        await this.deps.getStore().save(group);
+        this.changed(group.id, "created");
+        return group;
+    }
+    /**
+     * Change a group; omitted fields stay. With `noteIn` (a session of the group, usually the
+     * one the user has open), the changes are written there as notes ("RFI Desk now leads.").
+     */
+    async update(groupId, patch, options = {}) {
+        const before = await this.require(groupId);
+        const merged = {
+            name: patch.name ?? before.name,
+            topic: patch.topic ?? before.topic,
+            members: patch.members ?? before.members,
+            leadId: patch.leadId ?? before.leadId,
+            replyMode: patch.replyMode ?? before.replyMode,
+            // A member who left is no longer muted.
+            muted: (patch.muted ?? before.muted).filter((id) => (patch.members ?? before.members).includes(id)),
+            memberView: patch.memberView ?? before.memberView,
+            limits: patch.limits ?? before.limits,
+        };
+        const group = { ...this.validate(merged), id: before.id, createdAt: before.createdAt, updatedAt: new Date().toISOString() };
+        await this.deps.getStore().save(group);
+        this.changed(group.id, "updated");
+        if (options.noteIn) {
+            const session = await this.sessionOf(group.id, options.noteIn).catch(() => null);
+            if (session)
+                for (const note of this.describeChange(before, group))
+                    await this.thread.note(group.id, session.id, note);
+        }
+        return group;
+    }
+    /** Delete a group with all its sessions and their threads. Stops running turns first. */
+    async delete(groupId) {
+        await this.require(groupId);
+        for (const session of await this.listSessions(groupId))
+            await this.deleteSession(groupId, session.id);
+        await this.deps.getStore().delete(groupId);
+        this.changed(groupId, "deleted");
+    }
+    // ---------------------------------------------------------------------------
+    // Sessions
+    // ---------------------------------------------------------------------------
+    /** Start a session of the group. */
+    async startSession(groupId, options = {}) {
+        await this.require(groupId);
+        const metadata = { source: "group", groupId, ...(options.title?.trim() ? { title: options.title.trim() } : {}) };
+        return this.deps.getSessions().create({ ...metadata });
+    }
+    /** The group's sessions, most recently active first. */
+    async listSessions(groupId) {
+        const sessions = await this.deps.getSessions().list({ metadata: { source: "group", groupId } });
+        return sessions.sort((a, b) => b.updatedAt - a.updatedAt);
+    }
+    /** One of the group's sessions, or null. */
+    async getSession(groupId, sessionId) {
+        const session = await this.deps.getSessions().get(sessionId);
+        return session && isGroupSession(session) && session.metadata["groupId"] === groupId ? session : null;
+    }
+    /** Rename or pin a session. Throws GroupError "not_found". */
+    async updateSession(groupId, sessionId, fields) {
+        await this.sessionOf(groupId, sessionId);
+        const updated = await this.thread.updateMetadata(sessionId, (meta) => {
+            const next = { ...meta };
+            if (fields.title !== undefined) {
+                const title = fields.title.trim().slice(0, 200);
+                if (title)
+                    next.title = title;
+                else
+                    delete next.title;
+            }
+            if (fields.pinned !== undefined) {
+                if (fields.pinned)
+                    next.pinned = true;
+                else
+                    delete next.pinned;
+            }
+            return next;
+        });
+        if (!updated)
+            throw new GroupError("no such group session", "not_found");
+        return updated;
+    }
+    /** Delete a session: its thread, its member sessions (and their messages) and the session. */
+    async deleteSession(groupId, sessionId) {
+        await this.sessionOf(groupId, sessionId);
+        this.turns.stop(sessionId);
+        await this.turns.idle(sessionId);
+        await this.thread.settle(sessionId);
+        const sessions = this.deps.getSessions();
+        for (const member of await sessions.list({ metadata: { source: "group-member", groupSessionId: sessionId } })) {
+            for (const store of this.deps.getMemberMessages?.() ?? [])
+                await store.clear(member.id).catch(() => undefined);
+            await sessions.delete(member.id);
+        }
+        await this.deps.getMessages().deleteBySession(sessionId);
+        await sessions.delete(sessionId);
+        this.turns.forgetSession(sessionId);
+        this.thread.forget(sessionId);
+    }
+    /** The session's thread, in order; `afterSeq` keeps only later messages. */
+    async messages(groupId, sessionId, options = {}) {
+        await this.sessionOf(groupId, sessionId);
+        return this.thread.list(sessionId, options.afterSeq);
+    }
+    /**
+     * Every current member's private session in a group session, created when missing — a host
+     * attaches its approval channel to each before a turn streams.
+     */
+    async memberSessions(groupId, sessionId) {
+        const group = await this.require(groupId);
+        await this.sessionOf(groupId, sessionId);
+        const host = this.deps.getAgents();
+        const out = [];
+        for (const agentId of group.members) {
+            if (!host?.get(agentId))
+                continue;
+            out.push({ agentId, sessionId: await this.turns.memberSession(group, sessionId, agentId) });
+        }
+        return out;
+    }
+    /** Where a member session belongs (hosts route its approvals to the group's thread), or null. */
+    async memberSessionOf(sessionId) {
+        const session = await this.deps.getSessions().get(sessionId);
+        const meta = session?.metadata;
+        if (meta?.source !== "group-member" || !meta.groupId || !meta.groupSessionId || !meta.agentId)
+            return null;
+        return { groupId: meta.groupId, groupSessionId: meta.groupSessionId, agentId: meta.agentId };
+    }
+    // ---------------------------------------------------------------------------
+    // Turns
+    // ---------------------------------------------------------------------------
+    /**
+     * Send a user message to a group session and run the group turn it sets off; resolves
+     * when every member is done. Its progress streams as group:* events. Throws GroupError
+     * before anything runs ("busy" while another turn runs in the session).
+     */
+    async send(groupId, sessionId, request, options) {
+        const group = await this.require(groupId);
+        const session = await this.sessionOf(groupId, sessionId);
+        return this.turns.send(group, session, request, options);
+    }
+    /** Run a member's answer again, in place. */
+    async retry(groupId, sessionId, messageId, options) {
+        const group = await this.require(groupId);
+        const session = await this.sessionOf(groupId, sessionId);
+        const message = await this.deps.getMessages().get(messageId);
+        if (!message || message.sessionId !== sessionId)
+            throw new GroupError("no such message in this session", "not_found");
+        return this.turns.retry(group, session, message, options);
+    }
+    /** Stop the session's running turn, or one member of it. False when nothing was running. */
+    stop(sessionId, agentId) {
+        return this.turns.stop(sessionId, agentId);
+    }
+    isBusy(sessionId) {
+        return this.turns.isBusy(sessionId);
+    }
+    /** What each member of the session's running turn is doing (empty when idle). */
+    presence(sessionId) {
+        return this.turns.presenceOf(sessionId);
+    }
+    /** Every running group turn, with who is doing what. */
+    running() {
+        return this.turns.running();
+    }
+    /** Stop every running turn and stop listening. */
+    dispose() {
+        this.turns.dispose();
+        for (const off of this.unsubscribes)
+            off();
+        this.unsubscribes = [];
+    }
+    // ---------------------------------------------------------------------------
+    // Internals
+    // ---------------------------------------------------------------------------
+    async require(groupId) {
+        const group = await this.deps.getStore().get(groupId);
+        if (!group)
+            throw new GroupError("no such group", "not_found");
+        return group;
+    }
+    async sessionOf(groupId, sessionId) {
+        const session = await this.getSession(groupId, sessionId);
+        if (!session)
+            throw new GroupError("no such session in this group", "not_found");
+        return session;
+    }
+    /** A-107: the definition checked and normalized. */
+    validate(definition) {
+        const name = typeof definition?.name === "string" ? definition.name.trim() : "";
+        if (!name)
+            throw new GroupError('"name" is required', "invalid_argument");
+        if (name.length > GROUP_TEXT_LIMITS.name)
+            throw new GroupError(`"name" is ${name.length} characters; keep it under ${GROUP_TEXT_LIMITS.name}`, "invalid_argument");
+        const topic = typeof definition.topic === "string" ? definition.topic.trim() : "";
+        if (topic.length > GROUP_TEXT_LIMITS.topic)
+            throw new GroupError(`"topic" is ${topic.length} characters; keep it under ${GROUP_TEXT_LIMITS.topic}`, "invalid_argument");
+        if (!Array.isArray(definition.members))
+            throw new GroupError('"members" must be a list of agent ids', "invalid_argument");
+        const members = [...new Set(definition.members.filter((m) => typeof m === "string" && m.trim() !== "").map((m) => m.trim()))];
+        if (members.length < 2)
+            throw new GroupError("a group needs at least 2 members", "invalid_argument");
+        if (members.length > GROUP_TEXT_LIMITS.members)
+            throw new GroupError(`a group has at most ${GROUP_TEXT_LIMITS.members} members`, "invalid_argument");
+        const host = this.deps.getAgents();
+        const unknown = members.filter((id) => !host?.get(id));
+        if (unknown.length)
+            throw new GroupError(`not a running agent: ${unknown.join(", ")}`, "unknown_agent");
+        const leadId = typeof definition.leadId === "string" ? definition.leadId.trim() : "";
+        if (!members.includes(leadId))
+            throw new GroupError("the lead must be one of the members", "invalid_argument");
+        const replyMode = definition.replyMode ?? "lead";
+        if (!REPLY_MODES.includes(replyMode))
+            throw new GroupError(`"replyMode" must be one of ${REPLY_MODES.join(", ")}`, "invalid_argument");
+        const memberView = definition.memberView ?? "full";
+        if (!MEMBER_VIEWS.includes(memberView))
+            throw new GroupError(`"memberView" must be one of ${MEMBER_VIEWS.join(", ")}`, "invalid_argument");
+        const muted = [...new Set((definition.muted ?? []).filter((m) => typeof m === "string").map((m) => m.trim()))];
+        if (muted.includes(leadId))
+            throw new GroupError("the lead can't be muted", "invalid_argument");
+        const strangers = muted.filter((id) => !members.includes(id));
+        if (strangers.length)
+            throw new GroupError(`muted agents must be members: ${strangers.join(", ")}`, "invalid_argument");
+        const limits = typeof definition.limits === "object" && definition.limits !== null ? { ...definition.limits } : {};
+        return { name, topic, members, leadId, replyMode, muted, memberView, limits };
+    }
+    /** The notes a change leaves in the thread. */
+    describeChange(before, after) {
+        const name = (id) => this.deps.getAgents()?.get(id)?.profile.name ?? id;
+        const notes = [];
+        if (before.name !== after.name)
+            notes.push(`The group is now called “${after.name}”.`);
+        if (before.topic !== after.topic)
+            notes.push(after.topic ? `The group's purpose is now: ${after.topic}` : "The group's purpose was cleared.");
+        for (const id of after.members.filter((m) => !before.members.includes(m)))
+            notes.push(`You added ${name(id)}.`);
+        for (const id of before.members.filter((m) => !after.members.includes(m)))
+            notes.push(`You removed ${name(id)}.`);
+        if (before.leadId !== after.leadId)
+            notes.push(`${name(after.leadId)} now leads.`);
+        if (before.replyMode !== after.replyMode)
+            notes.push(`Who answers is now “${REPLY_LABELS[after.replyMode]}”.`);
+        for (const id of after.muted.filter((m) => !before.muted.includes(m)))
+            notes.push(`${name(id)} is muted.`);
+        for (const id of before.muted.filter((m) => !after.muted.includes(m) && after.members.includes(m)))
+            notes.push(`${name(id)} is back.`);
+        if (before.memberView !== after.memberView) {
+            notes.push(after.memberView === "addressed" ? "Members now see only what is addressed to them." : "Members now see the whole thread.");
+        }
+        return notes;
+    }
+    /** agent:removed — the agent leaves every group; a lead hands over to the next member. */
+    async removeAgentEverywhere(agentId) {
+        for (const group of await this.deps.getStore().list()) {
+            if (!group.members.includes(agentId))
+                continue;
+            const members = group.members.filter((m) => m !== agentId);
+            const leadId = group.leadId === agentId ? (members[0] ?? "") : group.leadId;
+            const next = {
+                ...group,
+                members,
+                leadId,
+                muted: group.muted.filter((m) => m !== agentId && m !== leadId),
+                updatedAt: new Date().toISOString(),
+            };
+            await this.deps.getStore().save(next);
+            this.changed(group.id, "updated");
+        }
+    }
+    changed(groupId, change) {
+        this.deps.eventBus.emit({ type: SDKEventType.GroupChanged, sessionId: "", payload: { groupId, change } });
+    }
+}
+const REPLY_LABELS = { lead: "Lead routes", all: "Everyone answers", mention: "Only when mentioned" };
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=group-hub.js.map

package/dist/components/group-hub/group-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-hub.js","sourceRoot":"","sources":["../../../src/components/group-hub/group-hub.ts"],"names":[],"mappings":"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"}

package/dist/components/group-hub/group-turns.d.ts

@@ -0,0 +1,109 @@
+import type { Session, StreamChunk } from "../../kernel/types.js";
+import { type GroupPresencePayload } from "../event-handler/events.js";
+import type { EventBus } from "../event-handler/types.js";
+import type { SessionStore } from "../persistence-hub/types/session-store.js";
+import type { ModelOptions } from "../llm-provider-hub/types.js";
+import type { RunOptions } from "../multi-agent-orchestration/agent/agent-loop/types.js";
+import type { AgentProfile } from "../multi-agent-orchestration/agent/types.js";
+import type { AgentSubagents, SubagentScopes, SubagentSpawnScope } from "../multi-agent-orchestration/agent/subagent-manager/types.js";
+import type { GroupThread } from "./thread.js";
+import { type Group, type GroupMemberRunner, type GroupMessage, type GroupSendOptions, type GroupSendRequest, type GroupTurnResult } from "./types.js";
+/** The part of an agent a group turn uses. Agent satisfies it. */
+export interface GroupAgent {
+    readonly profile: AgentProfile;
+    readonly subagents: AgentSubagents;
+    chatStream(message: string, options?: ModelOptions, runOptions?: RunOptions): AsyncIterable<StreamChunk>;
+}
+/** The agents members can be. AgentCore.agents (MultiAgentOrchestration) satisfies it. */
+export interface GroupAgentHost {
+    get(agentId: string): GroupAgent | undefined;
+}
+export interface GroupTurnsDeps {
+    eventBus: EventBus;
+    thread: GroupThread;
+    getSessions: () => SessionStore;
+    getAgents: () => GroupAgentHost | undefined;
+    /** The host's runner (AgentCore.useGroupRunner); absent = the member's own chatStream(). */
+    getRunner: () => GroupMemberRunner | undefined;
+}
+/**
+ * Group turns (A-109, A-112, A-115) — runs one user message through a group:
+ *  - one member answers alone; or several answer side by side as one round and the lead
+ *    sums up; or the lead answers and hands parts to members through spawn_subagent (A-105,
+ *    under a spawn scope: the members see the thread, work in their own member sessions,
+ *    stream into the thread, and need no extra approval), then sums up;
+ *  - guard rails: members per round, a token budget and a deadline for the whole turn, a
+ *    deadline per member; hand-off depth is A-105's (a member cannot delegate further);
+ *  - stop the whole turn or one member; one member failing does not fail the round, and the
+ *    summary says what is missing; retry one member's answer.
+ * One group turn runs per group session at a time.
+ */
+export declare class GroupTurns implements SubagentScopes {
+    private deps;
+    private active;
+    /** Lead session → its spawn scope while it leads a turn. */
+    private scopes;
+    /** `${groupSessionId}\0${agentId}` → the member's session id. */
+    private memberSessions;
+    /** Hand-off answers by child run id, until the run's end settles them. */
+    private handoffWriters;
+    private unsubscribes;
+    constructor(deps: GroupTurnsDeps);
+    /** SubagentScopes: a lead session's spawn scope while it leads a group turn. */
+    get(sessionId: string): SubagentSpawnScope | undefined;
+    isBusy(sessionId: string): boolean;
+    /** The running turns, for "busy" marks: group session → who is doing what. */
+    running(): Array<{
+        groupId: string;
+        sessionId: string;
+        turnId: string;
+        presence: GroupPresencePayload[];
+    }>;
+    /** What each member of a running turn is doing now (empty when idle). */
+    presenceOf(sessionId: string): GroupPresencePayload[];
+    /** Run one user message through the group. Throws GroupError before anything runs. */
+    send(group: Group, session: Session, request: GroupSendRequest, options?: GroupSendOptions): Promise<GroupTurnResult>;
+    /** Run a member's answer again, in place. Throws GroupError before anything runs. */
+    retry(group: Group, session: Session, message: GroupMessage, options?: GroupSendOptions): Promise<GroupTurnResult>;
+    /** Stop the session's running turn, or (with `agentId`) one member of it. False when nothing ran. */
+    stop(sessionId: string, agentId?: string): boolean;
+    /** Resolves once the session's running turn (if any) has ended. */
+    idle(sessionId: string): Promise<void>;
+    /** Stop every running turn and stop listening. */
+    dispose(): void;
+    /** Forget a deleted group session (its member sessions are deleted by the hub). */
+    forgetSession(sessionId: string): void;
+    /** The member's private session in a group session, created on first use. */
+    memberSession(group: Group, groupSessionId: string, agentId: string): Promise<string>;
+    private requireReady;
+    private begin;
+    /** A guard rail ended the turn: stop everyone, note why once. */
+    private limit;
+    private end;
+    private runPlan;
+    /** Several members side by side; then the lead sums up. */
+    private round;
+    /** One member answers in its own session; returns its answer (null when it could not run). */
+    private memberTurn;
+    /**
+     * What a member is told, and its answer opened in the thread ("running"). A round opens
+     * every answer first, in plan order, so the thread's order does not depend on who starts first.
+     */
+    private prepareMember;
+    private runMember;
+    /** The lead answers and may hand parts to `helpers`; their answers stream in as one round. */
+    private leadTurn;
+    /** A member's turn for a hand-off: its answer streams into the thread as part of the round. */
+    private handoffTurn;
+    /** A hand-off's child run ended: its row and its answer take the run's status. */
+    private settleHandoff;
+    /** Runs a member's streamed turn, handing each chunk to `onChunk`. */
+    private stream;
+    private setPresence;
+    private traceAttributes;
+    private names;
+    private nameOf;
+    /** A new session takes its first message as its title. */
+    private titleFrom;
+}
+//# sourceMappingURL=group-turns.d.ts.map

package/dist/components/group-hub/group-turns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-turns.d.ts","sourceRoot":"","sources":["../../../src/components/group-hub/group-turns.ts"],"names":[],"mappings":"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"}