macro-agent 0.2.4 → 0.2.6

package/dist/trigger/router/trigger-router.js

@@ -0,0 +1,362 @@
+/**
+ * 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 { formatTriggerPayload, formatTriggerSource } from "../types.js";
+import { createDirectStrategy, createHeadStrategy, createRoleStrategy, createBroadcastStrategy, createTaskStrategy, } from "./strategies/index.js";
+/**
+ * Create a trigger router
+ */
+export function createTriggerRouter(deps, config = {}) {
+    const strategies = new Map();
+    let defaultStrategyName = config.defaultStrategy ?? "head";
+    let started = false;
+    // Create routing context
+    const routingContext = {
+        eventStore: deps.eventStore,
+        agentManager: deps.agentManager,
+        messageRouter: deps.messageRouter,
+        systemEventQueue: deps.systemEventQueue,
+    };
+    /**
+     * Select the appropriate strategy for an event
+     */
+    function selectStrategy(event) {
+        // Check for explicit strategy in routing hints
+        const preferredName = event.routing?.strategyName;
+        if (preferredName) {
+            const preferred = strategies.get(preferredName);
+            if (preferred)
+                return preferred;
+        }
+        // Check target type and find matching strategy
+        const target = event.routing?.target;
+        if (target) {
+            // Find strategy that can handle this target type
+            for (const strategy of strategies.values()) {
+                if (strategy.canHandle?.(event)) {
+                    return strategy;
+                }
+            }
+        }
+        // Fall back to default strategy
+        return strategies.get(defaultStrategyName) ?? null;
+    }
+    /**
+     * Deliver trigger to a single agent
+     */
+    async function deliverToAgent(agentId, event, additionalContext) {
+        const content = formatTriggerForDelivery(event, additionalContext);
+        if (event.wakeMode === "next-prompt") {
+            // Queue for next prompt
+            deps.systemEventQueue.enqueue(content, {
+                agentId,
+                sourceKey: `${event.source.type}:${event.id}`,
+                priority: event.priority,
+            });
+            return { success: true, method: "queued" };
+        }
+        // Immediate wake mode - try inject/interrupt chain
+        const session = deps.agentManager.getSession(agentId);
+        if (session) {
+            // Agent has active session - try inject first
+            if (session.supportsInject()) {
+                try {
+                    const result = await session.inject(content);
+                    if (result.success) {
+                        return { success: true, method: "inject" };
+                    }
+                }
+                catch {
+                    // Fall through to interrupt
+                }
+            }
+            // Try interrupt
+            try {
+                // Start the interrupt (fire and forget the iteration)
+                const iterable = session.interruptWith(content);
+                const iterator = iterable[Symbol.asyncIterator]();
+                await iterator.next(); // Drive first update
+                return { success: true, method: "interrupt" };
+            }
+            catch {
+                // Fall through to queue
+            }
+        }
+        // No session or inject/interrupt failed - try wake via prompt
+        const agent = deps.agentManager.get(agentId);
+        if (agent && agent.state !== "stopped") {
+            try {
+                // Fire and forget prompt
+                const promptIterable = deps.agentManager.prompt(agentId, content);
+                (async () => {
+                    try {
+                        for await (const _ of promptIterable) {
+                            break; // Just drive first update
+                        }
+                    }
+                    catch {
+                        // Ignore background errors
+                    }
+                })();
+                return { success: true, method: "wake" };
+            }
+            catch {
+                // Fall through to queue
+            }
+        }
+        // Final fallback - queue for when agent becomes available
+        deps.systemEventQueue.enqueue(content, {
+            agentId,
+            sourceKey: `${event.source.type}:${event.id}`,
+            priority: event.priority,
+        });
+        return { success: true, method: "queued" };
+    }
+    /**
+     * Format trigger for delivery to agent
+     */
+    function formatTriggerForDelivery(event, additionalContext) {
+        const lines = [];
+        lines.push(`[Trigger: ${formatTriggerSource(event.source)}]`);
+        if (event.priority && event.priority !== "normal") {
+            lines.push(`Priority: ${event.priority.toUpperCase()}`);
+        }
+        lines.push(`Time: ${new Date(event.timestamp).toISOString()}`);
+        lines.push("");
+        lines.push(formatTriggerPayload(event.payload));
+        if (additionalContext) {
+            lines.push("");
+            lines.push(`Context: ${additionalContext}`);
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Spawn a new agent for handling the trigger
+     */
+    async function spawnAgent(event, decision) {
+        if (!decision.spawnNew)
+            return null;
+        const { task, role, parentId } = decision.spawnNew;
+        try {
+            // Find parent agent for spawning
+            let parent;
+            if (parentId) {
+                parent = parentId;
+            }
+            else {
+                // Default to head manager
+                const agents = deps.agentManager.list();
+                const headManager = agents.find((a) => !a.parent);
+                parent = headManager?.id;
+            }
+            if (!parent) {
+                console.error("[trigger-router] Cannot spawn: no parent agent found");
+                return null;
+            }
+            // Spawn via prompting parent to spawn
+            // This is a simplified approach - in practice you might
+            // use a direct spawn API
+            const spawnRequest = `Spawn a new ${role ?? "worker"} agent to: ${task}`;
+            const spawnPrompt = deps.agentManager.prompt(parent, spawnRequest);
+            for await (const _ of spawnPrompt) {
+                // Drive to completion
+            }
+            // Try to find the newly spawned agent
+            const agents = deps.agentManager.list();
+            const newAgent = agents.find((a) => a.parent === parent && a.task?.includes(task.slice(0, 20)));
+            return newAgent?.id ?? null;
+        }
+        catch (error) {
+            console.error("[trigger-router] Failed to spawn agent:", error);
+            return null;
+        }
+    }
+    // =============================================================================
+    // Router Interface
+    // =============================================================================
+    const router = {
+        async route(event) {
+            if (!started) {
+                return {
+                    success: false,
+                    deliveredTo: [],
+                    method: "queued",
+                    error: "Trigger router not started",
+                };
+            }
+            // Select routing strategy
+            const strategy = selectStrategy(event);
+            if (!strategy) {
+                return {
+                    success: false,
+                    deliveredTo: [],
+                    method: "queued",
+                    error: `No routing strategy available for event`,
+                };
+            }
+            // Get routing decision
+            let decision;
+            try {
+                decision = await strategy.route(event, routingContext);
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    deliveredTo: [],
+                    method: "queued",
+                    error: `Strategy error: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+            // Check for defer
+            if (decision.defer) {
+                // Try fallback target if available
+                if (event.routing?.fallbackTarget) {
+                    const fallbackEvent = {
+                        ...event,
+                        routing: {
+                            ...event.routing,
+                            target: event.routing.fallbackTarget,
+                            fallbackTarget: undefined,
+                        },
+                    };
+                    return this.route(fallbackEvent);
+                }
+                return {
+                    success: false,
+                    deliveredTo: [],
+                    method: "queued",
+                    error: decision.deferReason ?? "Routing deferred",
+                };
+            }
+            // Handle spawn if needed
+            let spawnedAgentId;
+            if (decision.spawnNew) {
+                const newAgentId = await spawnAgent(event, decision);
+                if (newAgentId) {
+                    spawnedAgentId = newAgentId;
+                    decision.targetAgents = [newAgentId];
+                }
+            }
+            // No targets
+            if (decision.targetAgents.length === 0) {
+                return {
+                    success: false,
+                    deliveredTo: [],
+                    method: "queued",
+                    error: "No target agents found",
+                };
+            }
+            // Apply wake mode override
+            const effectiveEvent = decision.wakeModeOverride
+                ? { ...event, wakeMode: decision.wakeModeOverride }
+                : event;
+            // Deliver to all target agents
+            const results = [];
+            for (const agentId of decision.targetAgents) {
+                const result = await deliverToAgent(agentId, effectiveEvent, decision.additionalContext);
+                results.push({ agentId, ...result });
+            }
+            // Aggregate results
+            const deliveredTo = results
+                .filter((r) => r.success)
+                .map((r) => r.agentId);
+            const primaryMethod = results[0]?.method ?? "queued";
+            return {
+                success: deliveredTo.length > 0,
+                deliveredTo,
+                method: deliveredTo.length > 1 ? "broadcast" : primaryMethod,
+                spawned: Boolean(spawnedAgentId),
+                spawnedAgentId,
+                metadata: {
+                    strategy: strategy.name,
+                    reason: decision.reason,
+                    totalTargets: decision.targetAgents.length,
+                    successfulDeliveries: deliveredTo.length,
+                },
+            };
+        },
+        registerStrategy(strategy) {
+            strategies.set(strategy.name, strategy);
+        },
+        unregisterStrategy(name) {
+            strategies.delete(name);
+        },
+        getStrategy(name) {
+            return strategies.get(name);
+        },
+        listStrategies() {
+            return Array.from(strategies.keys());
+        },
+        setDefaultStrategy(name) {
+            if (!strategies.has(name)) {
+                throw new Error(`Strategy not found: ${name}`);
+            }
+            defaultStrategyName = name;
+        },
+        getDefaultStrategy() {
+            return defaultStrategyName;
+        },
+        async start() {
+            if (started)
+                return;
+            // Register built-in strategies
+            router.registerStrategy(createHeadStrategy());
+            router.registerStrategy(createDirectStrategy());
+            router.registerStrategy(createRoleStrategy({ allowSpawn: true }));
+            router.registerStrategy(createBroadcastStrategy());
+            router.registerStrategy(createTaskStrategy());
+            // Initialize strategies
+            for (const strategy of strategies.values()) {
+                if (strategy.initialize) {
+                    await strategy.initialize(routingContext);
+                }
+            }
+            started = true;
+        },
+        async stop() {
+            if (!started)
+                return;
+            // Cleanup strategies
+            for (const strategy of strategies.values()) {
+                if (strategy.cleanup) {
+                    await strategy.cleanup();
+                }
+            }
+            started = false;
+        },
+    };
+    return router;
+}
+//# sourceMappingURL=trigger-router.js.map

package/dist/trigger/router/trigger-router.js.map

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

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

@@ -0,0 +1,225 @@
+/**
+ * Trigger Router Types
+ *
+ * Defines the routing strategy interface and related types
+ * for flexible trigger routing.
+ *
+ * @module trigger/router/types
+ */
+import type { AgentId } from "../../store/types/index.js";
+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 { TriggerEvent, TriggerDeliveryResult, TriggerWakeMode } from "../types.js";
+/**
+ * Context provided to routing strategies for making decisions
+ */
+export interface RoutingContext {
+    /** Event store for agent/task lookup */
+    eventStore: EventStore;
+    /** Agent manager for spawning/querying agents */
+    agentManager: AgentManager;
+    /** Message router for agent messaging */
+    messageRouter: MessageRouter;
+    /** System event queue for queueing events */
+    systemEventQueue: SystemEventQueue;
+}
+/**
+ * Extended context with state information for AI routing
+ */
+export interface ExtendedRoutingContext extends RoutingContext {
+    /** Summary of active agents */
+    activeAgents: AgentSummary[];
+    /** Summary of pending tasks */
+    pendingTasks: TaskSummary[];
+    /** Recent messages (optional) */
+    recentMessages?: MessageSummary[];
+    /** Blackboard state (optional) */
+    blackboardState?: Record<string, unknown>;
+}
+/**
+ * Agent summary for routing decisions
+ */
+export interface AgentSummary {
+    id: AgentId;
+    role?: string;
+    state: "running" | "stopped" | "sleeping";
+    currentTask?: string;
+    parentId?: AgentId | null;
+}
+/**
+ * Task summary for routing decisions
+ */
+export interface TaskSummary {
+    id: string;
+    description: string;
+    status: "pending" | "in_progress" | "completed" | "failed";
+    assignedAgent?: AgentId;
+}
+/**
+ * Message summary for routing decisions
+ */
+export interface MessageSummary {
+    from: AgentId;
+    to: AgentId;
+    preview: string;
+    timestamp: number;
+}
+/**
+ * Result of a routing strategy's decision
+ */
+export interface RoutingDecision {
+    /** Target agent(s) for delivery */
+    targetAgents: AgentId[];
+    /** Whether to spawn a new agent */
+    spawnNew?: SpawnConfig;
+    /** Additional context to include in delivery */
+    additionalContext?: string;
+    /** Override wake mode from trigger */
+    wakeModeOverride?: TriggerWakeMode;
+    /** Reason for the routing decision (for logging/debugging) */
+    reason?: string;
+    /** Whether to defer delivery (e.g., no suitable target) */
+    defer?: boolean;
+    /** Defer reason if applicable */
+    deferReason?: string;
+}
+/**
+ * Configuration for spawning a new agent
+ */
+export interface SpawnConfig {
+    /** Task description for the new agent */
+    task: string;
+    /** Role for the new agent */
+    role?: string;
+    /** Parent agent ID */
+    parentId?: AgentId;
+    /** Additional configuration */
+    config?: Record<string, unknown>;
+}
+/**
+ * Pluggable routing strategy interface
+ *
+ * Implement this interface to create custom routing strategies
+ * for trigger delivery.
+ */
+export interface RoutingStrategy {
+    /** Strategy name for identification */
+    readonly name: string;
+    /** Strategy description */
+    readonly description?: string;
+    /**
+     * Determine routing for a trigger event.
+     *
+     * This method can be async to support strategies that need
+     * to query external systems or use AI for routing decisions.
+     *
+     * @param event - The trigger event to route
+     * @param context - Routing context with system access
+     * @returns Routing decision
+     */
+    route(event: TriggerEvent, context: RoutingContext): Promise<RoutingDecision>;
+    /**
+     * Check if this strategy can handle the event.
+     *
+     * Optional method to allow strategy selection based on
+     * event characteristics.
+     *
+     * @param event - The trigger event
+     * @returns True if this strategy should be used
+     */
+    canHandle?(event: TriggerEvent): boolean;
+    /**
+     * Initialize the strategy (optional).
+     *
+     * Called when the strategy is registered with the router.
+     */
+    initialize?(context: RoutingContext): Promise<void>;
+    /**
+     * Cleanup the strategy (optional).
+     *
+     * Called when the strategy is unregistered or router is stopped.
+     */
+    cleanup?(): Promise<void>;
+}
+/**
+ * Trigger router configuration
+ */
+export interface TriggerRouterConfig {
+    /** Default routing strategy name */
+    defaultStrategy?: string;
+    /** AI router configuration */
+    aiRouter?: {
+        enabled: boolean;
+        systemPrompt?: string;
+        maxDecisionTimeMs?: number;
+    };
+}
+/**
+ * Trigger router interface
+ */
+export interface TriggerRouter {
+    /**
+     * Route a trigger event to appropriate agent(s)
+     *
+     * @param event - Trigger event to route
+     * @returns Delivery result
+     */
+    route(event: TriggerEvent): Promise<TriggerDeliveryResult>;
+    /**
+     * Register a routing strategy
+     *
+     * @param strategy - Strategy to register
+     */
+    registerStrategy(strategy: RoutingStrategy): void;
+    /**
+     * Unregister a routing strategy
+     *
+     * @param name - Strategy name to unregister
+     */
+    unregisterStrategy(name: string): void;
+    /**
+     * Get a registered strategy by name
+     *
+     * @param name - Strategy name
+     * @returns Strategy if found
+     */
+    getStrategy(name: string): RoutingStrategy | undefined;
+    /**
+     * List all registered strategies
+     *
+     * @returns Array of strategy names
+     */
+    listStrategies(): string[];
+    /**
+     * Set the default strategy
+     *
+     * @param name - Strategy name to use as default
+     */
+    setDefaultStrategy(name: string): void;
+    /**
+     * Get the default strategy name
+     *
+     * @returns Default strategy name
+     */
+    getDefaultStrategy(): string;
+    /**
+     * Start the router (initialize strategies, etc.)
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the router (cleanup strategies, etc.)
+     */
+    stop(): Promise<void>;
+}
+/**
+ * Options for strategy selection
+ */
+export interface StrategySelectionOptions {
+    /** Prefer a specific strategy by name */
+    preferredStrategy?: string;
+    /** Allow fallback to default if preferred not available */
+    allowFallback?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/trigger/router/types.js

@@ -0,0 +1,10 @@
+/**
+ * Trigger Router Types
+ *
+ * Defines the routing strategy interface and related types
+ * for flexible trigger routing.
+ *
+ * @module trigger/router/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/trigger/router/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/trigger/router/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/trigger/sources/cron/cron-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cron-service.d.ts","sourceRoot":"","sources":["../../../../src/trigger/sources/cron/cron-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EAMlB,MAAM,YAAY,CAAC;AAmBpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,aAAa,EAAE,aAAa,CAAC;IAC7B,uCAAuC;IACvC,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAuDD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,MAAM,GAAE,iBAAsB,GAC7B,WAAW,CAuYb"}
+{"version":3,"file":"cron-service.d.ts","sourceRoot":"","sources":["../../../../src/trigger/sources/cron/cron-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EAMlB,MAAM,YAAY,CAAC;AAmBpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,aAAa,EAAE,aAAa,CAAC;IAC7B,uCAAuC;IACvC,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAuDD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,MAAM,GAAE,iBAAsB,GAC7B,WAAW,CA0Yb"}

package/dist/trigger/sources/cron/cron-service.js

@@ -395,9 +395,12 @@ export function createCronService(deps, config = {}) {
             return this.run(id, { force: true });
         },
         getNextRunTime() {
-            // This is sync but uses cached state
-            // For async, we'd need to query the store
-            return null; // TODO: implement with store query
+            // Not currently computed: the next fire time depends on per-job schedule
+            // state held in the (async) store, and this accessor is synchronous.
+            // Returns null to indicate "unknown"; callers should not rely on it for
+            // scheduling decisions. Compute the next run from the job's cron
+            // expression directly if you need it.
+            return null;
         },
     };
 }