macro-agent 0.0.11 → 0.0.13

package/dist/teams/team-loader.js

@@ -0,0 +1,293 @@
+/**
+ * Team Template Loader
+ *
+ * Reads .macro-agent/teams/<name>/ directories, parses team.yaml,
+ * resolves role inheritance, loads prompts, and validates communication.
+ *
+ * @module teams/team-loader
+ */
+import * as fs from "fs";
+import * as path from "path";
+import yaml from "js-yaml";
+import { TeamLoadError, } from "./types.js";
+// =============================================================================
+// Constants
+// =============================================================================
+const TEAMS_DIR = ".macro-agent/teams";
+const MANIFEST_FILE = "team.yaml";
+const ROLES_DIR = "roles";
+const PROMPTS_DIR = "prompts";
+const TOOLS_DIR = "tools";
+const MCP_SERVERS_FILE = "mcp-servers.json";
+// =============================================================================
+// TeamLoader
+// =============================================================================
+/**
+ * Load a team template from disk and resolve all references.
+ *
+ * @param teamName - Team name (directory name under .macro-agent/teams/)
+ * @param roleRegistry - Role registry for resolving extends chains
+ * @param basePath - Project root (default: process.cwd())
+ * @returns Fully resolved TeamManifest
+ */
+export async function loadTeam(teamName, roleRegistry, basePath) {
+    const root = basePath ?? process.cwd();
+    const teamDir = path.join(root, TEAMS_DIR, teamName);
+    // 1. Check team directory exists
+    if (!fs.existsSync(teamDir)) {
+        throw new TeamLoadError(`Team directory not found: ${teamDir}`, "MANIFEST_NOT_FOUND", teamName);
+    }
+    // 2. Read and parse team.yaml
+    const manifestPath = path.join(teamDir, MANIFEST_FILE);
+    if (!fs.existsSync(manifestPath)) {
+        throw new TeamLoadError(`Team manifest not found: ${manifestPath}`, "MANIFEST_NOT_FOUND", teamName);
+    }
+    const raw = fs.readFileSync(manifestPath, "utf-8");
+    let parsed;
+    try {
+        parsed = yaml.load(raw);
+    }
+    catch (err) {
+        throw new TeamLoadError(`Failed to parse ${manifestPath}: ${err instanceof Error ? err.message : String(err)}`, "INVALID_MANIFEST", teamName);
+    }
+    // 3. Validate required fields
+    validateManifest(parsed, teamName);
+    const topology = parsed.topology;
+    const communication = (parsed.communication ?? {});
+    const macroAgent = (parsed.macro_agent ?? {});
+    const roleNames = parsed.roles;
+    // 4. Resolve roles
+    const resolvedRoles = new Map();
+    const spawnRules = topology.spawn_rules ?? {};
+    for (const roleName of roleNames) {
+        const resolved = resolveTeamRole(roleName, teamDir, roleRegistry, spawnRules);
+        resolvedRoles.set(roleName, resolved);
+    }
+    // 5. Load prompts
+    const loadedPrompts = new Map();
+    // Load prompts from topology nodes
+    const promptRefs = collectPromptRefs(topology, resolvedRoles);
+    for (const promptPath of promptRefs) {
+        const fullPath = path.join(teamDir, promptPath);
+        if (!fs.existsSync(fullPath)) {
+            throw new TeamLoadError(`Prompt file not found: ${fullPath}`, "PROMPT_NOT_FOUND", teamName);
+        }
+        loadedPrompts.set(promptPath, fs.readFileSync(fullPath, "utf-8"));
+    }
+    // 6. Load MCP server configs
+    const mcpServers = loadMcpServers(teamDir);
+    // 7. Validate communication topology
+    validateCommunication(communication, roleNames, teamName);
+    return {
+        name: parsed.name,
+        description: parsed.description ?? "",
+        version: parsed.version ?? 1,
+        roles: roleNames,
+        topology,
+        communication,
+        macro_agent: macroAgent,
+        _resolvedRoles: resolvedRoles,
+        _loadedPrompts: loadedPrompts,
+        _mcpServers: mcpServers,
+    };
+}
+// =============================================================================
+// Manifest Validation
+// =============================================================================
+function validateManifest(parsed, teamName) {
+    if (!parsed || typeof parsed !== "object") {
+        throw new TeamLoadError("Team manifest must be a YAML object", "INVALID_MANIFEST", teamName);
+    }
+    if (!parsed.name || typeof parsed.name !== "string") {
+        throw new TeamLoadError("Team manifest requires a 'name' string field", "INVALID_MANIFEST", teamName);
+    }
+    if (!Array.isArray(parsed.roles) || parsed.roles.length === 0) {
+        throw new TeamLoadError("Team manifest requires a non-empty 'roles' array", "INVALID_MANIFEST", teamName);
+    }
+    if (!parsed.topology || typeof parsed.topology !== "object") {
+        throw new TeamLoadError("Team manifest requires a 'topology' object", "INVALID_MANIFEST", teamName);
+    }
+    const topology = parsed.topology;
+    if (!topology.root || typeof topology.root !== "object") {
+        throw new TeamLoadError("Team topology requires a 'root' object", "INVALID_MANIFEST", teamName);
+    }
+}
+// =============================================================================
+// Role Resolution
+// =============================================================================
+/**
+ * Resolve a single team role: load YAML if present, resolve extends,
+ * compute capabilities, translate spawn rules.
+ */
+function resolveTeamRole(roleName, teamDir, roleRegistry, spawnRules) {
+    // Try to load role YAML from team directory
+    const roleFilePath = path.join(teamDir, ROLES_DIR, `${roleName}.yaml`);
+    let teamRoleDef = null;
+    if (fs.existsSync(roleFilePath)) {
+        const raw = fs.readFileSync(roleFilePath, "utf-8");
+        try {
+            teamRoleDef = yaml.load(raw);
+        }
+        catch (err) {
+            throw new TeamLoadError(`Failed to parse role file ${roleFilePath}: ${err instanceof Error ? err.message : String(err)}`, "INVALID_ROLE", roleName);
+        }
+    }
+    // Determine base role
+    const baseRoleName = teamRoleDef?.extends ?? roleName;
+    let parentRole;
+    try {
+        parentRole = roleRegistry.resolveRole(baseRoleName);
+    }
+    catch {
+        throw new TeamLoadError(`Base role '${baseRoleName}' not found for team role '${roleName}'`, "ROLE_NOT_FOUND", roleName);
+    }
+    // Compute capabilities
+    let capabilities;
+    if (teamRoleDef?.capabilities) {
+        // Full replacement
+        capabilities = teamRoleDef.capabilities;
+    }
+    else if (teamRoleDef?.capabilities_add || teamRoleDef?.capabilities_remove) {
+        // Additive/subtractive
+        const base = new Set(parentRole.capabilities);
+        for (const cap of teamRoleDef.capabilities_add ?? []) {
+            base.add(cap);
+        }
+        for (const cap of teamRoleDef.capabilities_remove ?? []) {
+            base.delete(cap);
+        }
+        capabilities = Array.from(base);
+    }
+    else {
+        // Inherit parent capabilities
+        capabilities = [...parentRole.capabilities];
+    }
+    // Translate spawn_rules into capability additions (RD3)
+    const allowedSpawns = spawnRules[roleName];
+    if (allowedSpawns) {
+        for (const targetRole of allowedSpawns) {
+            const spawnCap = `agent.spawn.${targetRole}`;
+            if (!capabilities.includes(spawnCap)) {
+                capabilities.push(spawnCap);
+            }
+        }
+    }
+    // Build the resolved RoleDefinition for registry
+    const roleDefinition = {
+        name: roleName,
+        displayName: teamRoleDef?.display_name ?? parentRole.displayName,
+        description: teamRoleDef?.description ?? parentRole.description,
+        capabilities,
+        workspace: teamRoleDef?.macro_agent?.workspace
+            ? {
+                type: (teamRoleDef.macro_agent.workspace.type ?? "own"),
+                branchPattern: teamRoleDef.macro_agent.workspace.branch_pattern,
+                cleanupOnTerminate: teamRoleDef.macro_agent.workspace.cleanup_on_terminate,
+            }
+            : parentRole.workspace,
+        lifecycle: teamRoleDef?.macro_agent?.lifecycle
+            ? {
+                type: (teamRoleDef.macro_agent.lifecycle.type ?? "ephemeral"),
+                cascadeTerminate: teamRoleDef.macro_agent.lifecycle.cascade_terminate,
+                selfCleanup: teamRoleDef.macro_agent.lifecycle.self_cleanup,
+                taskBound: teamRoleDef.macro_agent.lifecycle.task_bound,
+                parentBound: teamRoleDef.macro_agent.lifecycle.parent_bound,
+                maxDurationMs: teamRoleDef.macro_agent.lifecycle.max_duration_ms,
+            }
+            : parentRole.lifecycle,
+        tools: parentRole.tools,
+        protocol: parentRole.protocol,
+        permissions: parentRole.permissions,
+        extends: teamRoleDef?.extends,
+        systemPrompt: parentRole.systemPrompt,
+    };
+    return {
+        name: roleName,
+        baseRole: baseRoleName,
+        capabilities,
+        prompt: teamRoleDef?.prompt,
+        roleDefinition,
+    };
+}
+// =============================================================================
+// Prompt Collection
+// =============================================================================
+/**
+ * Collect all prompt file paths referenced by topology and roles.
+ */
+function collectPromptRefs(topology, resolvedRoles) {
+    const refs = new Set();
+    // From topology nodes
+    if (topology.root.prompt)
+        refs.add(topology.root.prompt);
+    for (const companion of topology.companions ?? []) {
+        if (companion.prompt)
+            refs.add(companion.prompt);
+    }
+    // From role definitions
+    for (const resolved of resolvedRoles.values()) {
+        if (resolved.prompt)
+            refs.add(resolved.prompt);
+    }
+    return refs;
+}
+// =============================================================================
+// MCP Server Loading
+// =============================================================================
+/**
+ * Load tools/mcp-servers.json if it exists.
+ * Returns a map of role name → MCP server entries.
+ */
+function loadMcpServers(teamDir) {
+    const result = new Map();
+    const mcpPath = path.join(teamDir, TOOLS_DIR, MCP_SERVERS_FILE);
+    if (!fs.existsSync(mcpPath)) {
+        return result;
+    }
+    const raw = fs.readFileSync(mcpPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    for (const [roleName, config] of Object.entries(parsed)) {
+        if (config.servers && Array.isArray(config.servers)) {
+            result.set(roleName, config.servers);
+        }
+    }
+    return result;
+}
+// =============================================================================
+// Communication Validation
+// =============================================================================
+/**
+ * Validate communication topology references.
+ */
+function validateCommunication(communication, roleNames, teamName) {
+    const channels = communication.channels ?? {};
+    const channelNames = new Set(Object.keys(channels));
+    const roleNameSet = new Set(roleNames);
+    // Validate subscriptions reference existing channels and roles
+    for (const [roleName, subs] of Object.entries(communication.subscriptions ?? {})) {
+        if (!roleNameSet.has(roleName)) {
+            throw new TeamLoadError(`Subscription references unknown role '${roleName}'`, "INVALID_COMMUNICATION", teamName);
+        }
+        for (const sub of subs) {
+            if (!channelNames.has(sub.channel)) {
+                throw new TeamLoadError(`Role '${roleName}' subscribes to unknown channel '${sub.channel}'`, "INVALID_COMMUNICATION", teamName);
+            }
+        }
+    }
+    // Validate emissions reference existing roles
+    for (const roleName of Object.keys(communication.emissions ?? {})) {
+        if (!roleNameSet.has(roleName)) {
+            throw new TeamLoadError(`Emissions references unknown role '${roleName}'`, "INVALID_COMMUNICATION", teamName);
+        }
+    }
+    // Validate peer connections
+    for (const peer of communication.routing?.peers ?? []) {
+        if (!roleNameSet.has(peer.from)) {
+            throw new TeamLoadError(`Peer connection references unknown role '${peer.from}'`, "INVALID_COMMUNICATION", teamName);
+        }
+        if (!roleNameSet.has(peer.to)) {
+            throw new TeamLoadError(`Peer connection references unknown role '${peer.to}'`, "INVALID_COMMUNICATION", teamName);
+        }
+    }
+}
+//# sourceMappingURL=team-loader.js.map

package/dist/teams/team-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-loader.js","sourceRoot":"","sources":["../../src/teams/team-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EACL,aAAa,GAQd,MAAM,YAAY,CAAC;AAEpB,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,SAAS,GAAG,oBAAoB,CAAC;AACvC,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,SAAS,GAAG,OAAO,CAAC;AAC1B,MAAM,WAAW,GAAG,SAAS,CAAC;AAC9B,MAAM,SAAS,GAAG,OAAO,CAAC;AAC1B,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAE5C,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAgB,EAChB,YAA0B,EAC1B,QAAiB;IAEjB,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAErD,iCAAiC;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,aAAa,CACrB,6BAA6B,OAAO,EAAE,EACtC,oBAAoB,EACpB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,aAAa,CACrB,4BAA4B,YAAY,EAAE,EAC1C,oBAAoB,EACpB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAA4B,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CACrB,mBAAmB,YAAY,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACtF,kBAAkB,EAClB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAwB,CAAC;IACjD,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAsB,CAAC;IACxE,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAyB,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAiB,CAAC;IAE3C,mBAAmB;IACnB,MAAM,aAAa,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC1D,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC;IAE9C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,eAAe,CAC9B,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,UAAU,CACX,CAAC;QACF,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,kBAAkB;IAClB,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD,mCAAmC;IACnC,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC9D,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,aAAa,CACrB,0BAA0B,QAAQ,EAAE,EACpC,kBAAkB,EAClB,QAAQ,CACT,CAAC;QACJ,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,6BAA6B;IAC7B,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,qCAAqC;IACrC,qBAAqB,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE1D,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAc;QAC3B,WAAW,EAAG,MAAM,CAAC,WAAsB,IAAI,EAAE;QACjD,OAAO,EAAG,MAAM,CAAC,OAAkB,IAAI,CAAC;QACxC,KAAK,EAAE,SAAS;QAChB,QAAQ;QACR,aAAa;QACb,WAAW,EAAE,UAAU;QACvB,cAAc,EAAE,aAAa;QAC7B,cAAc,EAAE,aAAa;QAC7B,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,SAAS,gBAAgB,CACvB,MAA+B,EAC/B,QAAgB;IAEhB,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,aAAa,CACrB,qCAAqC,EACrC,kBAAkB,EAClB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,aAAa,CACrB,8CAA8C,EAC9C,kBAAkB,EAClB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,aAAa,CACrB,kDAAkD,EAClD,kBAAkB,EAClB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,aAAa,CACrB,4CAA4C,EAC5C,kBAAkB,EAClB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAmC,CAAC;IAC5D,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxD,MAAM,IAAI,aAAa,CACrB,wCAAwC,EACxC,kBAAkB,EAClB,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,eAAe,CACtB,QAAgB,EAChB,OAAe,EACf,YAA0B,EAC1B,UAAoC;IAEpC,4CAA4C;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;IACvE,IAAI,WAAW,GAA8B,IAAI,CAAC;IAElD,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,aAAa,CACrB,6BAA6B,YAAY,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAChG,cAAc,EACd,QAAQ,CACT,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,YAAY,GAAG,WAAW,EAAE,OAAO,IAAI,QAAQ,CAAC;IACtD,IAAI,UAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CACrB,cAAc,YAAY,8BAA8B,QAAQ,GAAG,EACnE,gBAAgB,EAChB,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,uBAAuB;IACvB,IAAI,YAA0B,CAAC;IAC/B,IAAI,WAAW,EAAE,YAAY,EAAE,CAAC;QAC9B,mBAAmB;QACnB,YAAY,GAAG,WAAW,CAAC,YAA4B,CAAC;IAC1D,CAAC;SAAM,IAAI,WAAW,EAAE,gBAAgB,IAAI,WAAW,EAAE,mBAAmB,EAAE,CAAC;QAC7E,uBAAuB;QACvB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,gBAAgB,IAAI,EAAE,EAAE,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,GAAiB,CAAC,CAAC;QAC9B,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,mBAAmB,IAAI,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,GAAiB,CAAC,CAAC;QACjC,CAAC;QACD,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,8BAA8B;QAC9B,YAAY,GAAG,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED,wDAAwD;IACxD,MAAM,aAAa,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,UAAU,IAAI,aAAa,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,eAAe,UAAU,EAAgB,CAAC;YAC3D,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,MAAM,cAAc,GAAmB;QACrC,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,WAAW,EAAE,YAAY,IAAI,UAAU,CAAC,WAAW;QAChE,WAAW,EAAE,WAAW,EAAE,WAAW,IAAI,UAAU,CAAC,WAAW;QAC/D,YAAY;QACZ,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS;YAC5C,CAAC,CAAC;gBACE,IAAI,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,IAAI,KAAK,CAAwC;gBAC9F,aAAa,EAAE,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,cAAc;gBAC/D,kBAAkB,EAAE,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,oBAAoB;aAC3E;YACH,CAAC,CAAC,UAAU,CAAC,SAAS;QACxB,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS;YAC5C,CAAC,CAAC;gBACE,IAAI,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,IAAI,WAAW,CAA2D;gBACvH,gBAAgB,EAAE,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,iBAAiB;gBACrE,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,YAAY;gBAC3D,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU;gBACvD,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,YAAY;gBAC3D,aAAa,EAAE,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,eAAe;aACjE;YACH,CAAC,CAAC,UAAU,CAAC,SAAS;QACxB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,OAAO,EAAE,WAAW,EAAE,OAAO;QAC7B,YAAY,EAAE,UAAU,CAAC,YAAY;KACtC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,YAAY;QACtB,YAAY;QACZ,MAAM,EAAE,WAAW,EAAE,MAAM;QAC3B,cAAc;KACf,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,SAAS,iBAAiB,CACxB,QAAsB,EACtB,aAA4C;IAE5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,sBAAsB;IACtB,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QAClD,IAAI,SAAS,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,wBAAwB;IACxB,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9C,IAAI,QAAQ,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,cAAc,CACrB,OAAe;IAEf,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAEhE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAG5B,CAAC;IAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,IAAI,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;GAEG;AACH,SAAS,qBAAqB,CAC5B,aAAgC,EAChC,SAAmB,EACnB,QAAgB;IAEhB,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC9C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAEvC,+DAA+D;IAC/D,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,aAAa,CACrB,yCAAyC,QAAQ,GAAG,EACpD,uBAAuB,EACvB,QAAQ,CACT,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,aAAa,CACrB,SAAS,QAAQ,oCAAoC,GAAG,CAAC,OAAO,GAAG,EACnE,uBAAuB,EACvB,QAAQ,CACT,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,aAAa,CACrB,sCAAsC,QAAQ,GAAG,EACjD,uBAAuB,EACvB,QAAQ,CACT,CAAC;QACJ,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;QACtD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,aAAa,CACrB,4CAA4C,IAAI,CAAC,IAAI,GAAG,EACxD,uBAAuB,EACvB,QAAQ,CACT,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,aAAa,CACrB,4CAA4C,IAAI,CAAC,EAAE,GAAG,EACtD,uBAAuB,EACvB,QAAQ,CACT,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,139 @@
+/**
+ * Team Runtime
+ *
+ * Wires a loaded TeamManifest into the running system: registers roles,
+ * sets up integration strategy, configures communication topology,
+ * and manages the team lifecycle.
+ *
+ * @module teams/team-runtime
+ */
+import type { EventStore } from "../store/event-store.js";
+import type { MessageRouter } from "../router/message-router.js";
+import type { AgentManager } from "../agent/agent-manager.js";
+import type { TeamManifest } from "./types.js";
+import type { IntegrationStrategy } from "../workspace/strategies/types.js";
+export interface TeamServices {
+    agentManager: AgentManager;
+    messageRouter: MessageRouter;
+    eventStore: EventStore;
+}
+export interface TeamBootstrapResult {
+    rootId: string;
+    companionIds: string[];
+}
+export declare class TeamRuntime {
+    private readonly manifest;
+    private readonly services;
+    private rootAgentId?;
+    private companionAgentIds;
+    private roleRegistry;
+    private lifecycleUnsubscribe?;
+    private integrationStrategy?;
+    /** Role name → spawned agent ID mapping (populated during bootstrap) */
+    private roleAgentMap;
+    /** Peer connections that couldn't be wired at bootstrap (target role not yet spawned) */
+    private pendingPeerRoutes;
+    /** Per-agent signal filters from peer connections. Key: "fromAgentId→toAgentId" */
+    private peerSignalFilters;
+    /** Reverse mapping: agent ID → role name (for signal filter lookups) */
+    private agentRoleMap;
+    /** Lifecycle unsubscribe for deferred peer wiring */
+    private peerWiringUnsubscribe?;
+    constructor(manifest: TeamManifest, services: TeamServices);
+    /**
+     * Wire team configuration into running services.
+     *
+     * 1. Register team roles into RoleRegistry
+     * 2. Store team_config event in EventStore (for MCP subprocess discovery)
+     * 3. Register spawn interceptor on AgentManager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Spawn root and companion agents per the team topology.
+     */
+    bootstrap(): Promise<TeamBootstrapResult>;
+    /**
+     * Tear down team: remove spawn interceptor, stop continuation monitoring.
+     */
+    teardown(): Promise<void>;
+    /** Get task assignment mode */
+    getTaskMode(): "push" | "pull";
+    /** Get integration strategy name */
+    getStrategyName(): string;
+    /** Get the active manifest (for API) */
+    getManifest(): TeamManifest;
+    /** Get root agent ID (after bootstrap) */
+    getRootAgentId(): string | undefined;
+    /** Get companion agent IDs (after bootstrap) */
+    getCompanionAgentIds(): string[];
+    /** Get the instantiated integration strategy (after initialize) */
+    getIntegrationStrategy(): IntegrationStrategy | undefined;
+    /** Get signal filters for peer connections (for use by signal filtering - i-3o8g) */
+    getPeerSignalFilters(): ReadonlyMap<string, string[]>;
+    /**
+     * Monitor agent lifecycle events for auto-continuation of daemon agents.
+     *
+     * When a root or companion agent terminates unexpectedly and the team's
+     * lifecycle config enables continuations, automatically spawn a continuation.
+     */
+    private monitorContinuations;
+    /**
+     * Create the spawn interceptor that injects team context into spawn options.
+     */
+    private createSpawnInterceptor;
+    /**
+     * Get topic names a role should subscribe to based on communication config.
+     */
+    private getTopicsForRole;
+    /**
+     * Get MCP servers configured for a role.
+     */
+    private getMcpServersForRole;
+    /**
+     * Get the loaded prompt content for a role.
+     */
+    private getPromptForRole;
+    /**
+     * Get the prompt for a topology node (root or companion).
+     */
+    private getPromptForTopologyNode;
+    /**
+     * Generate interaction pattern injection sections based on team config.
+     */
+    private getInteractionPatterns;
+    /**
+     * Install a signal filter on the message router.
+     *
+     * Combines two filter sources:
+     * 1. Channel subscription filters (per-role, per-topic): from communication.subscriptions
+     * 2. Peer connection filters (per-agent-pair): from communication.routing.peers
+     *
+     * Status events with no details.signal always pass through (backwards compat).
+     */
+    private installSignalFilter;
+    /**
+     * Install emission validator on the message router.
+     * Checks whether an agent's emitted signal is in its role's allowed emissions list.
+     * Behavior depends on enforcement mode: strict (reject), permissive (warn), audit (record).
+     */
+    private installEmissionValidator;
+    /**
+     * Wire peer subscriptions from communication config.
+     * Falls back to legacy bidirectional subtree subs when no peers config exists.
+     */
+    private wirePeerRoutes;
+    /**
+     * Wire a single peer connection based on its `via` type.
+     */
+    private wireSinglePeerRoute;
+    /**
+     * Legacy bidirectional subtree subscriptions between root and companions.
+     * Used when no `routing.peers` config is defined (backwards compat).
+     */
+    private setupLegacyPeerSubscriptions;
+    /**
+     * Listen for agent spawns and wire pending peer routes when roles become available.
+     */
+    private setupDeferredPeerWiring;
+}
+//# sourceMappingURL=team-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-runtime.d.ts","sourceRoot":"","sources":["../../src/teams/team-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,2BAA2B,CAAC;AAIhF,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAM5E,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,qBAAa,WAAW;IAuBpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAvB3B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,oBAAoB,CAAC,CAAa;IAC1C,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAElD,wEAAwE;IACxE,OAAO,CAAC,YAAY,CAA8B;IAElD,yFAAyF;IACzF,OAAO,CAAC,iBAAiB,CAAwB;IAEjD,mFAAmF;IACnF,OAAO,CAAC,iBAAiB,CAA+B;IAExD,wEAAwE;IACxE,OAAO,CAAC,YAAY,CAA8B;IAElD,qDAAqD;IACrD,OAAO,CAAC,qBAAqB,CAAC,CAAa;gBAGxB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY;IASzC;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmEjC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAkE/C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB/B,+BAA+B;IAC/B,WAAW,IAAI,MAAM,GAAG,MAAM;IAI9B,oCAAoC;IACpC,eAAe,IAAI,MAAM;IAIzB,wCAAwC;IACxC,WAAW,IAAI,YAAY;IAI3B,0CAA0C;IAC1C,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,gDAAgD;IAChD,oBAAoB,IAAI,MAAM,EAAE;IAIhC,mEAAmE;IACnE,sBAAsB,IAAI,mBAAmB,GAAG,SAAS;IAIzD,qFAAqF;IACrF,oBAAoB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAQrD;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA6C5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+D9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0C9B;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAuD3B;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IA2ChC;;;OAGG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAUpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAiChC"}