mcp-event-intelligence 0.3.1 → 0.5.0

package/dist/src/composite/matching.js

@@ -9,6 +9,23 @@ function getByPath(source, path) {
     }
     return current;
 }
+function stableValue(value) {
+    if (Array.isArray(value))
+        return value.map(stableValue);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .map((key) => [
+            key,
+            stableValue(value[key]),
+        ]));
+    }
+    return value;
+}
+function sameSubscriptionArguments(left, right) {
+    return JSON.stringify(stableValue(left ?? {})) ===
+        JSON.stringify(stableValue(right ?? {}));
+}
 function scalarKey(value) {
     if (typeof value === 'string' ||
         typeof value === 'number' ||
@@ -29,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':
@@ -47,6 +108,7 @@ export function clauseMatches(clause, event) {
     const contractVersion = getByPath(event.data, '_derived.contractVersion');
     return (clause.event === event.name &&
         (!clause.serverId || clause.serverId === event.serverId) &&
+        sameSubscriptionArguments(clause.arguments, event.subscriptionArguments) &&
         (!clause.contractVersion ||
             String(contractVersion ?? '') === String(clause.contractVersion)) &&
         clause.where.every((predicate) => predicateMatches(event, predicate)));
@@ -58,8 +120,10 @@ 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 ?? {},
         ...(event.payloadHash ? { payloadHash: event.payloadHash } : {}),
         data: event.data,
     };
@@ -108,7 +172,8 @@ export function deterministicKeyForClause(definition, clauseId, event) {
 }
 export function sameEventIdentity(source, event) {
     return (source.sourceEventId === event.sourceEventId &&
-        (source.serverId ?? null) === (event.serverId ?? null));
+        (source.serverId ?? null) === (event.serverId ?? null) &&
+        sameSubscriptionArguments(source.subscriptionArguments, event.subscriptionArguments));
 }
 export function matchesCorrelationKey(record, key) {
     if (record.correlationKey === null || key === null)

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';