mcp-event-intelligence 0.1.0

package/dist/src/composite/engine.d.ts

@@ -0,0 +1,87 @@
+import type { SemanticEvaluator } from '../semantic/types.js';
+import { type CompositeTriggerDefinition, type TriggerMatchRecord } from '../intelligenceProtocol/triggerSchemas.js';
+export interface CompositeTriggerStore {
+    putTrigger(definition: CompositeTriggerDefinition): Promise<void>;
+    listTriggers(): CompositeTriggerDefinition[];
+    getTriggerState?(triggerId: string, version: string): {
+        status: 'active' | 'paused' | 'completed' | 'expired' | 'deleted';
+        owner?: unknown;
+        connectionIds?: string[];
+        fireCount?: number;
+        lastFiredAt?: string | null;
+        revision?: number;
+    } | null;
+    setTriggerState?(triggerId: string, version: string, status: 'active' | 'paused' | 'completed' | 'expired' | 'deleted', actor?: unknown, metadata?: Record<string, unknown>): Promise<unknown>;
+    appendTriggerMatch(record: TriggerMatchRecord): Promise<void>;
+    listTriggerMatches(triggerId?: string): TriggerMatchRecord[];
+    getTemporalDeadline?(deadlineId: string): {
+        deadlineId: string;
+        triggerId: string;
+        triggerVersion: string;
+        matchId: string;
+        conditionId: string;
+        dueAt: string;
+        status: 'pending' | 'cancelled' | 'fired';
+    } | null;
+    listTemporalDeadlines?(filter?: {
+        triggerId?: string;
+        matchId?: string;
+        status?: string;
+    }): Array<{
+        deadlineId: string;
+        triggerId: string;
+        triggerVersion: string;
+        matchId: string;
+        conditionId: string;
+        dueAt: string;
+        status: string;
+    }>;
+    putTemporalDeadline?(input: {
+        deadlineId: string;
+        triggerId: string;
+        triggerVersion: string;
+        matchId: string;
+        conditionId: string;
+        dueAt: string;
+        status: 'pending' | 'cancelled' | 'fired';
+    }): Promise<unknown>;
+    setTemporalDeadlineStatus?(deadlineId: string, status: 'pending' | 'cancelled' | 'fired'): Promise<unknown>;
+}
+export interface CompositeTriggerAudit {
+    appendAudit(input: {
+        auditId: string;
+        traceId: string;
+        timestamp: string;
+        kind: string;
+        entityType: 'trigger_match' | 'trigger';
+        entityId: string;
+        details?: Record<string, unknown>;
+    }): Promise<unknown>;
+}
+export interface CompositeIngestResult {
+    triggerId: string;
+    match: TriggerMatchRecord | null;
+    matched: boolean;
+    fired: boolean;
+}
+export declare class CompositeTriggerEngine {
+    private readonly store;
+    private readonly evaluator;
+    private readonly now;
+    constructor(store: CompositeTriggerStore & CompositeTriggerAudit, evaluator?: SemanticEvaluator | null, now?: () => Date);
+    register(definitionInput: unknown): Promise<CompositeTriggerDefinition>;
+    ingest(eventInput: unknown): Promise<CompositeIngestResult[]>;
+    markFired(matchId: string, wakeId: string): Promise<TriggerMatchRecord>;
+    markDerivedEmitted(matchId: string, derivedEventId: string): Promise<TriggerMatchRecord>;
+    private ingestTimerEvent;
+    private applyEvent;
+    private finalizeEligible;
+    private scheduleDeadlines;
+    private cancelDeadlinesForMatch;
+    private advanceLifecycleAfterEffect;
+    private lifecycleAllows;
+    private auditTriggerLifecycle;
+    private newMatch;
+    private latestMatch;
+    private audit;
+}