mcp-event-intelligence 0.4.0 → 0.5.0

package/dist/src/composite/matching.js

@@ -46,10 +46,54 @@ function predicateMatches(event, predicate) {
             if (Array.isArray(value))
                 return value.includes(predicate.value);
             return false;
+        case 'startsWith':
+            return typeof value === 'string' && value.startsWith(predicate.value);
+        case 'endsWith':
+            return typeof value === 'string' && value.endsWith(predicate.value);
+        case 'regex':
+            if (typeof value !== 'string')
+                return false;
+            try {
+                return new RegExp(predicate.value, predicate.flags ?? '').test(value);
+            }
+            catch {
+                return false;
+            }
         case 'in':
             return predicate.value.includes(value);
+        case 'notIn':
+            return !predicate.value.includes(value);
+        case 'between': {
+            const [lower, upper] = predicate.value;
+            if (typeof value === 'number') {
+                return (typeof lower === 'number' &&
+                    typeof upper === 'number' &&
+                    value >= lower &&
+                    value <= upper);
+            }
+            if (typeof value === 'string') {
+                return (typeof lower === 'string' &&
+                    typeof upper === 'string' &&
+                    value >= lower &&
+                    value <= upper);
+            }
+            return false;
+        }
         case 'exists':
             return predicate.value ? value !== undefined : value === undefined;
+        case 'isNull':
+            return predicate.value
+                ? value === null || value === undefined
+                : value !== null && value !== undefined;
+        case 'type':
+            if (predicate.value === 'null')
+                return value === null;
+            if (predicate.value === 'array')
+                return Array.isArray(value);
+            if (predicate.value === 'object') {
+                return value !== null && typeof value === 'object' && !Array.isArray(value);
+            }
+            return typeof value === predicate.value;
         case 'gt':
             return typeof value === 'number' && value > predicate.value;
         case 'gte':
@@ -76,6 +120,7 @@ export function asSourceEvent(clauseId, event) {
         sourceEventId: event.sourceEventId,
         eventName: event.name,
         occurredAt: event.occurredAt,
+        ...(event.receivedAt ? { receivedAt: event.receivedAt } : {}),
         ...(event.provider ? { provider: event.provider } : {}),
         ...(event.serverId ? { serverId: event.serverId } : {}),
         subscriptionArguments: event.subscriptionArguments ?? {},

package/dist/src/intelligenceProtocol/activationSchemas.d.ts

@@ -6,6 +6,7 @@ export declare const ActivationEvidenceSchema: z.ZodObject<{
     eventName: z.ZodString;
     traceId: z.ZodString;
     occurredAt: z.ZodString;
+    receivedAt: z.ZodOptional<z.ZodString>;
     payloadHash: z.ZodNullable<z.ZodString>;
     data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
@@ -54,6 +55,7 @@ export declare const ActivationEnvelopeSchema: z.ZodObject<{
         eventName: z.ZodString;
         traceId: z.ZodString;
         occurredAt: z.ZodString;
+        receivedAt: z.ZodOptional<z.ZodString>;
         payloadHash: z.ZodNullable<z.ZodString>;
         data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>>;

package/dist/src/intelligenceProtocol/activationSchemas.js

@@ -9,6 +9,7 @@ export const ActivationEvidenceSchema = z.object({
     eventName: z.string().min(1),
     traceId: Id,
     occurredAt: Timestamp,
+    receivedAt: Timestamp.optional(),
     payloadHash: z.string().regex(/^[a-f0-9]{64}$/).nullable(),
     data: z.record(z.string(), z.unknown()).optional(),
 }).strict();

package/dist/src/intelligenceProtocol/index.d.ts

@@ -1,3 +1,10 @@
+export { PATTERN_AST_VERSION, PatternValueSelectorSchema, PatternArithmeticValueSchema, PatternCompareOperatorSchema, AggregateFunctionSchema, PatternWindowSchema, PatternNodeV2Schema, PatternPartitionDimensionSchema, PatternAfterMatchSchema, PatternSelectionSchema, PatternExecutionPolicySchema, PatternMeasureSchema, PatternAstV2DefinitionSchema, collectPatternDurationsMs, collectGuaranteedPatternBindings, collectPatternMeasureRefs, collectPatternRefs, } from './patternV2Schemas.js';
+export type { PatternValueSelector, PatternArithmeticValue, PatternWindow, PatternNodeV2, PatternAfterMatch, PatternAstV2Definition, PatternMeasure, } from './patternV2Schemas.js';
+export { compileLegacyTriggerToPatternV2, } from '../patternV2/legacyCompiler.js';
+export { evaluatePatternV2, evaluatePatternAggregate, evaluatePatternMeasure, patternV2CandidateSignature, } from '../patternV2/evaluator.js';
+export type { PatternV2Candidate, PatternV2Evaluation, PatternV2SemanticDecision, PatternV2SemanticTrace, } from '../patternV2/evaluator.js';
+export { TRIGGER_LANGUAGE_VERSION, PREDICATE_OPERATOR, COMPOSITION_OPERATOR, TEMPORAL_OPERATOR, TRIGGER_LANGUAGE_CATALOG, describeTriggerLanguage, } from './operatorRegistry.js';
+export type { TriggerLanguageCategory, } from './operatorRegistry.js';
 export { EVENT_INTELLIGENCE_PROTOCOL, EVENT_INTELLIGENCE_PROTOCOL_VERSION, EVENT_INTELLIGENCE_SCHEMA_VERSION, EVENT_INTELLIGENCE_COMPATIBILITY, } from './version.js';
 export { RuntimeTargetSchema, EventSourceSchema, EventLineageSchema, McpEventOccurrenceSchema, SemanticConditionWireSchema, EventIngestRequestSchema, SemanticDecisionRecordSchema, WakeRecordSchema, LifecycleStateSchema, AuditKindSchema, AuditRecordSchema, parseEventIngestRequest, parseEventLineage, parseSemanticDecisionRecord, parseWakeRecord, parseAuditRecord, } from './schemas.js';
 export type { RuntimeTarget, McpEventOccurrence, SemanticConditionWire, EventIngestRequest, EventLineage, SemanticDecisionRecord, WakeRecord, LifecycleState, AuditRecord, } from './schemas.js';
@@ -8,8 +15,8 @@ export type { AppendAuditInput, } from './audit.js';
 export { mapMcpEventToLineage, } from './mapper.js';
 export type { MapMcpEventInput, } from './mapper.js';
 export { assertDecisionLineage, assertWakeLineage, } from './invariants.js';
-export { COMPOSITE_TRIGGER_PROTOCOL_VERSION, COMPOSITE_TRIGGER_SCHEMA_VERSION, StructuredPredicateSchema, TriggerClauseSchema, ContinuationContextPolicySchema, ContinuationContractSchema, DerivedEventProjectionSchema, DerivedEventDefinitionSchema, DerivedEventEvidenceRefSchema, DerivedEventRecordSchema, DeterministicCorrelationSchema, SemanticCorrelationSchema, CompositeTriggerDefinitionSchema, CorrelatableEventSchema, TriggerSourceEventSchema, CompositeCorrelationDecisionSchema, TriggerMatchStatusSchema, TriggerMatchRecordSchema, parseCompositeTriggerDefinition, parseCorrelatableEvent, parseTriggerMatchRecord, parseDerivedEventRecord, } from './triggerSchemas.js';
-export type { StructuredPredicate, TriggerClause, ContinuationContextPolicy, ContinuationContract, DerivedEventDefinition, DerivedEventRecord, CompositeTriggerDefinition, CorrelatableEvent, TriggerSourceEvent, TriggerMatchRecord, CompositeCorrelationDecision, } from './triggerSchemas.js';
+export { COMPOSITE_TRIGGER_PROTOCOL_VERSION, COMPOSITE_TRIGGER_SCHEMA_VERSION, StructuredPredicateSchema, TriggerClauseSchema, TemporalConditionSchema, ContinuationContextPolicySchema, ContinuationContractSchema, EventTimePolicySchema, DerivedEventProjectionSchema, DerivedEventDefinitionSchema, DerivedEventEvidenceRefSchema, DerivedEventRecordSchema, DeterministicCorrelationSchema, SemanticCorrelationSchema, CompositeTriggerDefinitionSchema, CorrelatableEventSchema, TriggerSourceEventSchema, CompositeCorrelationDecisionSchema, TriggerMatchStatusSchema, PatternMatchStateSchema, TriggerMatchRecordSchema, parseCompositeTriggerDefinition, parseCorrelatableEvent, parseTriggerMatchRecord, parseDerivedEventRecord, } from './triggerSchemas.js';
+export type { StructuredPredicate, TriggerClause, TemporalCondition, ContinuationContextPolicy, ContinuationContract, EventTimePolicy, DerivedEventDefinition, DerivedEventRecord, CompositeTriggerDefinition, CorrelatableEvent, TriggerSourceEvent, PatternMatchState, TriggerMatchRecord, CompositeCorrelationDecision, } from './triggerSchemas.js';
 export { TriggerPlanEventSchema, TriggerPlanMatchSchema, TriggerPlanInputSchema, parseTriggerPlanInput, } from './triggerPlanSchemas.js';
 export type { TriggerPlanEvent, TriggerPlanMatch, TriggerPlanInput, } from './triggerPlanSchemas.js';
 export { ActivationEvidenceSchema, ActivationEnvelopeSchema, parseActivationEnvelope, } from './activationSchemas.js';

package/dist/src/intelligenceProtocol/index.js

@@ -1,3 +1,7 @@
+export { PATTERN_AST_VERSION, PatternValueSelectorSchema, PatternArithmeticValueSchema, PatternCompareOperatorSchema, AggregateFunctionSchema, PatternWindowSchema, PatternNodeV2Schema, PatternPartitionDimensionSchema, PatternAfterMatchSchema, PatternSelectionSchema, PatternExecutionPolicySchema, PatternMeasureSchema, PatternAstV2DefinitionSchema, collectPatternDurationsMs, collectGuaranteedPatternBindings, collectPatternMeasureRefs, collectPatternRefs, } from './patternV2Schemas.js';
+export { compileLegacyTriggerToPatternV2, } from '../patternV2/legacyCompiler.js';
+export { evaluatePatternV2, evaluatePatternAggregate, evaluatePatternMeasure, patternV2CandidateSignature, } from '../patternV2/evaluator.js';
+export { TRIGGER_LANGUAGE_VERSION, PREDICATE_OPERATOR, COMPOSITION_OPERATOR, TEMPORAL_OPERATOR, TRIGGER_LANGUAGE_CATALOG, describeTriggerLanguage, } from './operatorRegistry.js';
 export { EVENT_INTELLIGENCE_PROTOCOL, EVENT_INTELLIGENCE_PROTOCOL_VERSION, EVENT_INTELLIGENCE_SCHEMA_VERSION, EVENT_INTELLIGENCE_COMPATIBILITY, } from './version.js';
 export { RuntimeTargetSchema, EventSourceSchema, EventLineageSchema, McpEventOccurrenceSchema, SemanticConditionWireSchema, EventIngestRequestSchema, SemanticDecisionRecordSchema, WakeRecordSchema, LifecycleStateSchema, AuditKindSchema, AuditRecordSchema, parseEventIngestRequest, parseEventLineage, parseSemanticDecisionRecord, parseWakeRecord, parseAuditRecord, } from './schemas.js';
 export { canTransition, assertTransition, allowedTransitions, } from './lifecycle.js';
@@ -5,6 +9,6 @@ export { canonicalJson, sha256Hex, } from './canonical.js';
 export { AuditChain, } from './audit.js';
 export { mapMcpEventToLineage, } from './mapper.js';
 export { assertDecisionLineage, assertWakeLineage, } from './invariants.js';
-export { COMPOSITE_TRIGGER_PROTOCOL_VERSION, COMPOSITE_TRIGGER_SCHEMA_VERSION, StructuredPredicateSchema, TriggerClauseSchema, ContinuationContextPolicySchema, ContinuationContractSchema, DerivedEventProjectionSchema, DerivedEventDefinitionSchema, DerivedEventEvidenceRefSchema, DerivedEventRecordSchema, DeterministicCorrelationSchema, SemanticCorrelationSchema, CompositeTriggerDefinitionSchema, CorrelatableEventSchema, TriggerSourceEventSchema, CompositeCorrelationDecisionSchema, TriggerMatchStatusSchema, TriggerMatchRecordSchema, parseCompositeTriggerDefinition, parseCorrelatableEvent, parseTriggerMatchRecord, parseDerivedEventRecord, } from './triggerSchemas.js';
+export { COMPOSITE_TRIGGER_PROTOCOL_VERSION, COMPOSITE_TRIGGER_SCHEMA_VERSION, StructuredPredicateSchema, TriggerClauseSchema, TemporalConditionSchema, ContinuationContextPolicySchema, ContinuationContractSchema, EventTimePolicySchema, DerivedEventProjectionSchema, DerivedEventDefinitionSchema, DerivedEventEvidenceRefSchema, DerivedEventRecordSchema, DeterministicCorrelationSchema, SemanticCorrelationSchema, CompositeTriggerDefinitionSchema, CorrelatableEventSchema, TriggerSourceEventSchema, CompositeCorrelationDecisionSchema, TriggerMatchStatusSchema, PatternMatchStateSchema, TriggerMatchRecordSchema, parseCompositeTriggerDefinition, parseCorrelatableEvent, parseTriggerMatchRecord, parseDerivedEventRecord, } from './triggerSchemas.js';
 export { TriggerPlanEventSchema, TriggerPlanMatchSchema, TriggerPlanInputSchema, parseTriggerPlanInput, } from './triggerPlanSchemas.js';
 export { ActivationEvidenceSchema, ActivationEnvelopeSchema, parseActivationEnvelope, } from './activationSchemas.js';

package/dist/src/intelligenceProtocol/operatorRegistry.d.ts

@@ -0,0 +1,567 @@
+export declare const TRIGGER_LANGUAGE_VERSION: "2";
+export declare const PREDICATE_OPERATOR: {
+    readonly EQ: "eq";
+    readonly NEQ: "neq";
+    readonly CONTAINS: "contains";
+    readonly STARTS_WITH: "startsWith";
+    readonly ENDS_WITH: "endsWith";
+    readonly REGEX: "regex";
+    readonly IN: "in";
+    readonly NOT_IN: "notIn";
+    readonly BETWEEN: "between";
+    readonly EXISTS: "exists";
+    readonly IS_NULL: "isNull";
+    readonly TYPE: "type";
+    readonly GT: "gt";
+    readonly GTE: "gte";
+    readonly LT: "lt";
+    readonly LTE: "lte";
+};
+export declare const COMPOSITION_OPERATOR: {
+    readonly ALL: "all";
+    readonly ANY: "any";
+    readonly SEQUENCE: "sequence";
+    readonly COUNT: "count";
+};
+export declare const TEMPORAL_OPERATOR: {
+    readonly CALENDAR: "calendar";
+    readonly ABSENCE: "absence";
+    readonly NOT: "not";
+    readonly UNLESS: "unless";
+    readonly AFTER: "after";
+    readonly UNTIL: "until";
+    readonly DEBOUNCE: "debounce";
+    readonly THRESHOLD: "threshold";
+    readonly RATE: "rate";
+    readonly DISTINCT: "distinct";
+};
+export declare const TRIGGER_LANGUAGE_CATALOG: Readonly<{
+    version: "2";
+    predicates: readonly ({
+        id: "eq";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: string;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "neq";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: string;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "contains";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: string;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "startsWith";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: string;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "endsWith";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: string;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "regex";
+        description: string;
+        fields: string[];
+        optionalFields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: string;
+        };
+        values?: undefined;
+    } | {
+        id: "in";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: string[];
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "notIn";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: string[];
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "between";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: number[];
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "exists";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: boolean;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "isNull";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: boolean;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "type";
+        description: string;
+        fields: string[];
+        values: string[];
+        example: {
+            path: string;
+            op: string;
+            value: string;
+        };
+        optionalFields?: undefined;
+    } | {
+        id: "gt";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: number;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "gte";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: number;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "lt";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: number;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    } | {
+        id: "lte";
+        description: string;
+        fields: string[];
+        example: {
+            path: string;
+            op: string;
+            value: number;
+        };
+        optionalFields?: undefined;
+        values?: undefined;
+    })[];
+    composition: readonly ({
+        id: "all";
+        canonicalKind: string;
+        description: string;
+        example: {
+            match: string;
+        };
+    } | {
+        id: "any";
+        canonicalKind: string;
+        description: string;
+        example: {
+            match: string;
+        };
+    } | {
+        id: "sequence";
+        canonicalKind: string;
+        description: string;
+        example: {
+            match: string;
+        };
+    } | {
+        id: "count";
+        canonicalKind: string;
+        description: string;
+        example: {
+            match: {
+                kind: string;
+                eventId: string;
+                atLeast: number;
+            };
+        };
+    })[];
+    temporal: readonly ({
+        id: "calendar";
+        description: string;
+        fields: string[];
+        optionalFields: string[];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            timezone: string;
+            after: string;
+            before: string;
+            weekdays: number[];
+            afterRef?: undefined;
+            forMs?: undefined;
+            beforeRef?: undefined;
+            atLeast?: undefined;
+            perMs?: undefined;
+            path?: undefined;
+        };
+        oneOf?: undefined;
+    } | {
+        id: "absence";
+        description: string;
+        fields: string[];
+        oneOf: string[][];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            afterRef: string;
+            forMs: number;
+            timezone?: undefined;
+            after?: undefined;
+            before?: undefined;
+            weekdays?: undefined;
+            beforeRef?: undefined;
+            atLeast?: undefined;
+            perMs?: undefined;
+            path?: undefined;
+        };
+        optionalFields?: undefined;
+    } | {
+        id: "not";
+        description: string;
+        fields: string[];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            timezone?: undefined;
+            after?: undefined;
+            before?: undefined;
+            weekdays?: undefined;
+            afterRef?: undefined;
+            forMs?: undefined;
+            beforeRef?: undefined;
+            atLeast?: undefined;
+            perMs?: undefined;
+            path?: undefined;
+        };
+        optionalFields?: undefined;
+        oneOf?: undefined;
+    } | {
+        id: "unless";
+        description: string;
+        fields: string[];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            timezone?: undefined;
+            after?: undefined;
+            before?: undefined;
+            weekdays?: undefined;
+            afterRef?: undefined;
+            forMs?: undefined;
+            beforeRef?: undefined;
+            atLeast?: undefined;
+            perMs?: undefined;
+            path?: undefined;
+        };
+        optionalFields?: undefined;
+        oneOf?: undefined;
+    } | {
+        id: "after";
+        description: string;
+        fields: string[];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            afterRef: string;
+            timezone?: undefined;
+            after?: undefined;
+            before?: undefined;
+            weekdays?: undefined;
+            forMs?: undefined;
+            beforeRef?: undefined;
+            atLeast?: undefined;
+            perMs?: undefined;
+            path?: undefined;
+        };
+        optionalFields?: undefined;
+        oneOf?: undefined;
+    } | {
+        id: "until";
+        description: string;
+        fields: string[];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            beforeRef: string;
+            timezone?: undefined;
+            after?: undefined;
+            before?: undefined;
+            weekdays?: undefined;
+            afterRef?: undefined;
+            forMs?: undefined;
+            atLeast?: undefined;
+            perMs?: undefined;
+            path?: undefined;
+        };
+        optionalFields?: undefined;
+        oneOf?: undefined;
+    } | {
+        id: "debounce";
+        description: string;
+        fields: string[];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            forMs: number;
+            timezone?: undefined;
+            after?: undefined;
+            before?: undefined;
+            weekdays?: undefined;
+            afterRef?: undefined;
+            beforeRef?: undefined;
+            atLeast?: undefined;
+            perMs?: undefined;
+            path?: undefined;
+        };
+        optionalFields?: undefined;
+        oneOf?: undefined;
+    } | {
+        id: "threshold";
+        description: string;
+        fields: string[];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            atLeast: number;
+            timezone?: undefined;
+            after?: undefined;
+            before?: undefined;
+            weekdays?: undefined;
+            afterRef?: undefined;
+            forMs?: undefined;
+            beforeRef?: undefined;
+            perMs?: undefined;
+            path?: undefined;
+        };
+        optionalFields?: undefined;
+        oneOf?: undefined;
+    } | {
+        id: "rate";
+        description: string;
+        fields: string[];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            atLeast: number;
+            perMs: number;
+            timezone?: undefined;
+            after?: undefined;
+            before?: undefined;
+            weekdays?: undefined;
+            afterRef?: undefined;
+            forMs?: undefined;
+            beforeRef?: undefined;
+            path?: undefined;
+        };
+        optionalFields?: undefined;
+        oneOf?: undefined;
+    } | {
+        id: "distinct";
+        description: string;
+        fields: string[];
+        example: {
+            id: string;
+            kind: string;
+            ref: string;
+            path: string;
+            atLeast: number;
+            timezone?: undefined;
+            after?: undefined;
+            before?: undefined;
+            weekdays?: undefined;
+            afterRef?: undefined;
+            forMs?: undefined;
+            beforeRef?: undefined;
+            perMs?: undefined;
+        };
+        optionalFields?: undefined;
+        oneOf?: undefined;
+    })[];
+    pattern: readonly ({
+        id: string;
+        description: string;
+        example: {
+            kind: string;
+            ref: string;
+        };
+        contiguity?: undefined;
+        fields?: undefined;
+        optionalFields?: undefined;
+    } | {
+        id: string;
+        description: string;
+        example?: undefined;
+        contiguity?: undefined;
+        fields?: undefined;
+        optionalFields?: undefined;
+    } | {
+        id: string;
+        description: string;
+        contiguity: string[];
+        example?: undefined;
+        fields?: undefined;
+        optionalFields?: undefined;
+    } | {
+        id: string;
+        description: string;
+        fields: string[];
+        optionalFields: string[];
+        contiguity: string[];
+        example?: undefined;
+    } | {
+        id: string;
+        description: string;
+        fields: string[];
+        optionalFields: string[];
+        example?: undefined;
+        contiguity?: undefined;
+    } | {
+        id: string;
+        description: string;
+        fields: string[];
+        example?: undefined;
+        contiguity?: undefined;
+        optionalFields?: undefined;
+    })[];
+    windows: readonly ({
+        id: string;
+        description: string;
+        fields: string[];
+        optionalFields?: undefined;
+    } | {
+        id: string;
+        description: string;
+        fields: string[];
+        optionalFields: string[];
+    })[];
+    aggregates: readonly {
+        id: string;
+        description: string;
+    }[];
+    state: readonly {
+        id: string;
+        description: string;
+    }[];
+    selection: readonly {
+        id: string;
+        values: (string | {
+            kind: string;
+            ref: string;
+        })[];
+        description: string;
+    }[];
+    semantic: readonly {
+        id: string;
+        description: string;
+        fields: string[];
+        optionalFields: string[];
+    }[];
+    correlation: readonly {
+        id: string;
+        description: string;
+        authoringField: string;
+    }[];
+    execution: readonly {
+        id: string;
+        description: string;
+    }[];
+    timing: readonly ({
+        id: string;
+        description: string;
+        authoringPath?: undefined;
+    } | {
+        id: string;
+        description: string;
+        authoringPath: string;
+    })[];
+    lifecycle: readonly {
+        id: string;
+        description: string;
+    }[];
+}>;
+export type TriggerLanguageCategory = 'predicates' | 'composition' | 'temporal' | 'pattern' | 'windows' | 'aggregates' | 'state' | 'selection' | 'semantic' | 'execution' | 'correlation' | 'timing' | 'lifecycle';
+export declare function describeTriggerLanguage(input?: {
+    category?: TriggerLanguageCategory;
+    operator?: string;
+}): Record<string, unknown>;