macro-agent 0.2.5 → 0.2.6

package/dist/router/channels.js

@@ -0,0 +1,126 @@
+/**
+ * Enhanced Channel Types
+ *
+ * Extended channel types for agent communication including
+ * broadcast and role-based addressing.
+ *
+ * @module router/channels
+ * @see s-9rld In-Flight Steering spec section 3.2
+ */
+/**
+ * Priority level numeric values for ordering
+ */
+export const PRIORITY_VALUES = {
+    low: 0,
+    normal: 1,
+    high: 2,
+    urgent: 3,
+};
+/**
+ * Compare two priorities (higher priority = larger value)
+ */
+export function comparePriority(a, b) {
+    return PRIORITY_VALUES[a] - PRIORITY_VALUES[b];
+}
+// =============================================================================
+// Channel Helpers
+// =============================================================================
+/**
+ * Create an agent channel
+ */
+export function agentChannel(id) {
+    return { type: "agent", id };
+}
+/**
+ * Create a task channel
+ */
+export function taskChannel(id) {
+    return { type: "task", id };
+}
+/**
+ * Create a topic channel
+ */
+export function topicChannel(topic) {
+    return { type: "topic", topic };
+}
+/**
+ * Create a broadcast channel
+ */
+export function broadcastChannel(scope) {
+    return { type: "broadcast", scope };
+}
+/**
+ * Create a role channel
+ */
+export function roleChannel(role, coordinatorId) {
+    return { type: "role", role, coordinatorId };
+}
+/**
+ * Create a lineage channel
+ */
+export function lineageChannel(agentId) {
+    return { type: "lineage", agentId };
+}
+/**
+ * Create a subtree channel
+ */
+export function subtreeChannel(agentId) {
+    return { type: "subtree", agentId };
+}
+/**
+ * Parse @role syntax to role channel
+ * Examples: @workers, @integrator, @monitor
+ */
+export function parseRoleSyntax(syntax, coordinatorId) {
+    if (!syntax.startsWith("@")) {
+        return null;
+    }
+    const role = syntax.slice(1);
+    if (!role) {
+        return null;
+    }
+    return roleChannel(role, coordinatorId);
+}
+// =============================================================================
+// Channel Type Guards
+// =============================================================================
+/**
+ * Check if channel is an agent channel
+ */
+export function isAgentChannel(channel) {
+    return channel.type === "agent";
+}
+/**
+ * Check if channel is a task channel
+ */
+export function isTaskChannel(channel) {
+    return channel.type === "task";
+}
+/**
+ * Check if channel is a topic channel
+ */
+export function isTopicChannel(channel) {
+    return channel.type === "topic";
+}
+/**
+ * Check if channel is a broadcast channel
+ */
+export function isBroadcastChannel(channel) {
+    return channel.type === "broadcast";
+}
+/**
+ * Check if channel is a role channel
+ */
+export function isRoleChannel(channel) {
+    return channel.type === "role";
+}
+/**
+ * Check if channel targets multiple recipients
+ */
+export function isMulticastChannel(channel) {
+    return (channel.type === "broadcast" ||
+        channel.type === "role" ||
+        channel.type === "topic" ||
+        channel.type === "subtree");
+}
+//# sourceMappingURL=channels.js.map

package/dist/router/channels.js.map

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

package/dist/router/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Message Router module exports
+ */
+export * from "./types.js";
+export * from "./message-router.js";
+export type { SignalType, SignalPayload, SignalPayloadMap, WorkerDonePayload, TaskDonePayload, WorkAssignedPayload, MergeRequestPayload, MergeCompletePayload, LandCompletePayload, ConflictDetectedPayload, HelpPayload, HelpClaimedPayload, HandoffPayload, StatusPayload, HealthCheckPayload, HealthCheckTimerPayload, StaleAgentPayload, PriorityChangePayload, ForceTerminateRequestPayload, WorkerSpawnedPayload, IntegratorDonePayload, AgentTimeoutPayload, AssignmentExpiredPayload, } from "./signals.js";
+export { SIGNALS, ALL_SIGNALS, isValidSignal } from "./signals.js";
+export type { ChannelType as EnhancedChannelType, Channel as EnhancedChannel, AgentChannel, TaskChannel, LineageChannel, SubtreeChannel, TopicChannel, BroadcastChannel, RoleChannel, MessagePriority, DeliveryMode, GroupResolution, } from "./channels.js";
+export { PRIORITY_VALUES, comparePriority, agentChannel, taskChannel, topicChannel, broadcastChannel, roleChannel, lineageChannel, subtreeChannel, parseRoleSyntax, isAgentChannel, isTaskChannel, isTopicChannel, isBroadcastChannel, isRoleChannel, isMulticastChannel, } from "./channels.js";
+export type { LegacyMessageTarget, SignalMessage, ContentMessage, Message, SendSignalRequest, SendContentRequest, MessageTarget as EnhancedMessageTarget, SendMessageRequest as EnhancedSendMessageRequest, SentMessage as EnhancedSentMessage, ReceivedMessage as EnhancedReceivedMessage, } from "./message-types.js";
+export { isSignalMessage, isContentMessage, isSendSignalRequest, isSendContentRequest, isLegacyTarget, isChannelTarget, createSignalMessage, createContentMessage, } from "./message-types.js";
+export { matchesBroadcastScope, getBroadcastRecipients, resolveBroadcastTarget, } from "./broadcast.js";
+export type { BroadcastAgentInfo, BroadcastAgentSource } from "./broadcast.js";
+export { matchesRole, getSubtreeIds, resolveRoleTarget, getAgentsByRole, } from "./role-resolver.js";
+export type { RoleAgentInfo, RoleAgentSource } from "./role-resolver.js";
+export { determineWakeAction, getWakeDecision, getWakeDecisionWithHint, shouldWakeAgent, shouldInterruptAgent, comparePriority as compareMessagePriority, PRIORITY_VALUES as MESSAGE_PRIORITY_VALUES, } from "./wake.js";
+export type { SessionChecker, WakeDecision, WakeOptions } from "./wake.js";
+export type { WakeHandler } from "./message-router.js";
+export { resolveParent, resolveChildren, resolveAncestors, resolveDescendants, resolveSiblings, resolveHierarchicalAddress, hasRecipients, } from "./address-resolver.js";
+export type { HierarchyAgentInfo, HierarchySource, ResolvedAddress, } from "./address-resolver.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AAGpC,YAAY,EACV,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGnE,YAAY,EACV,WAAW,IAAI,mBAAmB,EAClC,OAAO,IAAI,eAAe,EAC1B,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,IAAI,qBAAqB,EACtC,kBAAkB,IAAI,0BAA0B,EAChD,WAAW,IAAI,mBAAmB,EAClC,eAAe,IAAI,uBAAuB,GAC3C,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG/E,OAAO,EACL,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGzE,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,eAAe,IAAI,sBAAsB,EACzC,eAAe,IAAI,uBAAuB,GAC3C,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG3E,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,0BAA0B,EAC1B,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,uBAAuB,CAAC"}

package/dist/router/index.js

@@ -0,0 +1,18 @@
+/**
+ * Message Router module exports
+ */
+// Original types and router (backward compatible)
+export * from "./types.js";
+export * from "./message-router.js";
+export { SIGNALS, ALL_SIGNALS, isValidSignal } from "./signals.js";
+export { PRIORITY_VALUES, comparePriority, agentChannel, taskChannel, topicChannel, broadcastChannel, roleChannel, lineageChannel, subtreeChannel, parseRoleSyntax, isAgentChannel, isTaskChannel, isTopicChannel, isBroadcastChannel, isRoleChannel, isMulticastChannel, } from "./channels.js";
+export { isSignalMessage, isContentMessage, isSendSignalRequest, isSendContentRequest, isLegacyTarget, isChannelTarget, createSignalMessage, createContentMessage, } from "./message-types.js";
+// Broadcast channel resolution (Phase 5)
+export { matchesBroadcastScope, getBroadcastRecipients, resolveBroadcastTarget, } from "./broadcast.js";
+// Role channel resolution (Phase 5)
+export { matchesRole, getSubtreeIds, resolveRoleTarget, getAgentsByRole, } from "./role-resolver.js";
+// Priority-based wake decisions (Phase 5)
+export { determineWakeAction, getWakeDecision, getWakeDecisionWithHint, shouldWakeAgent, shouldInterruptAgent, comparePriority as compareMessagePriority, PRIORITY_VALUES as MESSAGE_PRIORITY_VALUES, } from "./wake.js";
+// Address resolver for hierarchical addresses (MAP Phase 2)
+export { resolveParent, resolveChildren, resolveAncestors, resolveDescendants, resolveSiblings, resolveHierarchicalAddress, hasRecipients, } from "./address-resolver.js";
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,kDAAkD;AAClD,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AA6BpC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAkBnE,OAAO,EACL,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAgBvB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,yCAAyC;AACzC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAIxB,oCAAoC;AACpC,OAAO,EACL,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAI5B,0CAA0C;AAC1C,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,eAAe,IAAI,sBAAsB,EACzC,eAAe,IAAI,uBAAuB,GAC3C,MAAM,WAAW,CAAC;AAOnB,4DAA4D;AAC5D,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,0BAA0B,EAC1B,aAAa,GACd,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,197 @@
+/**
+ * MessageRouter - Core Internal Message Routing Service
+ *
+ * ## Routing Architecture
+ *
+ * MessageRouter is the **core internal routing authority** for macro-agent.
+ * It handles all message delivery between internal agents.
+ *
+ * ```
+ * External → MAPAdapter/TriggerRouter → MessageRouter → EventStore
+ *            (protocol translation)     (routing logic)   (persistence)
+ * ```
+ *
+ * **Three routing entry points exist:**
+ *
+ * 1. **MessageRouter** (this module)
+ *    - Internal routing for agent-to-agent communication
+ *    - Supports: send(), sendToAddress(), emitStatus()
+ *    - Used by: AgentManager, MCP tools, internal components
+ *
+ * 2. **MAPAdapter** (src/map/adapter/)
+ *    - External MAP protocol interface for clients/agents/gateways
+ *    - Translates MAP protocol → internal routing
+ *    - Delegates message delivery to MessageRouter
+ *
+ * 3. **TriggerRouter** (src/trigger/router/)
+ *    - External event routing (webhooks, cron, system events)
+ *    - Queues events for batch delivery
+ *    - Uses WakeManager for delivery scheduling
+ *
+ * ## Supported Routing Methods
+ *
+ * **Legacy Channel-based** (send, sendMessage):
+ * - Direct agent, task, topic, lineage, subtree, broadcast
+ *
+ * **MAP Address-based** (sendToAddress):
+ * - Agent, agents, task, scope, role, broadcast, hierarchical, federated
+ *
+ * @module router/message-router
+ */
+import type { EventStore } from "../store/event-store.js";
+import type { AgentId, EventId } from "../store/types/index.js";
+import type { ReceivedMessage, GetMessagesOptions, Channel, DefaultSubscriptionOptions, EmitStatusRequest, TruncationConfig, AgentSpawner, AgentSessionChecker, SendToAddressRequest, AddressSendResult, TurnRecorderCallback } from "./types.js";
+import { type SessionChecker, type WakeDecision } from "./wake.js";
+import type { FederationHandler } from "../map/federation/types.js";
+/**
+ * MessageRouter interface
+ */
+export interface MessageRouter {
+    /**
+     * Send a message using MAP Address-based routing.
+     *
+     * This is the new MAP-native method that accepts Address types directly.
+     * It supports all legacy-compatible addresses and will throw for
+     * hierarchical addresses until full resolution is implemented.
+     *
+     * @param request - The send request with MAP Address
+     * @returns Result with delivery confirmation
+     * @throws AddressRoutingError if address cannot be resolved
+     */
+    sendToAddress(request: SendToAddressRequest): Promise<AddressSendResult>;
+    /**
+     * Emit a status event from an agent.
+     * Automatically routes to subtree subscribers (parents watching this agent).
+     */
+    emitStatus(request: EmitStatusRequest): void;
+    /**
+     * Get pending messages for an agent.
+     * By default excludes acknowledged messages.
+     */
+    getMessages(agentId: AgentId, options?: GetMessagesOptions): ReceivedMessage[];
+    /**
+     * Get full content of a message (if it was truncated).
+     */
+    getFullMessage(messageId: EventId): string | null;
+    /**
+     * Acknowledge a single message as read.
+     * Acknowledged messages are kept but excluded from getMessages().
+     */
+    acknowledgeMessage(agentId: AgentId, messageId: EventId): void;
+    /**
+     * Acknowledge multiple messages as read.
+     */
+    acknowledgeMessages(agentId: AgentId, messageIds: EventId[]): void;
+    /**
+     * Subscribe an agent to a channel.
+     * Channel types: agent, task, lineage, subtree, topic, broadcast
+     */
+    subscribe(agentId: AgentId, channel: Channel): void;
+    /**
+     * Unsubscribe an agent from a channel.
+     */
+    unsubscribe(agentId: AgentId, channel: Channel): void;
+    /**
+     * Get all channels an agent is subscribed to.
+     */
+    getSubscriptions(agentId: AgentId): Channel[];
+    /**
+     * Get all agents subscribed to a channel.
+     */
+    getSubscribers(channel: Channel): AgentId[];
+    /**
+     * Set up default subscriptions for a newly spawned agent.
+     * - Subscribes agent to its own agent channel
+     * - Subscribes agent to lineage (receives messages from ancestors)
+     * - Subscribes agent to task channel if task_id provided
+     * - Optionally subscribes parent to agent's subtree
+     */
+    setupDefaultSubscriptions(options: DefaultSubscriptionOptions): void;
+    /**
+     * Set turn recorder for conversation tracking.
+     * Called after direct message (agent/task address) delivery.
+     * Supports late binding since mail services may be created after router.
+     */
+    setTurnRecorder(recorder: TurnRecorderCallback): void;
+    /**
+     * Set signal filter for status notification delivery.
+     * Called before delivering each status notification — return false to suppress.
+     * Supports late binding since TeamRuntime is created after router.
+     */
+    setSignalFilter(filter: SignalFilter): void;
+    /**
+     * Set emission validator for outbound status events.
+     * Called before emitting a status event — can reject, warn, or audit.
+     * Supports late binding since TeamRuntime is created after router.
+     */
+    setEmissionValidator(validator: EmissionValidator): void;
+}
+/**
+ * Signal filter callback for status notification delivery.
+ * Return true to deliver, false to suppress.
+ *
+ * @param from - Agent emitting the status
+ * @param to - Agent that would receive the notification
+ * @param signal - Signal name from details.signal (undefined if not tagged)
+ */
+export type SignalFilter = (from: AgentId, to: AgentId, signal: string | undefined) => boolean;
+/**
+ * Emission validator result.
+ * - "allow": emit normally
+ * - "reject": block the emission (strict mode)
+ * - "warn": log warning but allow (permissive mode)
+ * - "audit": record audit event but allow (audit mode)
+ */
+export type EmissionValidatorResult = {
+    action: "allow" | "reject" | "warn" | "audit";
+    message?: string;
+};
+/**
+ * Emission validator callback for outbound status events.
+ * Called with the emitting agent's ID and the signal name.
+ * Returns an action to take (allow, reject, warn, audit).
+ *
+ * @param agentId - Agent emitting the status
+ * @param signal - Signal name from details.signal (undefined if not tagged)
+ */
+export type EmissionValidator = (agentId: AgentId, signal: string | undefined) => EmissionValidatorResult;
+/**
+ * Callback invoked when a message determines a wake action
+ */
+export type WakeHandler = (agentId: AgentId, decision: WakeDecision, messageId: EventId) => void;
+/**
+ * MessageRouter configuration
+ */
+export interface MessageRouterConfig {
+    truncation?: TruncationConfig;
+    /**
+     * Optional callback to spawn an agent for a task.
+     * Used when routing to a task with no assigned agent.
+     */
+    agentSpawner?: AgentSpawner;
+    /**
+     * Optional callback to check if an agent has an active session.
+     * Used to determine if a previous agent can be reused.
+     */
+    agentSessionChecker?: AgentSessionChecker;
+    /**
+     * Optional session checker for priority-based wake decisions.
+     * Provides information about agent session state.
+     */
+    sessionChecker?: SessionChecker;
+    /**
+     * Optional callback invoked when a message triggers a wake action.
+     * Used to actually wake/inject/interrupt agents.
+     */
+    wakeHandler?: WakeHandler;
+    /**
+     * Optional federation handler for cross-system messaging.
+     * Required when sending to federated addresses.
+     */
+    federationHandler?: FederationHandler;
+}
+/**
+ * Create a MessageRouter instance
+ */
+export declare function createMessageRouter(eventStore: EventStore, config?: MessageRouterConfig): MessageRouter;
+//# sourceMappingURL=message-router.d.ts.map

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

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