@passiveintent/core 1.0.0

package/dist/intent-sdk-performance.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Copyright (c) 2026 Purushottam <purushottam@passiveintent.dev>
+ *
+ * This source code is licensed under the AGPL-3.0-only license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { PerformanceReport } from './performance-instrumentation.js';
+export interface SimulationConfig {
+    sessions: number;
+    transitionsPerSession: number;
+    stateSpaceSize: number;
+    entropyControl: number;
+    mode: 'baseline' | 'noisy' | 'adversarial' | 'random';
+    anomalySessionRate?: number;
+    seed?: number;
+}
+export interface DeterministicScenarioConfig {
+    seed: number;
+    sessions: number;
+    transitionsPerSession: number;
+    mode: 'baseline' | 'noisy' | 'adversarial' | 'random';
+}
+export interface SessionReplay {
+    stateSequence: string[];
+    entropyValues: number[];
+    divergenceValues: number[];
+}
+export interface ScenarioReplaySummary {
+    seed: number;
+    mode: DeterministicScenarioConfig['mode'];
+    sessions: number;
+    transitionsPerSession: number;
+    sessionReplays: SessionReplay[];
+    evaluation: EvaluationSummary;
+}
+export interface EvaluationSummary {
+    accuracy: number;
+    precision: number;
+    recall: number;
+    f1: number;
+    avgDetectionLatency: number;
+    avgHesitationAtTrigger: number;
+    entropyTriggerRate: number;
+    divergenceTriggerRate: number;
+    truePositiveRate: number;
+    falsePositiveRate: number;
+}
+export interface SimulationSummary {
+    totalTransitions: number;
+    cpuMsPer10kTransitions: number;
+    memoryGrowthBytes: number;
+    entropyTriggerRate: number;
+    divergenceTriggerRate: number;
+    evaluation: EvaluationSummary;
+    performanceReport: PerformanceReport;
+}
+interface SessionResult {
+    isGroundTruthHesitation: boolean;
+    entropyTriggered: boolean;
+    divergenceTriggered: boolean;
+    detectionLatency: number | null;
+    hesitationAtTrigger: number | null;
+}
+export declare function evaluatePredictionMatrix(results: SessionResult[]): EvaluationSummary;
+export declare class BenchmarkSimulationEngine {
+    run(config: SimulationConfig): SimulationSummary;
+    simulateScenario(config: DeterministicScenarioConfig): ScenarioReplaySummary;
+    private runWithReplay;
+}
+export {};
+//# sourceMappingURL=intent-sdk-performance.d.ts.map

package/dist/intent-sdk-performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-sdk-performance.d.ts","sourceRoot":"","sources":["../src/intent-sdk-performance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAQ1E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED,UAAU,aAAa;IACrB,uBAAuB,EAAE,OAAO,CAAC;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAyID,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,iBAAiB,CA8CpF;AAED,qBAAa,yBAAyB;IACpC,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB;IAIhD,gBAAgB,CAAC,MAAM,EAAE,2BAA2B,GAAG,qBAAqB;IAyB5E,OAAO,CAAC,aAAa;CA+HtB"}

package/dist/intent-sdk.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) 2026 Purushottam <purushottam@passiveintent.dev>
+ *
+ * This source code is licensed under the AGPL-3.0-only license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * PassiveIntent
+ * --------------------------------------------------------
+ * Goals:
+ * - Entirely local inference (no network/data egress)
+ * - Tiny footprint + predictable runtime
+ * - Sparse + quantized storage for state transitions
+ */
+/**
+ * Backward-compatible facade module.
+ *
+ * Core implementation has been split across domain modules:
+ * - core/bloom
+ * - core/markov
+ * - engine/intent-manager
+ * - types/events
+ * - persistence/codec
+ */
+export { BloomFilter, computeBloomConfig } from './core/bloom.js';
+export { MarkovGraph } from './core/markov.js';
+export { IntentManager } from './engine/intent-manager.js';
+export { BroadcastSync, MAX_STATE_LENGTH } from './sync/broadcast-sync.js';
+export { normalizeRouteState } from './utils/route-normalizer.js';
+export { ATTENTION_RETURN_THRESHOLD_MS, IDLE_CHECK_INTERVAL_MS, MAX_PLAUSIBLE_DWELL_MS, SMOOTHING_EPSILON, USER_IDLE_THRESHOLD_MS, } from './engine/constants.js';
+export { AnomalyDispatcher } from './engine/anomaly-dispatcher.js';
+export { SignalEngine } from './engine/signal-engine.js';
+export { EventEmitter } from './engine/event-emitter.js';
+export { DriftProtectionPolicy } from './engine/policies/drift-protection-policy.js';
+export { BenchmarkRecorder } from './performance-instrumentation.js';
+export type { AnomalyDispatcherConfig, AnomalyEventEmitter, DriftProtectionPolicyLike, } from './engine/anomaly-dispatcher.js';
+export type { AnomalyDecision, EntropyDecision, TrajectoryDecision, DwellDecision, } from './engine/anomaly-decisions.js';
+export type { SignalEngineConfig } from './engine/signal-engine.js';
+export { BrowserLifecycleAdapter } from './adapters.js';
+export type { IntentEventName, IntentEventMap, HighEntropyPayload, TrajectoryAnomalyPayload, DwellTimeAnomalyPayload, StateChangePayload, BotDetectedPayload, HesitationDetectedPayload, SessionStalePayload, AttentionReturnPayload, UserIdlePayload, UserResumedPayload, ExitIntentPayload, ConversionPayload, PassiveIntentTelemetry, BloomFilterConfig, MarkovGraphConfig, IntentManagerConfig, DwellTimeConfig, PassiveIntentError, } from './types/events.js';
+export type { SerializedMarkovGraph } from './core/markov.js';
+export type { BenchmarkConfig, MemoryFootprintReport, OperationStats, PerformanceReport, } from './performance-instrumentation.js';
+export type { StorageAdapter, AsyncStorageAdapter, LifecycleAdapter } from './adapters.js';
+//# sourceMappingURL=intent-sdk.d.ts.map

package/dist/intent-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-sdk.d.ts","sourceRoot":"","sources":["../src/intent-sdk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,GACd,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,YAAY,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,iBAAiB,GAClB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/performance-instrumentation.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) 2026 Purushottam <purushottam@passiveintent.dev>
+ *
+ * This source code is licensed under the AGPL-3.0-only license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export interface BenchmarkConfig {
+    enabled?: boolean;
+    maxSamples?: number;
+}
+export interface OperationStats {
+    count: number;
+    avgMs: number;
+    p95Ms: number;
+    p99Ms: number;
+    maxMs: number;
+}
+export interface MemoryFootprintReport {
+    stateCount: number;
+    totalTransitions: number;
+    bloomBitsetBytes: number;
+    serializedGraphBytes: number;
+}
+export interface PerformanceReport {
+    benchmarkEnabled: boolean;
+    track: OperationStats;
+    bloomAdd: OperationStats;
+    bloomCheck: OperationStats;
+    incrementTransition: OperationStats;
+    entropyComputation: OperationStats;
+    divergenceComputation: OperationStats;
+    memoryFootprint: MemoryFootprintReport;
+}
+type OpName = 'track' | 'bloomAdd' | 'bloomCheck' | 'incrementTransition' | 'entropyComputation' | 'divergenceComputation';
+/**
+ * Optional performance recorder for the SDK’s internal hot-path operations.
+ *
+ * Disabled by default (`enabled: false`) — all `now()` and `record()` calls
+ * are no-ops when disabled, so there is zero overhead in production unless
+ * callers explicitly opt in via `IntentManagerConfig.benchmark.enabled: true`.
+ *
+ * Exposes p95/p99 latency and a memory-footprint snapshot via `report()`.
+ */
+export declare class BenchmarkRecorder {
+    readonly enabled: boolean;
+    private readonly maxSamples;
+    private readonly stats;
+    constructor(config?: BenchmarkConfig);
+    now(): number;
+    record(operation: OpName, startedAt: number): void;
+    report(memoryFootprint: MemoryFootprintReport): PerformanceReport;
+    serializedSizeBytes(payload: unknown): number;
+}
+export {};
+//# sourceMappingURL=performance-instrumentation.d.ts.map

package/dist/performance-instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-instrumentation.d.ts","sourceRoot":"","sources":["../src/performance-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,cAAc,CAAC;IAC3B,mBAAmB,EAAE,cAAc,CAAC;IACpC,kBAAkB,EAAE,cAAc,CAAC;IACnC,qBAAqB,EAAE,cAAc,CAAC;IACtC,eAAe,EAAE,qBAAqB,CAAC;CACxC;AA2DD,KAAK,MAAM,GACP,OAAO,GACP,UAAU,GACV,YAAY,GACZ,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,CAAC;AAE5B;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;gBAEjD,MAAM,GAAE,eAAoB;IAaxC,GAAG,IAAI,MAAM;IAIb,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKlD,MAAM,CAAC,eAAe,EAAE,qBAAqB,GAAG,iBAAiB;IAajE,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;CAI9C"}

package/dist/reporting-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026 Purushottam <purushottam@passiveintent.dev>
+ *
+ * This source code is licensed under the AGPL-3.0-only license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { EvaluationSummary } from './intent-sdk-performance.js';
+export interface PerfSummaryInput {
+    avgTrackMs: number;
+    p95TrackMs: number;
+    p99TrackMs: number;
+    memoryUsageEstimate: number;
+    serializedGraphSizeBytes: number;
+}
+export declare function printPerfSummary(summary: PerfSummaryInput): string;
+export declare function printAccuracySummary(summary: EvaluationSummary): string;
+//# sourceMappingURL=reporting-utils.d.ts.map

package/dist/reporting-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-utils.d.ts","sourceRoot":"","sources":["../src/reporting-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAalE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAcvE"}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@passiveintent/core",
+  "version": "1.0.0",
+  "description": "Privacy-first, SSR-safe intent detection engine using local Markov-chain inference and Bloom filters.",
+  "keywords": [
+    "intent",
+    "analytics",
+    "privacy",
+    "markov-chain",
+    "churn-prevention",
+    "zero-egress",
+    "gdpr",
+    "bloom-filter",
+    "edge-computing",
+    "behavioral-analytics"
+  ],
+  "author": "Purushottam <purushottam@passiveintent.dev> (https://github.com/purushpsm147)",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/passiveintent/core.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/passiveintent/core#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./calibration": {
+      "import": {
+        "types": "./dist/calibration.d.ts",
+        "default": "./dist/calibration.js"
+      },
+      "require": {
+        "types": "./dist/calibration.d.ts",
+        "default": "./dist/calibration.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist/*.js",
+    "dist/*.js.map",
+    "dist/*.cjs",
+    "dist/*.cjs.map",
+    "dist/*.d.ts",
+    "dist/*.d.ts.map"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && npm run build:js && npm run build:types",
+    "build:js": "tsup",
+    "build:types": "tsc --project tsconfig.types.json",
+    "build:tsc": "tsc --project tsconfig.json --declaration --sourceMap",
+    "release:pack": "npm run build && npm pack",
+    "release": "npm publish",
+    "test": "npm run test:unit",
+    "test:unit": "npm run build:tsc && node --test tests/*.test.mjs",
+    "test:coverage": "npm run build:tsc && c8 node --test tests/*.test.mjs",
+    "test:perf:run": "npm run build:tsc && node scripts/perf-runner.mjs",
+    "test:perf:assert": "node scripts/perf-regression.mjs",
+    "test:perf:matrix": "npm run build:tsc && node scripts/scenario-matrix.mjs --check-golden",
+    "test:perf:roc": "npm run build:tsc && node scripts/roc-experiment.mjs",
+    "bench:smoothing": "npm run build:tsc && node --test scripts/smoothing-alpha-benchmark.mjs",
+    "test:perf": "npm run test:perf:run && npm run test:perf:assert && npm run test:perf:matrix",
+    "test:perf:all": "npm run test:perf && npm run test:perf:roc",
+    "test:perf:update-baseline": "npm run build:tsc && node scripts/perf-runner.mjs --update-baseline",
+    "test:perf:update-matrix-golden": "npm run build:tsc && node scripts/scenario-matrix.mjs --update-golden",
+    "build:sandbox": "tsc --project tsconfig.sandbox.json",
+    "test:e2e": "npm run build:tsc && npm run build:sandbox && cypress run",
+    "test:e2e:headed": "npm run build:tsc && npm run build:sandbox && cypress run --headed --browser chrome",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "lint": "npm run typecheck",
+    "test:ci": "npm run lint && npm run build && npm run test:unit && npm run test:perf:assert",
+    "verify:package": "npm run build && node scripts/verify-package.mjs"
+  },
+  "devDependencies": {
+    "c8": "^10.1.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}