macro-agent 0.2.5 → 0.2.6

package/dist/trigger/router/strategies/direct-strategy.js

@@ -0,0 +1,119 @@
+/**
+ * Direct Routing Strategy
+ *
+ * Routes triggers directly to a specified agent ID.
+ * Validates agent exists and optionally spawns if not found.
+ *
+ * @module trigger/router/strategies/direct-strategy
+ */
+/**
+ * Create a direct routing strategy
+ *
+ * Routes triggers to explicitly specified agent IDs in the
+ * routing hints.
+ */
+export function createDirectStrategy(options = {}) {
+    const { validateAgent = true, allowSpawn = false } = options;
+    return {
+        name: "direct",
+        description: "Routes triggers directly to specified agent IDs",
+        canHandle(event) {
+            // Can handle if target is specified as an agent ID
+            const target = event.routing?.target;
+            return target?.type === "agent" && Boolean(target.agentId);
+        },
+        async route(event, context) {
+            const target = event.routing?.target;
+            // Ensure we have an agent target
+            if (target?.type !== "agent" || !target.agentId) {
+                return {
+                    targetAgents: [],
+                    defer: true,
+                    deferReason: "No agent ID specified in routing target",
+                };
+            }
+            const targetAgentId = target.agentId;
+            // Validate agent exists if configured
+            if (validateAgent) {
+                const agent = context.agentManager.get(targetAgentId);
+                if (!agent) {
+                    // Agent doesn't exist - check spawn config
+                    if (allowSpawn && event.routing?.spawnIfNotFound) {
+                        const spawnConfig = event.routing.spawnConfig;
+                        if (spawnConfig) {
+                            return {
+                                targetAgents: [],
+                                spawnNew: {
+                                    task: spawnConfig.task,
+                                    role: spawnConfig.role,
+                                    parentId: spawnConfig.parentId,
+                                },
+                                reason: `Agent ${targetAgentId} not found, spawning new agent`,
+                            };
+                        }
+                    }
+                    // Check fallback target
+                    if (event.routing?.fallbackTarget) {
+                        return {
+                            targetAgents: [],
+                            defer: true,
+                            deferReason: `Agent ${targetAgentId} not found, fallback to other strategy`,
+                        };
+                    }
+                    return {
+                        targetAgents: [],
+                        defer: true,
+                        deferReason: `Agent ${targetAgentId} not found`,
+                    };
+                }
+                // Agent exists but is stopped
+                if (agent.state === "stopped") {
+                    return {
+                        targetAgents: [targetAgentId],
+                        reason: `Agent ${targetAgentId} is stopped, will attempt to wake`,
+                    };
+                }
+            }
+            // Route to the specified agent
+            return {
+                targetAgents: [targetAgentId],
+                reason: `Direct routing to agent ${targetAgentId}`,
+            };
+        },
+    };
+}
+// =============================================================================
+// Head Manager Strategy
+// =============================================================================
+/**
+ * Create a head manager routing strategy
+ *
+ * Always routes to the head manager (coordinator).
+ */
+export function createHeadStrategy() {
+    return {
+        name: "head",
+        description: "Routes all triggers to the head manager",
+        canHandle(event) {
+            const target = event.routing?.target;
+            return target?.type === "head" || !target;
+        },
+        async route(_event, context) {
+            // Get head manager ID
+            const agents = context.agentManager.list();
+            const headManager = agents.find((a) => !a.parent);
+            if (!headManager) {
+                return {
+                    targetAgents: [],
+                    defer: true,
+                    deferReason: "No head manager found",
+                };
+            }
+            return {
+                targetAgents: [headManager.id],
+                reason: "Routing to head manager",
+            };
+        },
+    };
+}
+//# sourceMappingURL=direct-strategy.js.map

package/dist/trigger/router/strategies/direct-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-strategy.js","sourceRoot":"","sources":["../../../../src/trigger/router/strategies/direct-strategy.ts"],"names":[],"mappings":"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"}

package/dist/trigger/router/strategies/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Routing Strategies
+ *
+ * Pluggable strategies for routing trigger events to agents.
+ *
+ * @module trigger/router/strategies
+ */
+export { createDirectStrategy, createHeadStrategy, type DirectStrategyOptions, } from "./direct-strategy.js";
+export { createRoleStrategy, createBroadcastStrategy, createTaskStrategy, type RoleStrategyOptions, } from "./role-strategy.js";
+export { createAIRouterStrategy, getDefaultRouterSystemPrompt, type AIRouterStrategyOptions, } from "./ai-router-strategy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/trigger/router/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/trigger/router/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC"}

package/dist/trigger/router/strategies/index.js

@@ -0,0 +1,11 @@
+/**
+ * Routing Strategies
+ *
+ * Pluggable strategies for routing trigger events to agents.
+ *
+ * @module trigger/router/strategies
+ */
+export { createDirectStrategy, createHeadStrategy, } from "./direct-strategy.js";
+export { createRoleStrategy, createBroadcastStrategy, createTaskStrategy, } from "./role-strategy.js";
+export { createAIRouterStrategy, getDefaultRouterSystemPrompt, } from "./ai-router-strategy.js";
+//# sourceMappingURL=index.js.map

package/dist/trigger/router/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/trigger/router/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAE7B,MAAM,yBAAyB,CAAC"}

package/dist/trigger/router/strategies/role-strategy.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Role-Based Routing Strategy
+ *
+ * Routes triggers to agents based on their assigned roles.
+ * Supports single-agent and broadcast modes.
+ *
+ * @module trigger/router/strategies/role-strategy
+ */
+import type { RoutingStrategy } from "../types.js";
+/**
+ * Role routing strategy options
+ */
+export interface RoleStrategyOptions {
+    /** Route to all agents with role (broadcast) or just first */
+    mode?: "first" | "all";
+    /** Prefer running agents over stopped */
+    preferRunning?: boolean;
+    /** Allow spawning if no agent with role exists */
+    allowSpawn?: boolean;
+}
+/**
+ * Create a role-based routing strategy
+ *
+ * Routes triggers to agents that have a specific role assigned.
+ */
+export declare function createRoleStrategy(options?: RoleStrategyOptions): RoutingStrategy;
+/**
+ * Create a broadcast routing strategy
+ *
+ * Routes triggers to all agents in a broadcast channel.
+ */
+export declare function createBroadcastStrategy(): RoutingStrategy;
+/**
+ * Create a task-based routing strategy
+ *
+ * Routes triggers to the agent assigned to a specific task.
+ */
+export declare function createTaskStrategy(): RoutingStrategy;
+//# sourceMappingURL=role-strategy.d.ts.map

package/dist/trigger/router/strategies/role-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-strategy.d.ts","sourceRoot":"","sources":["../../../../src/trigger/router/strategies/role-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAmC,MAAM,aAAa,CAAC;AAMpF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACvB,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,mBAAwB,GAChC,eAAe,CAyGjB;AAMD;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,CAgEzD;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CA8CpD"}

package/dist/trigger/router/strategies/role-strategy.js

@@ -0,0 +1,207 @@
+/**
+ * Role-Based Routing Strategy
+ *
+ * Routes triggers to agents based on their assigned roles.
+ * Supports single-agent and broadcast modes.
+ *
+ * @module trigger/router/strategies/role-strategy
+ */
+/**
+ * Create a role-based routing strategy
+ *
+ * Routes triggers to agents that have a specific role assigned.
+ */
+export function createRoleStrategy(options = {}) {
+    const { mode = "first", preferRunning = true, allowSpawn = false } = options;
+    return {
+        name: "role",
+        description: "Routes triggers to agents by role",
+        canHandle(event) {
+            const target = event.routing?.target;
+            return target?.type === "role" && Boolean(target.role);
+        },
+        async route(event, context) {
+            const target = event.routing?.target;
+            // Ensure we have a role target
+            if (target?.type !== "role" || !target.role) {
+                return {
+                    targetAgents: [],
+                    defer: true,
+                    deferReason: "No role specified in routing target",
+                };
+            }
+            const targetRole = target.role;
+            // Find agents with the specified role
+            const allAgents = context.agentManager.list();
+            // Filter by role - check agent.role (top-level), config.role, or task hint
+            const agentsWithRole = allAgents.filter((agent) => {
+                // Check top-level role property first (standard Agent interface)
+                if (agent.role && agent.role.toLowerCase() === targetRole.toLowerCase()) {
+                    return true;
+                }
+                // Check role in config (legacy/alternative)
+                const config = agent.config;
+                const configRole = config?.role;
+                if (configRole && configRole.toLowerCase() === targetRole.toLowerCase()) {
+                    return true;
+                }
+                // Check if task mentions the role (fallback heuristic)
+                if (agent.task?.toLowerCase().includes(targetRole.toLowerCase())) {
+                    return true;
+                }
+                return false;
+            });
+            if (agentsWithRole.length === 0) {
+                // No agents with role - check spawn config
+                if (allowSpawn && event.routing?.spawnIfNotFound) {
+                    const spawnConfig = event.routing.spawnConfig;
+                    return {
+                        targetAgents: [],
+                        spawnNew: {
+                            task: spawnConfig?.task ?? `Handle ${targetRole} tasks`,
+                            role: targetRole,
+                            parentId: spawnConfig?.parentId,
+                        },
+                        reason: `No agent with role ${targetRole}, spawning new agent`,
+                    };
+                }
+                return {
+                    targetAgents: [],
+                    defer: true,
+                    deferReason: `No agents found with role: ${targetRole}`,
+                };
+            }
+            // Sort by preference
+            let candidates = [...agentsWithRole];
+            if (preferRunning) {
+                candidates.sort((a, b) => {
+                    // Running agents first
+                    if (a.state === "running" && b.state !== "running")
+                        return -1;
+                    if (b.state === "running" && a.state !== "running")
+                        return 1;
+                    // Then by creation time (newer first for freshness)
+                    return (b.created_at ?? 0) - (a.created_at ?? 0);
+                });
+            }
+            // Select targets based on mode
+            if (mode === "all") {
+                return {
+                    targetAgents: candidates.map((a) => a.id),
+                    reason: `Broadcasting to ${candidates.length} agents with role ${targetRole}`,
+                };
+            }
+            // First mode - return first matching agent
+            const selected = candidates[0];
+            return {
+                targetAgents: [selected.id],
+                reason: `Routing to agent ${selected.id} with role ${targetRole}`,
+            };
+        },
+    };
+}
+// =============================================================================
+// Broadcast Strategy
+// =============================================================================
+/**
+ * Create a broadcast routing strategy
+ *
+ * Routes triggers to all agents in a broadcast channel.
+ */
+export function createBroadcastStrategy() {
+    return {
+        name: "broadcast",
+        description: "Broadcasts triggers to all agents in a channel",
+        canHandle(event) {
+            const target = event.routing?.target;
+            return target?.type === "broadcast";
+        },
+        async route(event, context) {
+            const target = event.routing?.target;
+            if (target?.type !== "broadcast") {
+                return {
+                    targetAgents: [],
+                    defer: true,
+                    deferReason: "No broadcast channel specified",
+                };
+            }
+            const channel = target.channel;
+            // For now, broadcast channels map to roles
+            // In the future, this could use explicit channel subscriptions
+            const allAgents = context.agentManager.list();
+            // Filter running agents that might be interested in this channel
+            const subscribers = allAgents.filter((agent) => {
+                if (agent.state !== "running")
+                    return false;
+                const config = agent.config;
+                const agentRole = config?.role;
+                // Check if agent role matches channel
+                if (agentRole && agentRole.toLowerCase() === channel.toLowerCase()) {
+                    return true;
+                }
+                // Check subscribed channels in config
+                const channels = config?.channels;
+                if (channels?.includes(channel)) {
+                    return true;
+                }
+                return false;
+            });
+            if (subscribers.length === 0) {
+                return {
+                    targetAgents: [],
+                    reason: `No subscribers for broadcast channel: ${channel}`,
+                };
+            }
+            return {
+                targetAgents: subscribers.map((a) => a.id),
+                reason: `Broadcasting to ${subscribers.length} agents on channel ${channel}`,
+            };
+        },
+    };
+}
+// =============================================================================
+// Task Strategy
+// =============================================================================
+/**
+ * Create a task-based routing strategy
+ *
+ * Routes triggers to the agent assigned to a specific task.
+ */
+export function createTaskStrategy() {
+    return {
+        name: "task",
+        description: "Routes triggers to agents by task assignment",
+        canHandle(event) {
+            const target = event.routing?.target;
+            return target?.type === "task" && Boolean(target.taskId);
+        },
+        async route(event, context) {
+            const target = event.routing?.target;
+            if (target?.type !== "task" || !target.taskId) {
+                return {
+                    targetAgents: [],
+                    defer: true,
+                    deferReason: "No task ID specified",
+                };
+            }
+            const taskId = target.taskId;
+            // Find agent assigned to this task
+            const allAgents = context.agentManager.list();
+            const assignedAgent = allAgents.find((agent) => {
+                return agent.task_id === taskId;
+            });
+            if (!assignedAgent) {
+                return {
+                    targetAgents: [],
+                    defer: true,
+                    deferReason: `No agent assigned to task: ${taskId}`,
+                };
+            }
+            return {
+                targetAgents: [assignedAgent.id],
+                reason: `Routing to agent ${assignedAgent.id} assigned to task ${taskId}`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=role-strategy.js.map

package/dist/trigger/router/strategies/role-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-strategy.js","sourceRoot":"","sources":["../../../../src/trigger/router/strategies/role-strategy.ts"],"names":[],"mappings":"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"}

package/dist/trigger/router/trigger-router.d.ts

@@ -0,0 +1,54 @@
+/**
+ * TriggerRouter - External Event Routing
+ *
+ * ## Routing Architecture Role
+ *
+ * TriggerRouter handles **external system events** (webhooks, cron, etc.)
+ * and routes them to appropriate agents using pluggable strategies.
+ *
+ * ```
+ * External Events → TriggerRouter → SystemEventQueue → WakeManager → Agent
+ * (webhooks, cron)   (this)         (queueing)         (delivery)
+ * ```
+ *
+ * **Responsibilities:**
+ * - Route external events to target agents via configurable strategies
+ * - Queue events for deferred delivery (SystemEventQueue)
+ * - Support multiple routing strategies (direct, head, role-based, etc.)
+ * - Trigger wake cycles for sleeping agents
+ *
+ * **Routing Strategies:**
+ * - direct: Route to specific agent ID
+ * - head: Route to coordinator/head of hierarchy
+ * - role: Route to agents by role
+ * - broadcast: Fan-out to multiple agents
+ *
+ * **Differs from MessageRouter:**
+ * - TriggerRouter: External events → agents (one-way, queued)
+ * - MessageRouter: Agent ↔ agent communication (bidirectional, immediate)
+ *
+ * **Differs from MAPAdapter:**
+ * - TriggerRouter: System events (webhooks, cron, internal signals)
+ * - MAPAdapter: MAP protocol clients (external agents, UIs)
+ *
+ * @module trigger/router/trigger-router
+ */
+import type { EventStore } from "../../store/event-store.js";
+import type { AgentManager } from "../../agent/agent-manager.js";
+import type { MessageRouter } from "../../router/message-router.js";
+import type { SystemEventQueue } from "../queue/types.js";
+import type { TriggerRouter, TriggerRouterConfig } from "./types.js";
+/**
+ * Dependencies for creating a trigger router
+ */
+export interface TriggerRouterDeps {
+    eventStore: EventStore;
+    agentManager: AgentManager;
+    messageRouter: MessageRouter;
+    systemEventQueue: SystemEventQueue;
+}
+/**
+ * Create a trigger router
+ */
+export declare function createTriggerRouter(deps: TriggerRouterDeps, config?: TriggerRouterConfig): TriggerRouter;
+//# sourceMappingURL=trigger-router.d.ts.map

package/dist/trigger/router/trigger-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-router.d.ts","sourceRoot":"","sources":["../../../src/trigger/router/trigger-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAO1D,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EAIpB,MAAM,YAAY,CAAC;AAapB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,MAAM,GAAE,mBAAwB,GAC/B,aAAa,CA4Xf"}