macro-agent 0.2.4 → 0.2.6

package/src/trigger/types.ts

@@ -1,228 +0,0 @@
-/**
- * Core Trigger System Types
- *
- * Defines the foundational types for the trigger system including
- * trigger events, sources, payloads, and delivery results.
- *
- * @module trigger/types
- */
-
-import type { AgentId, TaskId } from "../store/types/index.js";
-
-// =============================================================================
-// Trigger Sources
-// =============================================================================
-
-/**
- * Sources that can generate trigger events
- */
-export type TriggerSource =
-  | { type: "cron"; jobId: string; jobName: string }
-  | { type: "webhook"; endpointId: string; method: string; path: string }
-  | { type: "system"; eventType: string }
-  | { type: "channel"; channelType: string; channelId: string }
-  | { type: "internal"; component: string };
-
-// =============================================================================
-// Trigger Payload
-// =============================================================================
-
-/**
- * Payload variants for trigger events
- */
-export type TriggerPayload =
-  | { kind: "text"; content: string }
-  | { kind: "json"; data: Record<string, unknown> }
-  | { kind: "activity"; activityType: string; details?: Record<string, unknown> };
-
-// =============================================================================
-// Wake Mode
-// =============================================================================
-
-/**
- * Wake mode determines how the trigger is delivered to the agent
- *
- * - "now": Immediately wake the agent using inject/interrupt chain
- * - "next-prompt": Queue the event to be delivered on agent's next prompt
- */
-export type TriggerWakeMode = "now" | "next-prompt";
-
-// =============================================================================
-// Routing Hints
-// =============================================================================
-
-/**
- * Target specification for trigger routing
- */
-export type TriggerTarget =
-  | { type: "head" }
-  | { type: "agent"; agentId: AgentId }
-  | { type: "role"; role: string }
-  | { type: "task"; taskId: TaskId }
-  | { type: "broadcast"; channel: string }
-  | { type: "ai-router" };
-
-/**
- * Routing hints for trigger delivery
- */
-export interface TriggerRoutingHint {
-  /** Primary target specification */
-  target?: TriggerTarget;
-  /** Fallback target if primary fails */
-  fallbackTarget?: TriggerTarget;
-  /** Custom routing strategy name */
-  strategyName?: string;
-  /** Whether to spawn new agent if target not found */
-  spawnIfNotFound?: boolean;
-  /** Spawn configuration if spawning is allowed */
-  spawnConfig?: {
-    task: string;
-    role?: string;
-    parentId?: AgentId;
-  };
-}
-
-// =============================================================================
-// Trigger Event
-// =============================================================================
-
-/**
- * Priority levels for trigger events
- */
-export type TriggerPriority = "low" | "normal" | "high" | "urgent";
-
-/**
- * A trigger event to be routed to agents
- */
-export interface TriggerEvent {
-  /** Unique event ID */
-  id: string;
-  /** Source of the trigger */
-  source: TriggerSource;
-  /** Payload content */
-  payload: TriggerPayload;
-  /** Wake mode for delivery */
-  wakeMode: TriggerWakeMode;
-  /** Event creation timestamp */
-  timestamp: number;
-  /** Routing configuration */
-  routing?: TriggerRoutingHint;
-  /** Priority level */
-  priority?: TriggerPriority;
-  /** Optional metadata */
-  metadata?: Record<string, unknown>;
-}
-
-// =============================================================================
-// Delivery Result
-// =============================================================================
-
-/**
- * Method used to deliver the trigger
- */
-export type TriggerDeliveryMethod =
-  | "queued"      // Added to system event queue
-  | "inject"      // Injected into active session
-  | "interrupt"   // Interrupted active session
-  | "wake"        // Woke sleeping agent with new prompt
-  | "spawn"       // Spawned new agent to handle
-  | "broadcast";  // Broadcast to multiple agents
-
-/**
- * Result of trigger delivery attempt
- */
-export interface TriggerDeliveryResult {
-  /** Whether delivery succeeded */
-  success: boolean;
-  /** Agent(s) that received the trigger */
-  deliveredTo: AgentId[];
-  /** Delivery method used */
-  method: TriggerDeliveryMethod;
-  /** Whether a new agent was spawned */
-  spawned?: boolean;
-  /** ID of spawned agent if applicable */
-  spawnedAgentId?: AgentId;
-  /** Error message if failed */
-  error?: string;
-  /** Additional metadata */
-  metadata?: Record<string, unknown>;
-}
-
-// =============================================================================
-// Trigger Router Interface (minimal, V1 router module removed)
-// =============================================================================
-
-/**
- * Minimal TriggerRouter interface for routing trigger events.
- * The full V1 router module was removed in the V2 cutover.
- */
-export interface TriggerRouter {
-  /** Route a trigger event to target agents */
-  route(event: TriggerEvent): Promise<TriggerDeliveryResult>;
-}
-
-// =============================================================================
-// Trigger Creation Helpers
-// =============================================================================
-
-/**
- * Options for creating a trigger event
- */
-export interface CreateTriggerOptions {
-  source: TriggerSource;
-  payload: TriggerPayload;
-  wakeMode?: TriggerWakeMode;
-  routing?: TriggerRoutingHint;
-  priority?: TriggerPriority;
-  metadata?: Record<string, unknown>;
-}
-
-/**
- * Create a trigger event with defaults
- */
-export function createTriggerEvent(options: CreateTriggerOptions): TriggerEvent {
-  return {
-    id: `trigger_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`,
-    source: options.source,
-    payload: options.payload,
-    wakeMode: options.wakeMode ?? "now",
-    timestamp: Date.now(),
-    routing: options.routing,
-    priority: options.priority ?? "normal",
-    metadata: options.metadata,
-  };
-}
-
-/**
- * Format a trigger payload as a human-readable string
- */
-export function formatTriggerPayload(payload: TriggerPayload): string {
-  switch (payload.kind) {
-    case "text":
-      return payload.content;
-    case "json":
-      return JSON.stringify(payload.data, null, 2);
-    case "activity":
-      return payload.details
-        ? `[${payload.activityType}] ${JSON.stringify(payload.details)}`
-        : `[${payload.activityType}]`;
-  }
-}
-
-/**
- * Format trigger source as a string
- */
-export function formatTriggerSource(source: TriggerSource): string {
-  switch (source.type) {
-    case "cron":
-      return `cron:${source.jobName}`;
-    case "webhook":
-      return `webhook:${source.endpointId}`;
-    case "system":
-      return `system:${source.eventType}`;
-    case "channel":
-      return `channel:${source.channelType}:${source.channelId}`;
-    case "internal":
-      return `internal:${source.component}`;
-  }
-}

package/src/trigger/wake/index.ts

@@ -1,22 +0,0 @@
-/**
- * Trigger Wake System
- *
- * Manages waking agents with pending system events.
- *
- * @module trigger/wake
- */
-
-export {
-  createWakeManager,
-  type WakeManagerDeps,
-} from "./wake-manager.js";
-
-export type {
-  TriggerWakeManager,
-  WakeManagerConfig,
-  WakeRequest,
-  WakeResult,
-  WakeCycleResult,
-  AgentDrainResult,
-  WakeHandler,
-} from "./types.js";

package/src/trigger/wake/types.ts

@@ -1,162 +0,0 @@
-/**
- * Trigger Wake System Types
- *
- * Types for the wake manager that handles polling agents
- * with pending events and delivering them.
- *
- * ## Wake System Architecture
- *
- * There are two wake mechanisms in macro-agent:
- *
- * 1. **Single-Agent Wake** (agent/wake.ts, activity/types.ts)
- *    - For immediately waking a single agent with an Activity
- *    - Priority-driven (urgent/high/normal/low)
- *    - Uses inject/interrupt fallback chain
- *    - Returns `WakeResult` (success: boolean, method: WakeMethod)
- *
- * 2. **Batch Wake Cycles** (trigger/wake/*)
- *    - For periodic delivery of queued system events
- *    - Heartbeat-based polling with coalescing
- *    - Processes all agents with pending events
- *    - Returns `WakeCycleStatus` (status: ran/skipped/failed)
- *
- * Use single-agent wake for: Immediate message delivery, activity notifications
- * Use batch wake cycles for: Scheduled event delivery, system-wide polling
- *
- * @module trigger/wake/types
- */
-
-import type { AgentId } from "../../store/types/index.js";
-
-// =============================================================================
-// Wake Manager Types
-// =============================================================================
-
-/**
- * Wake request for immediate agent activation
- */
-export interface WakeRequest {
-  /** Reason for the wake request */
-  reason: string;
-  /** Source component requesting wake */
-  source?: string;
-  /** Optional specific agent to wake */
-  agentId?: AgentId;
-  /** Coalesce delay in ms (default: 250) */
-  coalesceMs?: number;
-}
-
-/**
- * Status of a batch wake cycle.
- *
- * Note: This is different from `WakeResult` in activity/types.ts which
- * represents the outcome of waking a single agent.
- */
-export interface WakeCycleStatus {
-  status: "ran" | "skipped" | "failed";
-  /** Duration if ran */
-  durationMs?: number;
-  /** Reason if skipped or failed */
-  reason?: string;
-  /** Agents that were woken */
-  wokenAgents?: AgentId[];
-}
-
-/**
- * @deprecated Use WakeCycleStatus instead. Renamed for clarity.
- */
-export type WakeResult = WakeCycleStatus;
-
-/**
- * Wake handler function type
- */
-export type WakeHandler = (opts: { reason?: string }) => Promise<WakeCycleStatus>;
-
-/**
- * Wake manager configuration
- */
-export interface WakeManagerConfig {
-  /** Enable periodic heartbeat polling */
-  enableHeartbeat?: boolean;
-  /** Heartbeat interval in ms (default: 30000) */
-  heartbeatIntervalMs?: number;
-  /** Coalesce window for wake requests (default: 250) */
-  defaultCoalesceMs?: number;
-  /** Maximum retry delay for failed wakes (default: 5000) */
-  maxRetryDelayMs?: number;
-  /** Log wake operations */
-  enableLogging?: boolean;
-}
-
-/**
- * Wake manager interface
- */
-export interface TriggerWakeManager {
-  /**
-   * Request an immediate wake cycle
-   * @param request - Wake request details
-   */
-  requestWakeNow(request?: WakeRequest): void;
-
-  /**
-   * Check if a wake is pending
-   * @returns True if wake is scheduled
-   */
-  hasPendingWake(): boolean;
-
-  /**
-   * Run a single wake cycle immediately
-   * @param opts - Optional reason for the cycle
-   * @returns Wake cycle status
-   */
-  runWakeCycle(opts?: { reason?: string }): Promise<WakeCycleStatus>;
-
-  /**
-   * Start the wake manager (enables heartbeat if configured)
-   */
-  start(): void;
-
-  /**
-   * Stop the wake manager
-   */
-  stop(): void;
-
-  /**
-   * Check if manager is running
-   */
-  isRunning(): boolean;
-
-  /**
-   * Get pending wake reason if any
-   */
-  getPendingReason(): string | null;
-}
-
-// =============================================================================
-// Drain Result Types
-// =============================================================================
-
-/**
- * Result of draining events for a single agent
- */
-export interface AgentDrainResult {
-  agentId: AgentId;
-  eventCount: number;
-  deliveryMethod: "inject" | "interrupt" | "prompt" | "queued";
-  success: boolean;
-  error?: string;
-}
-
-/**
- * Result of a full wake cycle
- */
-export interface WakeCycleResult {
-  /** Agents processed */
-  agentsProcessed: AgentId[];
-  /** Successful deliveries */
-  successfulDeliveries: AgentDrainResult[];
-  /** Failed deliveries */
-  failedDeliveries: AgentDrainResult[];
-  /** Total duration */
-  durationMs: number;
-}