anantham-v2 2.0.0-alpha.1

package/dist/teams/agent-handoff-manager.js

@@ -0,0 +1,273 @@
+import { randomUUID } from "node:crypto";
+import { AgentHandoffSchema } from "../domain/team.js";
+import { TaskLeaseSchema } from "../domain/lease.js";
+import { EventTypes } from "../domain/event.js";
+import { TeamTopologyEvaluator } from "./team-topology-evaluator.js";
+/**
+ * Agent Handoff Manager orchestrating atomic task responsibility transfer,
+ * lease re-assignment with generation fencing bump, and receiver revalidation.
+ * PRD Part 2 Section 49, Section 50.
+ */
+export class AgentHandoffManager {
+    engine;
+    taskRepo;
+    leaseRepo;
+    teamRepo;
+    handoffRepo;
+    claimManager;
+    topologyEvaluator;
+    eventStore;
+    constructor(options) {
+        this.engine = options.engine;
+        this.taskRepo = options.taskRepo;
+        this.leaseRepo = options.leaseRepo;
+        this.teamRepo = options.teamRepo;
+        this.handoffRepo = options.handoffRepo;
+        this.claimManager = options.claimManager;
+        this.topologyEvaluator = options.topologyEvaluator ?? new TeamTopologyEvaluator();
+        this.eventStore = options.eventStore;
+    }
+    /**
+     * Prepare an authoritative task handoff to another agent.
+     */
+    prepareHandoff(params) {
+        // 1. Verify source agent ownership and fencing token
+        const isOwner = this.claimManager.verifyOwnership(params.taskId, params.leaseId, params.generation, params.sourceAgentId);
+        if (!isOwner) {
+            return {
+                success: false,
+                errorCode: "OWNERSHIP_VERIFICATION_FAILED",
+                errorMessage: `Source agent "${params.sourceAgentId}" does not possess active ownership for task "${params.taskId}" with generation "${params.generation}"`,
+            };
+        }
+        // 2. Fetch Team and verify memberships
+        const team = this.teamRepo.findById(params.teamId);
+        if (!team) {
+            return {
+                success: false,
+                errorCode: "TEAM_NOT_FOUND",
+                errorMessage: `Team "${params.teamId}" not found`,
+            };
+        }
+        const sourceMember = this.teamRepo.getMemberByInstance(params.teamId, params.sourceInstanceId);
+        if (!sourceMember || sourceMember.status !== "ACTIVE") {
+            return {
+                success: false,
+                errorCode: "SOURCE_NOT_ACTIVE_MEMBER",
+                errorMessage: `Source instance "${params.sourceInstanceId}" is not an active member of team "${params.teamId}"`,
+            };
+        }
+        const members = this.teamRepo.getMembers(params.teamId);
+        const targetMember = members.find((m) => m.agentId === params.targetAgentId && m.status === "ACTIVE");
+        if (!targetMember) {
+            return {
+                success: false,
+                errorCode: "TARGET_NOT_ACTIVE_MEMBER",
+                errorMessage: `Target agent "${params.targetAgentId}" is not an active member of team "${params.teamId}"`,
+            };
+        }
+        // 3. Check topology handoff legality
+        const isPermitted = this.topologyEvaluator.isHandoffPermitted(team, sourceMember.role, targetMember.role);
+        if (!isPermitted) {
+            return {
+                success: false,
+                errorCode: "TOPOLOGY_HANDOFF_BLOCKED",
+                errorMessage: `Handoff from role "${sourceMember.role}" to role "${targetMember.role}" is blocked under "${team.topology}" topology rules`,
+            };
+        }
+        // 4. Create handoff record
+        const handoffId = `handoff_${randomUUID()}`;
+        const nowIso = new Date().toISOString();
+        const handoff = {
+            id: handoffId,
+            teamId: params.teamId,
+            projectId: params.projectId,
+            sourceAgentId: params.sourceAgentId,
+            sourceInstanceId: params.sourceInstanceId,
+            targetAgentId: params.targetAgentId,
+            targetInstanceId: params.targetInstanceId,
+            taskId: params.taskId,
+            leaseId: params.leaseId,
+            generation: params.generation,
+            objective: params.objective,
+            acceptanceCriteria: params.acceptanceCriteria,
+            completedWork: params.completedWork,
+            unresolvedIssues: params.unresolvedIssues,
+            artifactRefs: params.artifactRefs,
+            verificationEvidence: params.verificationEvidence,
+            status: "PREPARED",
+            createdAt: nowIso,
+            updatedAt: nowIso,
+        };
+        AgentHandoffSchema.parse(handoff);
+        this.handoffRepo.save(handoff);
+        // 5. Emit durable event
+        this.emitEvent(EventTypes.HANDOFF_PREPARED, {
+            handoffId: handoff.id,
+            teamId: handoff.teamId,
+            projectId: handoff.projectId,
+            taskId: handoff.taskId,
+            sourceAgentId: handoff.sourceAgentId,
+            targetAgentId: handoff.targetAgentId,
+            generation: handoff.generation,
+            artifactRefs: handoff.artifactRefs,
+        });
+        return {
+            success: true,
+            handoff,
+        };
+    }
+    /**
+     * Accept an authoritative task handoff, atomically transferring task lease
+     * and incrementing the generation fencing token.
+     * PRD Part 2 Section 49.
+     */
+    acceptHandoff(handoffId, targetInstanceId) {
+        const now = Date.now();
+        const nowIso = new Date(now).toISOString();
+        let result;
+        try {
+            result = this.engine.transaction(() => {
+                // 1. Fetch handoff
+                const handoff = this.handoffRepo.findById(handoffId);
+                if (!handoff) {
+                    return {
+                        success: false,
+                        errorCode: "HANDOFF_NOT_FOUND",
+                        errorMessage: `Handoff "${handoffId}" not found`,
+                    };
+                }
+                if (handoff.status !== "PREPARED") {
+                    return {
+                        success: false,
+                        errorCode: "HANDOFF_NOT_PREPARED",
+                        errorMessage: `Handoff "${handoffId}" is in state "${handoff.status}" and cannot be accepted`,
+                    };
+                }
+                // 2. Validate target member
+                const targetMember = this.teamRepo.getMemberByInstance(handoff.teamId, targetInstanceId);
+                if (!targetMember || targetMember.agentId !== handoff.targetAgentId || targetMember.status !== "ACTIVE") {
+                    return {
+                        success: false,
+                        errorCode: "TARGET_NOT_ACTIVE_MEMBER",
+                        errorMessage: `Target instance "${targetInstanceId}" does not match target agent "${handoff.targetAgentId}" or is not active in team "${handoff.teamId}"`,
+                    };
+                }
+                // 3. Release previous source lease
+                const prevLease = this.leaseRepo.findById(handoff.leaseId);
+                if (prevLease && prevLease.status === "ACTIVE") {
+                    this.leaseRepo.updateStatus(prevLease.id, "RELEASED");
+                }
+                // 4. Create new lease for target with incremented generation fencing token
+                const newGeneration = handoff.generation + 1;
+                const newLeaseId = `lease_${randomUUID()}`;
+                const ttlMs = prevLease ? prevLease.ttlMs : 30000;
+                const newLease = {
+                    id: newLeaseId,
+                    taskId: handoff.taskId,
+                    agentId: handoff.targetAgentId,
+                    instanceId: targetInstanceId,
+                    projectId: handoff.projectId,
+                    sessionId: prevLease ? prevLease.sessionId : "session_handoff",
+                    generation: newGeneration,
+                    acquiredAt: nowIso,
+                    expiresAt: new Date(now + ttlMs).toISOString(),
+                    lastHeartbeatAt: nowIso,
+                    ttlMs,
+                    status: "ACTIVE",
+                    renewalCount: 0,
+                    maxRenewals: prevLease ? prevLease.maxRenewals : 100,
+                    metadata: {
+                        transferredFrom: handoff.sourceAgentId,
+                        handoffId: handoff.id,
+                    },
+                };
+                TaskLeaseSchema.parse(newLease);
+                this.leaseRepo.save(newLease);
+                // 5. Update task state
+                this.taskRepo.updateStatus(handoff.taskId, "claimed");
+                // 6. Update handoff state -> ACCEPTED
+                handoff.status = "ACCEPTED";
+                handoff.targetInstanceId = targetInstanceId;
+                handoff.updatedAt = nowIso;
+                this.handoffRepo.save(handoff);
+                return {
+                    success: true,
+                    handoff,
+                    newLease,
+                };
+            });
+        }
+        catch (err) {
+            return {
+                success: false,
+                errorCode: "TRANSACTION_ERROR",
+                errorMessage: err.message,
+            };
+        }
+        if (result.success && result.handoff && result.newLease) {
+            this.emitEvent(EventTypes.HANDOFF_ACCEPTED, {
+                handoffId: result.handoff.id,
+                taskId: result.handoff.taskId,
+                sourceAgentId: result.handoff.sourceAgentId,
+                targetAgentId: result.handoff.targetAgentId,
+                targetInstanceId: result.handoff.targetInstanceId,
+                newLeaseId: result.newLease.id,
+                generation: result.newLease.generation,
+                projectId: result.handoff.projectId,
+            });
+            this.emitEvent(EventTypes.TASK_LEASE_ACQUIRED, {
+                leaseId: result.newLease.id,
+                taskId: result.newLease.taskId,
+                agentId: result.newLease.agentId,
+                instanceId: result.newLease.instanceId,
+                generation: result.newLease.generation,
+                projectId: result.newLease.projectId,
+                ttlMs: result.newLease.ttlMs,
+            });
+        }
+        return result;
+    }
+    /**
+     * Reject a prepared handoff.
+     */
+    rejectHandoff(handoffId, reason) {
+        const handoff = this.handoffRepo.findById(handoffId);
+        if (!handoff || handoff.status !== "PREPARED")
+            return false;
+        handoff.status = "REJECTED";
+        handoff.unresolvedIssues.push(`Rejected: ${reason}`);
+        handoff.updatedAt = new Date().toISOString();
+        this.handoffRepo.save(handoff);
+        this.emitEvent(EventTypes.HANDOFF_REJECTED, {
+            handoffId: handoff.id,
+            taskId: handoff.taskId,
+            sourceAgentId: handoff.sourceAgentId,
+            targetAgentId: handoff.targetAgentId,
+            reason,
+            projectId: handoff.projectId,
+        });
+        return true;
+    }
+    emitEvent(type, payload) {
+        if (!this.eventStore)
+            return;
+        try {
+            this.eventStore.append({
+                id: `evt_${randomUUID()}`,
+                schemaVersion: 1,
+                type,
+                actor: "agent",
+                projectId: payload.projectId || "system",
+                taskId: payload.taskId ? payload.taskId : undefined,
+                agentId: payload.targetAgentId ? payload.targetAgentId : payload.sourceAgentId,
+                payload,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch {
+            // EventStore logging failure must not crash execution
+        }
+    }
+}
+//# sourceMappingURL=agent-handoff-manager.js.map

package/dist/teams/agent-handoff-manager.js.map

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

package/dist/teams/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./team-topology-evaluator.js";
+export * from "./peer-messenger.js";
+export * from "./agent-handoff-manager.js";
+export * from "./team-manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/teams/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/teams/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC"}

package/dist/teams/index.js

@@ -0,0 +1,5 @@
+export * from "./team-topology-evaluator.js";
+export * from "./peer-messenger.js";
+export * from "./agent-handoff-manager.js";
+export * from "./team-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/teams/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/teams/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC"}

package/dist/teams/peer-messenger.d.ts

@@ -0,0 +1,37 @@
+import { PeerMessage } from "../domain/team.js";
+import { EventStore } from "../event-state/event-store.js";
+import { PeerMessageRepository } from "../persistence/repositories/peer-message-repository.js";
+import { TeamRepository } from "../persistence/repositories/team-repository.js";
+import { TeamTopologyEvaluator } from "./team-topology-evaluator.js";
+export interface PeerMessengerOptions {
+    teamRepo: TeamRepository;
+    messageRepo: PeerMessageRepository;
+    topologyEvaluator?: TeamTopologyEvaluator;
+    eventStore?: EventStore;
+}
+export interface SendMessageResult {
+    success: boolean;
+    messageId?: string;
+    errorCode?: string;
+    errorMessage?: string;
+}
+/**
+ * Peer Messenger coordinating structured, policy-authorized agent-to-agent
+ * communication and artifact passing.
+ * PRD Part 2 Section 46, Section 47.
+ */
+export declare class PeerMessenger {
+    private readonly teamRepo;
+    private readonly messageRepo;
+    private readonly topologyEvaluator;
+    private readonly eventStore?;
+    constructor(options: PeerMessengerOptions);
+    /**
+     * Send a policy-authorized peer message.
+     */
+    sendMessage(message: PeerMessage): SendMessageResult;
+    listMessages(teamId: string, limit?: number): PeerMessage[];
+    listMessagesForAgent(teamId: string, agentId: string): PeerMessage[];
+    private emitEvent;
+}
+//# sourceMappingURL=peer-messenger.d.ts.map

package/dist/teams/peer-messenger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-messenger.d.ts","sourceRoot":"","sources":["../../src/teams/peer-messenger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAA+B,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,qBAAqB,CAAC;IACnC,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwB;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;gBAE7B,OAAO,EAAE,oBAAoB;IAOzC;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,iBAAiB;IAyGpD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,WAAW,EAAE;IAIhE,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAI3E,OAAO,CAAC,SAAS;CAkBlB"}

package/dist/teams/peer-messenger.js

@@ -0,0 +1,142 @@
+import { randomUUID } from "node:crypto";
+import { PeerMessageSchema } from "../domain/team.js";
+import { EventTypes } from "../domain/event.js";
+import { TeamTopologyEvaluator } from "./team-topology-evaluator.js";
+/**
+ * Peer Messenger coordinating structured, policy-authorized agent-to-agent
+ * communication and artifact passing.
+ * PRD Part 2 Section 46, Section 47.
+ */
+export class PeerMessenger {
+    teamRepo;
+    messageRepo;
+    topologyEvaluator;
+    eventStore;
+    constructor(options) {
+        this.teamRepo = options.teamRepo;
+        this.messageRepo = options.messageRepo;
+        this.topologyEvaluator = options.topologyEvaluator ?? new TeamTopologyEvaluator();
+        this.eventStore = options.eventStore;
+    }
+    /**
+     * Send a policy-authorized peer message.
+     */
+    sendMessage(message) {
+        // 1. Validate payload schema
+        try {
+            PeerMessageSchema.parse(message);
+        }
+        catch (err) {
+            return {
+                success: false,
+                errorCode: "INVALID_MESSAGE_SCHEMA",
+                errorMessage: err.message,
+            };
+        }
+        // 2. Fetch Team
+        const team = this.teamRepo.findById(message.teamId);
+        if (!team) {
+            return {
+                success: false,
+                errorCode: "TEAM_NOT_FOUND",
+                errorMessage: `Team "${message.teamId}" not found`,
+            };
+        }
+        // 3. Project Boundary Check
+        if (team.projectId !== message.projectId) {
+            return {
+                success: false,
+                errorCode: "PROJECT_ISOLATION_VIOLATION",
+                errorMessage: `Team "${message.teamId}" belongs to project "${team.projectId}", not "${message.projectId}"`,
+            };
+        }
+        // 4. Sender Membership Check
+        const senderMember = this.teamRepo.getMemberByInstance(message.teamId, message.senderInstanceId);
+        if (!senderMember || senderMember.status !== "ACTIVE") {
+            return {
+                success: false,
+                errorCode: "SENDER_NOT_ACTIVE_MEMBER",
+                errorMessage: `Sender instance "${message.senderInstanceId}" is not an active member of team "${message.teamId}"`,
+            };
+        }
+        // 5. Recipient Membership Check (if not broadcast)
+        let recipientRole = "broadcast";
+        if (message.recipientAgentId !== "broadcast") {
+            const members = this.teamRepo.getMembers(message.teamId);
+            const recipientMember = members.find((m) => m.agentId === message.recipientAgentId && m.status === "ACTIVE");
+            if (!recipientMember) {
+                return {
+                    success: false,
+                    errorCode: "RECIPIENT_NOT_ACTIVE_MEMBER",
+                    errorMessage: `Recipient agent "${message.recipientAgentId}" is not an active member of team "${message.teamId}"`,
+                };
+            }
+            recipientRole = recipientMember.role;
+        }
+        // 6. Topology Authorization Check
+        const isPermitted = this.topologyEvaluator.isCommunicationPermitted(team, senderMember.role, recipientRole, message.messageType);
+        if (!isPermitted) {
+            return {
+                success: false,
+                errorCode: "TOPOLOGY_COMMUNICATION_BLOCKED",
+                errorMessage: `Communication of type "${message.messageType}" from role "${senderMember.role}" to "${recipientRole}" is blocked by "${team.topology}" topology rules`,
+            };
+        }
+        // 7. Message Size Limit Check
+        const maxBytes = team.communicationPolicy.maxMessageSizeBytes ?? 65536;
+        const payloadStr = JSON.stringify(message.payload);
+        if (Buffer.byteLength(payloadStr, "utf8") > maxBytes) {
+            return {
+                success: false,
+                errorCode: "MESSAGE_SIZE_EXCEEDED",
+                errorMessage: `Message payload size (${Buffer.byteLength(payloadStr, "utf8")} bytes) exceeds limit of ${maxBytes} bytes. Use Artifact references for large data.`,
+            };
+        }
+        // 8. Persist message
+        this.messageRepo.save(message);
+        // 9. Emit durable event
+        this.emitEvent(EventTypes.PEER_MESSAGE_SENT, {
+            messageId: message.id,
+            teamId: message.teamId,
+            projectId: message.projectId,
+            senderAgentId: message.senderAgentId,
+            senderInstanceId: message.senderInstanceId,
+            recipientAgentId: message.recipientAgentId,
+            messageType: message.messageType,
+            taskRef: message.taskRef,
+            artifactRefs: message.artifactRefs,
+            timestamp: message.timestamp,
+        });
+        return {
+            success: true,
+            messageId: message.id,
+        };
+    }
+    listMessages(teamId, limit = 100) {
+        return this.messageRepo.listByTeam(teamId, limit);
+    }
+    listMessagesForAgent(teamId, agentId) {
+        return this.messageRepo.listForAgent(teamId, agentId);
+    }
+    emitEvent(type, payload) {
+        if (!this.eventStore)
+            return;
+        try {
+            this.eventStore.append({
+                id: `evt_${randomUUID()}`,
+                schemaVersion: 1,
+                type,
+                actor: "agent",
+                projectId: payload.projectId || "system",
+                taskId: payload.taskRef ? payload.taskRef : undefined,
+                agentId: payload.senderAgentId ? payload.senderAgentId : undefined,
+                payload,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch {
+            // EventStore logging failure must not crash execution
+        }
+    }
+}
+//# sourceMappingURL=peer-messenger.js.map

package/dist/teams/peer-messenger.js.map

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

package/dist/teams/team-manager.d.ts

@@ -0,0 +1,60 @@
+import { TeamDefinition, TeamFailurePolicy, TeamMember, TeamMemberStatus } from "../domain/team.js";
+import { EventStore } from "../event-state/event-store.js";
+import { TeamRepository } from "../persistence/repositories/team-repository.js";
+import { AgentManager } from "../agents/agent-manager.js";
+import { TaskClaimManager } from "../tasks/task-claim-manager.js";
+export interface TeamManagerOptions {
+    teamRepo: TeamRepository;
+    agentManager?: AgentManager;
+    claimManager?: TaskClaimManager;
+    eventStore?: EventStore;
+}
+export interface AddMemberResult {
+    success: boolean;
+    member?: TeamMember;
+    errorCode?: string;
+    errorMessage?: string;
+}
+/**
+ * Team Manager coordinating team lifecycle, membership, failure propagation,
+ * cancellation cascading, and crash recovery.
+ * PRD Part 2 Section 42, Section 44.
+ */
+export declare class TeamManager {
+    private readonly teamRepo;
+    private readonly agentManager?;
+    private readonly claimManager?;
+    private readonly eventStore?;
+    constructor(options: TeamManagerOptions);
+    getClaimManager(): TaskClaimManager | undefined;
+    /**
+     * Create and activate a versioned team.
+     */
+    createTeam(definition: Omit<TeamDefinition, "status" | "createdAt" | "updatedAt">): TeamDefinition;
+    /**
+     * Add a verified member to an active team.
+     */
+    addMember(teamId: string, params: Omit<TeamMember, "joinedAt" | "status">): AddMemberResult;
+    updateMemberStatus(teamId: string, instanceId: string, status: TeamMemberStatus): void;
+    /**
+     * Handle team member failure according to failure policy.
+     * PRD Part 2 Section 50.
+     */
+    handleMemberFailure(teamId: string, instanceId: string, error: string, policy?: TeamFailurePolicy): {
+        action: TeamFailurePolicy;
+        status: string;
+    };
+    /**
+     * Cancel team and propagate shutdown to all member instances.
+     */
+    cancelTeam(teamId: string, reason?: string): boolean;
+    /**
+     * Reconstruct and recover team state on system restart.
+     */
+    recoverTeamState(teamId: string): {
+        team: TeamDefinition | null;
+        members: TeamMember[];
+    };
+    private emitEvent;
+}
+//# sourceMappingURL=team-manager.d.ts.map

package/dist/teams/team-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-manager.d.ts","sourceRoot":"","sources":["../../src/teams/team-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EAEd,iBAAiB,EACjB,UAAU,EAEV,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;gBAE7B,OAAO,EAAE,kBAAkB;IAOhC,eAAe,IAAI,gBAAgB,GAAG,SAAS;IAItD;;OAEG;IACI,UAAU,CACf,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC,GACrE,cAAc;IA6BjB;;OAEG;IACI,SAAS,CACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC,GAC9C,eAAe;IAiEX,kBAAkB,CACvB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,GACvB,IAAI;IAIP;;;OAGG;IACI,mBAAmB,CACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,iBAA2B,GAClC;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAehD;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAyB3D;;OAEG;IACI,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;QACvC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;QAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;KACvB;IAMD,OAAO,CAAC,SAAS;CAgBlB"}