@svrnsec/pulse 0.3.0 → 0.3.1

package/index.d.ts

@@ -586,3 +586,131 @@ export interface SignatureComparison {
   profileMatch: boolean;
   providerMatch: boolean;
 }
+
+// =============================================================================
+// Extended Signal Layer Types
+// =============================================================================
+
+// ── ENF (Electrical Network Frequency) ───────────────────────────────────────
+
+export interface EnfResult {
+  enfAvailable: boolean;
+  ripplePresent: boolean;
+  gridFrequency: 50 | 60 | null;
+  gridRegion: 'americas' | 'emea_apac' | 'unknown';
+  ripplePower: number;
+  snr50hz: number;
+  snr60hz: number;
+  enfDeviation: number | null;
+  sampleRateHz: number;
+  resolutionUs: number;
+  verdict: 'grid_60hz' | 'grid_50hz' | 'no_grid_signal' | 'grid_detected_region_unknown' | 'unavailable';
+  isVmIndicator: boolean;
+  temporalAnchor: {
+    nominalHz: number;
+    measuredRippleHz: number;
+    capturedAt: number;
+    gridHz: number;
+  } | null;
+  reason?: string;
+}
+
+export declare function collectEnfTimings(opts?: { iterations?: number }): Promise<EnfResult>;
+
+// ── WebGPU Thermal Variance ───────────────────────────────────────────────────
+
+export interface GpuEntropyResult {
+  gpuPresent: boolean;
+  isSoftware: boolean;
+  vendorString: string | null;
+  dispatchCV: number;
+  thermalGrowth: number;
+  verdict: 'real_gpu' | 'software_renderer' | 'no_webgpu' | 'ambiguous';
+}
+
+export declare function collectGpuEntropy(opts?: object): Promise<GpuEntropyResult>;
+
+// ── DRAM Refresh Cycle ────────────────────────────────────────────────────────
+
+export interface DramResult {
+  timings: number[];
+  refreshPeriodMs: number | null;
+  refreshPresent: boolean;
+  peakLag: number;
+  peakPower: number;
+  verdict: 'dram' | 'virtual' | 'ambiguous';
+}
+
+export declare function collectDramTimings(opts?: { iterations?: number; bufferMb?: number }): DramResult;
+
+// ── LLM / AI Agent Behavioral Fingerprint ─────────────────────────────────────
+
+export interface LlmResult {
+  aiConf: number;
+  thinkTimePattern: 'llm_latency_peak' | 'human_pareto' | 'unknown';
+  correctionRate: number;
+  rhythmicity: number;
+  pauseDistribution: 'uniform' | 'pareto' | 'unknown';
+  verdict: 'ai_agent' | 'human' | 'insufficient_data';
+  matchedModel: string | null;
+}
+
+export declare function detectLlmAgent(bioSnapshot: object): LlmResult;
+
+// ── SAB Microsecond Timer ─────────────────────────────────────────────────────
+
+export interface SabTimerResult {
+  isClamped: boolean;
+  clampAmountUs: number;
+  resolutionUs: number;
+}
+
+export declare function isSabAvailable(): boolean;
+export declare function collectHighResTimings(opts?: { iterations?: number; matrixSize?: number }): {
+  timings: number[];
+  resolutionUs: number;
+};
+
+// =============================================================================
+// Terminal / DX Utilities
+// =============================================================================
+
+export declare function renderProbeResult(opts: {
+  payload: ProofPayload;
+  hash: string;
+  result?: ValidationResult;
+  enf?: EnfResult | null;
+  gpu?: GpuEntropyResult | null;
+  dram?: DramResult | null;
+  llm?: LlmResult | null;
+  elapsedMs?: number;
+}): void;
+
+export declare function renderError(err: Error | string): void;
+export declare function renderInlineUpdateHint(latest: string): void;
+
+// =============================================================================
+// Version / Update Notifier
+// =============================================================================
+
+export declare const CURRENT_VERSION: string;
+
+export declare function checkForUpdate(opts?: {
+  silent?: boolean;
+  pkg?: string;
+}): Promise<{ current: string; latest: string | null; updateAvailable: boolean }>;
+
+export declare function notifyOnExit(opts?: { pkg?: string }): void;
+
+// =============================================================================
+// Extended PulseCommitment (includes extended signal layer results)
+// =============================================================================
+
+export interface ExtendedPulseCommitment extends PulseCommitment {
+  extended: {
+    enf:  EnfResult  | null;
+    gpu:  GpuEntropyResult | null;
+    dram: DramResult | null;
+    llm:  LlmResult  | null;
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svrnsec/pulse",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Physical Turing Test — Hardware-Biological Symmetry Protocol distinguishing real consumer devices from sanitised datacenter VMs.",
   "type": "module",
   "license": "MIT",

package/src/proof/fingerprint.js

@@ -54,9 +54,9 @@ export function blake3HexStr(str) {
  * @param {string}  p.nonce    – server-issued challenge nonce (hex)
  * @returns {ProofPayload}
  */
-export function buildProof({ entropy, jitter, bio, canvas, audio, nonce }) {
+export function buildProof({ entropy, jitter, bio, canvas, audio, enf, gpu, dram, llm, nonce }) {
   if (!nonce || typeof nonce !== 'string') {
-    throw new Error('@sovereign/pulse: nonce is required for anti-replay protection');
+    throw new Error('@svrnsec/pulse: nonce is required for anti-replay protection');
   }
 
   // Hash the raw timing arrays IN-BROWSER so we can prove their integrity
@@ -138,12 +138,68 @@ export function buildProof({ entropy, jitter, bio, canvas, audio, nonce }) {
         jitterMeanMs:         _round(audio.jitterMeanMs,        4),
         jitterP95Ms:          _round(audio.jitterP95Ms,         4),
       },
+
+      // ── Electrical Network Frequency ─────────────────────────────────────
+      enf: enf ? {
+        available:       enf.enfAvailable,
+        ripplePresent:   enf.ripplePresent,
+        gridFrequency:   enf.gridFrequency,
+        gridRegion:      enf.gridRegion,
+        ripplePower:     _round(enf.ripplePower,    4),
+        enfDeviation:    _round(enf.enfDeviation,   3),
+        snr50hz:         _round(enf.snr50hz,        2),
+        snr60hz:         _round(enf.snr60hz,        2),
+        sampleRateHz:    _round(enf.sampleRateHz,   1),
+        verdict:         enf.verdict,
+        isVmIndicator:   enf.isVmIndicator,
+        capturedAt:      enf.temporalAnchor?.capturedAt ?? null,
+      } : null,
+
+      // ── WebGPU thermal variance ───────────────────────────────────────────
+      gpu: gpu ? {
+        available:       gpu.gpuPresent,
+        isSoftware:      gpu.isSoftware,
+        vendorString:    gpu.vendorString,
+        dispatchCV:      _round(gpu.dispatchCV,     4),
+        thermalGrowth:   _round(gpu.thermalGrowth,  4),
+        verdict:         gpu.verdict,
+      } : null,
+
+      // ── DRAM refresh cycle ────────────────────────────────────────────────
+      dram: dram ? {
+        refreshPresent:  dram.refreshPresent,
+        refreshPeriodMs: _round(dram.refreshPeriodMs, 2),
+        peakPower:       _round(dram.peakPower,        4),
+        verdict:         dram.verdict,
+      } : null,
+
+      // ── LLM / AI agent behavioral fingerprint ────────────────────────────
+      llm: llm ? {
+        aiConf:             _round(llm.aiConf,            3),
+        thinkTimePattern:   llm.thinkTimePattern,
+        correctionRate:     _round(llm.correctionRate,    3),
+        rhythmicity:        _round(llm.rhythmicity,       3),
+        pauseDistribution:  llm.pauseDistribution,
+        verdict:            llm.verdict,
+        matchedModel:       llm.matchedModel ?? null,
+      } : null,
     },
 
-    // Top-level classification summary
+    // Top-level classification summary — all signal layers combined
     classification: {
-      jitterScore:  _round(jitter.score, 4),
-      flags:        jitter.flags ?? [],
+      jitterScore:    _round(jitter.score, 4),
+      flags:          jitter.flags ?? [],
+      enfVerdict:     enf?.verdict  ?? 'unavailable',
+      gpuVerdict:     gpu?.verdict  ?? 'unavailable',
+      dramVerdict:    dram?.verdict ?? 'unavailable',
+      llmVerdict:     llm?.verdict  ?? 'unavailable',
+      // Combined VM confidence: any hard signal raises this
+      vmIndicators: [
+        enf?.isVmIndicator  ? 'enf_no_grid'     : null,
+        gpu?.isSoftware     ? 'gpu_software'     : null,
+        dram?.verdict === 'virtual' ? 'dram_no_refresh' : null,
+        llm?.aiConf > 0.7   ? 'llm_agent'        : null,
+      ].filter(Boolean),
     },
   };