@simulatte/doppler 0.1.8 → 0.2.0

package/src/hotswap/manifest.js

@@ -1,124 +0,0 @@
-
-
-import { log } from '../debug/index.js';
-
-// =============================================================================
-// Fetch + Verification
-// =============================================================================
-
-export async function fetchHotSwapManifest(url) {
-  const response = await fetch(url, { cache: 'no-store' });
-  if (!response.ok) {
-    throw new Error(`Failed to fetch hot-swap manifest: ${response.status}`);
-  }
-  return response.json();
-}
-
-function isExplicitLocalSource(source) {
-  if (!source || typeof source !== 'object') {
-    return false;
-  }
-  if (source.isLocal === true) {
-    return true;
-  }
-  return source.kind === 'local';
-}
-
-export async function verifyHotSwapManifest(manifest, policy, context = {}) {
-  if (!policy.enabled) {
-    return { ok: false, reason: 'Hot-swap disabled' };
-  }
-
-  if (!manifest.signature) {
-    if (policy.localOnly && policy.allowUnsignedLocal && isExplicitLocalSource(context.source)) {
-      return { ok: true, reason: 'Local-only unsigned manifest accepted' };
-    }
-    return { ok: false, reason: 'Signature required' };
-  }
-
-  if (!manifest.signerId) {
-    return { ok: false, reason: 'Missing signerId' };
-  }
-
-  const signer = policy.trustedSigners.find((entry) => entry.id === manifest.signerId);
-  if (!signer) {
-    return { ok: false, reason: `Signer not trusted: ${manifest.signerId}`, signerId: manifest.signerId };
-  }
-
-  const subtle = globalThis.crypto?.subtle;
-  if (!subtle) {
-    return { ok: false, reason: 'WebCrypto unavailable', signerId: manifest.signerId };
-  }
-
-  try {
-    const payloadBytes = new TextEncoder().encode(serializeHotSwapManifest(manifest));
-    const payload = new Uint8Array(payloadBytes);
-    const signatureBytes = new Uint8Array(decodeBase64ToArrayBuffer(manifest.signature));
-    const key = await importSignerKey(signer);
-    const ok = await subtle.verify(
-      { name: 'ECDSA', hash: 'SHA-256' },
-      key,
-      signatureBytes,
-      payload
-    );
-    return ok
-      ? { ok: true, reason: 'Signature verified', signerId: manifest.signerId }
-      : { ok: false, reason: 'Signature mismatch', signerId: manifest.signerId };
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    log.warn('HotSwap', `Signature verification failed: ${message}`);
-    return { ok: false, reason: 'Signature verification failed', signerId: manifest.signerId };
-  }
-}
-
-export function serializeHotSwapManifest(manifest) {
-  const { signature, ...payload } = manifest;
-  return stableStringify(payload);
-}
-
-// =============================================================================
-// Helpers
-// =============================================================================
-
-async function importSignerKey(signer) {
-  return globalThis.crypto.subtle.importKey(
-    'jwk',
-    signer.publicKeyJwk,
-    { name: 'ECDSA', namedCurve: 'P-256' },
-    false,
-    ['verify']
-  );
-}
-
-function decodeBase64ToArrayBuffer(value) {
-  if (typeof atob === 'function') {
-    const raw = atob(value);
-    const bytes = new Uint8Array(raw.length);
-    for (let i = 0; i < raw.length; i += 1) {
-      bytes[i] = raw.charCodeAt(i);
-    }
-    return bytes.buffer;
-  }
-
-  if (typeof Buffer !== 'undefined') {
-    const buffer = Buffer.from(value, 'base64');
-    return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
-  }
-
-  throw new Error('No base64 decoder available');
-}
-
-function stableStringify(value) {
-  if (value === null || typeof value !== 'object') {
-    return JSON.stringify(value);
-  }
-
-  if (Array.isArray(value)) {
-    return `[${value.map((item) => stableStringify(item)).join(',')}]`;
-  }
-
-  const record = value;
-  const keys = Object.keys(record).sort();
-  const entries = keys.map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`);
-  return `{${entries.join(',')}}`;
-}

package/src/hotswap/runtime.d.ts

@@ -1,31 +0,0 @@
-import type { HotSwapManifest } from './manifest.js';
-import type { HotSwapConfigSchema } from '../config/schema/hotswap.schema.js';
-
-export interface HotSwapRolloutContext {
-  subjectId?: string | null;
-  modelId?: string | null;
-  modelUrl?: string | null;
-  sessionId?: string | null;
-  optInTag?: string | null;
-  forceEnable?: boolean;
-}
-
-export interface HotSwapRolloutDecision {
-  allowed: boolean;
-  mode: string;
-  reason: string;
-  bucket: number | null;
-  threshold: number | null;
-  subjectId: string | null;
-}
-
-export declare function evaluateHotSwapRollout(
-  policy: HotSwapConfigSchema | null | undefined,
-  context?: HotSwapRolloutContext
-): HotSwapRolloutDecision;
-
-export declare function getHotSwapManifest(): HotSwapManifest | null;
-
-export declare function setHotSwapManifest(manifest: HotSwapManifest | null): void;
-
-export declare function getLastHotSwapRolloutDecision(): HotSwapRolloutDecision | null;

package/src/hotswap/runtime.js

@@ -1,150 +0,0 @@
-let activeManifest = null;
-let lastRolloutDecision = null;
-
-function normalizeRolloutPolicy(policy) {
-  const rollout = policy?.rollout && typeof policy.rollout === 'object'
-    ? policy.rollout
-    : {};
-  const rawMode = String(rollout.mode || 'shadow').trim().toLowerCase().replace(/_/g, '-');
-  if (rawMode !== 'default' && rawMode !== 'canary' && rawMode !== 'opt-in' && rawMode !== 'shadow') {
-    throw new Error(
-      `hotswap.rollout.mode must be one of default, canary, opt-in, shadow (received "${rollout.mode}")`
-    );
-  }
-  let canaryPercent = 0;
-  if (rollout.canaryPercent !== undefined && rollout.canaryPercent !== null) {
-    const parsedCanaryPercent = Number(rollout.canaryPercent);
-    if (!Number.isFinite(parsedCanaryPercent) || parsedCanaryPercent < 0 || parsedCanaryPercent > 100) {
-      throw new Error('hotswap.rollout.canaryPercent must be a number between 0 and 100 when provided.');
-    }
-    canaryPercent = parsedCanaryPercent;
-  }
-  if (rollout.cohortSalt !== undefined && rollout.cohortSalt !== null && typeof rollout.cohortSalt !== 'string') {
-    throw new Error('hotswap.rollout.cohortSalt must be a string when provided.');
-  }
-  const cohortSalt = String(rollout.cohortSalt || 'doppler-hotswap-v1').trim() || 'doppler-hotswap-v1';
-  if (rollout.optInAllowlist !== undefined && rollout.optInAllowlist !== null && !Array.isArray(rollout.optInAllowlist)) {
-    throw new Error('hotswap.rollout.optInAllowlist must be an array of strings when provided.');
-  }
-  const optInAllowlist = Array.isArray(rollout.optInAllowlist)
-    ? rollout.optInAllowlist.map((entry, index) => {
-      if (typeof entry !== 'string') {
-        throw new Error(`hotswap.rollout.optInAllowlist[${index}] must be a string.`);
-      }
-      const normalized = entry.trim();
-      if (!normalized) {
-        throw new Error(`hotswap.rollout.optInAllowlist[${index}] must not be empty.`);
-      }
-      return normalized;
-    })
-    : [];
-  return {
-    mode: rawMode,
-    canaryPercent,
-    cohortSalt,
-    optInAllowlist,
-  };
-}
-
-function hashBucket(value) {
-  const source = String(value || '');
-  let hash = 2166136261;
-  for (let i = 0; i < source.length; i += 1) {
-    hash ^= source.charCodeAt(i);
-    hash = Math.imul(hash, 16777619);
-  }
-  return Math.abs(hash >>> 0) % 100;
-}
-
-export function evaluateHotSwapRollout(policy = {}, context = {}) {
-  if (policy?.enabled !== true) {
-    const disabled = {
-      allowed: false,
-      mode: 'disabled',
-      reason: 'hotswap_disabled',
-      bucket: null,
-      threshold: null,
-      subjectId: null,
-    };
-    lastRolloutDecision = disabled;
-    return disabled;
-  }
-
-  const rollout = normalizeRolloutPolicy(policy);
-  const subjectId = String(
-    context.subjectId
-    || context.modelId
-    || context.modelUrl
-    || context.sessionId
-    || 'anonymous'
-  );
-  const forced = context.forceEnable === true;
-  const optInTag = String(context.optInTag || '').trim();
-  const bucket = hashBucket(`${rollout.cohortSalt}:${subjectId}`);
-
-  let decision = null;
-  if (forced) {
-    decision = {
-      allowed: true,
-      mode: rollout.mode,
-      reason: 'force_enable',
-      bucket,
-      threshold: rollout.mode === 'canary' ? rollout.canaryPercent : null,
-      subjectId,
-    };
-  } else if (rollout.mode === 'default') {
-    decision = {
-      allowed: true,
-      mode: rollout.mode,
-      reason: 'default_enabled',
-      bucket,
-      threshold: null,
-      subjectId,
-    };
-  } else if (rollout.mode === 'canary') {
-    decision = {
-      allowed: bucket < rollout.canaryPercent,
-      mode: rollout.mode,
-      reason: bucket < rollout.canaryPercent ? 'canary_selected' : 'canary_excluded',
-      bucket,
-      threshold: rollout.canaryPercent,
-      subjectId,
-    };
-  } else if (rollout.mode === 'opt-in') {
-    const allowlisted = rollout.optInAllowlist.includes(subjectId);
-    const tagged = optInTag.length > 0 && rollout.optInAllowlist.includes(optInTag);
-    const allowed = allowlisted === true || tagged === true;
-    decision = {
-      allowed,
-      mode: rollout.mode,
-      reason: allowed ? 'opt_in_selected' : 'opt_in_required',
-      bucket,
-      threshold: null,
-      subjectId,
-    };
-  } else {
-    decision = {
-      allowed: false,
-      mode: rollout.mode,
-      reason: 'shadow_mode',
-      bucket,
-      threshold: null,
-      subjectId,
-    };
-  }
-
-  lastRolloutDecision = decision;
-  return decision;
-}
-
-export function getHotSwapManifest() {
-  return activeManifest;
-}
-
-export function setHotSwapManifest(manifest) {
-  activeManifest = manifest;
-}
-
-export function getLastHotSwapRolloutDecision() {
-  return lastRolloutDecision;
-}

package/src/index-browser.d.ts

@@ -1,92 +0,0 @@
-export declare const DOPPLER_VERSION: string;
-export { doppler } from './client/doppler-api.browser.js';
-
-export {
-  DopplerLoader,
-  getDopplerLoader,
-  createDopplerLoader,
-} from './loader/doppler-loader.js';
-export { MultiModelLoader } from './loader/multi-model-loader.js';
-
-export { InferencePipeline, EmbeddingPipeline, createPipeline } from './generation/index.js';
-export {
-  StructuredJsonHeadPipeline,
-  isStructuredJsonHeadModelType,
-  createStructuredJsonHeadPipeline,
-  DreamStructuredPipeline,
-  isDreamStructuredModelType,
-  createDreamStructuredPipeline,
-} from './generation/index.js';
-export {
-  EnergyRowHeadPipeline,
-  createEnergyRowHeadPipeline,
-  DreamEnergyHeadPipeline,
-  createDreamEnergyHeadPipeline,
-} from './inference/pipelines/energy-head/row-head-pipeline.js';
-export { KVCache } from './inference/kv-cache.js';
-export { Tokenizer } from './inference/tokenizer.js';
-export { SpeculativeDecoder } from './inference/speculative.js';
-
-export { ExpertRouter } from './inference/expert-router.js';
-export { MoERouter } from './inference/moe-router.js';
-export { MultiModelNetwork } from './inference/multi-model-network.js';
-export { MultiPipelinePool } from './inference/multi-pipeline-pool.js';
-
-export {
-  LogitMergeKernel,
-  getLogitMergeKernel,
-  mergeLogits,
-  mergeMultipleLogits,
-} from './gpu/kernels/logit-merge.js';
-
-export type { RDRRManifest, ShardInfo } from './formats/rdrr/index.js';
-export type { TensorLocation, LoadProgress, LoadOptions, LoaderStats } from './loader/doppler-loader.js';
-export type { AdapterSource } from './loader/multi-model-loader.js';
-export type { ParsedModelConfig } from './generation/index.js';
-export type { SamplingOptions } from './generation/index.js';
-export type {
-  GenerateOptions,
-  GenerationResult,
-  KVCacheSnapshot,
-  LayerWeights,
-  ExpertWeights,
-  RouterWeights,
-} from './generation/index.js';
-export type { LoRAAdapter, LoRAModuleName } from './generation/index.js';
-export type { ExpertNode, ExpertTask } from './inference/multi-model-network.js';
-
-export {
-  ADAPTER_MANIFEST_SCHEMA,
-  validateManifest as validateAdapterManifest,
-  parseManifest as parseAdapterManifest,
-  serializeManifest as serializeAdapterManifest,
-  createManifest as createAdapterManifest,
-  computeLoRAScale,
-  loadLoRAWeights,
-  loadLoRAFromManifest,
-  loadLoRAFromUrl,
-  loadLoRAFromSafetensors,
-  AdapterManager,
-  getAdapterManager,
-  resetAdapterManager,
-  AdapterRegistry,
-  getAdapterRegistry,
-  resetAdapterRegistry,
-  createMemoryRegistry,
-} from './adapters/index.js';
-
-export type {
-  AdapterManifest,
-  AdapterMetadata,
-  AdapterTensorSpec,
-  LoRALoadOptions,
-  LoRAWeightsResult,
-  AdapterState,
-  EnableAdapterOptions,
-  AdapterStackOptions,
-  AdapterManagerEvents,
-  AdapterRegistryEntry,
-  AdapterQueryOptions,
-} from './adapters/index.js';
-
-export * from './tooling-exports.browser.js';

package/src/index-browser.js

@@ -1,68 +0,0 @@
-export { DOPPLER_VERSION } from './version.js';
-export { doppler } from './client/doppler-api.browser.js';
-
-// Core loaders
-export {
-  DopplerLoader,
-  getDopplerLoader,
-  createDopplerLoader,
-} from './loader/doppler-loader.js';
-export { MultiModelLoader } from './loader/multi-model-loader.js';
-
-// Inference pipeline
-export { InferencePipeline, EmbeddingPipeline, createPipeline } from './generation/index.js';
-export {
-  StructuredJsonHeadPipeline,
-  isStructuredJsonHeadModelType,
-  createStructuredJsonHeadPipeline,
-  DreamStructuredPipeline,
-  isDreamStructuredModelType,
-  createDreamStructuredPipeline,
-} from './generation/index.js';
-export {
-  EnergyRowHeadPipeline,
-  createEnergyRowHeadPipeline,
-  DreamEnergyHeadPipeline,
-  createDreamEnergyHeadPipeline,
-} from './inference/pipelines/energy-head/row-head-pipeline.js';
-export { KVCache } from './inference/kv-cache.js';
-export { Tokenizer } from './inference/tokenizer.js';
-export { SpeculativeDecoder } from './inference/speculative.js';
-
-// Multi-model orchestration
-export { ExpertRouter } from './inference/expert-router.js';
-export { MoERouter } from './inference/moe-router.js';
-export { MultiModelNetwork } from './inference/multi-model-network.js';
-export { MultiPipelinePool } from './inference/multi-pipeline-pool.js';
-
-// GPU primitives
-export {
-  LogitMergeKernel,
-  getLogitMergeKernel,
-  mergeLogits,
-  mergeMultipleLogits,
-} from './gpu/kernels/logit-merge.js';
-
-// LoRA Adapter Infrastructure
-export {
-  ADAPTER_MANIFEST_SCHEMA,
-  validateManifest as validateAdapterManifest,
-  parseManifest as parseAdapterManifest,
-  serializeManifest as serializeAdapterManifest,
-  createManifest as createAdapterManifest,
-  computeLoRAScale,
-  loadLoRAWeights,
-  loadLoRAFromManifest,
-  loadLoRAFromUrl,
-  loadLoRAFromSafetensors,
-  AdapterManager,
-  getAdapterManager,
-  resetAdapterManager,
-  AdapterRegistry,
-  getAdapterRegistry,
-  resetAdapterRegistry,
-  createMemoryRegistry,
-} from './adapters/index.js';
-
-// Tooling Surface — re-exported for browser tooling consumers.
-export * from './tooling-exports.browser.js';

package/src/index-internal.d.ts

@@ -1,2 +0,0 @@
-export * from './index.js';
-export * from './tooling-exports.js';

package/src/index-internal.js

@@ -1,2 +0,0 @@
-export * from './index.js';
-export * from './tooling-exports.js';

package/src/index.d.ts

@@ -1,103 +0,0 @@
-export declare const DOPPLER_VERSION: string;
-export { doppler } from './client/doppler-api.js';
-
-// Core loaders
-export {
-  DopplerLoader,
-  getDopplerLoader,
-  createDopplerLoader,
-} from './loader/doppler-loader.js';
-export { MultiModelLoader } from './loader/multi-model-loader.js';
-
-// Inference pipeline
-export { InferencePipeline, EmbeddingPipeline, createPipeline } from './generation/index.js';
-export {
-  StructuredJsonHeadPipeline,
-  isStructuredJsonHeadModelType,
-  createStructuredJsonHeadPipeline,
-  DreamStructuredPipeline,
-  isDreamStructuredModelType,
-  createDreamStructuredPipeline,
-} from './generation/index.js';
-export {
-  EnergyRowHeadPipeline,
-  createEnergyRowHeadPipeline,
-  DreamEnergyHeadPipeline,
-  createDreamEnergyHeadPipeline,
-} from './inference/pipelines/energy-head/row-head-pipeline.js';
-export { KVCache } from './inference/kv-cache.js';
-export { Tokenizer } from './inference/tokenizer.js';
-export { SpeculativeDecoder } from './inference/speculative.js';
-
-// Multi-model orchestration
-export { ExpertRouter } from './inference/expert-router.js';
-export { MoERouter } from './inference/moe-router.js';
-export { MultiModelNetwork } from './inference/multi-model-network.js';
-export { MultiPipelinePool } from './inference/multi-pipeline-pool.js';
-
-// GPU primitives
-export {
-  LogitMergeKernel,
-  getLogitMergeKernel,
-  mergeLogits,
-  mergeMultipleLogits,
-} from './gpu/kernels/logit-merge.js';
-
-// Types
-export type { RDRRManifest, ShardInfo } from './formats/rdrr/index.js';
-export type { TensorLocation, LoadProgress, LoadOptions, LoaderStats } from './loader/doppler-loader.js';
-export type { AdapterSource } from './loader/multi-model-loader.js';
-export type { ParsedModelConfig } from './generation/index.js';
-export type { SamplingOptions } from './generation/index.js';
-export type {
-  GenerateOptions,
-  GenerationResult,
-  KVCacheSnapshot,
-  LayerWeights,
-  ExpertWeights,
-  RouterWeights,
-} from './generation/index.js';
-export type { LoRAAdapter, LoRAModuleName } from './generation/index.js';
-export type { ExpertNode, ExpertTask } from './inference/multi-model-network.js';
-
-// LoRA Adapter Infrastructure
-export {
-  ADAPTER_MANIFEST_SCHEMA,
-  validateManifest as validateAdapterManifest,
-  parseManifest as parseAdapterManifest,
-  serializeManifest as serializeAdapterManifest,
-  createManifest as createAdapterManifest,
-  computeLoRAScale,
-  loadLoRAWeights,
-  loadLoRAFromManifest,
-  loadLoRAFromUrl,
-  loadLoRAFromSafetensors,
-  AdapterManager,
-  getAdapterManager,
-  resetAdapterManager,
-  AdapterRegistry,
-  getAdapterRegistry,
-  resetAdapterRegistry,
-  createMemoryRegistry,
-} from './adapters/index.js';
-
-export type {
-  AdapterManifest,
-  AdapterMetadata,
-  AdapterTensorSpec,
-  LoRALoadOptions,
-  LoRAWeightsResult,
-  AdapterState,
-  EnableAdapterOptions,
-  AdapterStackOptions,
-  AdapterManagerEvents,
-  AdapterRegistryEntry,
-  AdapterQueryOptions,
-} from './adapters/index.js';
-
-// ============================================================================
-// Tooling Surface — Re-exported for backward compatibility.
-// Prefer importing from 'doppler/tooling' for tooling-only consumers.
-// ============================================================================
-
-export * from './tooling-exports.shared.js';

package/src/index.js

@@ -1,76 +0,0 @@
-export { DOPPLER_VERSION } from './version.js';
-export { doppler } from './client/doppler-api.js';
-
-// Core loaders
-export {
-  DopplerLoader,
-  getDopplerLoader,
-  createDopplerLoader,
-} from './loader/doppler-loader.js';
-export { MultiModelLoader } from './loader/multi-model-loader.js';
-
-// Inference pipeline
-export { InferencePipeline, EmbeddingPipeline, createPipeline } from './generation/index.js';
-export {
-  StructuredJsonHeadPipeline,
-  isStructuredJsonHeadModelType,
-  createStructuredJsonHeadPipeline,
-  DreamStructuredPipeline,
-  isDreamStructuredModelType,
-  createDreamStructuredPipeline,
-} from './generation/index.js';
-export {
-  EnergyRowHeadPipeline,
-  createEnergyRowHeadPipeline,
-  DreamEnergyHeadPipeline,
-  createDreamEnergyHeadPipeline,
-} from './inference/pipelines/energy-head/row-head-pipeline.js';
-export { KVCache } from './inference/kv-cache.js';
-export { Tokenizer } from './inference/tokenizer.js';
-export { SpeculativeDecoder } from './inference/speculative.js';
-
-// Multi-model orchestration
-export { ExpertRouter } from './inference/expert-router.js';
-export { MoERouter } from './inference/moe-router.js';
-export { MultiModelNetwork } from './inference/multi-model-network.js';
-export { MultiPipelinePool } from './inference/multi-pipeline-pool.js';
-
-// GPU primitives
-export {
-  LogitMergeKernel,
-  getLogitMergeKernel,
-  mergeLogits,
-  mergeMultipleLogits,
-} from './gpu/kernels/logit-merge.js';
-
-// LoRA Adapter Infrastructure (Tier 1 P0 - RSI Foundation)
-export {
-  // Manifest
-  ADAPTER_MANIFEST_SCHEMA,
-  validateManifest as validateAdapterManifest,
-  parseManifest as parseAdapterManifest,
-  serializeManifest as serializeAdapterManifest,
-  createManifest as createAdapterManifest,
-  computeLoRAScale,
-  // Loader
-  loadLoRAWeights,
-  loadLoRAFromManifest,
-  loadLoRAFromUrl,
-  loadLoRAFromSafetensors,
-  // Manager
-  AdapterManager,
-  getAdapterManager,
-  resetAdapterManager,
-  // Registry
-  AdapterRegistry,
-  getAdapterRegistry,
-  resetAdapterRegistry,
-  createMemoryRegistry,
-} from './adapters/index.js';
-
-// ============================================================================
-// Tooling Surface — Re-exported for backward compatibility.
-// Prefer importing from 'doppler/tooling' for tooling-only consumers.
-// ============================================================================
-
-export * from './tooling-exports.shared.js';