macro-agent 0.0.10 → 0.0.12

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"}