@lssm/lib.contracts 1.7.4 → 1.9.0

package/dist/spec.d.ts

@@ -7,6 +7,9 @@ import { AnySchemaModel } from "@lssm/lib.schema";
 
 //#region src/spec.d.ts
 
+/**
+ * Distinguishes between state-changing operations (command) and read-only operations (query).
+ */
 type OpKind = 'command' | 'query';
 interface EmitDeclRef {
   ref: EventSpec<AnySchemaModel>;
@@ -18,6 +21,10 @@ interface EmitDeclInline {
   when: string;
   payload: AnySchemaModel;
 }
+/**
+ * Declaration of an event that an operation may emit.
+ * Can be a reference to an `EventSpec` or an inline definition.
+ */
 type EmitDecl = EmitDeclRef | EmitDeclInline;
 declare const isEmitDeclRef: (e: EmitDecl) => e is EmitDeclRef;
 interface TelemetryTrigger {
@@ -31,6 +38,13 @@ interface TelemetryTrigger {
     error?: unknown;
   }) => Record<string, unknown>;
 }
+/**
+ * The core specification interface for any operation (Command or Query).
+ *
+ * @template Input - The Zod-backed schema model for the input payload.
+ * @template Output - The Zod-backed schema model for the output payload, or a resource reference.
+ * @template Events - Tuple of events that this operation may emit.
+ */
 interface ContractSpec<Input extends AnySchemaModel, Output extends AnySchemaModel | ResourceRefDescriptor<boolean>, Events extends readonly EmitDecl[] | undefined = readonly EmitDecl[] | undefined> {
   meta: {
     /** Fully-qualified op name (e.g., "sigil.beginSignup") */
@@ -137,10 +151,18 @@ interface ContractSpec<Input extends AnySchemaModel, Output extends AnySchemaMod
   };
 }
 type AnyContractSpec = ContractSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>;
+/**
+ * Helper to define a Command (write operation).
+ * Sets `kind: 'command'` and defaults `idempotent: false`.
+ */
 declare const defineCommand: <I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>, E extends readonly EmitDecl[] | undefined = undefined>(spec: Omit<ContractSpec<I, O, E>, "meta" | "policy"> & {
   meta: Omit<ContractSpec<I, O, E>["meta"], "kind">;
   policy: Omit<ContractSpec<I, O, E>["policy"], "idempotent">;
 }) => ContractSpec<I, O, E>;
+/**
+ * Helper to define a Query (read-only operation).
+ * Sets `kind: 'query'` and forces `idempotent: true`.
+ */
 declare const defineQuery: <I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>, E extends readonly EmitDecl[] | undefined = undefined>(spec: Omit<ContractSpec<I, O, E>, "meta" | "policy"> & {
   meta: Omit<ContractSpec<I, O, E>["meta"], "kind">;
   policy: Omit<ContractSpec<I, O, E>["policy"], "idempotent">;

package/dist/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","names":[],"sources":["../src/spec.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../src/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAsBA;AAUA;AACA;AAEiB,KArBL,MAAA,GAqBK,SAAgB,GAAA,OAMzB;AAUS,UAlCA,WAAA,CAkCY;EACb,GAAA,EAlCT,SAkCS,CAlCC,cAkCD,CAAA;EACC,IAAA,EAAA,MAAA;;AACS,UAhCT,cAAA,CAgCS;EACX,IAAA,EAAA,MAAA;EASL,OAAA,EAAA,MAAA;EAEK,IAAA,EAAA,MAAA;EAEH,OAAA,EA1CD,cA0CC;;;;;;AA+CG,KAnFH,QAAA,GAAW,WAmFR,GAnFsB,cAmFtB;AAMH,cAxFC,aAwFD,EAAA,CAAA,CAAA,EAxFqB,QAwFrB,EAAA,GAAA,CAAA,IAxFqC,WAwFrC;AAQE,UA9FG,gBAAA,CA8FH;EACA,KAAA,EAAA;IAGJ,IAAA,EAAA,MAAA;IAAW,OAAA,CAAA,EAAA,MAAA;EAmCT,CAAA;EACV,UAAA,CAAA,EAAA,CAAA,IAAA,EAAA;IACA,KAAA,EAAA,OAAA;IAAiB,MAAA,CAAA,EAAA,OAAA;IAFW,KAAA,CAAA,EAAA,OAAA;EAAY,CAAA,EAAA,GA/HlC,MA+HkC,CAAA,MAAA,EAAA,OAAA,CAAA;AAS1C;;;;;;;;AAKa,UAnII,YAmIJ,CAAA,cAlIG,cAkIH,EAAA,eAjII,cAiIJ,GAjIqB,qBAiIrB,CAAA,OAAA,CAAA,EAAA,eAAA,SAhIa,QAgIb,EAAA,GAAA,SAAA,GAAA,SA/HE,QA+HF,EAAA,GAAA,SAAA,CAAA,CAAA;EAAL,IAAA,EAAA;IACoB;IAAG,IAAA,EAAA,MAAA;IAAG;IAAnB,OAAA,EAAA,MAAA;IAAL;IACoB,IAAA,EAxHpB,MAwHoB;IAAG;IAAG,SAAA,EAtHrB,SAsHqB;IAAnB;IAAL,MAAA,EApHA,KAoHA,EAAA;IAEI;IAAG,IAAA,EApHT,GAoHS,EAAA;IAAG;IAAnB,WAAA,EAAA,MAAA;IAAY;IAeF,IAAA,EAAA,MAaX;IAZU;IACA,OAAA,EAAA,MAAA;EAAiB,CAAA;EACR,EAAA,EAAA;IAEK;IAAG,KAAA,EA7HlB,KA6HkB,GAAA,IAAA;IAAG;IAAnB,MAAA,EA3HD,MA2HC;IAAL;IACoB,MAAA,CAAA,EA1Hf,MA0He,CAAA,MAAA,EAAA;MAAG,WAAA,EAAA,MAAA;MAAG,IAAA,CAAA,EAAA,MAAA;MAAnB,OAAA,CAAA,EAAA,MAAA;MAAL,IAAA,EAAA,MAAA;IACoB,CAAA,CAAA;EAAG,CAAA;EAAG,MAAA,EAAA;IAAnB;IAAL,IAAA,EAAA,WAAA,GAAA,MAAA,GAAA,OAAA;IAEI;IAAG,UAAA,CAAA,EAAA,OAAA;IAAG;IAAnB,SAAA,CAAA,EAAA;MAAY,GAAA,EAAA,MAAA;;;;;;;;;;eApGA;;;;;eAKA;;;;;YAMH;;;;;;;cAQE;cACA;;UAGJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmCE,eAAA,GAAkB,aAC5B,gBACA,iBAAiB;;;;;cAON,0BACD,0BACA,iBAAiB,mDACR,0CAEb,KAAK,aAAa,GAAG,GAAG;QACtB,KAAK,aAAa,GAAG,GAAG;UACtB,KAAK,aAAa,GAAG,GAAG;MAEjC,aAAa,GAAG,GAAG;;;;;cAeT,wBACD,0BACA,iBAAiB,mDACR,0CAEb,KAAK,aAAa,GAAG,GAAG;QACtB,KAAK,aAAa,GAAG,GAAG;UACtB,KAAK,aAAa,GAAG,GAAG;MAEjC,aAAa,GAAG,GAAG"}

package/dist/spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.js","names":[],"sources":["../src/spec.ts"],"sourcesContent":["/**\n * ContractSpec: a single source of truth describing one operation (command/query).\n * It carries narrative context for humans/agents AND machine-typed input/output/policy.\n */\nimport type { EventSpec } from './events';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { ResourceRefDescriptor } from './resources';\nimport type { Owner, Stability, Tag } from './ownership';\nimport type { PolicyRef } from './policy/spec';\nimport type { TestSpecRef } from './tests/spec';\n\nexport type OpKind = 'command' | 'query';\n\n// preferred: reference a declared event\nexport interface EmitDeclRef {\n  ref: EventSpec<AnySchemaModel>;\n  when: string;\n}\n// inline (fallback)\nexport interface EmitDeclInline {\n  name: string;\n  version: number;\n  when: string;\n  payload: AnySchemaModel;\n}\nexport type EmitDecl = EmitDeclRef | EmitDeclInline;\nexport const isEmitDeclRef = (e: EmitDecl): e is EmitDeclRef => 'ref' in e;\n\nexport interface TelemetryTrigger {\n  event: { name: string; version?: number };\n  properties?: (args: {\n    input: unknown;\n    output?: unknown;\n    error?: unknown;\n  }) => Record<string, unknown>;\n}\n\nexport interface ContractSpec<\n  Input extends AnySchemaModel,\n  Output extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  Events extends readonly EmitDecl[] | undefined =\n    | readonly EmitDecl[]\n    | undefined,\n> {\n  meta: {\n    /** Fully-qualified op name (e.g., \"sigil.beginSignup\") */\n    name: string;\n    /** Breaking changes => bump version */\n    version: number;\n    /** \"command\" changes state; \"query\" is read-only/idempotent */\n    kind: OpKind;\n    /** Lifecycle marker for comms & tooling */\n    stability: Stability;\n    /** Owners for CODEOWNERS / on-call / approvals */\n    owners: Owner[];\n    /** Search tags, grouping, docs navigation */\n    tags: Tag[];\n    /** Short human-friendly summary */\n    description: string;\n    /** Business goal: why this exists */\n    goal: string;\n    /** Background, constraints, scope edges (feeds docs & LLM context) */\n    context: string;\n  };\n\n  io: {\n    /** Zod schema for input payload */\n    input: Input | null;\n    /** Zod schema for output payload */\n    output: Output;\n    /** Named, typed errors this op may throw (optional) */\n    errors?: Record<\n      string,\n      {\n        description: string;\n        http?: number; // suggested HTTP status if surfaced over REST\n        gqlCode?: string; // suggested GraphQL error code\n        when: string; // human-readable condition\n      }\n    >;\n  };\n\n  policy: {\n    /** Minimal auth category allowed to call this op */\n    auth: 'anonymous' | 'user' | 'admin';\n    /** Idempotency hint. Queries default true; commands default false. */\n    idempotent?: boolean;\n    /** Soft rate limit suggestion; adapter enforces via limiter */\n    rateLimit?: { rpm: number; key: 'user' | 'org' | 'global' };\n    /** Feature flags that must be ON for this op to run */\n    flags?: string[];\n    /** Whether a human must approve before action (e.g., risky commands) */\n    escalate?: 'human_review' | null;\n    /** JSONPath-like pointers to redact from logs/prompts */\n    pii?: string[];\n    /** Referenced policy specs governing access */\n    policies?: PolicyRef[];\n    /** Field-level overrides referencing policy specs */\n    fieldPolicies?: {\n      field: string;\n      actions: ('read' | 'write')[];\n      policy?: PolicyRef;\n    }[];\n  };\n\n  sideEffects?: {\n    /** Declared events this op may emit; runtime will guard against others */\n    emits?: Events;\n    /** Analytics intents (names); the service decides the sink */\n    analytics?: string[];\n    /** Audit intents (labels); the service decides storage */\n    audit?: string[];\n  };\n\n  telemetry?: {\n    success?: TelemetryTrigger;\n    failure?: TelemetryTrigger;\n  };\n\n  tests?: TestSpecRef[];\n\n  transport?: {\n    rest?: {\n      /** Override HTTP method (default: POST for commands, GET for queries) */\n      method?: 'GET' | 'POST';\n      /** Override path (default derived from meta.name/version) */\n      path?: string;\n    };\n    gql?: {\n      /** Override field name (default: dots→underscores + _vN) */\n      field?: string;\n      returns?: string;\n      // byIdField?: string;\n      // resource?: string;\n    };\n    mcp?: {\n      /** Override tool identifier (default: \"<name>.v<version>\") */\n      toolName?: string;\n    };\n  };\n\n  acceptance?: {\n    /** Gherkin-lite scenarios for docs & auto tests */\n    scenarios?: {\n      name: string;\n      given: string[];\n      when: string[];\n      then: string[];\n    }[];\n    /** Request/response examples (used for docs & snapshot tests) */\n    examples?: { name: string; input: unknown; output: unknown }[];\n  };\n}\n\nexport type AnyContractSpec = ContractSpec<\n  AnySchemaModel,\n  AnySchemaModel | ResourceRefDescriptor<boolean>\n>;\n\nexport const defineCommand = <\n  I extends AnySchemaModel,\n  O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  E extends readonly EmitDecl[] | undefined = undefined,\n>(\n  spec: Omit<ContractSpec<I, O, E>, 'meta' | 'policy'> & {\n    meta: Omit<ContractSpec<I, O, E>['meta'], 'kind'>;\n    policy: Omit<ContractSpec<I, O, E>['policy'], 'idempotent'>;\n  }\n): ContractSpec<I, O, E> => ({\n  ...spec,\n  meta: { ...spec.meta, kind: 'command' as const },\n  policy: {\n    ...spec.policy,\n    idempotent:\n      (spec.policy as never as ContractSpec<never, never, never>)?.['policy']\n        ?.idempotent ?? false,\n  },\n});\n\nexport const defineQuery = <\n  I extends AnySchemaModel,\n  O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  E extends readonly EmitDecl[] | undefined = undefined,\n>(\n  spec: Omit<ContractSpec<I, O, E>, 'meta' | 'policy'> & {\n    meta: Omit<ContractSpec<I, O, E>['meta'], 'kind'>;\n    policy: Omit<ContractSpec<I, O, E>['policy'], 'idempotent'>;\n  }\n): ContractSpec<I, O, E> => ({\n  ...spec,\n  meta: { ...spec.meta, kind: 'query' as const },\n  policy: { ...spec.policy, idempotent: true },\n});\n"],"mappings":"AA0BA,MAAa,EAAiB,GAAkC,QAAS,EAqI5D,EAKX,IAI2B,CAC3B,GAAG,EACH,KAAM,CAAE,GAAG,EAAK,KAAM,KAAM,UAAoB,CAChD,OAAQ,CACN,GAAG,EAAK,OACR,WACG,EAAK,QAAwD,QAC1D,YAAc,GACrB,CACF,EAEY,EAKX,IAI2B,CAC3B,GAAG,EACH,KAAM,CAAE,GAAG,EAAK,KAAM,KAAM,QAAkB,CAC9C,OAAQ,CAAE,GAAG,EAAK,OAAQ,WAAY,GAAM,CAC7C"}
+{"version":3,"file":"spec.js","names":[],"sources":["../src/spec.ts"],"sourcesContent":["/**\n * ContractSpec: a single source of truth describing one operation (command/query).\n * It carries narrative context for humans/agents AND machine-typed input/output/policy.\n */\nimport type { EventSpec } from './events';\nimport type { AnySchemaModel } from '@lssm/lib.schema';\nimport type { ResourceRefDescriptor } from './resources';\nimport type { Owner, Stability, Tag } from './ownership';\nimport type { PolicyRef } from './policy/spec';\nimport type { TestSpecRef } from './tests/spec';\n\n/**\n * Distinguishes between state-changing operations (command) and read-only operations (query).\n */\nexport type OpKind = 'command' | 'query';\n\n// preferred: reference a declared event\nexport interface EmitDeclRef {\n  ref: EventSpec<AnySchemaModel>;\n  when: string;\n}\n// inline (fallback)\nexport interface EmitDeclInline {\n  name: string;\n  version: number;\n  when: string;\n  payload: AnySchemaModel;\n}\n/**\n * Declaration of an event that an operation may emit.\n * Can be a reference to an `EventSpec` or an inline definition.\n */\nexport type EmitDecl = EmitDeclRef | EmitDeclInline;\nexport const isEmitDeclRef = (e: EmitDecl): e is EmitDeclRef => 'ref' in e;\n\nexport interface TelemetryTrigger {\n  event: { name: string; version?: number };\n  properties?: (args: {\n    input: unknown;\n    output?: unknown;\n    error?: unknown;\n  }) => Record<string, unknown>;\n}\n\n/**\n * The core specification interface for any operation (Command or Query).\n *\n * @template Input - The Zod-backed schema model for the input payload.\n * @template Output - The Zod-backed schema model for the output payload, or a resource reference.\n * @template Events - Tuple of events that this operation may emit.\n */\nexport interface ContractSpec<\n  Input extends AnySchemaModel,\n  Output extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  Events extends readonly EmitDecl[] | undefined =\n    | readonly EmitDecl[]\n    | undefined,\n> {\n  meta: {\n    /** Fully-qualified op name (e.g., \"sigil.beginSignup\") */\n    name: string;\n    /** Breaking changes => bump version */\n    version: number;\n    /** \"command\" changes state; \"query\" is read-only/idempotent */\n    kind: OpKind;\n    /** Lifecycle marker for comms & tooling */\n    stability: Stability;\n    /** Owners for CODEOWNERS / on-call / approvals */\n    owners: Owner[];\n    /** Search tags, grouping, docs navigation */\n    tags: Tag[];\n    /** Short human-friendly summary */\n    description: string;\n    /** Business goal: why this exists */\n    goal: string;\n    /** Background, constraints, scope edges (feeds docs & LLM context) */\n    context: string;\n  };\n\n  io: {\n    /** Zod schema for input payload */\n    input: Input | null;\n    /** Zod schema for output payload */\n    output: Output;\n    /** Named, typed errors this op may throw (optional) */\n    errors?: Record<\n      string,\n      {\n        description: string;\n        http?: number; // suggested HTTP status if surfaced over REST\n        gqlCode?: string; // suggested GraphQL error code\n        when: string; // human-readable condition\n      }\n    >;\n  };\n\n  policy: {\n    /** Minimal auth category allowed to call this op */\n    auth: 'anonymous' | 'user' | 'admin';\n    /** Idempotency hint. Queries default true; commands default false. */\n    idempotent?: boolean;\n    /** Soft rate limit suggestion; adapter enforces via limiter */\n    rateLimit?: { rpm: number; key: 'user' | 'org' | 'global' };\n    /** Feature flags that must be ON for this op to run */\n    flags?: string[];\n    /** Whether a human must approve before action (e.g., risky commands) */\n    escalate?: 'human_review' | null;\n    /** JSONPath-like pointers to redact from logs/prompts */\n    pii?: string[];\n    /** Referenced policy specs governing access */\n    policies?: PolicyRef[];\n    /** Field-level overrides referencing policy specs */\n    fieldPolicies?: {\n      field: string;\n      actions: ('read' | 'write')[];\n      policy?: PolicyRef;\n    }[];\n  };\n\n  sideEffects?: {\n    /** Declared events this op may emit; runtime will guard against others */\n    emits?: Events;\n    /** Analytics intents (names); the service decides the sink */\n    analytics?: string[];\n    /** Audit intents (labels); the service decides storage */\n    audit?: string[];\n  };\n\n  telemetry?: {\n    success?: TelemetryTrigger;\n    failure?: TelemetryTrigger;\n  };\n\n  tests?: TestSpecRef[];\n\n  transport?: {\n    rest?: {\n      /** Override HTTP method (default: POST for commands, GET for queries) */\n      method?: 'GET' | 'POST';\n      /** Override path (default derived from meta.name/version) */\n      path?: string;\n    };\n    gql?: {\n      /** Override field name (default: dots→underscores + _vN) */\n      field?: string;\n      returns?: string;\n      // byIdField?: string;\n      // resource?: string;\n    };\n    mcp?: {\n      /** Override tool identifier (default: \"<name>.v<version>\") */\n      toolName?: string;\n    };\n  };\n\n  acceptance?: {\n    /** Gherkin-lite scenarios for docs & auto tests */\n    scenarios?: {\n      name: string;\n      given: string[];\n      when: string[];\n      then: string[];\n    }[];\n    /** Request/response examples (used for docs & snapshot tests) */\n    examples?: { name: string; input: unknown; output: unknown }[];\n  };\n}\n\nexport type AnyContractSpec = ContractSpec<\n  AnySchemaModel,\n  AnySchemaModel | ResourceRefDescriptor<boolean>\n>;\n\n/**\n * Helper to define a Command (write operation).\n * Sets `kind: 'command'` and defaults `idempotent: false`.\n */\nexport const defineCommand = <\n  I extends AnySchemaModel,\n  O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  E extends readonly EmitDecl[] | undefined = undefined,\n>(\n  spec: Omit<ContractSpec<I, O, E>, 'meta' | 'policy'> & {\n    meta: Omit<ContractSpec<I, O, E>['meta'], 'kind'>;\n    policy: Omit<ContractSpec<I, O, E>['policy'], 'idempotent'>;\n  }\n): ContractSpec<I, O, E> => ({\n  ...spec,\n  meta: { ...spec.meta, kind: 'command' as const },\n  policy: {\n    ...spec.policy,\n    idempotent:\n      (spec.policy as never as ContractSpec<never, never, never>)?.['policy']\n        ?.idempotent ?? false,\n  },\n});\n\n/**\n * Helper to define a Query (read-only operation).\n * Sets `kind: 'query'` and forces `idempotent: true`.\n */\nexport const defineQuery = <\n  I extends AnySchemaModel,\n  O extends AnySchemaModel | ResourceRefDescriptor<boolean>,\n  E extends readonly EmitDecl[] | undefined = undefined,\n>(\n  spec: Omit<ContractSpec<I, O, E>, 'meta' | 'policy'> & {\n    meta: Omit<ContractSpec<I, O, E>['meta'], 'kind'>;\n    policy: Omit<ContractSpec<I, O, E>['policy'], 'idempotent'>;\n  }\n): ContractSpec<I, O, E> => ({\n  ...spec,\n  meta: { ...spec.meta, kind: 'query' as const },\n  policy: { ...spec.policy, idempotent: true },\n});\n"],"mappings":"AAiCA,MAAa,EAAiB,GAAkC,QAAS,EAgJ5D,EAKX,IAI2B,CAC3B,GAAG,EACH,KAAM,CAAE,GAAG,EAAK,KAAM,KAAM,UAAoB,CAChD,OAAQ,CACN,GAAG,EAAK,OACR,WACG,EAAK,QAAwD,QAC1D,YAAc,GACrB,CACF,EAMY,EAKX,IAI2B,CAC3B,GAAG,EACH,KAAM,CAAE,GAAG,EAAK,KAAM,KAAM,QAAkB,CAC9C,OAAQ,CAAE,GAAG,EAAK,OAAQ,WAAY,GAAM,CAC7C"}

package/dist/telemetry/anomaly.js.map

@@ -1 +1 @@
-{"version":3,"file":"anomaly.js","names":[],"sources":["../../src/telemetry/anomaly.ts"],"sourcesContent":["import type { TelemetryDispatch } from './tracker';\nimport type { TelemetryAnomalyDetectionConfig } from './spec';\n\nexport interface TelemetryAnomalyEvent {\n  dispatch: TelemetryDispatch;\n  threshold: TelemetryAnomalyDetectionConfig;\n  metric: string;\n  value: number | undefined;\n  type: 'min' | 'max';\n}\n\nexport interface TelemetryAnomalyMonitorOptions {\n  onAnomaly?: (event: TelemetryAnomalyEvent) => void;\n  now?: () => Date;\n}\n\nexport class TelemetryAnomalyMonitor {\n  private readonly onAnomaly?: (event: TelemetryAnomalyEvent) => void;\n  private readonly now: () => Date;\n  private readonly samples = new Map<string, number>();\n\n  constructor(options: TelemetryAnomalyMonitorOptions = {}) {\n    this.onAnomaly = options.onAnomaly;\n    this.now = options.now ?? (() => new Date());\n  }\n\n  observe(dispatch: TelemetryDispatch) {\n    const anomalyConfig = dispatch.definition.anomalyDetection;\n    if (!anomalyConfig?.enabled) return;\n    if (!anomalyConfig.thresholds?.length) return;\n\n    const eventKey = `${dispatch.name}.v${dispatch.version}`;\n    const count = this.samples.get(eventKey) ?? 0;\n    const newCount = count + 1;\n    this.samples.set(eventKey, newCount);\n\n    if (\n      typeof anomalyConfig.minimumSample === 'number' &&\n      newCount < anomalyConfig.minimumSample\n    ) {\n      return;\n    }\n\n    for (const threshold of anomalyConfig.thresholds) {\n      const value = this.extractMetric(dispatch, threshold.metric);\n      if (typeof value !== 'number') continue;\n      if (typeof threshold.min === 'number' && value < threshold.min) {\n        this.emit(dispatch, anomalyConfig, threshold.metric, value, 'min');\n      }\n      if (typeof threshold.max === 'number' && value > threshold.max) {\n        this.emit(dispatch, anomalyConfig, threshold.metric, value, 'max');\n      }\n    }\n  }\n\n  private extractMetric(dispatch: TelemetryDispatch, metric: string) {\n    const value = dispatch.properties[metric];\n    if (typeof value === 'number') return value;\n    if (typeof value === 'object' && value !== null && 'value' in value) {\n      const maybeNumber = (value as Record<string, unknown>).value;\n      return typeof maybeNumber === 'number' ? maybeNumber : undefined;\n    }\n    return undefined;\n  }\n\n  private emit(\n    dispatch: TelemetryDispatch,\n    threshold: TelemetryAnomalyDetectionConfig,\n    metric: string,\n    value: number,\n    type: 'min' | 'max'\n  ) {\n    this.onAnomaly?.({\n      dispatch,\n      threshold,\n      metric,\n      value,\n      type,\n    });\n  }\n\n  reset() {\n    this.samples.clear();\n  }\n}\n\n"],"mappings":"AAgBA,IAAa,EAAb,KAAqC,CACnC,UACA,IACA,QAA2B,IAAI,IAE/B,YAAY,EAA0C,EAAE,CAAE,CACxD,KAAK,UAAY,EAAQ,UACzB,KAAK,IAAM,EAAQ,UAAc,IAAI,MAGvC,QAAQ,EAA6B,CACnC,IAAM,EAAgB,EAAS,WAAW,iBAE1C,GADI,CAAC,GAAe,SAChB,CAAC,EAAc,YAAY,OAAQ,OAEvC,IAAM,EAAW,GAAG,EAAS,KAAK,IAAI,EAAS,UAEzC,GADQ,KAAK,QAAQ,IAAI,EAAS,EAAI,GACnB,EACzB,QAAK,QAAQ,IAAI,EAAU,EAAS,CAGlC,SAAO,EAAc,eAAkB,UACvC,EAAW,EAAc,eAK3B,IAAK,IAAM,KAAa,EAAc,WAAY,CAChD,IAAM,EAAQ,KAAK,cAAc,EAAU,EAAU,OAAO,CACxD,OAAO,GAAU,WACjB,OAAO,EAAU,KAAQ,UAAY,EAAQ,EAAU,KACzD,KAAK,KAAK,EAAU,EAAe,EAAU,OAAQ,EAAO,MAAM,CAEhE,OAAO,EAAU,KAAQ,UAAY,EAAQ,EAAU,KACzD,KAAK,KAAK,EAAU,EAAe,EAAU,OAAQ,EAAO,MAAM,GAKxE,cAAsB,EAA6B,EAAgB,CACjE,IAAM,EAAQ,EAAS,WAAW,GAClC,GAAI,OAAO,GAAU,SAAU,OAAO,EACtC,GAAI,OAAO,GAAU,UAAY,GAAkB,UAAW,EAAO,CACnE,IAAM,EAAe,EAAkC,MACvD,OAAO,OAAO,GAAgB,SAAW,EAAc,IAAA,IAK3D,KACE,EACA,EACA,EACA,EACA,EACA,CACA,KAAK,YAAY,CACf,WACA,YACA,SACA,QACA,OACD,CAAC,CAGJ,OAAQ,CACN,KAAK,QAAQ,OAAO"}
+{"version":3,"file":"anomaly.js","names":[],"sources":["../../src/telemetry/anomaly.ts"],"sourcesContent":["import type { TelemetryDispatch } from './tracker';\nimport type { TelemetryAnomalyDetectionConfig } from './spec';\n\nexport interface TelemetryAnomalyEvent {\n  dispatch: TelemetryDispatch;\n  threshold: TelemetryAnomalyDetectionConfig;\n  metric: string;\n  value: number | undefined;\n  type: 'min' | 'max';\n}\n\nexport interface TelemetryAnomalyMonitorOptions {\n  onAnomaly?: (event: TelemetryAnomalyEvent) => void;\n  now?: () => Date;\n}\n\nexport class TelemetryAnomalyMonitor {\n  private readonly onAnomaly?: (event: TelemetryAnomalyEvent) => void;\n  private readonly now: () => Date;\n  private readonly samples = new Map<string, number>();\n\n  constructor(options: TelemetryAnomalyMonitorOptions = {}) {\n    this.onAnomaly = options.onAnomaly;\n    this.now = options.now ?? (() => new Date());\n  }\n\n  observe(dispatch: TelemetryDispatch) {\n    const anomalyConfig = dispatch.definition.anomalyDetection;\n    if (!anomalyConfig?.enabled) return;\n    if (!anomalyConfig.thresholds?.length) return;\n\n    const eventKey = `${dispatch.name}.v${dispatch.version}`;\n    const count = this.samples.get(eventKey) ?? 0;\n    const newCount = count + 1;\n    this.samples.set(eventKey, newCount);\n\n    if (\n      typeof anomalyConfig.minimumSample === 'number' &&\n      newCount < anomalyConfig.minimumSample\n    ) {\n      return;\n    }\n\n    for (const threshold of anomalyConfig.thresholds) {\n      const value = this.extractMetric(dispatch, threshold.metric);\n      if (typeof value !== 'number') continue;\n      if (typeof threshold.min === 'number' && value < threshold.min) {\n        this.emit(dispatch, anomalyConfig, threshold.metric, value, 'min');\n      }\n      if (typeof threshold.max === 'number' && value > threshold.max) {\n        this.emit(dispatch, anomalyConfig, threshold.metric, value, 'max');\n      }\n    }\n  }\n\n  private extractMetric(dispatch: TelemetryDispatch, metric: string) {\n    const value = dispatch.properties[metric];\n    if (typeof value === 'number') return value;\n    if (typeof value === 'object' && value !== null && 'value' in value) {\n      const maybeNumber = (value as Record<string, unknown>).value;\n      return typeof maybeNumber === 'number' ? maybeNumber : undefined;\n    }\n    return undefined;\n  }\n\n  private emit(\n    dispatch: TelemetryDispatch,\n    threshold: TelemetryAnomalyDetectionConfig,\n    metric: string,\n    value: number,\n    type: 'min' | 'max'\n  ) {\n    this.onAnomaly?.({\n      dispatch,\n      threshold,\n      metric,\n      value,\n      type,\n    });\n  }\n\n  reset() {\n    this.samples.clear();\n  }\n}\n"],"mappings":"AAgBA,IAAa,EAAb,KAAqC,CACnC,UACA,IACA,QAA2B,IAAI,IAE/B,YAAY,EAA0C,EAAE,CAAE,CACxD,KAAK,UAAY,EAAQ,UACzB,KAAK,IAAM,EAAQ,UAAc,IAAI,MAGvC,QAAQ,EAA6B,CACnC,IAAM,EAAgB,EAAS,WAAW,iBAE1C,GADI,CAAC,GAAe,SAChB,CAAC,EAAc,YAAY,OAAQ,OAEvC,IAAM,EAAW,GAAG,EAAS,KAAK,IAAI,EAAS,UAEzC,GADQ,KAAK,QAAQ,IAAI,EAAS,EAAI,GACnB,EACzB,QAAK,QAAQ,IAAI,EAAU,EAAS,CAGlC,SAAO,EAAc,eAAkB,UACvC,EAAW,EAAc,eAK3B,IAAK,IAAM,KAAa,EAAc,WAAY,CAChD,IAAM,EAAQ,KAAK,cAAc,EAAU,EAAU,OAAO,CACxD,OAAO,GAAU,WACjB,OAAO,EAAU,KAAQ,UAAY,EAAQ,EAAU,KACzD,KAAK,KAAK,EAAU,EAAe,EAAU,OAAQ,EAAO,MAAM,CAEhE,OAAO,EAAU,KAAQ,UAAY,EAAQ,EAAU,KACzD,KAAK,KAAK,EAAU,EAAe,EAAU,OAAQ,EAAO,MAAM,GAKxE,cAAsB,EAA6B,EAAgB,CACjE,IAAM,EAAQ,EAAS,WAAW,GAClC,GAAI,OAAO,GAAU,SAAU,OAAO,EACtC,GAAI,OAAO,GAAU,UAAY,GAAkB,UAAW,EAAO,CACnE,IAAM,EAAe,EAAkC,MACvD,OAAO,OAAO,GAAgB,SAAW,EAAc,IAAA,IAK3D,KACE,EACA,EACA,EACA,EACA,EACA,CACA,KAAK,YAAY,CACf,WACA,YACA,SACA,QACA,OACD,CAAC,CAGJ,OAAQ,CACN,KAAK,QAAQ,OAAO"}

package/dist/telemetry/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","names":[],"sources":["../../src/telemetry/spec.ts"],"sourcesContent":[],"mappings":";;;KAGY,qBAAA;UAMK,aAAA,SAAsB;EAN3B;EAMK,IAAA,EAAA,MAAA;EASA;EAQA,OAAA,EAAA,MAAA;EAML;EAKK,MAAA,EAAA,MAAA;AAWjB;AAKiB,UAnCA,oBAAA,CAmCwB;EAKxB,IAAA,EAAA,QAAA,GAAA,QAAiB,GAAA,SAAA,GAAA,WAAA,GAAA,MAAA;EAYL,QAAA,CAAA,EAAA,OAAA;EAAf,GAAA,CAAA,EAAA,OAAA;EAEH,MAAA,CAAA,EAAA,OAAA;EAEG,WAAA,CAAA,EAAA,MAAA;;AAIO,UApDJ,yBAAA,CAoDI;EAA+B,MAAA,EAAA,MAAA;EAKnC,GAAA,CAAA,EAAA,MAAA;EAKA,GAAA,CAAA,EAAA,MAAA;AAUjB;AACQ,KAnEI,sBAAA,GAmEJ,OAAA,GAAA,KAAA,GAAA,eAAA;AACE,UA/DO,+BAAA,CA+DP;EACC,OAAA,EAAA,OAAA;EAAe,UAAA,CAAA,EA9DX,yBA8DW,EAAA;EAKb,OAAA,CAAA,EAlED,sBAkEkB,EAAA;EAKb;;;;EAsDZ,aAAA,CAAA,EAAA,MAAA;;AAmBW,UAxIC,uBAAA,CAwIsB;;;;UAnItB,wBAAA;;;;UAKA,iBAAA;;;;;;;;;;;;cAYH,eAAe;;WAElB;;cAEG;;aAED;;qBAEQ;;;;UAKJ,uBAAA;;UAEP;;UAGO,eAAA;;;cAGH;;;;;;UAOG,aAAA;QACT;UACE;WACC;;cAKE,iBAAA;;;;iBAKI;UAaP;uCAI6B;gDAgBS;mDAqB3C;;iBAmBW,gBAAA,OAAuB"}
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../src/telemetry/spec.ts"],"sourcesContent":[],"mappings":";;;KAGY,qBAAA;UAEK,aAAA,SAAsB;EAF3B;EAEK,IAAA,EAAA,MAAA;EASA;EAQA,OAAA,EAAA,MAAA;EAML;EAEK,MAAA,EAAA,MAAA;AAWjB;AAKiB,UAhCA,oBAAA,CAgCwB;EAKxB,IAAA,EAAA,QAAA,GAAA,QAAiB,GAAA,SAAA,GAAA,WAAA,GAAA,MAAA;EAYL,QAAA,CAAA,EAAA,OAAA;EAAf,GAAA,CAAA,EAAA,OAAA;EAEH,MAAA,CAAA,EAAA,OAAA;EAEG,WAAA,CAAA,EAAA,MAAA;;AAIO,UAjDJ,yBAAA,CAiDI;EAA+B,MAAA,EAAA,MAAA;EAKnC,GAAA,CAAA,EAAA,MAAA;EAKA,GAAA,CAAA,EAAA,MAAA;AAUjB;AACQ,KAhEI,sBAAA,GAgEJ,OAAA,GAAA,KAAA,GAAA,eAAA;AACE,UA/DO,+BAAA,CA+DP;EACC,OAAA,EAAA,OAAA;EAAe,UAAA,CAAA,EA9DX,yBA8DW,EAAA;EAKb,OAAA,CAAA,EAlED,sBAkEkB,EAAA;EAKb;;;;EAmDkC,aAAA,CAAA,EAAA,MAAA;;AAmBnC,UArIC,uBAAA,CAqIsB;;;;UAhItB,wBAAA;;;;UAKA,iBAAA;;;;;;;;;;;;cAYH,eAAe;;WAElB;;cAEG;;aAED;;qBAEQ;;;;UAKJ,uBAAA;;UAEP;;UAGO,eAAA;;;cAGH;;;;;;UAOG,aAAA;QACT;UACE;WACC;;cAKE,iBAAA;;;;iBAKI;UAaP;uCAI6B;gDAgBS;mDAkBG;;iBAmBnC,gBAAA,OAAuB"}

package/dist/telemetry/spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.js","names":["latest: TelemetrySpec | undefined","latest: TelemetryEventDef | undefined"],"sources":["../../src/telemetry/spec.ts"],"sourcesContent":["import type { OwnerShipMeta } from '../ownership';\nimport type { EventKey } from '../events';\n\nexport type TelemetryPrivacyLevel =\n  | 'public'\n  | 'internal'\n  | 'pii'\n  | 'sensitive';\n\nexport interface TelemetryMeta extends OwnerShipMeta {\n  /** Fully-qualified telemetry spec name (e.g., \"sigil.core\"). */\n  name: string;\n  /** Incremented when telemetry definitions change in a breaking way. */\n  version: number;\n  /** Optional domain or bounded-context hint (e.g., \"onboarding\"). */\n  domain: string;\n}\n\nexport interface TelemetryPropertyDef {\n  type: 'string' | 'number' | 'boolean' | 'timestamp' | 'json';\n  required?: boolean;\n  pii?: boolean;\n  redact?: boolean;\n  description?: string;\n}\n\nexport interface TelemetryAnomalyThreshold {\n  metric: string;\n  min?: number;\n  max?: number;\n}\n\nexport type TelemetryAnomalyAction =\n  | 'alert'\n  | 'log'\n  | 'trigger_regen';\n\nexport interface TelemetryAnomalyDetectionConfig {\n  enabled: boolean;\n  thresholds?: TelemetryAnomalyThreshold[];\n  actions?: TelemetryAnomalyAction[];\n  /**\n   * Minimum sample size before evaluating thresholds.\n   * Helps avoid false positives on small sample sizes.\n   */\n  minimumSample?: number;\n}\n\nexport interface TelemetrySamplingConfig {\n  rate: number;\n  conditions?: string[];\n}\n\nexport interface TelemetryRetentionConfig {\n  days: number;\n  policy?: 'archive' | 'delete';\n}\n\nexport interface TelemetryEventDef {\n  /** Name of the event (should match EventSpec.name for cross-reference). */\n  name: string;\n  /** Version of the underlying event. */\n  version: number;\n  /** High-level semantics for docs/analyzers. */\n  semantics: {\n    who?: string;\n    what: string;\n    why?: string;\n  };\n  /** Detailed property metadata keyed by property name. */\n  properties: Record<string, TelemetryPropertyDef>;\n  /** Privacy level for the entire event. */\n  privacy: TelemetryPrivacyLevel;\n  /** Retention policy overrides. */\n  retention?: TelemetryRetentionConfig;\n  /** Sampling rules, defaulting to spec.config defaults. */\n  sampling?: TelemetrySamplingConfig;\n  /** Anomaly detection overrides. */\n  anomalyDetection?: TelemetryAnomalyDetectionConfig;\n  /** Optional tags for analytics/AI hints. */\n  tags?: string[];\n}\n\nexport interface TelemetryProviderConfig {\n  type: 'posthog' | 'segment' | 'opentelemetry' | 'internal';\n  config: Record<string, unknown>;\n}\n\nexport interface TelemetryConfig {\n  defaultRetentionDays?: number;\n  defaultSamplingRate?: number;\n  providers?: TelemetryProviderConfig[];\n  anomalyDetection?: {\n    enabled: boolean;\n    checkIntervalMs?: number;\n  };\n}\n\nexport interface TelemetrySpec {\n  meta: TelemetryMeta;\n  events: TelemetryEventDef[];\n  config?: TelemetryConfig;\n}\n\nconst telemetryKey = (meta: TelemetryMeta) => `${meta.name}.v${meta.version}`;\n\nexport class TelemetryRegistry {\n  private readonly items = new Map<string, TelemetrySpec>();\n  private readonly eventsByKey = new Map<EventKey, TelemetryEventDef>();\n  private readonly specByEventKey = new Map<EventKey, TelemetrySpec>();\n\n  register(spec: TelemetrySpec): this {\n    const key = telemetryKey(spec.meta);\n    if (this.items.has(key)) {\n      throw new Error(`Duplicate TelemetrySpec registration for ${key}`);\n    }\n    this.items.set(key, spec);\n    for (const event of spec.events) {\n      this.eventsByKey.set(`${event.name}.v${event.version}`, event);\n       this.specByEventKey.set(`${event.name}.v${event.version}`, spec);\n    }\n    return this;\n  }\n\n  list(): TelemetrySpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): TelemetrySpec | undefined {\n    if (version != null) {\n      return this.items.get(`${name}.v${version}`);\n    }\n    let latest: TelemetrySpec | undefined;\n    let maxVersion = -Infinity;\n    for (const item of this.items.values()) {\n      if (item.meta.name !== name) continue;\n      if (item.meta.version > maxVersion) {\n        maxVersion = item.meta.version;\n        latest = item;\n      }\n    }\n    return latest;\n  }\n\n  findEventDef(name: string, version?: number): TelemetryEventDef | undefined {\n    if (version != null) {\n      return this.eventsByKey.get(`${name}.v${version}`);\n    }\n    let latest: TelemetryEventDef | undefined;\n    let maxVersion = -Infinity;\n    for (const [key, event] of this.eventsByKey.entries()) {\n      const [eventName, versionPart] = key.split('.v');\n      if (eventName !== name) continue;\n      const ver = Number(versionPart);\n      if (Number.isFinite(ver) && ver > maxVersion) {\n        maxVersion = ver;\n        latest = event;\n      }\n    }\n    return latest;\n  }\n\n  getSpecForEvent(\n    name: string,\n    version?: number\n  ): TelemetrySpec | undefined {\n    if (version != null) {\n      return this.specByEventKey.get(`${name}.v${version}`);\n    }\n    let latest: TelemetrySpec | undefined;\n    let maxVersion = -Infinity;\n    for (const [key, spec] of this.specByEventKey.entries()) {\n      const [eventName, versionPart] = key.split('.v');\n      if (eventName !== name) continue;\n      const ver = Number(versionPart);\n      if (Number.isFinite(ver) && ver > maxVersion) {\n        maxVersion = ver;\n        latest = spec;\n      }\n    }\n    return latest;\n  }\n}\n\nexport function makeTelemetryKey(meta: TelemetryMeta) {\n  return telemetryKey(meta);\n}\n\n"],"mappings":"AAwGA,MAAM,EAAgB,GAAwB,GAAG,EAAK,KAAK,IAAI,EAAK,UAEpE,IAAa,EAAb,KAA+B,CAC7B,MAAyB,IAAI,IAC7B,YAA+B,IAAI,IACnC,eAAkC,IAAI,IAEtC,SAAS,EAA2B,CAClC,IAAM,EAAM,EAAa,EAAK,KAAK,CACnC,GAAI,KAAK,MAAM,IAAI,EAAI,CACrB,MAAU,MAAM,4CAA4C,IAAM,CAEpE,KAAK,MAAM,IAAI,EAAK,EAAK,CACzB,IAAK,IAAM,KAAS,EAAK,OACvB,KAAK,YAAY,IAAI,GAAG,EAAM,KAAK,IAAI,EAAM,UAAW,EAAM,CAC7D,KAAK,eAAe,IAAI,GAAG,EAAM,KAAK,IAAI,EAAM,UAAW,EAAK,CAEnE,OAAO,KAGT,MAAwB,CACtB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAc,EAA6C,CAC7D,GAAI,GAAW,KACb,OAAO,KAAK,MAAM,IAAI,GAAG,EAAK,IAAI,IAAU,CAE9C,IAAIA,EACA,EAAa,KACjB,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAa,EAAK,KAAK,QACvB,EAAS,GAGb,OAAO,EAGT,aAAa,EAAc,EAAiD,CAC1E,GAAI,GAAW,KACb,OAAO,KAAK,YAAY,IAAI,GAAG,EAAK,IAAI,IAAU,CAEpD,IAAIC,EACA,EAAa,KACjB,IAAK,GAAM,CAAC,EAAK,KAAU,KAAK,YAAY,SAAS,CAAE,CACrD,GAAM,CAAC,EAAW,GAAe,EAAI,MAAM,KAAK,CAChD,GAAI,IAAc,EAAM,SACxB,IAAM,EAAM,OAAO,EAAY,CAC3B,OAAO,SAAS,EAAI,EAAI,EAAM,IAChC,EAAa,EACb,EAAS,GAGb,OAAO,EAGT,gBACE,EACA,EAC2B,CAC3B,GAAI,GAAW,KACb,OAAO,KAAK,eAAe,IAAI,GAAG,EAAK,IAAI,IAAU,CAEvD,IAAID,EACA,EAAa,KACjB,IAAK,GAAM,CAAC,EAAK,KAAS,KAAK,eAAe,SAAS,CAAE,CACvD,GAAM,CAAC,EAAW,GAAe,EAAI,MAAM,KAAK,CAChD,GAAI,IAAc,EAAM,SACxB,IAAM,EAAM,OAAO,EAAY,CAC3B,OAAO,SAAS,EAAI,EAAI,EAAM,IAChC,EAAa,EACb,EAAS,GAGb,OAAO,IAIX,SAAgB,EAAiB,EAAqB,CACpD,OAAO,EAAa,EAAK"}
+{"version":3,"file":"spec.js","names":["latest: TelemetrySpec | undefined","latest: TelemetryEventDef | undefined"],"sources":["../../src/telemetry/spec.ts"],"sourcesContent":["import type { OwnerShipMeta } from '../ownership';\nimport type { EventKey } from '../events';\n\nexport type TelemetryPrivacyLevel = 'public' | 'internal' | 'pii' | 'sensitive';\n\nexport interface TelemetryMeta extends OwnerShipMeta {\n  /** Fully-qualified telemetry spec name (e.g., \"sigil.core\"). */\n  name: string;\n  /** Incremented when telemetry definitions change in a breaking way. */\n  version: number;\n  /** Optional domain or bounded-context hint (e.g., \"onboarding\"). */\n  domain: string;\n}\n\nexport interface TelemetryPropertyDef {\n  type: 'string' | 'number' | 'boolean' | 'timestamp' | 'json';\n  required?: boolean;\n  pii?: boolean;\n  redact?: boolean;\n  description?: string;\n}\n\nexport interface TelemetryAnomalyThreshold {\n  metric: string;\n  min?: number;\n  max?: number;\n}\n\nexport type TelemetryAnomalyAction = 'alert' | 'log' | 'trigger_regen';\n\nexport interface TelemetryAnomalyDetectionConfig {\n  enabled: boolean;\n  thresholds?: TelemetryAnomalyThreshold[];\n  actions?: TelemetryAnomalyAction[];\n  /**\n   * Minimum sample size before evaluating thresholds.\n   * Helps avoid false positives on small sample sizes.\n   */\n  minimumSample?: number;\n}\n\nexport interface TelemetrySamplingConfig {\n  rate: number;\n  conditions?: string[];\n}\n\nexport interface TelemetryRetentionConfig {\n  days: number;\n  policy?: 'archive' | 'delete';\n}\n\nexport interface TelemetryEventDef {\n  /** Name of the event (should match EventSpec.name for cross-reference). */\n  name: string;\n  /** Version of the underlying event. */\n  version: number;\n  /** High-level semantics for docs/analyzers. */\n  semantics: {\n    who?: string;\n    what: string;\n    why?: string;\n  };\n  /** Detailed property metadata keyed by property name. */\n  properties: Record<string, TelemetryPropertyDef>;\n  /** Privacy level for the entire event. */\n  privacy: TelemetryPrivacyLevel;\n  /** Retention policy overrides. */\n  retention?: TelemetryRetentionConfig;\n  /** Sampling rules, defaulting to spec.config defaults. */\n  sampling?: TelemetrySamplingConfig;\n  /** Anomaly detection overrides. */\n  anomalyDetection?: TelemetryAnomalyDetectionConfig;\n  /** Optional tags for analytics/AI hints. */\n  tags?: string[];\n}\n\nexport interface TelemetryProviderConfig {\n  type: 'posthog' | 'segment' | 'opentelemetry' | 'internal';\n  config: Record<string, unknown>;\n}\n\nexport interface TelemetryConfig {\n  defaultRetentionDays?: number;\n  defaultSamplingRate?: number;\n  providers?: TelemetryProviderConfig[];\n  anomalyDetection?: {\n    enabled: boolean;\n    checkIntervalMs?: number;\n  };\n}\n\nexport interface TelemetrySpec {\n  meta: TelemetryMeta;\n  events: TelemetryEventDef[];\n  config?: TelemetryConfig;\n}\n\nconst telemetryKey = (meta: TelemetryMeta) => `${meta.name}.v${meta.version}`;\n\nexport class TelemetryRegistry {\n  private readonly items = new Map<string, TelemetrySpec>();\n  private readonly eventsByKey = new Map<EventKey, TelemetryEventDef>();\n  private readonly specByEventKey = new Map<EventKey, TelemetrySpec>();\n\n  register(spec: TelemetrySpec): this {\n    const key = telemetryKey(spec.meta);\n    if (this.items.has(key)) {\n      throw new Error(`Duplicate TelemetrySpec registration for ${key}`);\n    }\n    this.items.set(key, spec);\n    for (const event of spec.events) {\n      this.eventsByKey.set(`${event.name}.v${event.version}`, event);\n      this.specByEventKey.set(`${event.name}.v${event.version}`, spec);\n    }\n    return this;\n  }\n\n  list(): TelemetrySpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): TelemetrySpec | undefined {\n    if (version != null) {\n      return this.items.get(`${name}.v${version}`);\n    }\n    let latest: TelemetrySpec | undefined;\n    let maxVersion = -Infinity;\n    for (const item of this.items.values()) {\n      if (item.meta.name !== name) continue;\n      if (item.meta.version > maxVersion) {\n        maxVersion = item.meta.version;\n        latest = item;\n      }\n    }\n    return latest;\n  }\n\n  findEventDef(name: string, version?: number): TelemetryEventDef | undefined {\n    if (version != null) {\n      return this.eventsByKey.get(`${name}.v${version}`);\n    }\n    let latest: TelemetryEventDef | undefined;\n    let maxVersion = -Infinity;\n    for (const [key, event] of this.eventsByKey.entries()) {\n      const [eventName, versionPart] = key.split('.v');\n      if (eventName !== name) continue;\n      const ver = Number(versionPart);\n      if (Number.isFinite(ver) && ver > maxVersion) {\n        maxVersion = ver;\n        latest = event;\n      }\n    }\n    return latest;\n  }\n\n  getSpecForEvent(name: string, version?: number): TelemetrySpec | undefined {\n    if (version != null) {\n      return this.specByEventKey.get(`${name}.v${version}`);\n    }\n    let latest: TelemetrySpec | undefined;\n    let maxVersion = -Infinity;\n    for (const [key, spec] of this.specByEventKey.entries()) {\n      const [eventName, versionPart] = key.split('.v');\n      if (eventName !== name) continue;\n      const ver = Number(versionPart);\n      if (Number.isFinite(ver) && ver > maxVersion) {\n        maxVersion = ver;\n        latest = spec;\n      }\n    }\n    return latest;\n  }\n}\n\nexport function makeTelemetryKey(meta: TelemetryMeta) {\n  return telemetryKey(meta);\n}\n"],"mappings":"AAiGA,MAAM,EAAgB,GAAwB,GAAG,EAAK,KAAK,IAAI,EAAK,UAEpE,IAAa,EAAb,KAA+B,CAC7B,MAAyB,IAAI,IAC7B,YAA+B,IAAI,IACnC,eAAkC,IAAI,IAEtC,SAAS,EAA2B,CAClC,IAAM,EAAM,EAAa,EAAK,KAAK,CACnC,GAAI,KAAK,MAAM,IAAI,EAAI,CACrB,MAAU,MAAM,4CAA4C,IAAM,CAEpE,KAAK,MAAM,IAAI,EAAK,EAAK,CACzB,IAAK,IAAM,KAAS,EAAK,OACvB,KAAK,YAAY,IAAI,GAAG,EAAM,KAAK,IAAI,EAAM,UAAW,EAAM,CAC9D,KAAK,eAAe,IAAI,GAAG,EAAM,KAAK,IAAI,EAAM,UAAW,EAAK,CAElE,OAAO,KAGT,MAAwB,CACtB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAc,EAA6C,CAC7D,GAAI,GAAW,KACb,OAAO,KAAK,MAAM,IAAI,GAAG,EAAK,IAAI,IAAU,CAE9C,IAAIA,EACA,EAAa,KACjB,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAa,EAAK,KAAK,QACvB,EAAS,GAGb,OAAO,EAGT,aAAa,EAAc,EAAiD,CAC1E,GAAI,GAAW,KACb,OAAO,KAAK,YAAY,IAAI,GAAG,EAAK,IAAI,IAAU,CAEpD,IAAIC,EACA,EAAa,KACjB,IAAK,GAAM,CAAC,EAAK,KAAU,KAAK,YAAY,SAAS,CAAE,CACrD,GAAM,CAAC,EAAW,GAAe,EAAI,MAAM,KAAK,CAChD,GAAI,IAAc,EAAM,SACxB,IAAM,EAAM,OAAO,EAAY,CAC3B,OAAO,SAAS,EAAI,EAAI,EAAM,IAChC,EAAa,EACb,EAAS,GAGb,OAAO,EAGT,gBAAgB,EAAc,EAA6C,CACzE,GAAI,GAAW,KACb,OAAO,KAAK,eAAe,IAAI,GAAG,EAAK,IAAI,IAAU,CAEvD,IAAID,EACA,EAAa,KACjB,IAAK,GAAM,CAAC,EAAK,KAAS,KAAK,eAAe,SAAS,CAAE,CACvD,GAAM,CAAC,EAAW,GAAe,EAAI,MAAM,KAAK,CAChD,GAAI,IAAc,EAAM,SACxB,IAAM,EAAM,OAAO,EAAY,CAC3B,OAAO,SAAS,EAAI,EAAI,EAAM,IAChC,EAAa,EACb,EAAS,GAGb,OAAO,IAIX,SAAgB,EAAiB,EAAqB,CACpD,OAAO,EAAa,EAAK"}

package/dist/telemetry/tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracker.d.ts","names":[],"sources":["../../src/telemetry/tracker.ts"],"sourcesContent":[],"mappings":";;;;UASiB,qBAAA;;EAAA,cAAA,CAAA,EAAA,MAAA,GAAqB,IAAA;EAUrB,MAAA,CAAA,EAAA,MAAA,GAAA,IAAiB;EAKpB,SAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EACH,KAAA,CAAA,EAAA,WAAA,GAAA,MAAA,GAAA,OAAA;EACA,OAAA,CAAA,EAAA,KAAA,GAAA,QAAA,GAAA,KAAA,GAAA,OAAA;EAEH,QAAA,CAAA,EAZK,MAYL,CAAA,MAAA,EAAA,OAAA,CAAA;;AACuB,UAVd,iBAAA,CAUc;EAGd,EAAA,EAAA,MAAA;EAKA,IAAA,EAAA,MAAA;EACL,OAAA,EAAA,MAAA;EACE,UAAA,EAAA,MAAA;EACK,UAAA,EAhBL,MAgBK,CAAA,MAAA,EAAA,OAAA,CAAA;EAEH,OAAA,EAjBL,iBAiBK,CAAA,SAAA,CAAA;EAAI,OAAA,EAhBT,qBAgBS;EAiBP,IAAA,CAAA,EAAA,MAAA,EAAA;EAOU,IAAA,EAtCf,aAsCe;EAWM,UAAA,EAhDf,iBAgDe;;AAYhB,UAzDI,wBAAA,CAyDJ;EACR,EAAA,EAAA,MAAA;EAAO,IAAA,CAAA,KAAA,EAxDE,iBAwDF,CAAA,EAxDsB,OAwDtB,CAAA,IAAA,CAAA;;UArDK,uBAAA;YACL;cACE;mBACK;;gBAEH;;cAiBH,gBAAA;;;;;;uBAOU;6BAWM;;mDAWb,mCACH,wBACR"}
+{"version":3,"file":"tracker.d.ts","names":[],"sources":["../../src/telemetry/tracker.ts"],"sourcesContent":[],"mappings":";;;;UASiB,qBAAA;;EAAA,cAAA,CAAA,EAAA,MAAA,GAAqB,IAAA;EAUrB,MAAA,CAAA,EAAA,MAAA,GAAA,IAAiB;EAKpB,SAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EACH,KAAA,CAAA,EAAA,WAAA,GAAA,MAAA,GAAA,OAAA;EACA,OAAA,CAAA,EAAA,KAAA,GAAA,QAAA,GAAA,KAAA,GAAA,OAAA;EAEH,QAAA,CAAA,EAZK,MAYL,CAAA,MAAA,EAAA,OAAA,CAAA;;AACuB,UAVd,iBAAA,CAUc;EAGd,EAAA,EAAA,MAAA;EAKA,IAAA,EAAA,MAAA;EACL,OAAA,EAAA,MAAA;EACE,UAAA,EAAA,MAAA;EACK,UAAA,EAhBL,MAgBK,CAAA,MAAA,EAAA,OAAA,CAAA;EAEH,OAAA,EAjBL,iBAiBK,CAAA,SAAA,CAAA;EAAI,OAAA,EAhBT,qBAgBS;EAoBP,IAAA,CAAA,EAAA,MAAA,EAAA;EAOU,IAAA,EAzCf,aAyCe;EAWM,UAAA,EAnDf,iBAmDe;;AAYhB,UA5DI,wBAAA,CA4DJ;EACR,EAAA,EAAA,MAAA;EAAO,IAAA,CAAA,KAAA,EA3DE,iBA2DF,CAAA,EA3DsB,OA2DtB,CAAA,IAAA,CAAA;;UAxDK,uBAAA;YACL;cACE;mBACK;;gBAEH;;cAoBH,gBAAA;;;;;;uBAOU;6BAWM;;mDAWb,mCACH,wBACR"}

package/dist/telemetry/tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracker.js","names":["dispatch: TelemetryDispatch","result: Record<string, unknown>"],"sources":["../../src/telemetry/tracker.ts"],"sourcesContent":["import { randomUUID } from 'crypto';\nimport type { TelemetryAnomalyMonitor } from './anomaly';\nimport type {\n  TelemetryEventDef,\n  TelemetryRegistry,\n  TelemetrySamplingConfig,\n  TelemetrySpec,\n} from './spec';\n\nexport interface TelemetryEventContext {\n  tenantId?: string;\n  organizationId?: string | null;\n  userId?: string | null;\n  sessionId?: string | null;\n  actor?: 'anonymous' | 'user' | 'admin';\n  channel?: 'web' | 'mobile' | 'job' | 'agent';\n  metadata?: Record<string, unknown>;\n}\n\nexport interface TelemetryDispatch {\n  id: string;\n  name: string;\n  version: number;\n  occurredAt: string;\n  properties: Record<string, unknown>;\n  privacy: TelemetryEventDef['privacy'];\n  context: TelemetryEventContext;\n  tags?: string[];\n  spec: TelemetrySpec;\n  definition: TelemetryEventDef;\n}\n\nexport interface RuntimeTelemetryProvider {\n  id: string;\n  send(event: TelemetryDispatch): Promise<void>;\n}\n\nexport interface TelemetryTrackerOptions {\n  registry: TelemetryRegistry;\n  providers?: RuntimeTelemetryProvider[];\n  anomalyMonitor?: TelemetryAnomalyMonitor;\n  random?: () => number;\n  clock?: () => Date;\n}\n\nconst maskValue = (value: unknown) => {\n  if (value == null) return value;\n  if (typeof value === 'string') return 'REDACTED';\n  if (typeof value === 'number') return 0;\n  if (typeof value === 'boolean') return false;\n  if (Array.isArray(value)) return value.map(() => 'REDACTED');\n  if (typeof value === 'object') {\n    return Object.fromEntries(\n      Object.keys(value as Record<string, unknown>).map((key) => [key, 'REDACTED'])\n    );\n  }\n  return 'REDACTED';\n};\n\nexport class TelemetryTracker {\n  private readonly providers = new Map<string, RuntimeTelemetryProvider>();\n  private readonly registry: TelemetryRegistry;\n  private readonly anomalyMonitor?: TelemetryAnomalyMonitor;\n  private readonly random: () => number;\n  private readonly clock: () => Date;\n\n  constructor(options: TelemetryTrackerOptions) {\n    this.registry = options.registry;\n    this.anomalyMonitor = options.anomalyMonitor;\n    this.random = options.random ?? Math.random;\n    this.clock = options.clock ?? (() => new Date());\n\n    for (const provider of options.providers ?? []) {\n      this.providers.set(provider.id, provider);\n    }\n  }\n\n  registerProvider(provider: RuntimeTelemetryProvider) {\n    this.providers.set(provider.id, provider);\n  }\n\n  unregisterProvider(providerId: string) {\n    this.providers.delete(providerId);\n  }\n\n  async track(\n    name: string,\n    version: number,\n    properties: Record<string, unknown>,\n    context: TelemetryEventContext = {}\n  ): Promise<boolean> {\n    const definition = this.registry.findEventDef(name, version);\n    if (!definition) return false;\n\n    const spec = this.registry.getSpecForEvent(definition.name, definition.version);\n    if (!spec) return false;\n\n    if (!this.shouldSample(definition.sampling ?? spec.config?.defaultSamplingRate)) {\n      return false;\n    }\n\n    const redactedProperties = this.redactProperties(definition, properties);\n    const dispatch: TelemetryDispatch = {\n      id: randomUUID(),\n      name: definition.name,\n      version: definition.version,\n      occurredAt: this.clock().toISOString(),\n      properties: redactedProperties,\n      privacy: definition.privacy,\n      context,\n      tags: definition.tags,\n      spec,\n      definition,\n    };\n\n    await Promise.all(\n      [...this.providers.values()].map((provider) => provider.send(dispatch))\n    );\n\n    this.anomalyMonitor?.observe(dispatch);\n    return true;\n  }\n\n  private shouldSample(\n    sampling: TelemetrySamplingConfig | number | undefined\n  ): boolean {\n    if (typeof sampling === 'number') {\n      return this.random() < sampling;\n    }\n    if (!sampling) return true;\n    return this.random() < sampling.rate;\n  }\n\n  private redactProperties(\n    definition: TelemetryEventDef,\n    properties: Record<string, unknown>\n  ): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(properties)) {\n      const def = definition.properties[key];\n      if (!def) {\n        result[key] = value;\n        continue;\n      }\n      if (def.redact || def.pii || definition.privacy === 'sensitive') {\n        result[key] = maskValue(value);\n      } else {\n        result[key] = value;\n      }\n    }\n    return result;\n  }\n}\n\n"],"mappings":"oCA6CA,MAAM,EAAa,GACb,GAAS,KAAa,EACtB,OAAO,GAAU,SAAiB,WAClC,OAAO,GAAU,SAAiB,EAClC,OAAO,GAAU,UAAkB,GACnC,MAAM,QAAQ,EAAM,CAAS,EAAM,QAAU,WAAW,CACxD,OAAO,GAAU,SACZ,OAAO,YACZ,OAAO,KAAK,EAAiC,CAAC,IAAK,GAAQ,CAAC,EAAK,WAAW,CAAC,CAC9E,CAEI,WAGT,IAAa,EAAb,KAA8B,CAC5B,UAA6B,IAAI,IACjC,SACA,eACA,OACA,MAEA,YAAY,EAAkC,CAC5C,KAAK,SAAW,EAAQ,SACxB,KAAK,eAAiB,EAAQ,eAC9B,KAAK,OAAS,EAAQ,QAAU,KAAK,OACrC,KAAK,MAAQ,EAAQ,YAAgB,IAAI,MAEzC,IAAK,IAAM,KAAY,EAAQ,WAAa,EAAE,CAC5C,KAAK,UAAU,IAAI,EAAS,GAAI,EAAS,CAI7C,iBAAiB,EAAoC,CACnD,KAAK,UAAU,IAAI,EAAS,GAAI,EAAS,CAG3C,mBAAmB,EAAoB,CACrC,KAAK,UAAU,OAAO,EAAW,CAGnC,MAAM,MACJ,EACA,EACA,EACA,EAAiC,EAAE,CACjB,CAClB,IAAM,EAAa,KAAK,SAAS,aAAa,EAAM,EAAQ,CAC5D,GAAI,CAAC,EAAY,MAAO,GAExB,IAAM,EAAO,KAAK,SAAS,gBAAgB,EAAW,KAAM,EAAW,QAAQ,CAG/E,GAFI,CAAC,GAED,CAAC,KAAK,aAAa,EAAW,UAAY,EAAK,QAAQ,oBAAoB,CAC7E,MAAO,GAGT,IAAM,EAAqB,KAAK,iBAAiB,EAAY,EAAW,CAClEA,EAA8B,CAClC,GAAI,GAAY,CAChB,KAAM,EAAW,KACjB,QAAS,EAAW,QACpB,WAAY,KAAK,OAAO,CAAC,aAAa,CACtC,WAAY,EACZ,QAAS,EAAW,QACpB,UACA,KAAM,EAAW,KACjB,OACA,aACD,CAOD,OALA,MAAM,QAAQ,IACZ,CAAC,GAAG,KAAK,UAAU,QAAQ,CAAC,CAAC,IAAK,GAAa,EAAS,KAAK,EAAS,CAAC,CACxE,CAED,KAAK,gBAAgB,QAAQ,EAAS,CAC/B,GAGT,aACE,EACS,CAKT,OAJI,OAAO,GAAa,SACf,KAAK,QAAQ,CAAG,EAEpB,EACE,KAAK,QAAQ,CAAG,EAAS,KADV,GAIxB,iBACE,EACA,EACyB,CACzB,IAAMC,EAAkC,EAAE,CAC1C,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,EAAW,CAAE,CACrD,IAAM,EAAM,EAAW,WAAW,GAClC,GAAI,CAAC,EAAK,CACR,EAAO,GAAO,EACd,SAEE,EAAI,QAAU,EAAI,KAAO,EAAW,UAAY,YAClD,EAAO,GAAO,EAAU,EAAM,CAE9B,EAAO,GAAO,EAGlB,OAAO"}
+{"version":3,"file":"tracker.js","names":["dispatch: TelemetryDispatch","result: Record<string, unknown>"],"sources":["../../src/telemetry/tracker.ts"],"sourcesContent":["import { randomUUID } from 'crypto';\nimport type { TelemetryAnomalyMonitor } from './anomaly';\nimport type {\n  TelemetryEventDef,\n  TelemetryRegistry,\n  TelemetrySamplingConfig,\n  TelemetrySpec,\n} from './spec';\n\nexport interface TelemetryEventContext {\n  tenantId?: string;\n  organizationId?: string | null;\n  userId?: string | null;\n  sessionId?: string | null;\n  actor?: 'anonymous' | 'user' | 'admin';\n  channel?: 'web' | 'mobile' | 'job' | 'agent';\n  metadata?: Record<string, unknown>;\n}\n\nexport interface TelemetryDispatch {\n  id: string;\n  name: string;\n  version: number;\n  occurredAt: string;\n  properties: Record<string, unknown>;\n  privacy: TelemetryEventDef['privacy'];\n  context: TelemetryEventContext;\n  tags?: string[];\n  spec: TelemetrySpec;\n  definition: TelemetryEventDef;\n}\n\nexport interface RuntimeTelemetryProvider {\n  id: string;\n  send(event: TelemetryDispatch): Promise<void>;\n}\n\nexport interface TelemetryTrackerOptions {\n  registry: TelemetryRegistry;\n  providers?: RuntimeTelemetryProvider[];\n  anomalyMonitor?: TelemetryAnomalyMonitor;\n  random?: () => number;\n  clock?: () => Date;\n}\n\nconst maskValue = (value: unknown) => {\n  if (value == null) return value;\n  if (typeof value === 'string') return 'REDACTED';\n  if (typeof value === 'number') return 0;\n  if (typeof value === 'boolean') return false;\n  if (Array.isArray(value)) return value.map(() => 'REDACTED');\n  if (typeof value === 'object') {\n    return Object.fromEntries(\n      Object.keys(value as Record<string, unknown>).map((key) => [\n        key,\n        'REDACTED',\n      ])\n    );\n  }\n  return 'REDACTED';\n};\n\nexport class TelemetryTracker {\n  private readonly providers = new Map<string, RuntimeTelemetryProvider>();\n  private readonly registry: TelemetryRegistry;\n  private readonly anomalyMonitor?: TelemetryAnomalyMonitor;\n  private readonly random: () => number;\n  private readonly clock: () => Date;\n\n  constructor(options: TelemetryTrackerOptions) {\n    this.registry = options.registry;\n    this.anomalyMonitor = options.anomalyMonitor;\n    this.random = options.random ?? Math.random;\n    this.clock = options.clock ?? (() => new Date());\n\n    for (const provider of options.providers ?? []) {\n      this.providers.set(provider.id, provider);\n    }\n  }\n\n  registerProvider(provider: RuntimeTelemetryProvider) {\n    this.providers.set(provider.id, provider);\n  }\n\n  unregisterProvider(providerId: string) {\n    this.providers.delete(providerId);\n  }\n\n  async track(\n    name: string,\n    version: number,\n    properties: Record<string, unknown>,\n    context: TelemetryEventContext = {}\n  ): Promise<boolean> {\n    const definition = this.registry.findEventDef(name, version);\n    if (!definition) return false;\n\n    const spec = this.registry.getSpecForEvent(\n      definition.name,\n      definition.version\n    );\n    if (!spec) return false;\n\n    if (\n      !this.shouldSample(\n        definition.sampling ?? spec.config?.defaultSamplingRate\n      )\n    ) {\n      return false;\n    }\n\n    const redactedProperties = this.redactProperties(definition, properties);\n    const dispatch: TelemetryDispatch = {\n      id: randomUUID(),\n      name: definition.name,\n      version: definition.version,\n      occurredAt: this.clock().toISOString(),\n      properties: redactedProperties,\n      privacy: definition.privacy,\n      context,\n      tags: definition.tags,\n      spec,\n      definition,\n    };\n\n    await Promise.all(\n      [...this.providers.values()].map((provider) => provider.send(dispatch))\n    );\n\n    this.anomalyMonitor?.observe(dispatch);\n    return true;\n  }\n\n  private shouldSample(\n    sampling: TelemetrySamplingConfig | number | undefined\n  ): boolean {\n    if (typeof sampling === 'number') {\n      return this.random() < sampling;\n    }\n    if (!sampling) return true;\n    return this.random() < sampling.rate;\n  }\n\n  private redactProperties(\n    definition: TelemetryEventDef,\n    properties: Record<string, unknown>\n  ): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(properties)) {\n      const def = definition.properties[key];\n      if (!def) {\n        result[key] = value;\n        continue;\n      }\n      if (def.redact || def.pii || definition.privacy === 'sensitive') {\n        result[key] = maskValue(value);\n      } else {\n        result[key] = value;\n      }\n    }\n    return result;\n  }\n}\n"],"mappings":"oCA6CA,MAAM,EAAa,GACb,GAAS,KAAa,EACtB,OAAO,GAAU,SAAiB,WAClC,OAAO,GAAU,SAAiB,EAClC,OAAO,GAAU,UAAkB,GACnC,MAAM,QAAQ,EAAM,CAAS,EAAM,QAAU,WAAW,CACxD,OAAO,GAAU,SACZ,OAAO,YACZ,OAAO,KAAK,EAAiC,CAAC,IAAK,GAAQ,CACzD,EACA,WACD,CAAC,CACH,CAEI,WAGT,IAAa,EAAb,KAA8B,CAC5B,UAA6B,IAAI,IACjC,SACA,eACA,OACA,MAEA,YAAY,EAAkC,CAC5C,KAAK,SAAW,EAAQ,SACxB,KAAK,eAAiB,EAAQ,eAC9B,KAAK,OAAS,EAAQ,QAAU,KAAK,OACrC,KAAK,MAAQ,EAAQ,YAAgB,IAAI,MAEzC,IAAK,IAAM,KAAY,EAAQ,WAAa,EAAE,CAC5C,KAAK,UAAU,IAAI,EAAS,GAAI,EAAS,CAI7C,iBAAiB,EAAoC,CACnD,KAAK,UAAU,IAAI,EAAS,GAAI,EAAS,CAG3C,mBAAmB,EAAoB,CACrC,KAAK,UAAU,OAAO,EAAW,CAGnC,MAAM,MACJ,EACA,EACA,EACA,EAAiC,EAAE,CACjB,CAClB,IAAM,EAAa,KAAK,SAAS,aAAa,EAAM,EAAQ,CAC5D,GAAI,CAAC,EAAY,MAAO,GAExB,IAAM,EAAO,KAAK,SAAS,gBACzB,EAAW,KACX,EAAW,QACZ,CAGD,GAFI,CAAC,GAGH,CAAC,KAAK,aACJ,EAAW,UAAY,EAAK,QAAQ,oBACrC,CAED,MAAO,GAGT,IAAM,EAAqB,KAAK,iBAAiB,EAAY,EAAW,CAClEA,EAA8B,CAClC,GAAI,GAAY,CAChB,KAAM,EAAW,KACjB,QAAS,EAAW,QACpB,WAAY,KAAK,OAAO,CAAC,aAAa,CACtC,WAAY,EACZ,QAAS,EAAW,QACpB,UACA,KAAM,EAAW,KACjB,OACA,aACD,CAOD,OALA,MAAM,QAAQ,IACZ,CAAC,GAAG,KAAK,UAAU,QAAQ,CAAC,CAAC,IAAK,GAAa,EAAS,KAAK,EAAS,CAAC,CACxE,CAED,KAAK,gBAAgB,QAAQ,EAAS,CAC/B,GAGT,aACE,EACS,CAKT,OAJI,OAAO,GAAa,SACf,KAAK,QAAQ,CAAG,EAEpB,EACE,KAAK,QAAQ,CAAG,EAAS,KADV,GAIxB,iBACE,EACA,EACyB,CACzB,IAAMC,EAAkC,EAAE,CAC1C,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,EAAW,CAAE,CACrD,IAAM,EAAM,EAAW,WAAW,GAClC,GAAI,CAAC,EAAK,CACR,EAAO,GAAO,EACd,SAEE,EAAI,QAAU,EAAI,KAAO,EAAW,UAAY,YAClD,EAAO,GAAO,EAAU,EAAM,CAE9B,EAAO,GAAO,EAGlB,OAAO"}

package/dist/tests/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":["config: TestRunnerConfig","scenarios: ScenarioRunResult[]","assertionResults: AssertionResult[]","events: RecordedEvent[]","ctx: HandlerCtx","failures: string[]"],"sources":["../../src/tests/runner.ts"],"sourcesContent":["import { deepStrictEqual } from 'node:assert';\nimport { SpecRegistry } from '../index';\nimport type { HandlerCtx } from '../types';\nimport type {\n  Action,\n  Assertion,\n  ExpectErrorAssertion,\n  ExpectEventsAssertion,\n  ExpectOutputAssertion,\n  Fixture,\n  TestScenario,\n  TestSpec,\n} from './spec';\n\nexport interface ScenarioRunResult {\n  scenario: TestScenario;\n  status: 'passed' | 'failed';\n  error?: Error;\n  assertionResults: AssertionResult[];\n}\n\nexport interface AssertionResult {\n  assertion: Assertion;\n  status: 'passed' | 'failed';\n  message?: string;\n}\n\nexport interface TestRunResult {\n  spec: TestSpec;\n  scenarios: ScenarioRunResult[];\n  passed: number;\n  failed: number;\n}\n\nexport interface TestRunnerConfig {\n  registry: SpecRegistry;\n  createContext?: () => HandlerCtx | Promise<HandlerCtx>;\n  beforeEach?: (scenario: TestScenario) => void | Promise<void>;\n  afterEach?: (\n    scenario: TestScenario,\n    result: ScenarioRunResult\n  ) => void | Promise<void>;\n}\n\ninterface OperationResult {\n  output?: unknown;\n  error?: Error;\n  events: RecordedEvent[];\n}\n\ninterface RecordedEvent {\n  name: string;\n  version: number;\n  payload: unknown;\n}\n\nexport class TestRunner {\n  constructor(private readonly config: TestRunnerConfig) {}\n\n  async run(spec: TestSpec): Promise<TestRunResult> {\n    const scenarios: ScenarioRunResult[] = [];\n    let passed = 0;\n    let failed = 0;\n\n    for (const scenario of spec.scenarios) {\n      await this.config.beforeEach?.(scenario);\n\n      const result = await this.runScenario(spec, scenario);\n      scenarios.push(result);\n      if (result.status === 'passed') passed += 1;\n      else failed += 1;\n\n      await this.config.afterEach?.(scenario, result);\n    }\n\n    return {\n      spec,\n      scenarios,\n      passed,\n      failed,\n    };\n  }\n\n  private async runScenario(\n    spec: TestSpec,\n    scenario: TestScenario\n  ): Promise<ScenarioRunResult> {\n    const assertionResults: AssertionResult[] = [];\n\n    try {\n      const context = await this.createContext();\n      const fixtures = [...(spec.fixtures ?? []), ...(scenario.given ?? [])];\n      const events: RecordedEvent[] = [];\n\n      for (const fixture of fixtures) {\n        await this.executeOperation(fixture, context, events);\n      }\n\n      const actionResult = await this.executeOperation(\n        scenario.when,\n        context,\n        events\n      );\n\n      const assertions = scenario.then ?? [];\n      for (const assertion of assertions) {\n        const assertionResult = this.evaluateAssertion(\n          assertion,\n          actionResult,\n          events\n        );\n        assertionResults.push(assertionResult);\n      }\n\n      const hasFailure = assertionResults.some(\n        (assertion) => assertion.status === 'failed'\n      );\n      return {\n        scenario,\n        status: hasFailure ? 'failed' : 'passed',\n        assertionResults,\n      };\n    } catch (error) {\n      return {\n        scenario,\n        status: 'failed',\n        error: error as Error,\n        assertionResults,\n      };\n    }\n  }\n\n  private async createContext(): Promise<HandlerCtx> {\n    const baseCtx = (await this.config.createContext?.()) ?? {};\n    return { ...baseCtx };\n  }\n\n  private async executeOperation(\n    action: Action | Fixture,\n    baseCtx: HandlerCtx,\n    recordedEvents: RecordedEvent[]\n  ): Promise<OperationResult> {\n    const ctx: HandlerCtx = {\n      ...baseCtx,\n      eventPublisher: async (event) => {\n        recordedEvents.push({\n          name: event.name,\n          version: event.version,\n          payload: event.payload,\n        });\n        await baseCtx.eventPublisher?.(event);\n      },\n    };\n\n    try {\n      const output = await this.config.registry.execute(\n        action.operation.name,\n        action.operation.version,\n        action.input ?? null,\n        ctx\n      );\n      return { output, events: recordedEvents };\n    } catch (error) {\n      return { error: error as Error, events: recordedEvents };\n    }\n  }\n\n  private evaluateAssertion(\n    assertion: Assertion,\n    result: OperationResult,\n    events: RecordedEvent[]\n  ): AssertionResult {\n    switch (assertion.type) {\n      case 'expectOutput':\n        return this.evaluateOutputAssertion(assertion, result);\n      case 'expectError':\n        return this.evaluateErrorAssertion(assertion, result);\n      case 'expectEvents':\n        return this.evaluateEventsAssertion(assertion, events);\n      default:\n        return {\n          assertion,\n          status: 'failed',\n          message: `Unknown assertion type ${(assertion as Assertion).type}`,\n        };\n    }\n  }\n\n  private evaluateOutputAssertion(\n    assertion: ExpectOutputAssertion,\n    result: OperationResult\n  ): AssertionResult {\n    if (result.error) {\n      return {\n        assertion,\n        status: 'failed',\n        message: `Expected output but operation threw error: ${result.error.message}`,\n      };\n    }\n    try {\n      deepStrictEqual(result.output, assertion.match);\n      return { assertion, status: 'passed' };\n    } catch (error) {\n      return {\n        assertion,\n        status: 'failed',\n        message:\n          error instanceof Error ? error.message : 'Output assertion failed',\n      };\n    }\n  }\n\n  private evaluateErrorAssertion(\n    assertion: ExpectErrorAssertion,\n    result: OperationResult\n  ): AssertionResult {\n    if (!result.error) {\n      return {\n        assertion,\n        status: 'failed',\n        message: 'Expected an error but operation completed successfully',\n      };\n    }\n    if (\n      assertion.messageIncludes &&\n      !result.error.message.includes(assertion.messageIncludes)\n    ) {\n      return {\n        assertion,\n        status: 'failed',\n        message: `Error message \"${result.error.message}\" did not include expected substring \"${assertion.messageIncludes}\"`,\n      };\n    }\n    return { assertion, status: 'passed' };\n  }\n\n  private evaluateEventsAssertion(\n    assertion: ExpectEventsAssertion,\n    events: RecordedEvent[]\n  ): AssertionResult {\n    const failures: string[] = [];\n\n    for (const expected of assertion.events) {\n      const matches = events.filter(\n        (event) =>\n          event.name === expected.name && event.version === expected.version\n      );\n      const count = matches.length;\n      if (\n        (typeof expected.min === 'number' && count < expected.min) ||\n        (typeof expected.max === 'number' && count > expected.max)\n      ) {\n        failures.push(\n          `Event ${expected.name}.v${expected.version} occurred ${count} times (expected ${expected.min ?? 0} - ${expected.max ?? '∞'})`\n        );\n      } else if (\n        typeof expected.min === 'undefined' &&\n        typeof expected.max === 'undefined' &&\n        count === 0\n      ) {\n        failures.push(\n          `Event ${expected.name}.v${expected.version} did not occur`\n        );\n      }\n    }\n\n    if (failures.length > 0) {\n      return {\n        assertion,\n        status: 'failed',\n        message: failures.join('; '),\n      };\n    }\n    return { assertion, status: 'passed' };\n  }\n}\n\n"],"mappings":"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"}
+{"version":3,"file":"runner.js","names":["config: TestRunnerConfig","scenarios: ScenarioRunResult[]","assertionResults: AssertionResult[]","events: RecordedEvent[]","ctx: HandlerCtx","failures: string[]"],"sources":["../../src/tests/runner.ts"],"sourcesContent":["import { deepStrictEqual } from 'node:assert';\nimport { SpecRegistry } from '../index';\nimport type { HandlerCtx } from '../types';\nimport type {\n  Action,\n  Assertion,\n  ExpectErrorAssertion,\n  ExpectEventsAssertion,\n  ExpectOutputAssertion,\n  Fixture,\n  TestScenario,\n  TestSpec,\n} from './spec';\n\nexport interface ScenarioRunResult {\n  scenario: TestScenario;\n  status: 'passed' | 'failed';\n  error?: Error;\n  assertionResults: AssertionResult[];\n}\n\nexport interface AssertionResult {\n  assertion: Assertion;\n  status: 'passed' | 'failed';\n  message?: string;\n}\n\nexport interface TestRunResult {\n  spec: TestSpec;\n  scenarios: ScenarioRunResult[];\n  passed: number;\n  failed: number;\n}\n\nexport interface TestRunnerConfig {\n  registry: SpecRegistry;\n  createContext?: () => HandlerCtx | Promise<HandlerCtx>;\n  beforeEach?: (scenario: TestScenario) => void | Promise<void>;\n  afterEach?: (\n    scenario: TestScenario,\n    result: ScenarioRunResult\n  ) => void | Promise<void>;\n}\n\ninterface OperationResult {\n  output?: unknown;\n  error?: Error;\n  events: RecordedEvent[];\n}\n\ninterface RecordedEvent {\n  name: string;\n  version: number;\n  payload: unknown;\n}\n\nexport class TestRunner {\n  constructor(private readonly config: TestRunnerConfig) {}\n\n  async run(spec: TestSpec): Promise<TestRunResult> {\n    const scenarios: ScenarioRunResult[] = [];\n    let passed = 0;\n    let failed = 0;\n\n    for (const scenario of spec.scenarios) {\n      await this.config.beforeEach?.(scenario);\n\n      const result = await this.runScenario(spec, scenario);\n      scenarios.push(result);\n      if (result.status === 'passed') passed += 1;\n      else failed += 1;\n\n      await this.config.afterEach?.(scenario, result);\n    }\n\n    return {\n      spec,\n      scenarios,\n      passed,\n      failed,\n    };\n  }\n\n  private async runScenario(\n    spec: TestSpec,\n    scenario: TestScenario\n  ): Promise<ScenarioRunResult> {\n    const assertionResults: AssertionResult[] = [];\n\n    try {\n      const context = await this.createContext();\n      const fixtures = [...(spec.fixtures ?? []), ...(scenario.given ?? [])];\n      const events: RecordedEvent[] = [];\n\n      for (const fixture of fixtures) {\n        await this.executeOperation(fixture, context, events);\n      }\n\n      const actionResult = await this.executeOperation(\n        scenario.when,\n        context,\n        events\n      );\n\n      const assertions = scenario.then ?? [];\n      for (const assertion of assertions) {\n        const assertionResult = this.evaluateAssertion(\n          assertion,\n          actionResult,\n          events\n        );\n        assertionResults.push(assertionResult);\n      }\n\n      const hasFailure = assertionResults.some(\n        (assertion) => assertion.status === 'failed'\n      );\n      return {\n        scenario,\n        status: hasFailure ? 'failed' : 'passed',\n        assertionResults,\n      };\n    } catch (error) {\n      return {\n        scenario,\n        status: 'failed',\n        error: error as Error,\n        assertionResults,\n      };\n    }\n  }\n\n  private async createContext(): Promise<HandlerCtx> {\n    const baseCtx = (await this.config.createContext?.()) ?? {};\n    return { ...baseCtx };\n  }\n\n  private async executeOperation(\n    action: Action | Fixture,\n    baseCtx: HandlerCtx,\n    recordedEvents: RecordedEvent[]\n  ): Promise<OperationResult> {\n    const ctx: HandlerCtx = {\n      ...baseCtx,\n      eventPublisher: async (event) => {\n        recordedEvents.push({\n          name: event.name,\n          version: event.version,\n          payload: event.payload,\n        });\n        await baseCtx.eventPublisher?.(event);\n      },\n    };\n\n    try {\n      const output = await this.config.registry.execute(\n        action.operation.name,\n        action.operation.version,\n        action.input ?? null,\n        ctx\n      );\n      return { output, events: recordedEvents };\n    } catch (error) {\n      return { error: error as Error, events: recordedEvents };\n    }\n  }\n\n  private evaluateAssertion(\n    assertion: Assertion,\n    result: OperationResult,\n    events: RecordedEvent[]\n  ): AssertionResult {\n    switch (assertion.type) {\n      case 'expectOutput':\n        return this.evaluateOutputAssertion(assertion, result);\n      case 'expectError':\n        return this.evaluateErrorAssertion(assertion, result);\n      case 'expectEvents':\n        return this.evaluateEventsAssertion(assertion, events);\n      default:\n        return {\n          assertion,\n          status: 'failed',\n          message: `Unknown assertion type ${(assertion as Assertion).type}`,\n        };\n    }\n  }\n\n  private evaluateOutputAssertion(\n    assertion: ExpectOutputAssertion,\n    result: OperationResult\n  ): AssertionResult {\n    if (result.error) {\n      return {\n        assertion,\n        status: 'failed',\n        message: `Expected output but operation threw error: ${result.error.message}`,\n      };\n    }\n    try {\n      deepStrictEqual(result.output, assertion.match);\n      return { assertion, status: 'passed' };\n    } catch (error) {\n      return {\n        assertion,\n        status: 'failed',\n        message:\n          error instanceof Error ? error.message : 'Output assertion failed',\n      };\n    }\n  }\n\n  private evaluateErrorAssertion(\n    assertion: ExpectErrorAssertion,\n    result: OperationResult\n  ): AssertionResult {\n    if (!result.error) {\n      return {\n        assertion,\n        status: 'failed',\n        message: 'Expected an error but operation completed successfully',\n      };\n    }\n    if (\n      assertion.messageIncludes &&\n      !result.error.message.includes(assertion.messageIncludes)\n    ) {\n      return {\n        assertion,\n        status: 'failed',\n        message: `Error message \"${result.error.message}\" did not include expected substring \"${assertion.messageIncludes}\"`,\n      };\n    }\n    return { assertion, status: 'passed' };\n  }\n\n  private evaluateEventsAssertion(\n    assertion: ExpectEventsAssertion,\n    events: RecordedEvent[]\n  ): AssertionResult {\n    const failures: string[] = [];\n\n    for (const expected of assertion.events) {\n      const matches = events.filter(\n        (event) =>\n          event.name === expected.name && event.version === expected.version\n      );\n      const count = matches.length;\n      if (\n        (typeof expected.min === 'number' && count < expected.min) ||\n        (typeof expected.max === 'number' && count > expected.max)\n      ) {\n        failures.push(\n          `Event ${expected.name}.v${expected.version} occurred ${count} times (expected ${expected.min ?? 0} - ${expected.max ?? '∞'})`\n        );\n      } else if (\n        typeof expected.min === 'undefined' &&\n        typeof expected.max === 'undefined' &&\n        count === 0\n      ) {\n        failures.push(\n          `Event ${expected.name}.v${expected.version} did not occur`\n        );\n      }\n    }\n\n    if (failures.length > 0) {\n      return {\n        assertion,\n        status: 'failed',\n        message: failures.join('; '),\n      };\n    }\n    return { assertion, status: 'passed' };\n  }\n}\n"],"mappings":"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"}

package/dist/tests/spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.js","names":["latest: TestSpec | undefined"],"sources":["../../src/tests/spec.ts"],"sourcesContent":["import type { Owner, Stability, Tag } from '../ownership';\n\nexport interface OperationTargetRef {\n  name: string;\n  version?: number;\n}\n\nexport interface WorkflowTargetRef {\n  name: string;\n  version?: number;\n}\n\nexport type TestTarget =\n  | { type: 'contract'; operation: OperationTargetRef }\n  | { type: 'workflow'; workflow: WorkflowTargetRef };\n\nexport interface Fixture {\n  description?: string;\n  operation: OperationTargetRef;\n  input?: unknown;\n}\n\nexport interface Action {\n  operation: OperationTargetRef;\n  input?: unknown;\n}\n\nexport interface ExpectOutputAssertion {\n  type: 'expectOutput';\n  match: unknown;\n}\n\nexport interface ExpectErrorAssertion {\n  type: 'expectError';\n  messageIncludes?: string;\n}\n\nexport interface ExpectedEvent {\n  name: string;\n  version: number;\n  min?: number;\n  max?: number;\n}\n\nexport interface ExpectEventsAssertion {\n  type: 'expectEvents';\n  events: ExpectedEvent[];\n}\n\nexport type Assertion =\n  | ExpectOutputAssertion\n  | ExpectErrorAssertion\n  | ExpectEventsAssertion;\n\nexport interface TestScenario {\n  name: string;\n  description?: string;\n  given?: Fixture[];\n  when: Action;\n  then?: Assertion[];\n}\n\nexport interface CoverageRequirement {\n  statements?: number;\n  branches?: number;\n  functions?: number;\n  lines?: number;\n  mutations?: number;\n}\n\nexport interface TestSpecMeta {\n  name: string;\n  version: number;\n  title: string;\n  description?: string;\n  owners: Owner[];\n  tags: Tag[];\n  stability: Stability;\n}\n\nexport interface TestSpec {\n  meta: TestSpecMeta;\n  target: TestTarget;\n  fixtures?: Fixture[];\n  scenarios: TestScenario[];\n  coverage?: CoverageRequirement;\n}\n\nexport interface TestSpecRef {\n  name: string;\n  version?: number;\n}\n\nconst testKey = (meta: TestSpecMeta) => `${meta.name}.v${meta.version}`;\n\nexport class TestRegistry {\n  private readonly items = new Map<string, TestSpec>();\n\n  register(spec: TestSpec): this {\n    const key = testKey(spec.meta);\n    if (this.items.has(key)) {\n      throw new Error(`Duplicate TestSpec registration for ${key}`);\n    }\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): TestSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): TestSpec | undefined {\n    if (version != null) {\n      return this.items.get(`${name}.v${version}`);\n    }\n    let latest: TestSpec | undefined;\n    let maxVersion = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.name !== name) continue;\n      if (spec.meta.version > maxVersion) {\n        maxVersion = spec.meta.version;\n        latest = spec;\n      }\n    }\n    return latest;\n  }\n}\n\nexport function makeTestKey(meta: TestSpecMeta) {\n  return testKey(meta);\n}\n\n"],"mappings":"AA6FA,MAAM,EAAW,GAAuB,GAAG,EAAK,KAAK,IAAI,EAAK,UAE9D,IAAa,EAAb,KAA0B,CACxB,MAAyB,IAAI,IAE7B,SAAS,EAAsB,CAC7B,IAAM,EAAM,EAAQ,EAAK,KAAK,CAC9B,GAAI,KAAK,MAAM,IAAI,EAAI,CACrB,MAAU,MAAM,uCAAuC,IAAM,CAG/D,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAAmB,CACjB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAc,EAAwC,CACxD,GAAI,GAAW,KACb,OAAO,KAAK,MAAM,IAAI,GAAG,EAAK,IAAI,IAAU,CAE9C,IAAIA,EACA,EAAa,KACjB,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAa,EAAK,KAAK,QACvB,EAAS,GAGb,OAAO,IAIX,SAAgB,EAAY,EAAoB,CAC9C,OAAO,EAAQ,EAAK"}
+{"version":3,"file":"spec.js","names":["latest: TestSpec | undefined"],"sources":["../../src/tests/spec.ts"],"sourcesContent":["import type { Owner, Stability, Tag } from '../ownership';\n\nexport interface OperationTargetRef {\n  name: string;\n  version?: number;\n}\n\nexport interface WorkflowTargetRef {\n  name: string;\n  version?: number;\n}\n\nexport type TestTarget =\n  | { type: 'contract'; operation: OperationTargetRef }\n  | { type: 'workflow'; workflow: WorkflowTargetRef };\n\nexport interface Fixture {\n  description?: string;\n  operation: OperationTargetRef;\n  input?: unknown;\n}\n\nexport interface Action {\n  operation: OperationTargetRef;\n  input?: unknown;\n}\n\nexport interface ExpectOutputAssertion {\n  type: 'expectOutput';\n  match: unknown;\n}\n\nexport interface ExpectErrorAssertion {\n  type: 'expectError';\n  messageIncludes?: string;\n}\n\nexport interface ExpectedEvent {\n  name: string;\n  version: number;\n  min?: number;\n  max?: number;\n}\n\nexport interface ExpectEventsAssertion {\n  type: 'expectEvents';\n  events: ExpectedEvent[];\n}\n\nexport type Assertion =\n  | ExpectOutputAssertion\n  | ExpectErrorAssertion\n  | ExpectEventsAssertion;\n\nexport interface TestScenario {\n  name: string;\n  description?: string;\n  given?: Fixture[];\n  when: Action;\n  then?: Assertion[];\n}\n\nexport interface CoverageRequirement {\n  statements?: number;\n  branches?: number;\n  functions?: number;\n  lines?: number;\n  mutations?: number;\n}\n\nexport interface TestSpecMeta {\n  name: string;\n  version: number;\n  title: string;\n  description?: string;\n  owners: Owner[];\n  tags: Tag[];\n  stability: Stability;\n}\n\nexport interface TestSpec {\n  meta: TestSpecMeta;\n  target: TestTarget;\n  fixtures?: Fixture[];\n  scenarios: TestScenario[];\n  coverage?: CoverageRequirement;\n}\n\nexport interface TestSpecRef {\n  name: string;\n  version?: number;\n}\n\nconst testKey = (meta: TestSpecMeta) => `${meta.name}.v${meta.version}`;\n\nexport class TestRegistry {\n  private readonly items = new Map<string, TestSpec>();\n\n  register(spec: TestSpec): this {\n    const key = testKey(spec.meta);\n    if (this.items.has(key)) {\n      throw new Error(`Duplicate TestSpec registration for ${key}`);\n    }\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): TestSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): TestSpec | undefined {\n    if (version != null) {\n      return this.items.get(`${name}.v${version}`);\n    }\n    let latest: TestSpec | undefined;\n    let maxVersion = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.name !== name) continue;\n      if (spec.meta.version > maxVersion) {\n        maxVersion = spec.meta.version;\n        latest = spec;\n      }\n    }\n    return latest;\n  }\n}\n\nexport function makeTestKey(meta: TestSpecMeta) {\n  return testKey(meta);\n}\n"],"mappings":"AA6FA,MAAM,EAAW,GAAuB,GAAG,EAAK,KAAK,IAAI,EAAK,UAE9D,IAAa,EAAb,KAA0B,CACxB,MAAyB,IAAI,IAE7B,SAAS,EAAsB,CAC7B,IAAM,EAAM,EAAQ,EAAK,KAAK,CAC9B,GAAI,KAAK,MAAM,IAAI,EAAI,CACrB,MAAU,MAAM,uCAAuC,IAAM,CAG/D,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAAmB,CACjB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAc,EAAwC,CACxD,GAAI,GAAW,KACb,OAAO,KAAK,MAAM,IAAI,GAAG,EAAK,IAAI,IAAU,CAE9C,IAAIA,EACA,EAAa,KACjB,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAa,EAAK,KAAK,QACvB,EAAS,GAGb,OAAO,IAIX,SAAgB,EAAY,EAAoB,CAC9C,OAAO,EAAQ,EAAK"}

package/dist/themes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themes.d.ts","names":[],"sources":["../src/themes.ts"],"sourcesContent":[],"mappings":";;;KAEY,UAAA;UAEK;EAFL,KAAA,EAGH,CAHG;EAEK,WAAA,CAAA,EAAU,MAAA;AAK3B;AAC0B,UADT,WAAA,CACS;EAAf,MAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAe,UAAf,CAAA,MAAA,CAAA,CAAA;EACc,KAAA,CAAA,EAAf,MAAe,CAAA,MAAA,EAAA,UAAA,CAAA,MAAA,CAAA,CAAA;EAAf,KAAA,CAAA,EACA,MADA,CAAA,MAAA,EACe,UADf,CAAA,MAAA,CAAA,CAAA;EACe,UAAA,CAAA,EACV,MADU,CAAA,MAAA,EACK,UADL,CAAA,MAAA,CAAA,CAAA;EAAf,OAAA,CAAA,EAEE,MAFF,CAAA,MAAA,EAEiB,UAFjB,CAAA,MAAA,CAAA,CAAA;EACoB,MAAA,CAAA,EAEnB,MAFmB,CAAA,MAAA,EAEJ,UAFI,CAAA,MAAA,CAAA,CAAA;;AACH,UAIV,0BAAA,CAJU;EAAf,KAAA,CAAA,EAKF,MALE,CAAA,MAAA,EAAA,OAAA,CAAA;EACc,MAAA,CAAA,EAKf,WALe;;AAAT,UAQA,oBAAA,CARA;EAGA,SAAA,EAAA,MAAA;EAKA,QAAA,EAEL,MAFK,CAAA,MAAoB,EAEV,0BAAA,CAAA;AAG3B;AACS,UADQ,aAAA,CACR;EAEE,KAAA,EAFF,UAEE;EACI,MAAA,EAAA,MAAA;EAAoB,MAAA,CAAA,EADxB,WACwB;EAGlB,UAAA,CAAA,EAHF,oBAGY,EAAA;;AAIhB,UAJM,SAAA,SAAkB,aAIxB,CAAA;EAJwB,IAAA,EAAA,MAAA;EAAa,OAAA,EAAA,MAAA;EAO/B,OAAA,CAAA,EAJL,QAIc;EAClB,MAAA,CAAA,EAJG,UAIH,EAAA;;AAEO,UAHE,SAAA,CAGF;EACD,IAAA,EAHN,SAGM;EAAa,MAAA,EAFjB,WAEiB;EAGV,UAAA,CAAQ,EAJV,oBAIU,EAAA;EAQZ,SAAA,CAAA,EAXC,aAWY,EAAA;;AAWhB,UAnBO,QAAA,CAmBP;EAI6B,IAAA,EAAA,MAAA;EAAS,OAAA,EAAA,MAAA;AAehD;cA9Ba,aAAA;;iBAGI;UAQP;uCAI6B;;iBAevB,YAAA,OAAmB,YAAY"}
+{"version":3,"file":"themes.d.ts","names":[],"sources":["../src/themes.ts"],"sourcesContent":[],"mappings":";;;KAEY,UAAA;UAEK;EAFL,KAAA,EAGH,CAHG;EAEK,WAAA,CAAA,EAAU,MAAA;AAK3B;AAC0B,UADT,WAAA,CACS;EAAf,MAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAe,UAAf,CAAA,MAAA,CAAA,CAAA;EACc,KAAA,CAAA,EAAf,MAAe,CAAA,MAAA,EAAA,UAAA,CAAA,MAAA,CAAA,CAAA;EAAf,KAAA,CAAA,EACA,MADA,CAAA,MAAA,EACe,UADf,CAAA,MAAA,CAAA,CAAA;EACe,UAAA,CAAA,EACV,MADU,CAAA,MAAA,EACK,UADL,CAAA,MAAA,CAAA,CAAA;EAAf,OAAA,CAAA,EAEE,MAFF,CAAA,MAAA,EAEiB,UAFjB,CAAA,MAAA,CAAA,CAAA;EACoB,MAAA,CAAA,EAEnB,MAFmB,CAAA,MAAA,EAEJ,UAFI,CAAA,MAAA,CAAA,CAAA;;AACH,UAIV,0BAAA,CAJU;EAAf,KAAA,CAAA,EAKF,MALE,CAAA,MAAA,EAAA,OAAA,CAAA;EACc,MAAA,CAAA,EAKf,WALe;;AAAT,UAQA,oBAAA,CARA;EAGA,SAAA,EAAA,MAAA;EAKA,QAAA,EAEL,MAFK,CAAA,MAAoB,EAEV,0BAAA,CAAA;AAG3B;AACS,UADQ,aAAA,CACR;EAEE,KAAA,EAFF,UAEE;EACI,MAAA,EAAA,MAAA;EAAoB,MAAA,CAAA,EADxB,WACwB;EAGlB,UAAA,CAAA,EAHF,oBAGY,EAAA;;AAIhB,UAJM,SAAA,SAAkB,aAIxB,CAAA;EAJwB,IAAA,EAAA,MAAA;EAAa,OAAA,EAAA,MAAA;EAO/B,OAAA,CAAA,EAJL,QAIc;EAClB,MAAA,CAAA,EAJG,UAIH,EAAA;;AAEO,UAHE,SAAA,CAGF;EACD,IAAA,EAHN,SAGM;EAAa,MAAA,EAFjB,WAEiB;EAGV,UAAA,CAAQ,EAJV,oBAIU,EAAA;EAOZ,SAAA,CAAA,EAVC,aAUY,EAAA;;AAUhB,UAjBO,QAAA,CAiBP;EAI6B,IAAA,EAAA,MAAA;EAAS,OAAA,EAAA,MAAA;AAehD;cA7Ba,aAAA;;iBAGI;UAOP;uCAI6B;;iBAevB,YAAA,OAAmB,YAAY"}

package/dist/themes.js.map

@@ -1 +1 @@
-{"version":3,"file":"themes.js","names":["candidate: ThemeSpec | undefined"],"sources":["../src/themes.ts"],"sourcesContent":["import type { OwnerShipMeta } from './ownership';\n\nexport type ThemeScope = 'global' | 'tenant' | 'user';\n\nexport interface ThemeToken<T> {\n  value: T;\n  description?: string;\n}\n\nexport interface ThemeTokens {\n  colors?: Record<string, ThemeToken<string>>;\n  radii?: Record<string, ThemeToken<number>>;\n  space?: Record<string, ThemeToken<number>>;\n  typography?: Record<string, ThemeToken<number>>;\n  shadows?: Record<string, ThemeToken<string>>;\n  motion?: Record<string, ThemeToken<string>>;\n}\n\nexport interface ComponentVariantDefinition {\n  props?: Record<string, unknown>;\n  tokens?: ThemeTokens;\n}\n\nexport interface ComponentVariantSpec {\n  component: string;\n  variants: Record<string, ComponentVariantDefinition>;\n}\n\nexport interface ThemeOverride {\n  scope: ThemeScope;\n  target: string;\n  tokens?: ThemeTokens;\n  components?: ComponentVariantSpec[];\n}\n\nexport interface ThemeMeta extends OwnerShipMeta {\n  name: string;\n  version: number;\n  extends?: ThemeRef;\n  scopes?: ThemeScope[];\n}\n\nexport interface ThemeSpec {\n  meta: ThemeMeta;\n  tokens: ThemeTokens;\n  components?: ComponentVariantSpec[];\n  overrides?: ThemeOverride[];\n}\n\nexport interface ThemeRef {\n  name: string;\n  version: number;\n}\n\nconst themeKey = (ref: ThemeRef | ThemeMeta) =>\n  `${ref.name}.v${ref.version}`;\n\nexport class ThemeRegistry {\n  private readonly items = new Map<string, ThemeSpec>();\n\n  register(spec: ThemeSpec): this {\n    const key = themeKey(spec.meta);\n    if (this.items.has(key))\n      throw new Error(`Duplicate theme ${key}`);\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): ThemeSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): ThemeSpec | undefined {\n    if (version != null) return this.items.get(themeKey({ name, version }));\n    let candidate: ThemeSpec | undefined;\n    let max = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.name !== name) continue;\n      if (spec.meta.version > max) {\n        max = spec.meta.version;\n        candidate = spec;\n      }\n    }\n    return candidate;\n  }\n}\n\nexport function makeThemeRef(spec: ThemeSpec): ThemeRef {\n  return { name: spec.meta.name, version: spec.meta.version };\n}\n\n"],"mappings":"AAsDA,MAAM,EAAY,GAChB,GAAG,EAAI,KAAK,IAAI,EAAI,UAEtB,IAAa,EAAb,KAA2B,CACzB,MAAyB,IAAI,IAE7B,SAAS,EAAuB,CAC9B,IAAM,EAAM,EAAS,EAAK,KAAK,CAC/B,GAAI,KAAK,MAAM,IAAI,EAAI,CACrB,MAAU,MAAM,mBAAmB,IAAM,CAE3C,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAAoB,CAClB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAc,EAAyC,CACzD,GAAI,GAAW,KAAM,OAAO,KAAK,MAAM,IAAI,EAAS,CAAE,OAAM,UAAS,CAAC,CAAC,CACvE,IAAIA,EACA,EAAM,KACV,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAM,EAAK,KAAK,QAChB,EAAY,GAGhB,OAAO,IAIX,SAAgB,EAAa,EAA2B,CACtD,MAAO,CAAE,KAAM,EAAK,KAAK,KAAM,QAAS,EAAK,KAAK,QAAS"}
+{"version":3,"file":"themes.js","names":["candidate: ThemeSpec | undefined"],"sources":["../src/themes.ts"],"sourcesContent":["import type { OwnerShipMeta } from './ownership';\n\nexport type ThemeScope = 'global' | 'tenant' | 'user';\n\nexport interface ThemeToken<T> {\n  value: T;\n  description?: string;\n}\n\nexport interface ThemeTokens {\n  colors?: Record<string, ThemeToken<string>>;\n  radii?: Record<string, ThemeToken<number>>;\n  space?: Record<string, ThemeToken<number>>;\n  typography?: Record<string, ThemeToken<number>>;\n  shadows?: Record<string, ThemeToken<string>>;\n  motion?: Record<string, ThemeToken<string>>;\n}\n\nexport interface ComponentVariantDefinition {\n  props?: Record<string, unknown>;\n  tokens?: ThemeTokens;\n}\n\nexport interface ComponentVariantSpec {\n  component: string;\n  variants: Record<string, ComponentVariantDefinition>;\n}\n\nexport interface ThemeOverride {\n  scope: ThemeScope;\n  target: string;\n  tokens?: ThemeTokens;\n  components?: ComponentVariantSpec[];\n}\n\nexport interface ThemeMeta extends OwnerShipMeta {\n  name: string;\n  version: number;\n  extends?: ThemeRef;\n  scopes?: ThemeScope[];\n}\n\nexport interface ThemeSpec {\n  meta: ThemeMeta;\n  tokens: ThemeTokens;\n  components?: ComponentVariantSpec[];\n  overrides?: ThemeOverride[];\n}\n\nexport interface ThemeRef {\n  name: string;\n  version: number;\n}\n\nconst themeKey = (ref: ThemeRef | ThemeMeta) => `${ref.name}.v${ref.version}`;\n\nexport class ThemeRegistry {\n  private readonly items = new Map<string, ThemeSpec>();\n\n  register(spec: ThemeSpec): this {\n    const key = themeKey(spec.meta);\n    if (this.items.has(key)) throw new Error(`Duplicate theme ${key}`);\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): ThemeSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): ThemeSpec | undefined {\n    if (version != null) return this.items.get(themeKey({ name, version }));\n    let candidate: ThemeSpec | undefined;\n    let max = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.name !== name) continue;\n      if (spec.meta.version > max) {\n        max = spec.meta.version;\n        candidate = spec;\n      }\n    }\n    return candidate;\n  }\n}\n\nexport function makeThemeRef(spec: ThemeSpec): ThemeRef {\n  return { name: spec.meta.name, version: spec.meta.version };\n}\n"],"mappings":"AAsDA,MAAM,EAAY,GAA8B,GAAG,EAAI,KAAK,IAAI,EAAI,UAEpE,IAAa,EAAb,KAA2B,CACzB,MAAyB,IAAI,IAE7B,SAAS,EAAuB,CAC9B,IAAM,EAAM,EAAS,EAAK,KAAK,CAC/B,GAAI,KAAK,MAAM,IAAI,EAAI,CAAE,MAAU,MAAM,mBAAmB,IAAM,CAElE,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAAoB,CAClB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAc,EAAyC,CACzD,GAAI,GAAW,KAAM,OAAO,KAAK,MAAM,IAAI,EAAS,CAAE,OAAM,UAAS,CAAC,CAAC,CACvE,IAAIA,EACA,EAAM,KACV,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAM,EAAK,KAAK,QAChB,EAAY,GAGhB,OAAO,IAIX,SAAgB,EAAa,EAA2B,CACtD,MAAO,CAAE,KAAM,EAAK,KAAK,KAAM,QAAS,EAAK,KAAK,QAAS"}

package/dist/types/all.d.ts

@@ -8,7 +8,7 @@ import { AnyContractSpec, ContractSpec, EmitDecl, EmitDeclInline, EmitDeclRef, O
 import { TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyThreshold, TelemetryConfig, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySpec, makeTelemetryKey } from "../telemetry/spec.js";
 import { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions } from "../telemetry/anomaly.js";
 import { RuntimeTelemetryProvider, TelemetryDispatch, TelemetryEventContext, TelemetryTracker, TelemetryTrackerOptions } from "../telemetry/tracker.js";
-import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, capabilityKey } from "../capabilities.js";
+import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, capabilityKey, defineCapability } from "../capabilities.js";
 import { DataPresentation, MarkdownPresentation, PresentationContent, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRegistry, PresentationSpec, WebComponentPresentation, jsonSchemaForPresentation } from "../presentations.js";
 import { PresentationDescriptorV2, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationTarget, PresentationV2Meta, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer } from "../presentations.v2.js";
 import { AllocationStrategy, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, MetricAggregation, SuccessMetric, TargetingRule, makeExperimentKey } from "../experiments/spec.js";
@@ -57,4 +57,4 @@ import { VectorIndexConfig, VectorIndexer } from "../knowledge/ingestion/vector-
 import { StorageIngestionAdapter } from "../knowledge/ingestion/storage-adapter.js";
 import { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService } from "../knowledge/query/service.js";
 import { KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessResult } from "../knowledge/runtime.js";
-export { Action, ActionExecutionResult, Actor, AllocationStrategy, AnyContractSpec, AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppComposition, AppCompositionDeps, AppIntegrationBinding, AppIntegrationSlot, AppKnowledgeBinding, AppRouteConfig, AppThemeBinding, ArrayFieldSpec, Assertion, AssertionResult, AttributeMatcher, BaseFieldSpec, BehaviorSignal, BehaviorSignalEnvelope, BehaviorSignalProvider, BlueprintTranslationCatalog, BlueprintUpdater, BrandingAssetRef, BrandingDefaults, CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, Channel, CheckboxFieldSpec, CompensationStep, CompensationStrategy, ComponentVariantDefinition, ComponentVariantSpec, ComposeOptions, ConnectionStatus, ConsentDefinition, ConstraintDecl, ConstraintHandler, ContractSpec, CoverageRequirement, CreateTenantConfigDraftCommand, DataMigrationStep, DataPresentation, DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, DecisionContext, DocumentFragment, DocumentProcessor, EmbeddingService, EmitDecl, EmitDeclInline, EmitDeclRef, EnhanceFields, ErrorSignal, ErrorSignalEnvelope, ErrorSignalProvider, EventEnvelope, EventKey, EventPublisher, EventRef, EventSpec, ExecutionStatus, ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, ExpressionContext, FeatureFlagState, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, FieldLevelDecision, FieldPolicyRule, FieldSpec, Fixture, FormAction, FormOption, FormRef, FormRegistry, FormSpec, FormValuesFor, GetResolvedBrandingQuery, GetTenantConfigVersionQuery, GroupFieldSpec, GuardCondition, GuardConditionKind, HandlerCtx, IntegrationByokSetup, IntegrationCallContext, IntegrationCallError, IntegrationCallGuard, IntegrationCallGuardOptions, IntegrationCallResult, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationContext, IntegrationHealthCheck, IntegrationInvocationStatus, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationTelemetryEmitter, IntegrationTelemetryEvent, IntegrationTraceMetadata, IntegrationUsageMetrics, KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessPolicy, KnowledgeAccessResult, KnowledgeAnswer, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeQueryConfig, KnowledgeQueryService, KnowledgeRetentionPolicy, KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, ListTenantConfigVersionsQuery, Locale, MarkdownPresentation, MessageKey, MetricAggregation, MigrationCheck, MigrationExecutor, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, MissingReference, OpKind, OpRef, OperationTargetRef, OptionsSource, Owner, OwnerShipMeta, Owners, OwnersEnum, PIIPolicy, PlatformTranslationCatalog, PolicyCondition, PolicyDecider, PolicyDeciderInput, PolicyDecision, PolicyEffect, PolicyEngine, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, Predicate, PredicateOp, PresentationContent, PresentationDescriptorV2, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRef, PresentationRegistry, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationTarget, PresentationV2Meta, PresentationValidator, PromoteTenantConfigToPreviewCommand, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, ProposalSink, ProposalTarget, PublishTenantConfigCommand, RadioFieldSpec, RateLimitDefinition, RateLimiter, RawDocument, ReactRenderDescriptor, RegenerationContext, RegenerationRule, RegenerationTrigger, RegeneratorOptions, RegeneratorService, RegeneratorSignal, RelationshipDefinition, RelationshipMatcher, RenderContext, ResolveAppConfigDeps, ResolveMessageQuery, ResolvedAppConfig, ResolvedBranding, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, ResourceContext, ResourceMatcher, ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, RetryPolicy, RollbackTenantConfigCommand, RunMigrationsAction, RunTestsAction, RuntimeTelemetryProvider, SLA, ScenarioRunResult, SchemaMigrationStep, SelectFieldSpec, SignalAdapters, SpecChangeProposal, SpecPointer, Stability, StabilityEnum, StateStore, Step, StepAction, StepExecution, StepType, StorageIngestionAdapter, SubjectContext, SubjectMatcher, SubjectRelationship, SuccessMetric, SwitchFieldSpec, Tag, Tags, TagsEnum, TargetingRule, TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions, TelemetryAnomalyThreshold, TelemetryBinding, TelemetryConfig, TelemetryDispatch, TelemetryEventContext, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySignal, TelemetrySignalEnvelope, TelemetrySignalProvider, TelemetrySpec, TelemetryTracker, TelemetryTrackerOptions, TelemetryTrigger, TenantAppConfig, TenantAppConfigMeta, TenantBrandingAsset, TenantBrandingConfig, TenantConfigUpdater, TenantRouteOverride, TenantSpecOverride, TestExecutor, TestRegistry, TestRunResult, TestRunner, TestRunnerConfig, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, TextFieldSpec, TextareaFieldSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, TransformEngine, Transition, TranslationCatalogMeta, TranslationCatalogPointer, TranslationEntry, TranslationResolver, TriggerRegenerationAction, TypedOptionsSource, TypedPredicate, TypedWhenClause, UpdateBlueprintAction, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantConfigAction, UpdateTenantTranslationOverridesCommand, ValidateWorkflowSpecOptions, ValidationContext, ValidationIssue, ValidationMigrationStep, ValidationResult, ValidationSeverity, VectorIndexConfig, VectorIndexer, VerifyCustomDomainCommand, WebComponentPresentation, WhenClause, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowTargetRef, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, appConfigContracts, assertWorkflowSpecValid, behaviorToEnvelope, buildZodWithRelations, capabilityKey, composeAppConfig, connectionStatusLabel, createDefaultTransformEngine, dataViewKey, defaultGqlField, defaultMcpTool, defaultRestPath, defineCommand, defineEvent, defineFormSpec, defineQuery, defineResourceTemplate, emailThreadsKnowledgeSpace, ensureConnectionReady, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, installFeature, isEmitDeclRef, isResourceRef, jsonSchemaForPresentation, jsonSchemaForSpec, lifecycleContracts, makeAppBlueprintKey, makeExperimentKey, makeIntegrationSpecKey, makeKnowledgeSpaceKey, makePolicyKey, makeTelemetryKey, makeTestKey, makeThemeRef, productCanonKnowledgeSpace, registerAppConfigContracts, registerAppConfigLifecycleContracts, registerBasicValidation, registerDefaultReactRenderer, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, resolveAppConfig, resourceRef, supportFaqKnowledgeSpace, telemetryToEnvelope, toV2FromV1, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateWorkflowSpec };
+export { Action, ActionExecutionResult, Actor, AllocationStrategy, AnyContractSpec, AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppComposition, AppCompositionDeps, AppIntegrationBinding, AppIntegrationSlot, AppKnowledgeBinding, AppRouteConfig, AppThemeBinding, ArrayFieldSpec, Assertion, AssertionResult, AttributeMatcher, BaseFieldSpec, BehaviorSignal, BehaviorSignalEnvelope, BehaviorSignalProvider, BlueprintTranslationCatalog, BlueprintUpdater, BrandingAssetRef, BrandingDefaults, CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, Channel, CheckboxFieldSpec, CompensationStep, CompensationStrategy, ComponentVariantDefinition, ComponentVariantSpec, ComposeOptions, ConnectionStatus, ConsentDefinition, ConstraintDecl, ConstraintHandler, ContractSpec, CoverageRequirement, CreateTenantConfigDraftCommand, DataMigrationStep, DataPresentation, DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, DecisionContext, DocumentFragment, DocumentProcessor, EmbeddingService, EmitDecl, EmitDeclInline, EmitDeclRef, EnhanceFields, ErrorSignal, ErrorSignalEnvelope, ErrorSignalProvider, EventEnvelope, EventKey, EventPublisher, EventRef, EventSpec, ExecutionStatus, ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, ExpressionContext, FeatureFlagState, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, FieldLevelDecision, FieldPolicyRule, FieldSpec, Fixture, FormAction, FormOption, FormRef, FormRegistry, FormSpec, FormValuesFor, GetResolvedBrandingQuery, GetTenantConfigVersionQuery, GroupFieldSpec, GuardCondition, GuardConditionKind, HandlerCtx, IntegrationByokSetup, IntegrationCallContext, IntegrationCallError, IntegrationCallGuard, IntegrationCallGuardOptions, IntegrationCallResult, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationContext, IntegrationHealthCheck, IntegrationInvocationStatus, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationTelemetryEmitter, IntegrationTelemetryEvent, IntegrationTraceMetadata, IntegrationUsageMetrics, KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessPolicy, KnowledgeAccessResult, KnowledgeAnswer, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeQueryConfig, KnowledgeQueryService, KnowledgeRetentionPolicy, KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, ListTenantConfigVersionsQuery, Locale, MarkdownPresentation, MessageKey, MetricAggregation, MigrationCheck, MigrationExecutor, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, MissingReference, OpKind, OpRef, OperationTargetRef, OptionsSource, Owner, OwnerShipMeta, Owners, OwnersEnum, PIIPolicy, PlatformTranslationCatalog, PolicyCondition, PolicyDecider, PolicyDeciderInput, PolicyDecision, PolicyEffect, PolicyEngine, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, Predicate, PredicateOp, PresentationContent, PresentationDescriptorV2, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRef, PresentationRegistry, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationTarget, PresentationV2Meta, PresentationValidator, PromoteTenantConfigToPreviewCommand, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, ProposalSink, ProposalTarget, PublishTenantConfigCommand, RadioFieldSpec, RateLimitDefinition, RateLimiter, RawDocument, ReactRenderDescriptor, RegenerationContext, RegenerationRule, RegenerationTrigger, RegeneratorOptions, RegeneratorService, RegeneratorSignal, RelationshipDefinition, RelationshipMatcher, RenderContext, ResolveAppConfigDeps, ResolveMessageQuery, ResolvedAppConfig, ResolvedBranding, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, ResourceContext, ResourceMatcher, ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, RetryPolicy, RollbackTenantConfigCommand, RunMigrationsAction, RunTestsAction, RuntimeTelemetryProvider, SLA, ScenarioRunResult, SchemaMigrationStep, SelectFieldSpec, SignalAdapters, SpecChangeProposal, SpecPointer, Stability, StabilityEnum, StateStore, Step, StepAction, StepExecution, StepType, StorageIngestionAdapter, SubjectContext, SubjectMatcher, SubjectRelationship, SuccessMetric, SwitchFieldSpec, Tag, Tags, TagsEnum, TargetingRule, TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions, TelemetryAnomalyThreshold, TelemetryBinding, TelemetryConfig, TelemetryDispatch, TelemetryEventContext, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySignal, TelemetrySignalEnvelope, TelemetrySignalProvider, TelemetrySpec, TelemetryTracker, TelemetryTrackerOptions, TelemetryTrigger, TenantAppConfig, TenantAppConfigMeta, TenantBrandingAsset, TenantBrandingConfig, TenantConfigUpdater, TenantRouteOverride, TenantSpecOverride, TestExecutor, TestRegistry, TestRunResult, TestRunner, TestRunnerConfig, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, TextFieldSpec, TextareaFieldSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, TransformEngine, Transition, TranslationCatalogMeta, TranslationCatalogPointer, TranslationEntry, TranslationResolver, TriggerRegenerationAction, TypedOptionsSource, TypedPredicate, TypedWhenClause, UpdateBlueprintAction, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantConfigAction, UpdateTenantTranslationOverridesCommand, ValidateWorkflowSpecOptions, ValidationContext, ValidationIssue, ValidationMigrationStep, ValidationResult, ValidationSeverity, VectorIndexConfig, VectorIndexer, VerifyCustomDomainCommand, WebComponentPresentation, WhenClause, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowTargetRef, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, appConfigContracts, assertWorkflowSpecValid, behaviorToEnvelope, buildZodWithRelations, capabilityKey, composeAppConfig, connectionStatusLabel, createDefaultTransformEngine, dataViewKey, defaultGqlField, defaultMcpTool, defaultRestPath, defineCapability, defineCommand, defineEvent, defineFormSpec, defineQuery, defineResourceTemplate, emailThreadsKnowledgeSpace, ensureConnectionReady, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, installFeature, isEmitDeclRef, isResourceRef, jsonSchemaForPresentation, jsonSchemaForSpec, lifecycleContracts, makeAppBlueprintKey, makeExperimentKey, makeIntegrationSpecKey, makeKnowledgeSpaceKey, makePolicyKey, makeTelemetryKey, makeTestKey, makeThemeRef, productCanonKnowledgeSpace, registerAppConfigContracts, registerAppConfigLifecycleContracts, registerBasicValidation, registerDefaultReactRenderer, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, resolveAppConfig, resourceRef, supportFaqKnowledgeSpace, telemetryToEnvelope, toV2FromV1, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateWorkflowSpec };

package/dist/types.d.ts

@@ -4,6 +4,7 @@ import { TelemetryTracker } from "./telemetry/tracker.js";
 import { Locale, MessageKey } from "./translations/catalog.js";
 import { ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation } from "./app-config/runtime.js";
 import { SecretProvider } from "./integrations/secrets/provider.js";
+import { SpecVariantResolver } from "./experiments/spec-resolver.js";
 
 //#region src/types.d.ts
 /**
@@ -80,6 +81,8 @@ interface HandlerCtx {
     config: ResolvedTranslation;
     resolve?: TranslationResolver;
   };
+  /** Optional spec variant resolver for experiments */
+  specVariantResolver?: SpecVariantResolver;
 }
 //#endregion
 export { Actor, Channel, EventPublisher, FieldLevelDecision, HandlerCtx, PolicyDecider, PolicyDeciderInput, PolicyDecision, RateLimiter, TranslationResolver };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;KAGY,KAAA;KACA,OAAA;AAwBK,UANA,kBAAA,CAMc;EAGZ,KAAA,EAAA,MAAA;EAAL,MAAA,EAAA,OAAA,GAAA,MAAA;EAEK,MAAA,CAAA,EAAA,MAAA;;AAEE,UAPJ,cAAA,CAOI;EAAiB,MAAA,EAAA,OAAA,GAAA,MAAA;EAIrB,MAAA,CAAA,EAAA,MAAA;EAYL,SAAA,CAAA,EApBE,IAoBW,CApBN,mBAoBM,EAAA,KAAA,GAAA,KAAA,GAAA,eAAA,GAAA,OAAA,CAAA;EAChB,QAAA,CAAA,EAAA,cAAA,GAAA,IAAA;EACI,cAAA,CAAA,EApBM,kBAoBN,EAAA;EAAR,GAAA,CAAA,EAnBG,UAmBH,CAAA,KAAA,CAAA;EAAO,gBAAA,CAAA,EAlBS,iBAkBT,EAAA;EAEA,WAAA,CAAA,EAAW,QAAA,GAAA,KAIlB;AAEL;AACO,UAvBU,kBAAA,CAuBV;EACI,OAAA,EAAA,MAAA;EACN,OAAA,EAAA,MAAA;EAAO,OAAA,EAAA,MAAA;EAGA,KAAA,EAxBH,KAwBG;EAOK,OAAA,CAAA,EA9BL,OA8Be;EAKjB,KAAA,CAAA,EAAA,MAAA,EAAA;EACE,cAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAID,MAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAEG,KAAA,CAAA,EAAA,MAAA,EAAA;;AAIK,KAvCP,aAAA,GAuCO,CAAA,KAAA,EAtCV,kBAsCU,EAAA,GArCd,OAqCc,CArCN,cAqCM,CAAA;AAEA,KArCP,WAAA,GAqCO,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,GAAA,EAAA,MAAA,EAAA,GAjCd,OAiCc,CAAA,IAAA,CAAA;AAOZ,KAtCK,mBAAA,GAsCL,CAAA,GAAA,EArCA,UAqCA,EAAA,MAAA,CAAA,EApCI,MAoCJ,EAAA,GAnCF,OAmCE,CAAA,MAAA,GAAA,IAAA,CAAA,GAAA,MAAA,GAAA,IAAA;;AAIU,KApCL,cAAA,GAoCK,CAAA,QAAA,EAAA;EAEH,IAAA,EAAA,MAAA;EAED,OAAA,EAAA,MAAA;EAGD,OAAA,EAAA,OAAA;EACE,OAAA,CAAA,EAAA,MAAA;CAAmB,EAAA,GAvC3B,OAuC2B,CAAA,IAAA,CAAA;UArChB,UAAA;;;;;UAKP;YACE;;;WAID;;cAEG;;cAEA;;mBAEK;;mBAEA;;uEAOZ;;cAEO;;iBAEG;;cAEH;;aAED;;;YAGD;cACE"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;KAGY,KAAA;KACA,OAAA;AAyBK,UANA,kBAAA,CAMc;EAI3B,KAAA,EAAA,MAAA;EADU,MAAA,EAAA,OAAA,GAAA,MAAA;EAKK,MAAA,CAAA,EAAA,MAAA;;AAEE,UAVJ,cAAA,CAUI;EAAiB,MAAA,EAAA,OAAA,GAAA,MAAA;EAIrB,MAAA,CAAA,EAAA,MAAA;EAYL,SAAA,CAAA,EAvBE,IAuBW,CAtBrB,mBAsBqB,EAAA,KAAA,GAAA,KAAA,GAAA,eAAA,GAAA,OAAA,CAAA;EAChB,QAAA,CAAA,EAAA,cAAA,GAAA,IAAA;EACI,cAAA,CAAA,EApBM,kBAoBN,EAAA;EAAR,GAAA,CAAA,EAnBG,UAmBH,CAAA,KAAA,CAAA;EAAO,gBAAA,CAAA,EAlBS,iBAkBT,EAAA;EAEA,WAAA,CAAA,EAAW,QAAA,GAAA,KAIlB;AAEL;AACO,UAvBU,kBAAA,CAuBV;EACI,OAAA,EAAA,MAAA;EACN,OAAA,EAAA,MAAA;EAAO,OAAA,EAAA,MAAA;EAGA,KAAA,EAxBH,KAwBG;EAOK,OAAA,CAAA,EA9BL,OA8Be;EAKjB,KAAA,CAAA,EAAA,MAAA,EAAA;EACE,cAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAID,MAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAEG,KAAA,CAAA,EAAA,MAAA,EAAA;;AAIK,KAvCP,aAAA,GAuCO,CAAA,KAAA,EAtCV,kBAsCU,EAAA,GArCd,OAqCc,CArCN,cAqCM,CAAA;AAEA,KArCP,WAAA,GAqCO,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,GAAA,EAAA,MAAA,EAAA,GAjCd,OAiCc,CAAA,IAAA,CAAA;AAOZ,KAtCK,mBAAA,GAsCL,CAAA,GAAA,EArCA,UAqCA,EAAA,MAAA,CAAA,EApCI,MAoCJ,EAAA,GAnCF,OAmCE,CAAA,MAAA,GAAA,IAAA,CAAA,GAAA,MAAA,GAAA,IAAA;;AAIU,KApCL,cAAA,GAoCK,CAAA,QAAA,EAAA;EAEH,IAAA,EAAA,MAAA;EAED,OAAA,EAAA,MAAA;EAGD,OAAA,EAAA,OAAA;EACE,OAAA,CAAA,EAAA,MAAA;CAGU,EAAA,GA1ClB,OA0CkB,CAAA,IAAA,CAAA;AAAmB,UAxC1B,UAAA,CAwC0B;;;;;UAnCjC;YACE;;;WAID;;cAEG;;cAEA;;mBAEK;;mBAEA;;uEAOZ;;cAEO;;iBAEG;;cAEH;;aAED;;;YAGD;cACE;;;wBAGU"}

package/dist/workflow/adapters/db-adapter.d.ts

@@ -1,15 +1,35 @@
-import { StateStore } from "../state.js";
+import { StateStore, WorkflowState, WorkflowStateFilters } from "../state.js";
 
 //#region src/workflow/adapters/db-adapter.d.ts
-interface DatabaseStateStoreOptions {
-  /** Placeholder for connection string / client injection. */
-  connection?: unknown;
+interface PrismaClientLike {
+  workflowState: {
+    create: (args: {
+      data: any;
+    }) => Promise<any>;
+    findUnique: (args: {
+      where: {
+        id: string;
+      };
+    }) => Promise<any>;
+    update: (args: {
+      where: {
+        id: string;
+      };
+      data: any;
+    }) => Promise<any>;
+    findMany: (args: {
+      where?: any;
+    }) => Promise<any[]>;
+  };
+}
+declare class PrismaStateStore implements StateStore {
+  private readonly prisma;
+  constructor(prisma: PrismaClientLike);
+  create(state: WorkflowState): Promise<void>;
+  get(workflowId: string): Promise<WorkflowState | undefined>;
+  update(workflowId: string, updater: (current: WorkflowState) => WorkflowState): Promise<WorkflowState>;
+  list(filters?: WorkflowStateFilters): Promise<WorkflowState[]>;
 }
-/**
- * Placeholder factory to guide future database adapters (PostgreSQL, MongoDB, etc.).
- * Consumers should provide their own implementation that satisfies {@link StateStore}.
- */
-declare function createDatabaseStateStore(_options: DatabaseStateStoreOptions): StateStore;
 //#endregion
-export { DatabaseStateStoreOptions, createDatabaseStateStore };
+export { PrismaStateStore };
 //# sourceMappingURL=db-adapter.d.ts.map

package/dist/workflow/adapters/db-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-adapter.d.ts","names":[],"sources":["../../../src/workflow/adapters/db-adapter.ts"],"sourcesContent":[],"mappings":";;;UAEiB,yBAAA;;EAAA,UAAA,CAAA,EAAA,OAAA;AASjB;;;;;iBAAgB,wBAAA,WACJ,4BACT"}
+{"version":3,"file":"db-adapter.d.ts","names":[],"sources":["../../../src/workflow/adapters/db-adapter.ts"],"sourcesContent":[],"mappings":";;;UAGU,gBAAA;;IAAA,MAAA,EAAA,CAAA,IAAA,EAAgB;MAEW,IAAA,EAAA,GAAA;IACgB,CAAA,EAAA,GADhB,OACgB,CAAA,GAAA,CAAA;IACO,UAAA,EAAA,CAAA,IAAA,EAAA;MACnB,KAAA,EAAA;QAAO,EAAA,EAAA,MAAA;MAInC,CAAA;IAC0B,CAAA,EAAA,GAPc,OAOd,CAAA,GAAA,CAAA;IAEjB,MAAA,EAAA,CAAA,IAAA,EAAA;MAAgB,KAAA,EAAA;QAiBG,EAAA,EAAA,MAAA;MAAR,CAAA;MAuBV,IAAA,EAAA,GAAA;IAAkB,CAAA,EAAA,GAhDmB,OAgDnB,CAAA,GAAA,CAAA;IAC5B,QAAA,EAAA,CAAA,IAAA,EAAA;MAAR,KAAA,CAAA,EAAA,GAAA;IAkCkB,CAAA,EAAA,GAlFkB,OAkFlB,CAAA,GAAA,EAAA,CAAA;EAA+B,CAAA;;AA9Eb,cAA5B,gBAAA,YAA4B,UAAA,CAAA;EAAU,iBAAA,MAAA;sBACZ;gBAEjB,gBAAgB;2BAiBL,QAAQ;gDAuBlB,kBAAkB,gBACpC,QAAQ;iBAkCU,uBAAuB,QAAQ"}

package/dist/workflow/adapters/db-adapter.js

@@ -1,2 +1,2 @@
-function e(e){throw Error(`Database state store adapter not implemented. Provide a custom adapter that satisfies StateStore.`)}export{e as createDatabaseStateStore};
+var e=class{constructor(e){this.prisma=e}async create(e){await this.prisma.workflowState.create({data:{id:e.workflowId,name:e.workflowName,version:e.workflowVersion,status:e.status,currentStep:e.currentStep,data:e.data,history:e.history,retryCounts:e.retryCounts??{},createdAt:e.createdAt,updatedAt:e.updatedAt}})}async get(e){let t=await this.prisma.workflowState.findUnique({where:{id:e}});if(t)return{workflowId:t.id,workflowName:t.name,workflowVersion:t.version,currentStep:t.currentStep,data:t.data,history:t.history,retryCounts:t.retryCounts,status:t.status,createdAt:t.createdAt,updatedAt:t.updatedAt}}async update(e,t){let n=await this.get(e);if(!n)throw Error(`Workflow ${e} not found`);let r=t(n),i=await this.prisma.workflowState.update({where:{id:e},data:{status:r.status,currentStep:r.currentStep,data:r.data,history:r.history,retryCounts:r.retryCounts,updatedAt:r.updatedAt}});return{workflowId:i.id,workflowName:i.name,workflowVersion:i.version,currentStep:i.currentStep,data:i.data,history:i.history,retryCounts:i.retryCounts,status:i.status,createdAt:i.createdAt,updatedAt:i.updatedAt}}async list(e){let t={};return e?.status&&(t.status=e.status),(await this.prisma.workflowState.findMany({where:t})).map(e=>({workflowId:e.id,workflowName:e.name,workflowVersion:e.version,currentStep:e.currentStep,data:e.data,history:e.history,retryCounts:e.retryCounts,status:e.status,createdAt:e.createdAt,updatedAt:e.updatedAt}))}};export{e as PrismaStateStore};
 //# sourceMappingURL=db-adapter.js.map

package/dist/workflow/adapters/db-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"db-adapter.js","names":[],"sources":["../../../src/workflow/adapters/db-adapter.ts"],"sourcesContent":["import type { StateStore } from '../state';\n\nexport interface DatabaseStateStoreOptions {\n  /** Placeholder for connection string / client injection. */\n  connection?: unknown;\n}\n\n/**\n * Placeholder factory to guide future database adapters (PostgreSQL, MongoDB, etc.).\n * Consumers should provide their own implementation that satisfies {@link StateStore}.\n */\nexport function createDatabaseStateStore(\n  _options: DatabaseStateStoreOptions\n): StateStore {\n  throw new Error(\n    'Database state store adapter not implemented. Provide a custom adapter that satisfies StateStore.'\n  );\n}\n\n"],"mappings":"AAWA,SAAgB,EACd,EACY,CACZ,MAAU,MACR,oGACD"}
+{"version":3,"file":"db-adapter.js","names":["prisma: PrismaClientLike","where: any"],"sources":["../../../src/workflow/adapters/db-adapter.ts"],"sourcesContent":["import type { StateStore, WorkflowState, WorkflowStateFilters } from '../state';\n\n// Generic interface for Prisma Client to avoid hard dependency on generated client\ninterface PrismaClientLike {\n  workflowState: {\n    create: (args: { data: any }) => Promise<any>;\n    findUnique: (args: { where: { id: string } }) => Promise<any>;\n    update: (args: { where: { id: string }; data: any }) => Promise<any>;\n    findMany: (args: { where?: any }) => Promise<any[]>;\n  };\n}\n\nexport class PrismaStateStore implements StateStore {\n  constructor(private readonly prisma: PrismaClientLike) {}\n\n  async create(state: WorkflowState): Promise<void> {\n    await this.prisma.workflowState.create({\n      data: {\n        id: state.workflowId,\n        name: state.workflowName,\n        version: state.workflowVersion,\n        status: state.status,\n        currentStep: state.currentStep,\n        data: state.data, // Assumes Prisma handles JSON\n        history: state.history, // Assumes Prisma handles JSON\n        retryCounts: state.retryCounts ?? {},\n        createdAt: state.createdAt,\n        updatedAt: state.updatedAt,\n      },\n    });\n  }\n\n  async get(workflowId: string): Promise<WorkflowState | undefined> {\n    const record = await this.prisma.workflowState.findUnique({\n      where: { id: workflowId },\n    });\n\n    if (!record) return undefined;\n\n    return {\n      workflowId: record.id,\n      workflowName: record.name,\n      workflowVersion: record.version,\n      currentStep: record.currentStep,\n      data: record.data as Record<string, unknown>,\n      history: record.history as any[],\n      retryCounts: record.retryCounts as Record<string, number>,\n      status: record.status as any,\n      createdAt: record.createdAt,\n      updatedAt: record.updatedAt,\n    };\n  }\n\n  async update(\n    workflowId: string,\n    updater: (current: WorkflowState) => WorkflowState\n  ): Promise<WorkflowState> {\n    const current = await this.get(workflowId);\n    if (!current) {\n      throw new Error(`Workflow ${workflowId} not found`);\n    }\n\n    const next = updater(current);\n\n    const updated = await this.prisma.workflowState.update({\n      where: { id: workflowId },\n      data: {\n        status: next.status,\n        currentStep: next.currentStep,\n        data: next.data,\n        history: next.history,\n        retryCounts: next.retryCounts,\n        updatedAt: next.updatedAt,\n      },\n    });\n\n    return {\n      workflowId: updated.id,\n      workflowName: updated.name,\n      workflowVersion: updated.version,\n      currentStep: updated.currentStep,\n      data: updated.data as Record<string, unknown>,\n      history: updated.history as any[],\n      retryCounts: updated.retryCounts as Record<string, number>,\n      status: updated.status as any,\n      createdAt: updated.createdAt,\n      updatedAt: updated.updatedAt,\n    };\n  }\n\n  async list(filters?: WorkflowStateFilters): Promise<WorkflowState[]> {\n    const where: any = {};\n    if (filters?.status) {\n      where.status = filters.status;\n    }\n\n    const records = await this.prisma.workflowState.findMany({\n      where,\n    });\n\n    return records.map((record) => ({\n      workflowId: record.id,\n      workflowName: record.name,\n      workflowVersion: record.version,\n      currentStep: record.currentStep,\n      data: record.data as Record<string, unknown>,\n      history: record.history as any[],\n      retryCounts: record.retryCounts as Record<string, number>,\n      status: record.status as any,\n      createdAt: record.createdAt,\n      updatedAt: record.updatedAt,\n    }));\n  }\n}\n"],"mappings":"AAYA,IAAa,EAAb,KAAoD,CAClD,YAAY,EAA2C,CAA1B,KAAA,OAAA,EAE7B,MAAM,OAAO,EAAqC,CAChD,MAAM,KAAK,OAAO,cAAc,OAAO,CACrC,KAAM,CACJ,GAAI,EAAM,WACV,KAAM,EAAM,aACZ,QAAS,EAAM,gBACf,OAAQ,EAAM,OACd,YAAa,EAAM,YACnB,KAAM,EAAM,KACZ,QAAS,EAAM,QACf,YAAa,EAAM,aAAe,EAAE,CACpC,UAAW,EAAM,UACjB,UAAW,EAAM,UAClB,CACF,CAAC,CAGJ,MAAM,IAAI,EAAwD,CAChE,IAAM,EAAS,MAAM,KAAK,OAAO,cAAc,WAAW,CACxD,MAAO,CAAE,GAAI,EAAY,CAC1B,CAAC,CAEG,KAEL,MAAO,CACL,WAAY,EAAO,GACnB,aAAc,EAAO,KACrB,gBAAiB,EAAO,QACxB,YAAa,EAAO,YACpB,KAAM,EAAO,KACb,QAAS,EAAO,QAChB,YAAa,EAAO,YACpB,OAAQ,EAAO,OACf,UAAW,EAAO,UAClB,UAAW,EAAO,UACnB,CAGH,MAAM,OACJ,EACA,EACwB,CACxB,IAAM,EAAU,MAAM,KAAK,IAAI,EAAW,CAC1C,GAAI,CAAC,EACH,MAAU,MAAM,YAAY,EAAW,YAAY,CAGrD,IAAM,EAAO,EAAQ,EAAQ,CAEvB,EAAU,MAAM,KAAK,OAAO,cAAc,OAAO,CACrD,MAAO,CAAE,GAAI,EAAY,CACzB,KAAM,CACJ,OAAQ,EAAK,OACb,YAAa,EAAK,YAClB,KAAM,EAAK,KACX,QAAS,EAAK,QACd,YAAa,EAAK,YAClB,UAAW,EAAK,UACjB,CACF,CAAC,CAEF,MAAO,CACL,WAAY,EAAQ,GACpB,aAAc,EAAQ,KACtB,gBAAiB,EAAQ,QACzB,YAAa,EAAQ,YACrB,KAAM,EAAQ,KACd,QAAS,EAAQ,QACjB,YAAa,EAAQ,YACrB,OAAQ,EAAQ,OAChB,UAAW,EAAQ,UACnB,UAAW,EAAQ,UACpB,CAGH,MAAM,KAAK,EAA0D,CACnE,IAAMC,EAAa,EAAE,CASrB,OARI,GAAS,SACX,EAAM,OAAS,EAAQ,SAGT,MAAM,KAAK,OAAO,cAAc,SAAS,CACvD,QACD,CAAC,EAEa,IAAK,IAAY,CAC9B,WAAY,EAAO,GACnB,aAAc,EAAO,KACrB,gBAAiB,EAAO,QACxB,YAAa,EAAO,YACpB,KAAM,EAAO,KACb,QAAS,EAAO,QAChB,YAAa,EAAO,YACpB,OAAQ,EAAO,OACf,UAAW,EAAO,UAClB,UAAW,EAAO,UACnB,EAAE"}

package/dist/workflow/adapters/file-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-adapter.js","names":[],"sources":["../../../src/workflow/adapters/file-adapter.ts"],"sourcesContent":["import type { StateStore } from '../state';\n\nexport interface FileStateStoreOptions {\n  /** Absolute or relative path to the persistence file. */\n  filePath: string;\n}\n\n/**\n * Placeholder for a file-backed state store adapter.\n * Implementations should manage locking/concurrency and JSON serialization.\n */\nexport function createFileStateStore(\n  _options: FileStateStoreOptions\n): StateStore {\n  throw new Error(\n    'File-backed state store adapter not implemented. Provide a custom adapter that satisfies StateStore.'\n  );\n}\n\n"],"mappings":"AAWA,SAAgB,EACd,EACY,CACZ,MAAU,MACR,uGACD"}
+{"version":3,"file":"file-adapter.js","names":[],"sources":["../../../src/workflow/adapters/file-adapter.ts"],"sourcesContent":["import type { StateStore } from '../state';\n\nexport interface FileStateStoreOptions {\n  /** Absolute or relative path to the persistence file. */\n  filePath: string;\n}\n\n/**\n * Placeholder for a file-backed state store adapter.\n * Implementations should manage locking/concurrency and JSON serialization.\n */\nexport function createFileStateStore(\n  _options: FileStateStoreOptions\n): StateStore {\n  throw new Error(\n    'File-backed state store adapter not implemented. Provide a custom adapter that satisfies StateStore.'\n  );\n}\n"],"mappings":"AAWA,SAAgB,EACd,EACY,CACZ,MAAU,MACR,uGACD"}

package/dist/workflow/adapters/index.d.ts

@@ -1,4 +1,4 @@
 import { InMemoryStateStore } from "./memory-store.js";
-import { DatabaseStateStoreOptions, createDatabaseStateStore } from "./db-adapter.js";
+import { PrismaStateStore } from "./db-adapter.js";
 import { FileStateStoreOptions, createFileStateStore } from "./file-adapter.js";
-export { DatabaseStateStoreOptions, FileStateStoreOptions, InMemoryStateStore, createDatabaseStateStore, createFileStateStore };
+export { FileStateStoreOptions, InMemoryStateStore, PrismaStateStore, createFileStateStore };

package/dist/workflow/adapters/index.js

@@ -1 +1 @@
-import{InMemoryStateStore as e}from"./memory-store.js";import{createDatabaseStateStore as t}from"./db-adapter.js";import{createFileStateStore as n}from"./file-adapter.js";export{e as InMemoryStateStore,t as createDatabaseStateStore,n as createFileStateStore};
+import{InMemoryStateStore as e}from"./memory-store.js";import{PrismaStateStore as t}from"./db-adapter.js";import{createFileStateStore as n}from"./file-adapter.js";export{e as InMemoryStateStore,t as PrismaStateStore,n as createFileStateStore};

package/dist/workflow/adapters/memory-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-store.d.ts","names":[],"sources":["../../../src/workflow/adapters/memory-store.ts"],"sourcesContent":[],"mappings":";;;;;;AA4BA;;AAGsC,cAHzB,kBAAA,YAA8B,UAGL,CAAA;EAMG,iBAAA,KAAA;EAAR,MAAA,CAAA,KAAA,EANX,aAMW,CAAA,EANK,OAML,CAAA,IAAA,CAAA;EAOV,GAAA,CAAA,UAAA,EAAA,MAAA,CAAA,EAPU,OAOV,CAPkB,aAOlB,GAAA,SAAA,CAAA;EAAkB,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,OAAA,EAAlB,aAAkB,EAAA,GAAA,aAAA,CAAA,EACpC,OADoC,CAC5B,aAD4B,CAAA;EAC5B,IAAA,CAAA,OAAA,CAAA,EASU,oBATV,CAAA,EASiC,OATjC,CASyC,aATzC,EAAA,CAAA;EAAR,KAAA,CAAA,CAAA,EAAA,IAAA"}
+{"version":3,"file":"memory-store.d.ts","names":[],"sources":["../../../src/workflow/adapters/memory-store.ts"],"sourcesContent":[],"mappings":";;;;;;AAwBA;;AAGsC,cAHzB,kBAAA,YAA8B,UAGL,CAAA;EAMG,iBAAA,KAAA;EAAR,MAAA,CAAA,KAAA,EANX,aAMW,CAAA,EANK,OAML,CAAA,IAAA,CAAA;EAOV,GAAA,CAAA,UAAA,EAAA,MAAA,CAAA,EAPU,OAOV,CAPkB,aAOlB,GAAA,SAAA,CAAA;EAAkB,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,OAAA,EAAlB,aAAkB,EAAA,GAAA,aAAA,CAAA,EACpC,OADoC,CAC5B,aAD4B,CAAA;EAC5B,IAAA,CAAA,OAAA,CAAA,EAQU,oBARV,CAAA,EAQiC,OARjC,CAQyC,aARzC,EAAA,CAAA;EAAR,KAAA,CAAA,CAAA,EAAA,IAAA"}

package/dist/workflow/adapters/memory-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-store.js","names":["result: Record<string, unknown>"],"sources":["../../../src/workflow/adapters/memory-store.ts"],"sourcesContent":["import type {\n  StateStore,\n  WorkflowState,\n  WorkflowStateFilters,\n} from '../state';\n\nfunction cloneState(state: WorkflowState): WorkflowState {\n  return {\n    ...state,\n    data: deepCopy(state.data),\n    history: state.history.map((execution) => ({\n      ...execution,\n      input: deepCopy(execution.input),\n      output: deepCopy(execution.output),\n      startedAt: new Date(execution.startedAt),\n      completedAt: execution.completedAt\n        ? new Date(execution.completedAt)\n        : undefined,\n    })),\n    createdAt: new Date(state.createdAt),\n    updatedAt: new Date(state.updatedAt),\n  };\n}\n\n/**\n * Naive in-memory state store. Suitable for tests and single-node development\n * environments. Swap with a database-backed adapter in production.\n */\nexport class InMemoryStateStore implements StateStore {\n  private readonly items = new Map<string, WorkflowState>();\n\n  async create(state: WorkflowState): Promise<void> {\n    if (this.items.has(state.workflowId))\n      throw new Error(`Workflow state already exists: ${state.workflowId}`);\n    this.items.set(state.workflowId, cloneState(state));\n  }\n\n  async get(workflowId: string): Promise<WorkflowState | undefined> {\n    const state = this.items.get(workflowId);\n    return state ? cloneState(state) : undefined;\n  }\n\n  async update(\n    workflowId: string,\n    updater: (current: WorkflowState) => WorkflowState\n  ): Promise<WorkflowState> {\n    const current = this.items.get(workflowId);\n    if (!current)\n      throw new Error(`Workflow state not found for ${workflowId}`);\n    const next = cloneState(updater(cloneState(current)));\n    this.items.set(workflowId, next);\n    return cloneState(next);\n  }\n\n  async list(filters?: WorkflowStateFilters): Promise<WorkflowState[]> {\n    const all = [...this.items.values()];\n    const filtered = filters?.status\n      ? all.filter((state) => state.status === filters.status)\n      : all;\n    return filtered.map(cloneState);\n  }\n\n  clear() {\n    this.items.clear();\n  }\n}\n\nfunction deepCopy<T>(value: T): T {\n  if (value instanceof Date) return new Date(value.getTime()) as T;\n  if (Array.isArray(value)) return value.map((item) => deepCopy(item)) as T;\n  if (value && typeof value === 'object') {\n    const result: Record<string, unknown> = {};\n    for (const [key, val] of Object.entries(value as Record<string, unknown>)) {\n      result[key] = deepCopy(val);\n    }\n    return result as T;\n  }\n  return value;\n}\n\n"],"mappings":"AAMA,SAAS,EAAW,EAAqC,CACvD,MAAO,CACL,GAAG,EACH,KAAM,EAAS,EAAM,KAAK,CAC1B,QAAS,EAAM,QAAQ,IAAK,IAAe,CACzC,GAAG,EACH,MAAO,EAAS,EAAU,MAAM,CAChC,OAAQ,EAAS,EAAU,OAAO,CAClC,UAAW,IAAI,KAAK,EAAU,UAAU,CACxC,YAAa,EAAU,YACnB,IAAI,KAAK,EAAU,YAAY,CAC/B,IAAA,GACL,EAAE,CACH,UAAW,IAAI,KAAK,EAAM,UAAU,CACpC,UAAW,IAAI,KAAK,EAAM,UAAU,CACrC,CAOH,IAAa,EAAb,KAAsD,CACpD,MAAyB,IAAI,IAE7B,MAAM,OAAO,EAAqC,CAChD,GAAI,KAAK,MAAM,IAAI,EAAM,WAAW,CAClC,MAAU,MAAM,kCAAkC,EAAM,aAAa,CACvE,KAAK,MAAM,IAAI,EAAM,WAAY,EAAW,EAAM,CAAC,CAGrD,MAAM,IAAI,EAAwD,CAChE,IAAM,EAAQ,KAAK,MAAM,IAAI,EAAW,CACxC,OAAO,EAAQ,EAAW,EAAM,CAAG,IAAA,GAGrC,MAAM,OACJ,EACA,EACwB,CACxB,IAAM,EAAU,KAAK,MAAM,IAAI,EAAW,CAC1C,GAAI,CAAC,EACH,MAAU,MAAM,gCAAgC,IAAa,CAC/D,IAAM,EAAO,EAAW,EAAQ,EAAW,EAAQ,CAAC,CAAC,CAErD,OADA,KAAK,MAAM,IAAI,EAAY,EAAK,CACzB,EAAW,EAAK,CAGzB,MAAM,KAAK,EAA0D,CACnE,IAAM,EAAM,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAIpC,OAHiB,GAAS,OACtB,EAAI,OAAQ,GAAU,EAAM,SAAW,EAAQ,OAAO,CACtD,GACY,IAAI,EAAW,CAGjC,OAAQ,CACN,KAAK,MAAM,OAAO,GAItB,SAAS,EAAY,EAAa,CAChC,GAAI,aAAiB,KAAM,OAAO,IAAI,KAAK,EAAM,SAAS,CAAC,CAC3D,GAAI,MAAM,QAAQ,EAAM,CAAE,OAAO,EAAM,IAAK,GAAS,EAAS,EAAK,CAAC,CACpE,GAAI,GAAS,OAAO,GAAU,SAAU,CACtC,IAAMA,EAAkC,EAAE,CAC1C,IAAK,GAAM,CAAC,EAAK,KAAQ,OAAO,QAAQ,EAAiC,CACvE,EAAO,GAAO,EAAS,EAAI,CAE7B,OAAO,EAET,OAAO"}
+{"version":3,"file":"memory-store.js","names":["result: Record<string, unknown>"],"sources":["../../../src/workflow/adapters/memory-store.ts"],"sourcesContent":["import type { StateStore, WorkflowState, WorkflowStateFilters } from '../state';\n\nfunction cloneState(state: WorkflowState): WorkflowState {\n  return {\n    ...state,\n    data: deepCopy(state.data),\n    history: state.history.map((execution) => ({\n      ...execution,\n      input: deepCopy(execution.input),\n      output: deepCopy(execution.output),\n      startedAt: new Date(execution.startedAt),\n      completedAt: execution.completedAt\n        ? new Date(execution.completedAt)\n        : undefined,\n    })),\n    createdAt: new Date(state.createdAt),\n    updatedAt: new Date(state.updatedAt),\n  };\n}\n\n/**\n * Naive in-memory state store. Suitable for tests and single-node development\n * environments. Swap with a database-backed adapter in production.\n */\nexport class InMemoryStateStore implements StateStore {\n  private readonly items = new Map<string, WorkflowState>();\n\n  async create(state: WorkflowState): Promise<void> {\n    if (this.items.has(state.workflowId))\n      throw new Error(`Workflow state already exists: ${state.workflowId}`);\n    this.items.set(state.workflowId, cloneState(state));\n  }\n\n  async get(workflowId: string): Promise<WorkflowState | undefined> {\n    const state = this.items.get(workflowId);\n    return state ? cloneState(state) : undefined;\n  }\n\n  async update(\n    workflowId: string,\n    updater: (current: WorkflowState) => WorkflowState\n  ): Promise<WorkflowState> {\n    const current = this.items.get(workflowId);\n    if (!current) throw new Error(`Workflow state not found for ${workflowId}`);\n    const next = cloneState(updater(cloneState(current)));\n    this.items.set(workflowId, next);\n    return cloneState(next);\n  }\n\n  async list(filters?: WorkflowStateFilters): Promise<WorkflowState[]> {\n    const all = [...this.items.values()];\n    const filtered = filters?.status\n      ? all.filter((state) => state.status === filters.status)\n      : all;\n    return filtered.map(cloneState);\n  }\n\n  clear() {\n    this.items.clear();\n  }\n}\n\nfunction deepCopy<T>(value: T): T {\n  if (value instanceof Date) return new Date(value.getTime()) as T;\n  if (Array.isArray(value)) return value.map((item) => deepCopy(item)) as T;\n  if (value && typeof value === 'object') {\n    const result: Record<string, unknown> = {};\n    for (const [key, val] of Object.entries(value as Record<string, unknown>)) {\n      result[key] = deepCopy(val);\n    }\n    return result as T;\n  }\n  return value;\n}\n"],"mappings":"AAEA,SAAS,EAAW,EAAqC,CACvD,MAAO,CACL,GAAG,EACH,KAAM,EAAS,EAAM,KAAK,CAC1B,QAAS,EAAM,QAAQ,IAAK,IAAe,CACzC,GAAG,EACH,MAAO,EAAS,EAAU,MAAM,CAChC,OAAQ,EAAS,EAAU,OAAO,CAClC,UAAW,IAAI,KAAK,EAAU,UAAU,CACxC,YAAa,EAAU,YACnB,IAAI,KAAK,EAAU,YAAY,CAC/B,IAAA,GACL,EAAE,CACH,UAAW,IAAI,KAAK,EAAM,UAAU,CACpC,UAAW,IAAI,KAAK,EAAM,UAAU,CACrC,CAOH,IAAa,EAAb,KAAsD,CACpD,MAAyB,IAAI,IAE7B,MAAM,OAAO,EAAqC,CAChD,GAAI,KAAK,MAAM,IAAI,EAAM,WAAW,CAClC,MAAU,MAAM,kCAAkC,EAAM,aAAa,CACvE,KAAK,MAAM,IAAI,EAAM,WAAY,EAAW,EAAM,CAAC,CAGrD,MAAM,IAAI,EAAwD,CAChE,IAAM,EAAQ,KAAK,MAAM,IAAI,EAAW,CACxC,OAAO,EAAQ,EAAW,EAAM,CAAG,IAAA,GAGrC,MAAM,OACJ,EACA,EACwB,CACxB,IAAM,EAAU,KAAK,MAAM,IAAI,EAAW,CAC1C,GAAI,CAAC,EAAS,MAAU,MAAM,gCAAgC,IAAa,CAC3E,IAAM,EAAO,EAAW,EAAQ,EAAW,EAAQ,CAAC,CAAC,CAErD,OADA,KAAK,MAAM,IAAI,EAAY,EAAK,CACzB,EAAW,EAAK,CAGzB,MAAM,KAAK,EAA0D,CACnE,IAAM,EAAM,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAIpC,OAHiB,GAAS,OACtB,EAAI,OAAQ,GAAU,EAAM,SAAW,EAAQ,OAAO,CACtD,GACY,IAAI,EAAW,CAGjC,OAAQ,CACN,KAAK,MAAM,OAAO,GAItB,SAAS,EAAY,EAAa,CAChC,GAAI,aAAiB,KAAM,OAAO,IAAI,KAAK,EAAM,SAAS,CAAC,CAC3D,GAAI,MAAM,QAAQ,EAAM,CAAE,OAAO,EAAM,IAAK,GAAS,EAAS,EAAK,CAAC,CACpE,GAAI,GAAS,OAAO,GAAU,SAAU,CACtC,IAAMA,EAAkC,EAAE,CAC1C,IAAK,GAAM,CAAC,EAAK,KAAQ,OAAO,QAAQ,EAAiC,CACvE,EAAO,GAAO,EAAS,EAAI,CAE7B,OAAO,EAET,OAAO"}

package/dist/workflow/expression.js.map

@@ -1 +1 @@
-{"version":3,"file":"expression.js","names":["current: any","parts: string[]"],"sources":["../../src/workflow/expression.ts"],"sourcesContent":["export interface ExpressionContext {\n  data: Record<string, unknown>;\n  input?: unknown;\n  output?: unknown;\n}\n\nexport function evaluateExpression(\n  expression: string | undefined,\n  ctx: ExpressionContext\n): boolean {\n  if (!expression) return true;\n  const trimmed = expression.trim();\n  if (!trimmed) return true;\n\n  const orParts = splitByOperator(trimmed, '||');\n  if (orParts.length > 1) return orParts.some((part) => evaluateExpression(part, ctx));\n\n  const andParts = splitByOperator(trimmed, '&&');\n  if (andParts.length > 1) return andParts.every((part) => evaluateExpression(part, ctx));\n\n  return evaluateSingle(trimmed, ctx);\n}\n\nfunction evaluateSingle(expr: string, ctx: ExpressionContext): boolean {\n  const trimmed = expr.trim();\n  if (!trimmed) return true;\n  if (trimmed.startsWith('!')) return !evaluateSingle(trimmed.slice(1), ctx);\n\n  const comparisonMatch = trimmed.match(\n    /^(data|input|output)\\.([A-Za-z0-9_.\\[\\]]+)\\s*(===|==|!==|!=|>=|<=|>|<)\\s*(.+)$/\n  );\n  if (comparisonMatch) {\n    const [, root, path, operator, rawRight] = comparisonMatch as [\n      string,\n      string,\n      string,\n      ComparisonOperator,\n      string\n    ];\n    const left = resolveRoot(root, ctx, path);\n    const right = parseLiteral(rawRight);\n    return compare(left, right, operator);\n  }\n\n  const truthyMatch = trimmed.match(/^(data|input|output)\\.([A-Za-z0-9_.\\[\\]]+)$/);\n  if (truthyMatch) {\n    const [, root, path] = truthyMatch as [string, string, string];\n    const value = resolveRoot(root, ctx, path);\n    return Boolean(value);\n  }\n\n  const literal = parseLiteral(trimmed);\n  return Boolean(literal);\n}\n\ntype ComparisonOperator = '===' | '==' | '!==' | '!=' | '>=' | '<=' | '>' | '<';\n\nfunction compare(\n  left: unknown,\n  right: unknown,\n  operator: ComparisonOperator\n): boolean {\n  switch (operator) {\n    case '===':\n    case '==':\n      return left === right;\n    case '!==':\n    case '!=':\n      return left !== right;\n    case '>':\n      return Number(left) > Number(right);\n    case '>=':\n      return Number(left) >= Number(right);\n    case '<':\n      return Number(left) < Number(right);\n    case '<=':\n      return Number(left) <= Number(right);\n    default:\n      return false;\n  }\n}\n\nfunction parseLiteral(value: string): unknown {\n  const trimmed = (value ?? '').trim();\n  if (\n    (trimmed.startsWith('\"') && trimmed.endsWith('\"')) ||\n    (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))\n  )\n    return trimmed.slice(1, -1);\n  if (/^-?\\d+(\\.\\d+)?$/.test(trimmed)) return Number(trimmed);\n  if (/^true$/i.test(trimmed)) return true;\n  if (/^false$/i.test(trimmed)) return false;\n  if (/^null$/i.test(trimmed)) return null;\n  if (/^undefined$/i.test(trimmed)) return undefined;\n  return trimmed;\n}\n\nfunction resolveRoot(\n  root: string,\n  ctx: ExpressionContext,\n  path: string\n): unknown {\n  const source =\n    root === 'data'\n      ? ctx.data\n      : root === 'input'\n        ? ctx.input\n        : ctx.output;\n  return resolvePath(source, path);\n}\n\nfunction resolvePath(source: unknown, path: string): unknown {\n  if (source == null) return undefined;\n  if (!path) return source;\n  const segments = path\n    .replace(/\\[(\\d+)\\]/g, '.$1')\n    .split('.')\n    .filter(Boolean);\n\n  let current: any = source;\n  for (const segment of segments) {\n    if (current == null) return undefined;\n    current = current[segment as keyof typeof current];\n  }\n  return current;\n}\n\nfunction splitByOperator(expr: string, operator: '&&' | '||'): string[] {\n  const parts: string[] = [];\n  let buffer = '';\n  let inSingleQuote = false;\n  let inDoubleQuote = false;\n\n  for (let i = 0; i < expr.length; i++) {\n    const char = expr[i]!;\n    const next = expr.slice(i, i + operator.length);\n\n    if (char === \"'\" && !inDoubleQuote) {\n      inSingleQuote = !inSingleQuote;\n      buffer += char;\n      continue;\n    }\n    if (char === '\"' && !inSingleQuote) {\n      inDoubleQuote = !inDoubleQuote;\n      buffer += char;\n      continue;\n    }\n\n    if (!inSingleQuote && !inDoubleQuote && next === operator) {\n      parts.push(buffer.trim());\n      buffer = '';\n      i += operator.length - 1;\n      continue;\n    }\n\n    buffer += char;\n  }\n\n  if (buffer.trim().length) parts.push(buffer.trim());\n  return parts;\n}\n\n"],"mappings":"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"}
+{"version":3,"file":"expression.js","names":["current: any","parts: string[]"],"sources":["../../src/workflow/expression.ts"],"sourcesContent":["export interface ExpressionContext {\n  data: Record<string, unknown>;\n  input?: unknown;\n  output?: unknown;\n}\n\nexport function evaluateExpression(\n  expression: string | undefined,\n  ctx: ExpressionContext\n): boolean {\n  if (!expression) return true;\n  const trimmed = expression.trim();\n  if (!trimmed) return true;\n\n  const orParts = splitByOperator(trimmed, '||');\n  if (orParts.length > 1)\n    return orParts.some((part) => evaluateExpression(part, ctx));\n\n  const andParts = splitByOperator(trimmed, '&&');\n  if (andParts.length > 1)\n    return andParts.every((part) => evaluateExpression(part, ctx));\n\n  return evaluateSingle(trimmed, ctx);\n}\n\nfunction evaluateSingle(expr: string, ctx: ExpressionContext): boolean {\n  const trimmed = expr.trim();\n  if (!trimmed) return true;\n  if (trimmed.startsWith('!')) return !evaluateSingle(trimmed.slice(1), ctx);\n\n  const comparisonMatch = trimmed.match(\n    /^(data|input|output)\\.([A-Za-z0-9_.\\[\\]]+)\\s*(===|==|!==|!=|>=|<=|>|<)\\s*(.+)$/\n  );\n  if (comparisonMatch) {\n    const [, root, path, operator, rawRight] = comparisonMatch as [\n      string,\n      string,\n      string,\n      ComparisonOperator,\n      string,\n    ];\n    const left = resolveRoot(root, ctx, path);\n    const right = parseLiteral(rawRight);\n    return compare(left, right, operator);\n  }\n\n  const truthyMatch = trimmed.match(\n    /^(data|input|output)\\.([A-Za-z0-9_.\\[\\]]+)$/\n  );\n  if (truthyMatch) {\n    const [, root, path] = truthyMatch as [string, string, string];\n    const value = resolveRoot(root, ctx, path);\n    return Boolean(value);\n  }\n\n  const literal = parseLiteral(trimmed);\n  return Boolean(literal);\n}\n\ntype ComparisonOperator = '===' | '==' | '!==' | '!=' | '>=' | '<=' | '>' | '<';\n\nfunction compare(\n  left: unknown,\n  right: unknown,\n  operator: ComparisonOperator\n): boolean {\n  switch (operator) {\n    case '===':\n    case '==':\n      return left === right;\n    case '!==':\n    case '!=':\n      return left !== right;\n    case '>':\n      return Number(left) > Number(right);\n    case '>=':\n      return Number(left) >= Number(right);\n    case '<':\n      return Number(left) < Number(right);\n    case '<=':\n      return Number(left) <= Number(right);\n    default:\n      return false;\n  }\n}\n\nfunction parseLiteral(value: string): unknown {\n  const trimmed = (value ?? '').trim();\n  if (\n    (trimmed.startsWith('\"') && trimmed.endsWith('\"')) ||\n    (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))\n  )\n    return trimmed.slice(1, -1);\n  if (/^-?\\d+(\\.\\d+)?$/.test(trimmed)) return Number(trimmed);\n  if (/^true$/i.test(trimmed)) return true;\n  if (/^false$/i.test(trimmed)) return false;\n  if (/^null$/i.test(trimmed)) return null;\n  if (/^undefined$/i.test(trimmed)) return undefined;\n  return trimmed;\n}\n\nfunction resolveRoot(\n  root: string,\n  ctx: ExpressionContext,\n  path: string\n): unknown {\n  const source =\n    root === 'data' ? ctx.data : root === 'input' ? ctx.input : ctx.output;\n  return resolvePath(source, path);\n}\n\nfunction resolvePath(source: unknown, path: string): unknown {\n  if (source == null) return undefined;\n  if (!path) return source;\n  const segments = path\n    .replace(/\\[(\\d+)\\]/g, '.$1')\n    .split('.')\n    .filter(Boolean);\n\n  let current: any = source;\n  for (const segment of segments) {\n    if (current == null) return undefined;\n    current = current[segment as keyof typeof current];\n  }\n  return current;\n}\n\nfunction splitByOperator(expr: string, operator: '&&' | '||'): string[] {\n  const parts: string[] = [];\n  let buffer = '';\n  let inSingleQuote = false;\n  let inDoubleQuote = false;\n\n  for (let i = 0; i < expr.length; i++) {\n    const char = expr[i]!;\n    const next = expr.slice(i, i + operator.length);\n\n    if (char === \"'\" && !inDoubleQuote) {\n      inSingleQuote = !inSingleQuote;\n      buffer += char;\n      continue;\n    }\n    if (char === '\"' && !inSingleQuote) {\n      inDoubleQuote = !inDoubleQuote;\n      buffer += char;\n      continue;\n    }\n\n    if (!inSingleQuote && !inDoubleQuote && next === operator) {\n      parts.push(buffer.trim());\n      buffer = '';\n      i += operator.length - 1;\n      continue;\n    }\n\n    buffer += char;\n  }\n\n  if (buffer.trim().length) parts.push(buffer.trim());\n  return parts;\n}\n"],"mappings":"AAMA,SAAgB,EACd,EACA,EACS,CACT,GAAI,CAAC,EAAY,MAAO,GACxB,IAAM,EAAU,EAAW,MAAM,CACjC,GAAI,CAAC,EAAS,MAAO,GAErB,IAAM,EAAU,EAAgB,EAAS,KAAK,CAC9C,GAAI,EAAQ,OAAS,EACnB,OAAO,EAAQ,KAAM,GAAS,EAAmB,EAAM,EAAI,CAAC,CAE9D,IAAM,EAAW,EAAgB,EAAS,KAAK,CAI/C,OAHI,EAAS,OAAS,EACb,EAAS,MAAO,GAAS,EAAmB,EAAM,EAAI,CAAC,CAEzD,EAAe,EAAS,EAAI,CAGrC,SAAS,EAAe,EAAc,EAAiC,CACrE,IAAM,EAAU,EAAK,MAAM,CAC3B,GAAI,CAAC,EAAS,MAAO,GACrB,GAAI,EAAQ,WAAW,IAAI,CAAE,MAAO,CAAC,EAAe,EAAQ,MAAM,EAAE,CAAE,EAAI,CAE1E,IAAM,EAAkB,EAAQ,MAC9B,iFACD,CACD,GAAI,EAAiB,CACnB,GAAM,EAAG,EAAM,EAAM,EAAU,GAAY,EAS3C,OAAO,EAFM,EAAY,EAAM,EAAK,EAAK,CAC3B,EAAa,EAAS,CACR,EAAS,CAGvC,IAAM,EAAc,EAAQ,MAC1B,8CACD,CACD,GAAI,EAAa,CACf,GAAM,EAAG,EAAM,GAAQ,EAEvB,MAAO,EADO,EAAY,EAAM,EAAK,EAAK,CAK5C,MAAO,EADS,EAAa,EAAQ,CAMvC,SAAS,EACP,EACA,EACA,EACS,CACT,OAAQ,EAAR,CACE,IAAK,MACL,IAAK,KACH,OAAO,IAAS,EAClB,IAAK,MACL,IAAK,KACH,OAAO,IAAS,EAClB,IAAK,IACH,OAAO,OAAO,EAAK,CAAG,OAAO,EAAM,CACrC,IAAK,KACH,OAAO,OAAO,EAAK,EAAI,OAAO,EAAM,CACtC,IAAK,IACH,OAAO,OAAO,EAAK,CAAG,OAAO,EAAM,CACrC,IAAK,KACH,OAAO,OAAO,EAAK,EAAI,OAAO,EAAM,CACtC,QACE,MAAO,IAIb,SAAS,EAAa,EAAwB,CAC5C,IAAM,GAAW,GAAS,IAAI,MAAM,CACpC,GACG,EAAQ,WAAW,IAAI,EAAI,EAAQ,SAAS,IAAI,EAChD,EAAQ,WAAW,IAAI,EAAI,EAAQ,SAAS,IAAI,CAEjD,OAAO,EAAQ,MAAM,EAAG,GAAG,CAC7B,GAAI,kBAAkB,KAAK,EAAQ,CAAE,OAAO,OAAO,EAAQ,CAC3D,GAAI,UAAU,KAAK,EAAQ,CAAE,MAAO,GACpC,GAAI,WAAW,KAAK,EAAQ,CAAE,MAAO,GACrC,GAAI,UAAU,KAAK,EAAQ,CAAE,OAAO,KAChC,mBAAe,KAAK,EAAQ,CAChC,OAAO,EAGT,SAAS,EACP,EACA,EACA,EACS,CAGT,OAAO,EADL,IAAS,OAAS,EAAI,KAAO,IAAS,QAAU,EAAI,MAAQ,EAAI,OACvC,EAAK,CAGlC,SAAS,EAAY,EAAiB,EAAuB,CAC3D,GAAI,GAAU,KAAM,OACpB,GAAI,CAAC,EAAM,OAAO,EAClB,IAAM,EAAW,EACd,QAAQ,aAAc,MAAM,CAC5B,MAAM,IAAI,CACV,OAAO,QAAQ,CAEdA,EAAe,EACnB,IAAK,IAAM,KAAW,EAAU,CAC9B,GAAI,GAAW,KAAM,OACrB,EAAU,EAAQ,GAEpB,OAAO,EAGT,SAAS,EAAgB,EAAc,EAAiC,CACtE,IAAMC,EAAkB,EAAE,CACtB,EAAS,GACT,EAAgB,GAChB,EAAgB,GAEpB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAK,OAAQ,IAAK,CACpC,IAAM,EAAO,EAAK,GACZ,EAAO,EAAK,MAAM,EAAG,EAAI,EAAS,OAAO,CAE/C,GAAI,IAAS,KAAO,CAAC,EAAe,CAClC,EAAgB,CAAC,EACjB,GAAU,EACV,SAEF,GAAI,IAAS,KAAO,CAAC,EAAe,CAClC,EAAgB,CAAC,EACjB,GAAU,EACV,SAGF,GAAI,CAAC,GAAiB,CAAC,GAAiB,IAAS,EAAU,CACzD,EAAM,KAAK,EAAO,MAAM,CAAC,CACzB,EAAS,GACT,GAAK,EAAS,OAAS,EACvB,SAGF,GAAU,EAIZ,OADI,EAAO,MAAM,CAAC,QAAQ,EAAM,KAAK,EAAO,MAAM,CAAC,CAC5C"}