macro-agent 0.1.0 → 0.1.2

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

@@ -1,7 +1,7 @@
 /**
  * Team Runtime
  *
- * Wires a loaded TeamManifest into the running system: registers roles,
+ * Wires a loaded team template into the running system: registers roles,
  * sets up integration strategy, configures communication topology,
  * and manages the team lifecycle.
  *
@@ -9,26 +9,41 @@
  */
 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 { AgentManager, SpawnInterceptor } from "../agent/agent-manager.js";
+import type { SignalFilter, EmissionValidator } from "../router/message-router.js";
+import type { AgentId } from "../store/types/index.js";
+import type { TeamManifest, MacroResolvedTemplate } from "./types.js";
 import type { IntegrationStrategy } from "../workspace/strategies/types.js";
 export interface TeamServices {
     agentManager: AgentManager;
     messageRouter: MessageRouter;
     eventStore: EventStore;
+    /** Optional workspace manager for merge queue wiring */
+    workspaceManager?: import("../workspace/types.js").WorkspaceManager;
+    /** Optional task backend for auto-scaling queue depth checks */
+    taskBackend?: import("../task/backend/types.js").TaskBackend;
 }
 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?;
+    private scalingTimer?;
+    private lastScaleUpTime;
+    private teamStreamId?;
+    private mergeQueueUnsub?;
+    private mergeRequestPollTimer?;
+    private lastMergeRequestSeen;
+    /** The resolved template (canonical internal representation) */
+    private readonly resolved;
+    /** Legacy loaded prompts map (path → content) for backward compat */
+    private readonly loadedPrompts;
     /** 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) */
@@ -37,23 +52,47 @@ export declare class TeamRuntime {
     private peerSignalFilters;
     /** Reverse mapping: agent ID → role name (for signal filter lookups) */
     private agentRoleMap;
+    /** Pre-computed per-role allowed signals from channel subscriptions */
+    private roleAllowedSignals;
     /** Lifecycle unsubscribe for deferred peer wiring */
     private peerWiringUnsubscribe?;
-    constructor(manifest: TeamManifest, services: TeamServices);
+    /**
+     * Create a TeamRuntime.
+     *
+     * Accepts either a MacroResolvedTemplate (new) or a TeamManifest (legacy).
+     * Internally always uses MacroResolvedTemplate.
+     */
+    constructor(input: TeamManifest | MacroResolvedTemplate, services: TeamServices);
+    private get manifest();
+    private get communication();
     /**
      * 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
+     * 3. Instantiate integration strategy
+     *
+     * Note: Does NOT install spawn interceptor, signal filter, or emission
+     * validator on services. Call installOnServices() for standalone use,
+     * or let TeamManager handle composite installation.
      */
-    initialize(): Promise<void>;
+    initialize(options?: {
+        teamInstanceId?: string;
+    }): Promise<void>;
     /**
      * Spawn root and companion agents per the team topology.
+     *
+     * Populates internal state (agentRoleMap, peerSignalFilters) used by
+     * createSignalFilter() and createEmissionValidator(). Call installOnServices()
+     * after bootstrap for standalone use, or let TeamManager handle installation.
      */
     bootstrap(): Promise<TeamBootstrapResult>;
     /**
-     * Tear down team: remove spawn interceptor, stop continuation monitoring.
+     * Tear down team: stop continuation monitoring, clean up strategy.
+     *
+     * Note: Does NOT clear spawn interceptor or filters on services.
+     * The caller (TeamManager or standalone code) is responsible for
+     * removing the interceptor/filters from shared services.
      */
     teardown(): Promise<void>;
     /** Get task assignment mode */
@@ -62,14 +101,24 @@ export declare class TeamRuntime {
     getStrategyName(): string;
     /** Get the active manifest (for API) */
     getManifest(): TeamManifest;
+    /** Get the resolved template */
+    getResolvedTemplate(): MacroResolvedTemplate;
     /** 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 team-wide integration stream ID (after bootstrap) */
+    getTeamStreamId(): string | undefined;
     /** Get signal filters for peer connections (for use by signal filtering - i-3o8g) */
     getPeerSignalFilters(): ReadonlyMap<string, string[]>;
+    /** Get the agent → role mapping (for TeamManager agent-team lookups) */
+    getAgentRoleMap(): ReadonlyMap<AgentId, string>;
+    /** Register an agent's role mapping (for TeamManager to track dynamically spawned agents) */
+    registerAgent(agentId: AgentId, roleName: string): void;
+    /** Check if this team owns a given agent */
+    hasAgent(agentId: string): boolean;
     /**
      * Monitor agent lifecycle events for auto-continuation of daemon agents.
      *
@@ -77,10 +126,37 @@ export declare class TeamRuntime {
      * lifecycle config enables continuations, automatically spawn a continuation.
      */
     private monitorContinuations;
+    /** Minimum interval between scale-up actions (ms) */
+    private static readonly SCALE_COOLDOWN_MS;
+    /** Default scaling check interval (ms) */
+    private static readonly SCALE_CHECK_INTERVAL_MS;
+    /**
+     * Monitor task queue depth and auto-scale workers.
+     *
+     * Follows the same lifecycle pattern as monitorContinuations().
+     * Only active when `scaling.scale_on === "task_queue_depth"` and
+     * a task backend is available.
+     */
+    private monitorScaling;
+    /**
+     * Create the team-wide integration stream and subscribe to merge queue events.
+     *
+     * When a worker submits to the merge queue, the integrator agent is
+     * automatically prompted to process it.
+     */
+    private setupWorkspaceIntegration;
+    /**
+     * Poll EventStore for MERGE_REQUEST signals emitted by worker subprocesses.
+     *
+     * Workers call done() in their MCP subprocess, which emits MERGE_REQUEST to
+     * the shared EventStore. This polling picks up those signals and submits to
+     * the merge queue on the main server.
+     */
+    private startMergeRequestPolling;
     /**
-     * Create the spawn interceptor that injects team context into spawn options.
+     * Internal: Create the spawn interceptor that injects team context into spawn options.
      */
-    private createSpawnInterceptor;
+    private _createSpawnInterceptor;
     /**
      * Get topic names a role should subscribe to based on communication config.
      */
@@ -102,21 +178,51 @@ export declare class TeamRuntime {
      */
     private getInteractionPatterns;
     /**
-     * Install a signal filter on the message router.
+     * Create the spawn interceptor for this team.
+     *
+     * Returns a function that injects team context (topics, MCP servers,
+     * env vars, prompt, interaction patterns) into spawn options.
+     * The caller (TeamManager or installOnServices) is responsible for
+     * installing it on AgentManager.
+     */
+    createSpawnInterceptor(): SpawnInterceptor;
+    /**
+     * Create the signal filter for this team.
      *
      * 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
+     * 1. Channel subscription filters (per-role, per-topic)
+     * 2. Peer connection filters (per-agent-pair)
      *
-     * Status events with no details.signal always pass through (backwards compat).
+     * Must be called after bootstrap() so that agentRoleMap and
+     * peerSignalFilters are populated. Returns null if no filtering needed.
+     */
+    createSignalFilter(): SignalFilter | null;
+    /**
+     * Create the emission validator for this team.
+     *
+     * Checks whether an agent's emitted signal is in its role's allowed
+     * emissions list. Behavior depends on enforcement mode.
+     * Returns null if no emissions config exists.
+     */
+    createEmissionValidator(): EmissionValidator | null;
+    /**
+     * Convenience method: install interceptor, signal filter, and emission
+     * validator directly on the shared services.
+     *
+     * Use this for standalone operation (without TeamManager).
+     * TeamManager uses the individual create* methods for composite dispatch.
+     */
+    installOnServices(): void;
+    /**
+     * Convenience method: uninstall interceptor and filters from services.
+     * Use on teardown for standalone operation.
      */
-    private installSignalFilter;
+    uninstallFromServices(): void;
     /**
-     * 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).
+     * Pre-compute per-role allowed signals from channel subscriptions.
+     * Called during bootstrap() so createSignalFilter() can use the result.
      */
-    private installEmissionValidator;
+    private computeRoleAllowedSignals;
     /**
      * Wire peer subscriptions from communication config.
      * Falls back to legacy bidirectional subtree subs when no peers config exists.

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

@@ -1 +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"}
+{"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,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EAElB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EAGtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAO5E,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,uBAAuB,EAAE,gBAAgB,CAAC;IACpE,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,0BAA0B,EAAE,WAAW,CAAC;CAC9D;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AA6CD,qBAAa,WAAW;IA6CpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IA5C3B,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;IAClD,OAAO,CAAC,YAAY,CAAC,CAAiC;IACtD,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,qBAAqB,CAAC,CAAiC;IAC/D,OAAO,CAAC,oBAAoB,CAAK;IAEjC,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IAEjD,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IAEpD,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,uEAAuE;IACvE,OAAO,CAAC,kBAAkB,CAA0C;IAEpE,qDAAqD;IACrD,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAE3C;;;;;OAKG;gBAED,KAAK,EAAE,YAAY,GAAG,qBAAqB,EAC1B,QAAQ,EAAE,YAAY;IAezC,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,aAAa,GAExB;IAMD;;;;;;;;;;OAUG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuFtE;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAsE/C;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC/B,+BAA+B;IAC/B,WAAW,IAAI,MAAM,GAAG,MAAM;IAI9B,oCAAoC;IACpC,eAAe,IAAI,MAAM;IAIzB,wCAAwC;IACxC,WAAW,IAAI,YAAY;IAa3B,gCAAgC;IAChC,mBAAmB,IAAI,qBAAqB;IAI5C,0CAA0C;IAC1C,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,gDAAgD;IAChD,oBAAoB,IAAI,MAAM,EAAE;IAIhC,mEAAmE;IACnE,sBAAsB,IAAI,mBAAmB,GAAG,SAAS;IAIzD,4DAA4D;IAC5D,eAAe,IAAI,MAAM,GAAG,SAAS;IAIrC,qFAAqF;IACrF,oBAAoB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAIrD,wEAAwE;IACxE,eAAe,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC;IAI/C,6FAA6F;IAC7F,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKvD,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQlC;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA6C5B,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAEnD,0CAA0C;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IAExD;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAqFtB;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAoDjC;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAsEhC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwF/B;;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;;;;;;;OAOG;IACH,sBAAsB,IAAI,gBAAgB;IAI1C;;;;;;;;;OASG;IACH,kBAAkB,IAAI,YAAY,GAAG,IAAI;IAyBzC;;;;;;OAMG;IACH,uBAAuB,IAAI,iBAAiB,GAAG,IAAI;IAoCnD;;;;;;OAMG;IACH,iBAAiB,IAAI,IAAI;IAgBzB;;;OAGG;IACH,qBAAqB,IAAI,IAAI;IAQ7B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAyBjC;;;OAGG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAUpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAiChC"}