llama-cpp-pro 0.2.2

package/dist/esm/isomorphic/provider.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.web.js","sourceRoot":"","sources":["../../../src/isomorphic/provider.web.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  EmbedRequest,\n  EmbedResult,\n  GenerateRequest,\n  GenerateResult,\n  InitializeOptions,\n  LlmProvider,\n  MemorySnapshot,\n  PlatformKind,\n  TokenEvent,\n} from './provider.interface';\nimport type { DetokenizeResult, TokenizeResult } from '../workers/wasm.engine';\nimport { LlmError } from './errors';\nimport { DefaultModelScheduler } from './model.scheduler';\nimport {\n  WASM_MAX_CONCURRENT_MODELS,\n  WASM_POOL_CEILING_BYTES,\n  wasmMemoryPressure,\n} from './wasmMemoryPolicy';\nimport {\n  ensureModelInOpfs,\n  getOpfsUsage,\n} from '../storage/opfs.store';\nimport { getManifestEntry } from '../storage/manifest';\nimport type { WorkerEvent, WorkerRequest } from '../workers/worker.protocol';\n\n// ---------------------------------------------------------------------------\n// Fix #10: Pre-flight capability checks\n// ---------------------------------------------------------------------------\n\n/** Verify that the browser supports everything the web WASM path needs. */\nexport function checkWasmCapabilities(): {\n  supported: boolean;\n  missing: string[];\n} {\n  const missing: string[] = [];\n\n  if (typeof WebAssembly !== 'object' || typeof WebAssembly.instantiate !== 'function') {\n    missing.push('WebAssembly');\n  }\n  if (typeof (globalThis as any)?.Worker === 'undefined') {\n    missing.push('Worker');\n  }\n  if (\n    typeof (globalThis as any)?.navigator?.storage?.getDirectory !== 'function'\n  ) {\n    missing.push('OPFS (navigator.storage.getDirectory)');\n  }\n\n  // WASM threads (needed for multi-threaded inference) require cross-origin\n  // isolation. Warn but don't block — single-threaded inference still works.\n  const coi = (globalThis as any)?.crossOriginIsolated === true;\n  const hasShared = typeof SharedArrayBuffer !== 'undefined';\n  if (!coi || !hasShared) {\n    // Not a hard failure — single-threaded WASM still functions.\n    // Callers can check this separately via checkCrossOriginIsolation().\n  }\n\n  return { supported: missing.length === 0, missing };\n}\n\n/** Returns true only when COOP/COEP headers are set for WASM threads. */\nexport function checkCrossOriginIsolation(): boolean {\n  return (\n    (globalThis as any)?.crossOriginIsolated === true &&\n    typeof SharedArrayBuffer !== 'undefined'\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Worker factory helpers\n// ---------------------------------------------------------------------------\ntype WithoutId<T> = T extends { id: string } ? Omit<T, 'id'> : never;\ntype WorkerRequestWithoutId = WithoutId<WorkerRequest>;\ntype WorkerFactory = () => Worker;\n\ntype PendingRequest = {\n  resolve: (value: any) => void;\n  reject: (reason?: unknown) => void;\n  onToken?: (event: TokenEvent) => void;\n  onProgress?: (downloaded: number, total: number) => void;\n};\n\nconst toError = (code: string, message: string, meta?: Record<string, unknown>): LlmError => {\n  const knownCodes = [\n    'MODEL_NOT_LOADED',\n    'MODEL_LIMIT_REACHED',\n    'INSUFFICIENT_MEMORY',\n    'MODEL_DOWNLOAD_FAILED',\n    'STORAGE_UNAVAILABLE',\n    'STORAGE_IO_FAILED',\n    'UNSUPPORTED_PLATFORM',\n    'WASM_INIT_FAILED',\n    'NATIVE_PLUGIN_UNAVAILABLE',\n    'INFERENCE_FAILED',\n    'INVALID_REQUEST',\n  ];\n  const normalizedCode = knownCodes.includes(code) ? (code as any) : 'INFERENCE_FAILED';\n  const text =\n    message == null || message === ''\n      ? 'Unknown inference error'\n      : typeof message === 'string'\n        ? message\n        : String(message);\n  return new LlmError(normalizedCode, text, meta);\n};\n\n// ---------------------------------------------------------------------------\n// Fix #11: Cross-browser memory snapshot using storage.estimate() fallback\n// ---------------------------------------------------------------------------\nasync function getMemorySnapshotCrossBrowser(): Promise<MemorySnapshot> {\n  // performance.memory is Chromium-only and non-standard. Use it when present,\n  // otherwise fall back to storage.estimate() which is universally available.\n  const perfMem = (globalThis as any)?.performance?.memory;\n  if (perfMem && typeof perfMem.jsHeapSizeLimit === 'number' && perfMem.jsHeapSizeLimit > 0) {\n    const totalBytes = Number(perfMem.jsHeapSizeLimit);\n    const usedBytes  = Number(perfMem.usedJSHeapSize);\n    const freeBytes  = totalBytes - usedBytes;\n    const usedRatio  = usedBytes / totalBytes;\n    const pressure   = usedRatio >= 0.85 ? 'high' : usedRatio >= 0.7 ? 'medium' : 'low';\n    return { totalBytes, usedBytes, freeBytes, pressure };\n  }\n\n  // Fallback: use OPFS storage quota as a coarse proxy for available memory.\n  // Not perfect but gives the admission controller a real number to work with\n  // on Safari/Firefox instead of always returning undefined (which caused the\n  // memory guard to be silently bypassed — fix #11).\n  try {\n    const est = await (globalThis as any)?.navigator?.storage?.estimate?.();\n    if (est && typeof est.quota === 'number' && typeof est.usage === 'number') {\n      const totalBytes = est.quota;\n      const usedBytes  = est.usage;\n      const freeBytes  = totalBytes - usedBytes;\n      const usedRatio  = totalBytes > 0 ? usedBytes / totalBytes : 0;\n      const pressure   = usedRatio >= 0.85 ? 'high' : usedRatio >= 0.7 ? 'medium' : 'low';\n      return { totalBytes, usedBytes, freeBytes, pressure };\n    }\n  } catch {\n    // ignore\n  }\n\n  return { pressure: 'unknown' };\n}\n\n// ---------------------------------------------------------------------------\n// WebProvider\n// ---------------------------------------------------------------------------\nexport class WebProvider implements LlmProvider {\n  private static globalWorkerFactory?: WorkerFactory;\n  readonly platform: PlatformKind = 'web';\n  private loadedModelIds = new Set<string>();\n  private worker: Worker | null = null;\n  private reqCounter = 0;\n  private pending = new Map<string, PendingRequest>();\n  // Fix #5: wire the scheduler so admission control is enforced on the web path.\n  private scheduler = new DefaultModelScheduler(WASM_MAX_CONCURRENT_MODELS);\n\n  constructor(private workerFactoryOverride?: WorkerFactory) {}\n\n  static setWorkerFactory(factory?: WorkerFactory): void {\n    WebProvider.globalWorkerFactory = factory;\n  }\n\n  // Fix #15: resolve compiled worker .js first; fall back to .ts for dev.\n  private resolveWorkerUrl(): string | URL {\n    const customUrl = (globalThis as any)?.__LLAMA_WORKER_URL__;\n    if (typeof customUrl === 'string' && customUrl.length > 0) {\n      return customUrl;\n    }\n    try {\n      const metaUrl = new Function('return import.meta.url')() as string;\n      return new URL('../../dist/workers/llm.worker.js', metaUrl);\n    } catch {\n      return '/dist/workers/llm.worker.js';\n    }\n  }\n\n  private defaultWorkerFactory(): Worker {\n    return new Worker(this.resolveWorkerUrl(), { type: 'module' });\n  }\n\n  private ensureWorker(): Worker {\n    if (this.worker) return this.worker;\n    const factory =\n      this.workerFactoryOverride ??\n      WebProvider.globalWorkerFactory ??\n      (() => this.defaultWorkerFactory());\n    const worker = factory();\n    worker.onmessage = (evt: MessageEvent<WorkerEvent>) => {\n      const message = evt.data;\n      const request = this.pending.get(message.id);\n      if (!request) return;\n\n      if (message.type === 'TOKEN') {\n        request.onToken?.({\n          modelId: message.modelId,\n          token: message.token,\n          index: message.index,\n        });\n        return;\n      }\n\n      if (message.type === 'PROGRESS') {\n        request.onProgress?.(message.downloaded, message.total);\n        return;\n      }\n\n      if (message.type === 'RESULT') {\n        this.pending.delete(message.id);\n        request.resolve(message.payload);\n        return;\n      }\n\n      this.pending.delete(message.id);\n      request.reject(toError(message.code, message.message, message.meta));\n    };\n    worker.onerror = (evt) => {\n      const err = toError(\n        'INFERENCE_FAILED',\n        `Web worker error: ${evt.message || 'unknown worker error'}`,\n      );\n      for (const [id, req] of this.pending.entries()) {\n        this.pending.delete(id);\n        req.reject(err);\n      }\n    };\n    this.worker = worker;\n    return worker;\n  }\n\n  private sendRequest<T>(\n    request: WorkerRequestWithoutId,\n    onToken?: (event: TokenEvent) => void,\n    onProgress?: (downloaded: number, total: number) => void,\n  ): Promise<T> {\n    const worker = this.ensureWorker();\n    const id = `req_${Date.now()}_${this.reqCounter++}`;\n    const message = { ...request, id } as WorkerRequest;\n    return new Promise<T>((resolve, reject) => {\n      this.pending.set(id, { resolve, reject, onToken, onProgress });\n      try {\n        // Fix #9: no Transferable[] needed — the ArrayBuffer lives in the worker\n        worker.postMessage(message);\n      } catch (error) {\n        this.pending.delete(id);\n        reject(\n          toError('INFERENCE_FAILED', 'Failed to post request to wasm worker.', {\n            cause: String(error),\n            requestType: request.type,\n          }),\n        );\n      }\n    });\n  }\n\n  async initialize(opts: InitializeOptions): Promise<void> {\n    // Fix #10: gate on capability check before touching the worker.\n    // Skip when a custom worker factory is injected (tests / custom hosts).\n    const usingCustomWorker =\n      !!this.workerFactoryOverride || !!WebProvider.globalWorkerFactory;\n    if (!usingCustomWorker) {\n      const caps = checkWasmCapabilities();\n      if (!caps.supported) {\n        throw new LlmError(\n          'UNSUPPORTED_PLATFORM',\n          `Missing browser capabilities for WASM inference: ${caps.missing.join(', ')}`,\n          { missing: caps.missing },\n        );\n      }\n    }\n    await this.sendRequest<{ ok: boolean }>({ type: 'INIT' });\n    await this.loadModel(opts);\n  }\n\n  async loadModel(opts: InitializeOptions): Promise<void> {\n    if (!opts.modelId) {\n      throw new LlmError('INVALID_REQUEST', 'modelId is required');\n    }\n    if (this.loadedModelIds.has(opts.modelId)) {\n      return;\n    }\n\n    const existing = await getManifestEntry(opts.modelId);\n    if (!existing && !opts.modelUrl) {\n      throw new LlmError(\n        'INVALID_REQUEST',\n        'modelUrl is required for first-time web load when model is not cached in OPFS.',\n      );\n    }\n\n    // Download and persist to OPFS if needed (#6: with progress events).\n    if (!existing && opts.modelUrl) {\n      await ensureModelInOpfs(opts.modelId, opts.modelUrl, opts.onProgress);\n    }\n\n    // Fix #5: enforce admission control (memory guard + slot limit) BEFORE\n    // asking the worker to load, using a real memory snapshot (#11).\n    const memory = await getMemorySnapshotCrossBrowser();\n    const wasmMemory = await this.fetchWorkerMemory().catch(\n      (): Record<string, unknown> => ({}),\n    );\n    const wasmLinearBytes =\n      typeof wasmMemory.wasmLinearBytes === 'number' ? wasmMemory.wasmLinearBytes : undefined;\n    const manifestEntry = existing ?? (await getManifestEntry(opts.modelId));\n    const modelBytes = manifestEntry?.sizeBytes ?? 0;\n    this.scheduler.ensureCapacity(\n      opts.modelId,\n      modelBytes,\n      memory,\n      undefined,\n      {\n        wasmLinearBytes,\n        wasmPoolCeilingBytes: WASM_POOL_CEILING_BYTES,\n        loadOpts: {\n          n_ctx: opts.n_ctx,\n          n_batch: opts.n_batch,\n          embedding: opts.embedding,\n        },\n      },\n    );\n\n    // Fix #9: send modelId only — the worker reads from OPFS internally.\n    const loadResult = await this.sendRequest<{\n      ok: boolean;\n      alreadyLoaded?: boolean;\n      measuredFootprintBytes?: number;\n      wasmLinearBytes?: number;\n    }>(\n      {\n        type: 'LOAD_MODEL',\n        modelId: opts.modelId,\n        opts: {\n          modelPath: (opts as any).modelPath ?? (opts as any).model_path ?? manifestEntry?.path,\n          modelBytes,\n          n_ctx: opts.n_ctx,\n          n_batch: opts.n_batch,\n          n_gpu_layers: opts.n_gpu_layers,\n          n_threads: opts.n_threads,\n          embedding: opts.embedding,\n          use_mmap: opts.use_mmap,\n          preferVfsStreaming: opts.preferVfsStreaming,\n        },\n      },\n      undefined,\n      opts.onProgress,\n    );\n\n    let measuredFootprint = loadResult.measuredFootprintBytes;\n    if (!(typeof measuredFootprint === 'number' && measuredFootprint > 0)) {\n      const workerMem = await this.fetchWorkerMemory().catch((): Record<string, unknown> => ({}));\n      measuredFootprint = this.readMeasuredFootprintFromWorker(workerMem, opts.modelId);\n    }\n\n    this.loadedModelIds.add(opts.modelId);\n    this.scheduler.markLoaded(\n      opts.modelId,\n      modelBytes,\n      {\n        n_ctx: opts.n_ctx,\n        n_batch: opts.n_batch,\n        embedding: opts.embedding,\n      },\n      measuredFootprint,\n    );\n    if (typeof measuredFootprint === 'number' && measuredFootprint > 0) {\n      this.scheduler.calibrateFootprint(opts.modelId, measuredFootprint);\n    }\n  }\n\n  private readMeasuredFootprintFromWorker(\n    workerMem: Record<string, unknown>,\n    modelId: string,\n  ): number | undefined {\n    const models = workerMem.loadedModels;\n    if (!Array.isArray(models)) return undefined;\n    for (const row of models) {\n      if (!row || typeof row !== 'object') continue;\n      const entry = row as Record<string, unknown>;\n      if (entry.modelId !== modelId) continue;\n      if (typeof entry.measuredFootprintBytes === 'number' && entry.measuredFootprintBytes > 0) {\n        return entry.measuredFootprintBytes;\n      }\n    }\n    return undefined;\n  }\n\n  async unloadModel(modelId: string): Promise<void> {\n    if (!this.loadedModelIds.has(modelId)) {\n      return;\n    }\n    await this.sendRequest<{ ok: boolean }>({ type: 'UNLOAD_MODEL', modelId });\n    this.loadedModelIds.delete(modelId);\n    this.scheduler.markUnloaded(modelId);\n  }\n\n  async generate(req: GenerateRequest): Promise<GenerateResult> {\n    if (!this.loadedModelIds.has(req.modelId)) {\n      throw new LlmError('MODEL_NOT_LOADED', `Model '${req.modelId}' is not loaded`);\n    }\n    return this.sendRequest<GenerateResult>({\n      type: 'GENERATE',\n      modelId: req.modelId,\n      req: {\n        prompt: req.prompt,\n        messages: req.messages,\n        max_tokens: req.max_tokens,\n        temperature: req.temperature,\n        stream: false,\n      },\n    });\n  }\n\n  async generateStream(req: GenerateRequest, onToken: (event: TokenEvent) => void): Promise<GenerateResult> {\n    if (!this.loadedModelIds.has(req.modelId)) {\n      throw new LlmError('MODEL_NOT_LOADED', `Model '${req.modelId}' is not loaded`);\n    }\n    return this.sendRequest<GenerateResult>(\n      {\n        type: 'GENERATE',\n        modelId: req.modelId,\n        req: {\n          prompt: req.prompt,\n          messages: req.messages,\n          max_tokens: req.max_tokens,\n          temperature: req.temperature,\n          stream: true,\n        },\n      },\n      onToken,\n    );\n  }\n\n  async embed(req: EmbedRequest): Promise<EmbedResult> {\n    if (!this.loadedModelIds.has(req.modelId)) {\n      throw new LlmError('MODEL_NOT_LOADED', `Model '${req.modelId}' is not loaded`);\n    }\n    return this.sendRequest<EmbedResult>({\n      type: 'EMBED',\n      modelId: req.modelId,\n      input: req.input,\n    });\n  }\n\n  // Fix #11: use cross-browser memory snapshot instead of performance.memory only.\n  async getMemorySnapshot(): Promise<MemorySnapshot> {\n    return getMemorySnapshotCrossBrowser();\n  }\n\n  /** Worker WASM linear memory + loaded-model registry (for scheduling UI). */\n  async fetchWorkerMemory(): Promise<Record<string, unknown>> {\n    return this.sendRequest<Record<string, unknown>>({ type: 'MEMORY' });\n  }\n\n  async getWasmMemoryStatus(): Promise<Record<string, unknown>> {\n    const [browser, workerRaw] = await Promise.all([\n      getMemorySnapshotCrossBrowser(),\n      this.fetchWorkerMemory().catch((): Record<string, unknown> => ({})),\n    ]);\n    const worker = workerRaw;\n    const wasmLinearBytes =\n      typeof worker.wasmLinearBytes === 'number' ? worker.wasmLinearBytes : undefined;\n    return {\n      browser,\n      worker,\n      wasmLinearBytes,\n      wasmPoolCeilingBytes: WASM_POOL_CEILING_BYTES,\n      wasmHeadroomBytes:\n        typeof wasmLinearBytes === 'number'\n          ? Math.max(0, WASM_POOL_CEILING_BYTES - wasmLinearBytes)\n          : undefined,\n      pressure:\n        typeof wasmLinearBytes === 'number'\n          ? wasmMemoryPressure(wasmLinearBytes, WASM_POOL_CEILING_BYTES)\n          : browser.pressure,\n      loadedModels: this.loadedModelIds.size,\n      maxModels: WASM_MAX_CONCURRENT_MODELS,\n      schedulerFootprintBytes: this.scheduler.totalFootprintBytes(),\n    };\n  }\n\n  async tokenize(modelId: string, text: string): Promise<TokenizeResult> {\n    if (!this.loadedModelIds.has(modelId)) {\n      throw new LlmError('MODEL_NOT_LOADED', `Model '${modelId}' is not loaded`);\n    }\n    return this.sendRequest<TokenizeResult>({ type: 'TOKENIZE', modelId, text });\n  }\n\n  async detokenize(modelId: string, tokens: number[]): Promise<DetokenizeResult> {\n    if (!this.loadedModelIds.has(modelId)) {\n      throw new LlmError('MODEL_NOT_LOADED', `Model '${modelId}' is not loaded`);\n    }\n    return this.sendRequest<DetokenizeResult>({ type: 'DETOKENIZE', modelId, tokens });\n  }\n\n  async convertJsonSchemaToGrammar(schemaJson: string): Promise<string> {\n    // CONVERT_GRAMMAR is context-free — no model needs to be loaded.\n    // The worker must be initialised (INIT sent), but that happens on first use.\n    const result = await this.sendRequest<{ grammar: string }>({\n      type: 'CONVERT_GRAMMAR',\n      schemaJson,\n    });\n    return result.grammar;\n  }\n\n  private requireLoaded(modelId: string): void {\n    if (!this.loadedModelIds.has(modelId)) {\n      throw new LlmError('MODEL_NOT_LOADED', `Model '${modelId}' is not loaded`);\n    }\n  }\n\n  async rerank(modelId: string, query: string, documents: string[]): Promise<Array<{ index: number; score: number }>> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ results: Array<{ index: number; score: number }> }>({\n      type: 'RERANK',\n      modelId,\n      query,\n      documents,\n    });\n    return result.results;\n  }\n\n  async bench(modelId: string, pp: number, tg: number, pl: number, nr: number): Promise<string> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ result: string }>({\n      type: 'BENCH',\n      modelId,\n      pp,\n      tg,\n      pl,\n      nr,\n    });\n    return result.result;\n  }\n\n  async saveSession(modelId: string, filepath: string, tokenSize: number): Promise<number> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ tokens_saved: number }>({\n      type: 'SAVE_SESSION',\n      modelId,\n      filepath,\n      tokenSize,\n    });\n    return result.tokens_saved;\n  }\n\n  async loadSession(\n    modelId: string,\n    filepath: string,\n  ): Promise<{ tokens_loaded: number; prompt: string }> {\n    this.requireLoaded(modelId);\n    return this.sendRequest<{ tokens_loaded: number; prompt: string }>({\n      type: 'LOAD_SESSION',\n      modelId,\n      filepath,\n    });\n  }\n\n  async applyLoraAdapters(\n    modelId: string,\n    loraAdapters: Array<{ path: string; scaled?: number }>,\n  ): Promise<void> {\n    this.requireLoaded(modelId);\n    await this.sendRequest<{ ok: boolean }>({\n      type: 'APPLY_LORA',\n      modelId,\n      loraAdapters,\n    });\n  }\n\n  async removeLoraAdapters(modelId: string): Promise<void> {\n    this.requireLoaded(modelId);\n    await this.sendRequest<{ ok: boolean }>({ type: 'REMOVE_LORA', modelId });\n  }\n\n  async getLoadedLoraAdapters(\n    modelId: string,\n  ): Promise<Array<{ path: string; scaled?: number }>> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ adapters: Array<{ path: string; scaled?: number }> }>({\n      type: 'GET_LORA',\n      modelId,\n    });\n    return result.adapters;\n  }\n\n  async initMultimodal(modelId: string, path: string, useGpu = false): Promise<boolean> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ ok: boolean }>({\n      type: 'INIT_MULTIMODAL',\n      modelId,\n      path,\n      useGpu,\n    });\n    return !!result.ok;\n  }\n\n  async isMultimodalEnabled(modelId: string): Promise<boolean> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ enabled: boolean }>({\n      type: 'MULTIMODAL_STATUS',\n      modelId,\n    });\n    return !!result.enabled;\n  }\n\n  async getMultimodalSupport(\n    modelId: string,\n  ): Promise<{ vision: boolean; audio: boolean }> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ vision: boolean; audio: boolean }>({\n      type: 'MULTIMODAL_STATUS',\n      modelId,\n    });\n    return { vision: !!result.vision, audio: !!result.audio };\n  }\n\n  async releaseMultimodal(modelId: string): Promise<void> {\n    await this.sendRequest<{ ok: boolean }>({ type: 'RELEASE_MULTIMODAL', modelId });\n  }\n\n  async initVocoder(modelId: string, path: string, nBatch = 512): Promise<boolean> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ ok: boolean }>({\n      type: 'INIT_VOCODER',\n      modelId,\n      path,\n      nBatch,\n    });\n    return !!result.ok;\n  }\n\n  async isVocoderEnabled(modelId: string): Promise<boolean> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ enabled: boolean }>({\n      type: 'VOCODER_ENABLED',\n      modelId,\n    });\n    return !!result.enabled;\n  }\n\n  async releaseVocoder(modelId: string): Promise<void> {\n    await this.sendRequest<{ ok: boolean }>({ type: 'RELEASE_VOCODER', modelId });\n  }\n\n  async getFormattedAudioCompletion(\n    modelId: string,\n    speaker: object | null,\n    textToSpeak: string,\n  ): Promise<{ prompt: string; grammar?: string }> {\n    this.requireLoaded(modelId);\n    return this.sendRequest<{ prompt: string; grammar?: string }>({\n      type: 'FORMATTED_AUDIO',\n      modelId,\n      speakerJson: speaker ? JSON.stringify(speaker) : '',\n      textToSpeak,\n    });\n  }\n\n  async getAudioCompletionGuideTokens(modelId: string, textToSpeak: string): Promise<number[]> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ tokens: number[] }>({\n      type: 'AUDIO_GUIDE_TOKENS',\n      modelId,\n      textToSpeak,\n    });\n    return result.tokens;\n  }\n\n  async decodeAudioTokens(modelId: string, tokens: number[]): Promise<number[]> {\n    this.requireLoaded(modelId);\n    const result = await this.sendRequest<{ audio: number[] }>({\n      type: 'DECODE_AUDIO_TOKENS',\n      modelId,\n      tokens,\n    });\n    return result.audio;\n  }\n\n  /**\n   * Terminate the worker mid-inference. WASM is single-threaded, so posting\n   * an abort message cannot be received while generate() is running. Worker\n   * termination is the only reliable interrupt. The model will need to be\n   * reloaded on the next generate() call.\n   */\n  stopGeneration(): void {\n    if (!this.worker) return;\n    this.worker.terminate();\n    this.worker = null;\n    const interrupted = toError('INFERENCE_FAILED', 'Generation stopped by caller.');\n    for (const [id, req] of this.pending.entries()) {\n      this.pending.delete(id);\n      req.reject(interrupted);\n    }\n    // Worker is gone, so all previously tracked model IDs are invalid.\n    this.loadedModelIds.clear();\n    for (const id of this.scheduler.listLoaded()) {\n      this.scheduler.markUnloaded(id);\n    }\n  }\n\n  async health(): Promise<{ ok: boolean; details?: Record<string, unknown> }> {\n    const usage = await getOpfsUsage().catch(() => ({\n      usedBytes: 0 as number,\n      quotaBytes: undefined as number | undefined,\n    }));\n    const workerHealth = await this.sendRequest<Record<string, unknown>>({ type: 'HEALTH' }).catch(\n      (error: unknown) => ({\n        ok: false,\n        message: error instanceof Error ? error.message : String(error),\n      }),\n    );\n    const workerRecord = workerHealth as Record<string, unknown>;\n    const workerDetails = workerRecord.details as Record<string, unknown> | undefined;\n    return {\n      ok: !!workerHealth?.ok,\n      details: {\n        loadedModels: this.loadedModelIds.size,\n        opfsUsedBytes: usage.usedBytes,\n        opfsQuotaBytes: usage.quotaBytes,\n        worker: workerHealth,\n        crossOriginIsolated: checkCrossOriginIsolation(),\n        wasmJspi: workerDetails?.wasmJspi,\n        wasmPthread: workerDetails?.wasmPthread,\n      },\n    };\n  }\n}\n"]}

package/dist/esm/isomorphic/sidecar-sse.d.ts

@@ -0,0 +1,14 @@
+/** OpenAI-style SSE lines emitted by the native desktop sidecar. */
+export type SidecarSseKind = 'chat' | 'completion';
+/** Extract a token string from one SSE `data:` JSON payload (empty if none). */
+export declare function extractSidecarSseToken(payload: string, kind: SidecarSseKind): string;
+/** Parse a single SSE line; returns a token when present. */
+export declare function parseSidecarSseLine(line: string, kind: SidecarSseKind): string | null;
+/** Buffers decoded stream bytes into complete newline-delimited lines. */
+export declare class SidecarSseLineParser {
+    private buffer;
+    feed(chunk: string): string[];
+    flush(): string[];
+}
+/** Read token chunks from a fetch `ReadableStream` body. */
+export declare function readSidecarSseTokens(body: ReadableStream<Uint8Array>, kind: SidecarSseKind, onToken: (token: string) => void): Promise<void>;

package/dist/esm/isomorphic/sidecar-sse.js

@@ -0,0 +1,76 @@
+/** Extract a token string from one SSE `data:` JSON payload (empty if none). */
+export function extractSidecarSseToken(payload, kind) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    if (payload === '[DONE]') {
+        return '';
+    }
+    try {
+        const chunk = JSON.parse(payload);
+        if (kind === 'chat') {
+            return (_d = (_c = (_b = (_a = chunk.choices) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.delta) === null || _c === void 0 ? void 0 : _c.content) !== null && _d !== void 0 ? _d : '';
+        }
+        return (_g = (_f = (_e = chunk.choices) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.text) !== null && _g !== void 0 ? _g : '';
+    }
+    catch (_h) {
+        return '';
+    }
+}
+/** Parse a single SSE line; returns a token when present. */
+export function parseSidecarSseLine(line, kind) {
+    if (!line.startsWith('data: ')) {
+        return null;
+    }
+    const payload = line.slice(6).trim();
+    if (payload === '[DONE]') {
+        return null;
+    }
+    const token = extractSidecarSseToken(payload, kind);
+    return token ? token : null;
+}
+/** Buffers decoded stream bytes into complete newline-delimited lines. */
+export class SidecarSseLineParser {
+    constructor() {
+        this.buffer = '';
+    }
+    feed(chunk) {
+        var _a;
+        this.buffer += chunk;
+        const lines = this.buffer.split('\n');
+        this.buffer = (_a = lines.pop()) !== null && _a !== void 0 ? _a : '';
+        return lines;
+    }
+    flush() {
+        if (!this.buffer) {
+            return [];
+        }
+        const line = this.buffer;
+        this.buffer = '';
+        return [line];
+    }
+}
+/** Read token chunks from a fetch `ReadableStream` body. */
+export async function readSidecarSseTokens(body, kind, onToken) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    const parser = new SidecarSseLineParser();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        const lines = parser.feed(decoder.decode(value, { stream: true }));
+        for (const line of lines) {
+            const token = parseSidecarSseLine(line, kind);
+            if (token) {
+                onToken(token);
+            }
+        }
+    }
+    for (const line of parser.flush()) {
+        const token = parseSidecarSseLine(line, kind);
+        if (token) {
+            onToken(token);
+        }
+    }
+}
+//# sourceMappingURL=sidecar-sse.js.map

package/dist/esm/isomorphic/sidecar-sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-sse.js","sourceRoot":"","sources":["../../../src/isomorphic/sidecar-sse.ts"],"names":[],"mappings":"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","sourcesContent":["/** OpenAI-style SSE lines emitted by the native desktop sidecar. */\nexport type SidecarSseKind = 'chat' | 'completion';\n\n/** Extract a token string from one SSE `data:` JSON payload (empty if none). */\nexport function extractSidecarSseToken(payload: string, kind: SidecarSseKind): string {\n  if (payload === '[DONE]') {\n    return '';\n  }\n  try {\n    const chunk = JSON.parse(payload) as {\n      choices?: Array<{ delta?: { content?: string }; text?: string }>;\n    };\n    if (kind === 'chat') {\n      return chunk.choices?.[0]?.delta?.content ?? '';\n    }\n    return chunk.choices?.[0]?.text ?? '';\n  } catch {\n    return '';\n  }\n}\n\n/** Parse a single SSE line; returns a token when present. */\nexport function parseSidecarSseLine(line: string, kind: SidecarSseKind): string | null {\n  if (!line.startsWith('data: ')) {\n    return null;\n  }\n  const payload = line.slice(6).trim();\n  if (payload === '[DONE]') {\n    return null;\n  }\n  const token = extractSidecarSseToken(payload, kind);\n  return token ? token : null;\n}\n\n/** Buffers decoded stream bytes into complete newline-delimited lines. */\nexport class SidecarSseLineParser {\n  private buffer = '';\n\n  feed(chunk: string): string[] {\n    this.buffer += chunk;\n    const lines = this.buffer.split('\\n');\n    this.buffer = lines.pop() ?? '';\n    return lines;\n  }\n\n  flush(): string[] {\n    if (!this.buffer) {\n      return [];\n    }\n    const line = this.buffer;\n    this.buffer = '';\n    return [line];\n  }\n}\n\n/** Read token chunks from a fetch `ReadableStream` body. */\nexport async function readSidecarSseTokens(\n  body: ReadableStream<Uint8Array>,\n  kind: SidecarSseKind,\n  onToken: (token: string) => void,\n): Promise<void> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  const parser = new SidecarSseLineParser();\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) {\n      break;\n    }\n    const lines = parser.feed(decoder.decode(value, { stream: true }));\n    for (const line of lines) {\n      const token = parseSidecarSseLine(line, kind);\n      if (token) {\n        onToken(token);\n      }\n    }\n  }\n  for (const line of parser.flush()) {\n    const token = parseSidecarSseLine(line, kind);\n    if (token) {\n      onToken(token);\n    }\n  }\n}\n"]}

package/dist/esm/isomorphic/wasmMemoryCalibration.d.ts

@@ -0,0 +1,26 @@
+export type ModelFootprintEntry = {
+    fileBytes: number;
+    estimatedBytes: number;
+    measuredBytes?: number;
+    linearBefore?: number;
+    linearAfter?: number;
+    calibratedAt?: number;
+};
+export type WasmProjectionInput = {
+    wasmLinearBytes: number;
+    residentModelCount: number;
+    residentFootprintBytes: number;
+    candidateEstimateBytes: number;
+    candidateMeasuredBytes?: number;
+};
+/** Bytes used for scheduling — measured when calibrated, else estimate. */
+export declare function resolveFootprintBytes(entry: ModelFootprintEntry | number | undefined, fallbackEstimate: number): number;
+/** Attribute heap growth to one model load (delta from linear before → after). */
+export declare function calibrateFootprintFromLinearDelta(linearBefore: number, linearAfter: number, estimatedBytes: number, options?: {
+    firstModelInHeap?: boolean;
+}): number;
+export declare function createFootprintEntry(fileBytes: number, estimatedBytes: number): ModelFootprintEntry;
+export declare function applyCalibration(entry: ModelFootprintEntry, linearBefore: number, linearAfter: number, firstModelInHeap: boolean): ModelFootprintEntry;
+export declare function sumResidentFootprintBytes(footprints: Map<string, ModelFootprintEntry | number>, excludeModelId?: string): number;
+/** Project WASM pool usage after admitting one more model (footprint-based). */
+export declare function projectWasmAfterLoad(input: WasmProjectionInput): number;

package/dist/esm/isomorphic/wasmMemoryCalibration.js

@@ -0,0 +1,60 @@
+const WARM_HEAP_BYTES = 64 * 1024 * 1024;
+/** Bytes used for scheduling — measured when calibrated, else estimate. */
+export function resolveFootprintBytes(entry, fallbackEstimate) {
+    if (typeof entry === 'number' && entry > 0)
+        return entry;
+    if (entry && typeof entry === 'object') {
+        if (typeof entry.measuredBytes === 'number' && entry.measuredBytes > 0) {
+            return entry.measuredBytes;
+        }
+        if (entry.estimatedBytes > 0)
+            return entry.estimatedBytes;
+    }
+    return fallbackEstimate;
+}
+/** Attribute heap growth to one model load (delta from linear before → after). */
+export function calibrateFootprintFromLinearDelta(linearBefore, linearAfter, estimatedBytes, options) {
+    const delta = Math.max(0, linearAfter - linearBefore);
+    if ((options === null || options === void 0 ? void 0 : options.firstModelInHeap) && linearAfter > WARM_HEAP_BYTES) {
+        return linearAfter;
+    }
+    if (delta > 0) {
+        return delta;
+    }
+    return estimatedBytes;
+}
+export function createFootprintEntry(fileBytes, estimatedBytes) {
+    return { fileBytes, estimatedBytes };
+}
+export function applyCalibration(entry, linearBefore, linearAfter, firstModelInHeap) {
+    const measuredBytes = calibrateFootprintFromLinearDelta(linearBefore, linearAfter, entry.estimatedBytes, { firstModelInHeap });
+    return Object.assign(Object.assign({}, entry), { measuredBytes,
+        linearBefore,
+        linearAfter, calibratedAt: Date.now() });
+}
+export function sumResidentFootprintBytes(footprints, excludeModelId) {
+    let sum = 0;
+    for (const [id, entry] of footprints) {
+        if (excludeModelId && id === excludeModelId)
+            continue;
+        const fallback = typeof entry === 'object' ? entry.estimatedBytes : 0;
+        sum += resolveFootprintBytes(entry, fallback);
+    }
+    return sum;
+}
+/** Project WASM pool usage after admitting one more model (footprint-based). */
+export function projectWasmAfterLoad(input) {
+    var _a;
+    const linear = input.wasmLinearBytes;
+    const nextBytes = (_a = input.candidateMeasuredBytes) !== null && _a !== void 0 ? _a : input.candidateEstimateBytes;
+    // Prefer calibrated footprints over linear heap size. Linear may include unused
+    // pre-grown headroom (or a prior failed grow to MAXIMUM_MEMORY).
+    if (input.residentModelCount > 0) {
+        return input.residentFootprintBytes + nextBytes;
+    }
+    if (linear > WARM_HEAP_BYTES) {
+        return nextBytes;
+    }
+    return Math.max(linear, nextBytes);
+}
+//# sourceMappingURL=wasmMemoryCalibration.js.map

package/dist/esm/isomorphic/wasmMemoryCalibration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasmMemoryCalibration.js","sourceRoot":"","sources":["../../../src/isomorphic/wasmMemoryCalibration.ts"],"names":[],"mappings":"AAiBA,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzC,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CACnC,KAA+C,EAC/C,gBAAwB;IAExB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YACvE,OAAO,KAAK,CAAC,aAAa,CAAC;QAC7B,CAAC;QACD,IAAI,KAAK,CAAC,cAAc,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,cAAc,CAAC;IAC5D,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,iCAAiC,CAC/C,YAAoB,EACpB,WAAmB,EACnB,cAAsB,EACtB,OAAwC;IAExC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC;IACtD,IAAI,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,gBAAgB,KAAI,WAAW,GAAG,eAAe,EAAE,CAAC;QAC/D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAiB,EACjB,cAAsB;IAEtB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAA0B,EAC1B,YAAoB,EACpB,WAAmB,EACnB,gBAAyB;IAEzB,MAAM,aAAa,GAAG,iCAAiC,CACrD,YAAY,EACZ,WAAW,EACX,KAAK,CAAC,cAAc,EACpB,EAAE,gBAAgB,EAAE,CACrB,CAAC;IACF,uCACK,KAAK,KACR,aAAa;QACb,YAAY;QACZ,WAAW,EACX,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,IACxB;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAqD,EACrD,cAAuB;IAEvB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QACrC,IAAI,cAAc,IAAI,EAAE,KAAK,cAAc;YAAE,SAAS;QACtD,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,GAAG,IAAI,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,KAA0B;;IAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC;IACrC,MAAM,SAAS,GAAG,MAAA,KAAK,CAAC,sBAAsB,mCAAI,KAAK,CAAC,sBAAsB,CAAC;IAE/E,gFAAgF;IAChF,iEAAiE;IACjE,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAClD,CAAC;IACD,IAAI,MAAM,GAAG,eAAe,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACrC,CAAC","sourcesContent":["export type ModelFootprintEntry = {\n  fileBytes: number;\n  estimatedBytes: number;\n  measuredBytes?: number;\n  linearBefore?: number;\n  linearAfter?: number;\n  calibratedAt?: number;\n};\n\nexport type WasmProjectionInput = {\n  wasmLinearBytes: number;\n  residentModelCount: number;\n  residentFootprintBytes: number;\n  candidateEstimateBytes: number;\n  candidateMeasuredBytes?: number;\n};\n\nconst WARM_HEAP_BYTES = 64 * 1024 * 1024;\n\n/** Bytes used for scheduling — measured when calibrated, else estimate. */\nexport function resolveFootprintBytes(\n  entry: ModelFootprintEntry | number | undefined,\n  fallbackEstimate: number,\n): number {\n  if (typeof entry === 'number' && entry > 0) return entry;\n  if (entry && typeof entry === 'object') {\n    if (typeof entry.measuredBytes === 'number' && entry.measuredBytes > 0) {\n      return entry.measuredBytes;\n    }\n    if (entry.estimatedBytes > 0) return entry.estimatedBytes;\n  }\n  return fallbackEstimate;\n}\n\n/** Attribute heap growth to one model load (delta from linear before → after). */\nexport function calibrateFootprintFromLinearDelta(\n  linearBefore: number,\n  linearAfter: number,\n  estimatedBytes: number,\n  options?: { firstModelInHeap?: boolean },\n): number {\n  const delta = Math.max(0, linearAfter - linearBefore);\n  if (options?.firstModelInHeap && linearAfter > WARM_HEAP_BYTES) {\n    return linearAfter;\n  }\n  if (delta > 0) {\n    return delta;\n  }\n  return estimatedBytes;\n}\n\nexport function createFootprintEntry(\n  fileBytes: number,\n  estimatedBytes: number,\n): ModelFootprintEntry {\n  return { fileBytes, estimatedBytes };\n}\n\nexport function applyCalibration(\n  entry: ModelFootprintEntry,\n  linearBefore: number,\n  linearAfter: number,\n  firstModelInHeap: boolean,\n): ModelFootprintEntry {\n  const measuredBytes = calibrateFootprintFromLinearDelta(\n    linearBefore,\n    linearAfter,\n    entry.estimatedBytes,\n    { firstModelInHeap },\n  );\n  return {\n    ...entry,\n    measuredBytes,\n    linearBefore,\n    linearAfter,\n    calibratedAt: Date.now(),\n  };\n}\n\nexport function sumResidentFootprintBytes(\n  footprints: Map<string, ModelFootprintEntry | number>,\n  excludeModelId?: string,\n): number {\n  let sum = 0;\n  for (const [id, entry] of footprints) {\n    if (excludeModelId && id === excludeModelId) continue;\n    const fallback = typeof entry === 'object' ? entry.estimatedBytes : 0;\n    sum += resolveFootprintBytes(entry, fallback);\n  }\n  return sum;\n}\n\n/** Project WASM pool usage after admitting one more model (footprint-based). */\nexport function projectWasmAfterLoad(input: WasmProjectionInput): number {\n  const linear = input.wasmLinearBytes;\n  const nextBytes = input.candidateMeasuredBytes ?? input.candidateEstimateBytes;\n\n  // Prefer calibrated footprints over linear heap size. Linear may include unused\n  // pre-grown headroom (or a prior failed grow to MAXIMUM_MEMORY).\n  if (input.residentModelCount > 0) {\n    return input.residentFootprintBytes + nextBytes;\n  }\n  if (linear > WARM_HEAP_BYTES) {\n    return nextBytes;\n  }\n  return Math.max(linear, nextBytes);\n}\n"]}

package/dist/esm/isomorphic/wasmMemoryPolicy.d.ts

@@ -0,0 +1,55 @@
+import type { MemorySnapshot } from './provider.interface';
+/** Max concurrent GGUF contexts in one WASM worker (matches n_threads slot policy). */
+export declare const WASM_MAX_CONCURRENT_MODELS = 5;
+/** Emscripten MAXIMUM_MEMORY — absolute hard limit from build (2 GiB). */
+export declare const WASM_EMSCRIPTEN_MAX_BYTES = 2147483648;
+/** WASM pool planning cap — aligned with Emscripten max (was 1536 MB). */
+export declare const WASM_POOL_CEILING_BYTES = 2147483648;
+/** Keep this much headroom free inside the WASM pool after a load. */
+export declare const WASM_POOL_RESERVE_BYTES: number;
+export type ModelLoadMemoryOpts = {
+    n_ctx?: number;
+    n_batch?: number;
+    embedding?: boolean;
+};
+export type WasmMemoryStatus = MemorySnapshot & {
+    wasmLinearBytes?: number;
+    wasmPoolCeilingBytes?: number;
+    wasmHeadroomBytes?: number;
+    loadedModelCount?: number;
+    maxModels?: number;
+    loadedModels?: Array<{
+        modelId: string;
+        fileBytes?: number;
+        estimatedFootprintBytes?: number;
+    }>;
+};
+export type WasmLoadAdmissionInput = {
+    modelId: string;
+    fileBytes: number;
+    loadOpts?: ModelLoadMemoryOpts;
+    currentlyLoaded: number;
+    maxModels?: number;
+    wasmLinearBytes?: number;
+    wasmPoolCeilingBytes?: number;
+    loadedFootprintBytes?: number;
+    /** Prior measured footprint for this model id (if re-loading after unload). */
+    candidateMeasuredBytes?: number;
+    reserveBytes?: number;
+    browserMemory?: MemorySnapshot;
+};
+export type WasmLoadAdmissionResult = {
+    allow: boolean;
+    deniedBy?: 'limit' | 'wasm_pool' | 'browser_memory';
+    reason?: string;
+    estimatedFootprintBytes: number;
+    projectedWasmBytes?: number;
+};
+/**
+ * Estimate WASM linear memory for one model (weights + context/KV headroom).
+ * PWA loads via async OPFS — weights are not fully duplicated in heap (not 2× file).
+ * Observed: LFM2 ~697 MB GGUF → ~940 MB WASM; BGE ~17 MB → ~150–200 MB.
+ */
+export declare function estimateModelWasmFootprint(fileBytes: number, opts?: ModelLoadMemoryOpts): number;
+export declare function canAdmitWasmModelLoad(input: WasmLoadAdmissionInput): WasmLoadAdmissionResult;
+export declare function wasmMemoryPressure(wasmLinearBytes: number, ceilingBytes?: number): MemorySnapshot['pressure'];

package/dist/esm/isomorphic/wasmMemoryPolicy.js

@@ -0,0 +1,93 @@
+import { projectWasmAfterLoad } from './wasmMemoryCalibration';
+/** Max concurrent GGUF contexts in one WASM worker (matches n_threads slot policy). */
+export const WASM_MAX_CONCURRENT_MODELS = 5;
+/** Emscripten MAXIMUM_MEMORY — absolute hard limit from build (2 GiB). */
+export const WASM_EMSCRIPTEN_MAX_BYTES = 2147483648;
+/** WASM pool planning cap — aligned with Emscripten max (was 1536 MB). */
+export const WASM_POOL_CEILING_BYTES = WASM_EMSCRIPTEN_MAX_BYTES;
+/** Keep this much headroom free inside the WASM pool after a load. */
+export const WASM_POOL_RESERVE_BYTES = 64 * 1024 * 1024;
+/**
+ * Estimate WASM linear memory for one model (weights + context/KV headroom).
+ * PWA loads via async OPFS — weights are not fully duplicated in heap (not 2× file).
+ * Observed: LFM2 ~697 MB GGUF → ~940 MB WASM; BGE ~17 MB → ~150–200 MB.
+ */
+export function estimateModelWasmFootprint(fileBytes, opts = {}) {
+    if (!(fileBytes > 0))
+        return 20 * 1024 * 1024;
+    const embedding = opts.embedding === true;
+    const n_ctx = typeof opts.n_ctx === 'number' && opts.n_ctx > 0 ? opts.n_ctx : embedding ? 256 : 512;
+    const n_batch = typeof opts.n_batch === 'number' && opts.n_batch > 0 ? opts.n_batch : embedding ? 32 : 16;
+    // Async OPFS: ~1.3× file for large chat; embed models are lighter.
+    const weightMultiplier = embedding ? 1.25 : fileBytes > 200 * 1024 * 1024 ? 1.32 : 1.2;
+    const ctxBytes = n_ctx * n_batch * 4096;
+    const proportional = Math.ceil(fileBytes * 0.12);
+    const minHeadroom = embedding ? 48 * 1024 * 1024 : 96 * 1024 * 1024;
+    const headroom = Math.max(minHeadroom, proportional, ctxBytes);
+    return Math.ceil(fileBytes * weightMultiplier + headroom);
+}
+export function canAdmitWasmModelLoad(input) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const maxModels = (_a = input.maxModels) !== null && _a !== void 0 ? _a : WASM_MAX_CONCURRENT_MODELS;
+    const ceiling = (_b = input.wasmPoolCeilingBytes) !== null && _b !== void 0 ? _b : WASM_POOL_CEILING_BYTES;
+    const reserve = (_c = input.reserveBytes) !== null && _c !== void 0 ? _c : WASM_POOL_RESERVE_BYTES;
+    const estimated = estimateModelWasmFootprint(input.fileBytes, (_d = input.loadOpts) !== null && _d !== void 0 ? _d : {});
+    if (input.currentlyLoaded >= maxModels) {
+        return {
+            allow: false,
+            deniedBy: 'limit',
+            reason: `Model slot limit reached (${maxModels} concurrent WASM contexts)`,
+            estimatedFootprintBytes: estimated,
+        };
+    }
+    const linear = (_e = input.wasmLinearBytes) !== null && _e !== void 0 ? _e : 0;
+    const loadedFootprint = (_f = input.loadedFootprintBytes) !== null && _f !== void 0 ? _f : 0;
+    const projectedWasm = projectWasmAfterLoad({
+        wasmLinearBytes: linear,
+        residentModelCount: input.currentlyLoaded,
+        residentFootprintBytes: loadedFootprint,
+        candidateEstimateBytes: estimated,
+        candidateMeasuredBytes: input.candidateMeasuredBytes,
+    });
+    const admitLimit = Math.min(ceiling, WASM_EMSCRIPTEN_MAX_BYTES) - reserve;
+    if (projectedWasm > admitLimit) {
+        return {
+            allow: false,
+            deniedBy: 'wasm_pool',
+            reason: `WASM pool would exceed ${(ceiling / 1024 / 1024).toFixed(0)} MB ` +
+                `(projected ${(projectedWasm / 1024 / 1024).toFixed(0)} MB, ` +
+                `GGUF ${(input.fileBytes / 1024 / 1024).toFixed(0)} MB → est. WASM ~${(estimated / 1024 / 1024).toFixed(0)} MB)`,
+            estimatedFootprintBytes: estimated,
+            projectedWasmBytes: projectedWasm,
+        };
+    }
+    if (typeof ((_g = input.browserMemory) === null || _g === void 0 ? void 0 : _g.freeBytes) === 'number') {
+        const browserReserve = 256 * 1024 * 1024;
+        const postFree = input.browserMemory.freeBytes - estimated;
+        if (postFree < browserReserve) {
+            return {
+                allow: false,
+                deniedBy: 'browser_memory',
+                reason: 'Insufficient browser JS heap after model load reserve',
+                estimatedFootprintBytes: estimated,
+                projectedWasmBytes: projectedWasm,
+            };
+        }
+    }
+    return {
+        allow: true,
+        estimatedFootprintBytes: estimated,
+        projectedWasmBytes: projectedWasm,
+    };
+}
+export function wasmMemoryPressure(wasmLinearBytes, ceilingBytes = WASM_POOL_CEILING_BYTES) {
+    if (!(wasmLinearBytes > 0) || !(ceilingBytes > 0))
+        return 'unknown';
+    const ratio = wasmLinearBytes / ceilingBytes;
+    if (ratio >= 0.85)
+        return 'high';
+    if (ratio >= 0.7)
+        return 'medium';
+    return 'low';
+}
+//# sourceMappingURL=wasmMemoryPolicy.js.map

package/dist/esm/isomorphic/wasmMemoryPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasmMemoryPolicy.js","sourceRoot":"","sources":["../../../src/isomorphic/wasmMemoryPolicy.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MemorySnapshot } from './provider.interface';\nimport { projectWasmAfterLoad } from './wasmMemoryCalibration';\n\n/** Max concurrent GGUF contexts in one WASM worker (matches n_threads slot policy). */\nexport const WASM_MAX_CONCURRENT_MODELS = 5;\n\n/** Emscripten MAXIMUM_MEMORY — absolute hard limit from build (2 GiB). */\nexport const WASM_EMSCRIPTEN_MAX_BYTES = 2147483648;\n\n/** WASM pool planning cap — aligned with Emscripten max (was 1536 MB). */\nexport const WASM_POOL_CEILING_BYTES = WASM_EMSCRIPTEN_MAX_BYTES;\n\n/** Keep this much headroom free inside the WASM pool after a load. */\nexport const WASM_POOL_RESERVE_BYTES = 64 * 1024 * 1024;\n\nexport type ModelLoadMemoryOpts = {\n  n_ctx?: number;\n  n_batch?: number;\n  embedding?: boolean;\n};\n\nexport type WasmMemoryStatus = MemorySnapshot & {\n  wasmLinearBytes?: number;\n  wasmPoolCeilingBytes?: number;\n  wasmHeadroomBytes?: number;\n  loadedModelCount?: number;\n  maxModels?: number;\n  loadedModels?: Array<{ modelId: string; fileBytes?: number; estimatedFootprintBytes?: number }>;\n};\n\nexport type WasmLoadAdmissionInput = {\n  modelId: string;\n  fileBytes: number;\n  loadOpts?: ModelLoadMemoryOpts;\n  currentlyLoaded: number;\n  maxModels?: number;\n  wasmLinearBytes?: number;\n  wasmPoolCeilingBytes?: number;\n  loadedFootprintBytes?: number;\n  /** Prior measured footprint for this model id (if re-loading after unload). */\n  candidateMeasuredBytes?: number;\n  reserveBytes?: number;\n  browserMemory?: MemorySnapshot;\n};\n\nexport type WasmLoadAdmissionResult = {\n  allow: boolean;\n  deniedBy?: 'limit' | 'wasm_pool' | 'browser_memory';\n  reason?: string;\n  estimatedFootprintBytes: number;\n  projectedWasmBytes?: number;\n};\n\n/**\n * Estimate WASM linear memory for one model (weights + context/KV headroom).\n * PWA loads via async OPFS — weights are not fully duplicated in heap (not 2× file).\n * Observed: LFM2 ~697 MB GGUF → ~940 MB WASM; BGE ~17 MB → ~150–200 MB.\n */\nexport function estimateModelWasmFootprint(\n  fileBytes: number,\n  opts: ModelLoadMemoryOpts = {},\n): number {\n  if (!(fileBytes > 0)) return 20 * 1024 * 1024;\n\n  const embedding = opts.embedding === true;\n  const n_ctx = typeof opts.n_ctx === 'number' && opts.n_ctx > 0 ? opts.n_ctx : embedding ? 256 : 512;\n  const n_batch = typeof opts.n_batch === 'number' && opts.n_batch > 0 ? opts.n_batch : embedding ? 32 : 16;\n\n  // Async OPFS: ~1.3× file for large chat; embed models are lighter.\n  const weightMultiplier = embedding ? 1.25 : fileBytes > 200 * 1024 * 1024 ? 1.32 : 1.2;\n  const ctxBytes = n_ctx * n_batch * 4096;\n  const proportional = Math.ceil(fileBytes * 0.12);\n  const minHeadroom = embedding ? 48 * 1024 * 1024 : 96 * 1024 * 1024;\n  const headroom = Math.max(minHeadroom, proportional, ctxBytes);\n\n  return Math.ceil(fileBytes * weightMultiplier + headroom);\n}\n\nexport function canAdmitWasmModelLoad(input: WasmLoadAdmissionInput): WasmLoadAdmissionResult {\n  const maxModels = input.maxModels ?? WASM_MAX_CONCURRENT_MODELS;\n  const ceiling = input.wasmPoolCeilingBytes ?? WASM_POOL_CEILING_BYTES;\n  const reserve = input.reserveBytes ?? WASM_POOL_RESERVE_BYTES;\n  const estimated = estimateModelWasmFootprint(input.fileBytes, input.loadOpts ?? {});\n\n  if (input.currentlyLoaded >= maxModels) {\n    return {\n      allow: false,\n      deniedBy: 'limit',\n      reason: `Model slot limit reached (${maxModels} concurrent WASM contexts)`,\n      estimatedFootprintBytes: estimated,\n    };\n  }\n\n  const linear = input.wasmLinearBytes ?? 0;\n  const loadedFootprint = input.loadedFootprintBytes ?? 0;\n  const projectedWasm = projectWasmAfterLoad({\n    wasmLinearBytes: linear,\n    residentModelCount: input.currentlyLoaded,\n    residentFootprintBytes: loadedFootprint,\n    candidateEstimateBytes: estimated,\n    candidateMeasuredBytes: input.candidateMeasuredBytes,\n  });\n  const admitLimit = Math.min(ceiling, WASM_EMSCRIPTEN_MAX_BYTES) - reserve;\n\n  if (projectedWasm > admitLimit) {\n    return {\n      allow: false,\n      deniedBy: 'wasm_pool',\n      reason:\n        `WASM pool would exceed ${(ceiling / 1024 / 1024).toFixed(0)} MB ` +\n        `(projected ${(projectedWasm / 1024 / 1024).toFixed(0)} MB, ` +\n        `GGUF ${(input.fileBytes / 1024 / 1024).toFixed(0)} MB → est. WASM ~${(estimated / 1024 / 1024).toFixed(0)} MB)`,\n      estimatedFootprintBytes: estimated,\n      projectedWasmBytes: projectedWasm,\n    };\n  }\n\n  if (typeof input.browserMemory?.freeBytes === 'number') {\n    const browserReserve = 256 * 1024 * 1024;\n    const postFree = input.browserMemory.freeBytes - estimated;\n    if (postFree < browserReserve) {\n      return {\n        allow: false,\n        deniedBy: 'browser_memory',\n        reason: 'Insufficient browser JS heap after model load reserve',\n        estimatedFootprintBytes: estimated,\n        projectedWasmBytes: projectedWasm,\n      };\n    }\n  }\n\n  return {\n    allow: true,\n    estimatedFootprintBytes: estimated,\n    projectedWasmBytes: projectedWasm,\n  };\n}\n\nexport function wasmMemoryPressure(\n  wasmLinearBytes: number,\n  ceilingBytes: number = WASM_POOL_CEILING_BYTES,\n): MemorySnapshot['pressure'] {\n  if (!(wasmLinearBytes > 0) || !(ceilingBytes > 0)) return 'unknown';\n  const ratio = wasmLinearBytes / ceilingBytes;\n  if (ratio >= 0.85) return 'high';\n  if (ratio >= 0.7) return 'medium';\n  return 'low';\n}\n"]}

package/dist/esm/storage/manifest.d.ts

@@ -0,0 +1,13 @@
+export interface ModelManifestEntry {
+    modelId: string;
+    path: string;
+    sizeBytes: number;
+    sha256?: string;
+    sourceUrl?: string;
+    createdAt: number;
+    lastUsedAt: number;
+}
+export declare function listManifestEntries(): Promise<ModelManifestEntry[]>;
+export declare function getManifestEntry(modelId: string): Promise<ModelManifestEntry | undefined>;
+export declare function upsertManifestEntry(entry: ModelManifestEntry): Promise<void>;
+export declare function removeManifestEntry(modelId: string): Promise<void>;

package/dist/esm/storage/manifest.js

@@ -0,0 +1,87 @@
+import { LlmError } from '../isomorphic/errors';
+const MANIFEST_FILE = '.llm-manifest.json';
+const getStorageApi = () => {
+    var _a;
+    const storageApi = (_a = globalThis === null || globalThis === void 0 ? void 0 : globalThis.navigator) === null || _a === void 0 ? void 0 : _a.storage;
+    if (!storageApi || typeof storageApi.getDirectory !== 'function') {
+        throw new LlmError('STORAGE_UNAVAILABLE', 'OPFS is not available in this runtime. navigator.storage.getDirectory is missing.');
+    }
+    return storageApi;
+};
+const getRootDirectory = async () => {
+    const storageApi = getStorageApi();
+    try {
+        return await storageApi.getDirectory();
+    }
+    catch (error) {
+        throw new LlmError('STORAGE_IO_FAILED', 'Failed to access OPFS root directory.', {
+            cause: String(error),
+        });
+    }
+};
+const readTextFile = async (fileHandle) => {
+    const file = await fileHandle.getFile();
+    return file.text();
+};
+const writeTextFile = async (fileHandle, content) => {
+    const writable = await fileHandle.createWritable();
+    try {
+        await writable.write(content);
+    }
+    finally {
+        await writable.close();
+    }
+};
+async function loadManifestInternal() {
+    const root = await getRootDirectory();
+    try {
+        const handle = await root.getFileHandle(MANIFEST_FILE, { create: true });
+        const content = await readTextFile(handle);
+        if (!content.trim()) {
+            return {};
+        }
+        const parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return {};
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new LlmError('STORAGE_IO_FAILED', 'Failed to read OPFS manifest.', {
+            cause: String(error),
+        });
+    }
+}
+async function saveManifestInternal(manifest) {
+    const root = await getRootDirectory();
+    try {
+        const handle = await root.getFileHandle(MANIFEST_FILE, { create: true });
+        await writeTextFile(handle, JSON.stringify(manifest, null, 2));
+    }
+    catch (error) {
+        throw new LlmError('STORAGE_IO_FAILED', 'Failed to write OPFS manifest.', {
+            cause: String(error),
+        });
+    }
+}
+export async function listManifestEntries() {
+    const manifest = await loadManifestInternal();
+    return Object.values(manifest);
+}
+export async function getManifestEntry(modelId) {
+    const manifest = await loadManifestInternal();
+    return manifest[modelId];
+}
+export async function upsertManifestEntry(entry) {
+    const manifest = await loadManifestInternal();
+    manifest[entry.modelId] = entry;
+    await saveManifestInternal(manifest);
+}
+export async function removeManifestEntry(modelId) {
+    const manifest = await loadManifestInternal();
+    if (manifest[modelId]) {
+        delete manifest[modelId];
+        await saveManifestInternal(manifest);
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/esm/storage/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/storage/manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import { LlmError } from '../isomorphic/errors';\n\nexport interface ModelManifestEntry {\n  modelId: string;\n  path: string;\n  sizeBytes: number;\n  sha256?: string;\n  sourceUrl?: string;\n  createdAt: number;\n  lastUsedAt: number;\n}\n\ntype ManifestMap = Record<string, ModelManifestEntry>;\n\nconst MANIFEST_FILE = '.llm-manifest.json';\n\nconst getStorageApi = (): any => {\n  const storageApi = (globalThis as any)?.navigator?.storage;\n  if (!storageApi || typeof storageApi.getDirectory !== 'function') {\n    throw new LlmError(\n      'STORAGE_UNAVAILABLE',\n      'OPFS is not available in this runtime. navigator.storage.getDirectory is missing.',\n    );\n  }\n  return storageApi;\n};\n\nconst getRootDirectory = async (): Promise<any> => {\n  const storageApi = getStorageApi();\n  try {\n    return await storageApi.getDirectory();\n  } catch (error) {\n    throw new LlmError('STORAGE_IO_FAILED', 'Failed to access OPFS root directory.', {\n      cause: String(error),\n    });\n  }\n};\n\nconst readTextFile = async (fileHandle: any): Promise<string> => {\n  const file = await fileHandle.getFile();\n  return file.text();\n};\n\nconst writeTextFile = async (fileHandle: any, content: string): Promise<void> => {\n  const writable = await fileHandle.createWritable();\n  try {\n    await writable.write(content);\n  } finally {\n    await writable.close();\n  }\n};\n\nasync function loadManifestInternal(): Promise<ManifestMap> {\n  const root = await getRootDirectory();\n  try {\n    const handle = await root.getFileHandle(MANIFEST_FILE, { create: true });\n    const content = await readTextFile(handle);\n    if (!content.trim()) {\n      return {};\n    }\n    const parsed = JSON.parse(content) as unknown;\n    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n      return {};\n    }\n    return parsed as ManifestMap;\n  } catch (error) {\n    throw new LlmError('STORAGE_IO_FAILED', 'Failed to read OPFS manifest.', {\n      cause: String(error),\n    });\n  }\n}\n\nasync function saveManifestInternal(manifest: ManifestMap): Promise<void> {\n  const root = await getRootDirectory();\n  try {\n    const handle = await root.getFileHandle(MANIFEST_FILE, { create: true });\n    await writeTextFile(handle, JSON.stringify(manifest, null, 2));\n  } catch (error) {\n    throw new LlmError('STORAGE_IO_FAILED', 'Failed to write OPFS manifest.', {\n      cause: String(error),\n    });\n  }\n}\n\nexport async function listManifestEntries(): Promise<ModelManifestEntry[]> {\n  const manifest = await loadManifestInternal();\n  return Object.values(manifest);\n}\n\nexport async function getManifestEntry(modelId: string): Promise<ModelManifestEntry | undefined> {\n  const manifest = await loadManifestInternal();\n  return manifest[modelId];\n}\n\nexport async function upsertManifestEntry(entry: ModelManifestEntry): Promise<void> {\n  const manifest = await loadManifestInternal();\n  manifest[entry.modelId] = entry;\n  await saveManifestInternal(manifest);\n}\n\nexport async function removeManifestEntry(modelId: string): Promise<void> {\n  const manifest = await loadManifestInternal();\n  if (manifest[modelId]) {\n    delete manifest[modelId];\n    await saveManifestInternal(manifest);\n  }\n}\n\n"]}

package/dist/esm/storage/opfs.store.d.ts

@@ -0,0 +1,31 @@
+import { type ModelManifestEntry } from './manifest';
+export declare function ensureModelInOpfs(modelId: string, modelUrl: string, onProgress?: (downloaded: number, total: number) => void, signal?: AbortSignal): Promise<ModelManifestEntry>;
+/**
+ * Choice 3 — primary web model load path.
+ * Opens an OPFS FileSystemSyncAccessHandle in the worker and reads the
+ * model in fixed-size chunks (default 4MB). Chunks are streamed into WASM
+ * MEMFS; the full GGUF is never materialised as a single JS ArrayBuffer.
+ *
+ * Worker-only: createSyncAccessHandle is not available on the main thread.
+ */
+export declare const OPFS_MODEL_CHUNK_BYTES: number;
+export interface OpfsModelSyncReader {
+    readonly sizeBytes: number;
+    readChunk(offset: number, length?: number): Uint8Array;
+    close(): void;
+}
+export declare function openOpfsModelSyncReader(modelId: string): Promise<OpfsModelSyncReader>;
+/**
+ * Read the model from OPFS as an ArrayBuffer (fallback when sync handles
+ * are unavailable). Prefer openOpfsModelSyncReader in workers.
+ */
+export declare function readModelBufferFromOpfs(modelId: string): Promise<{
+    buffer: ArrayBuffer;
+    sizeBytes: number;
+}>;
+export declare function readModelFromOpfs(modelId: string): Promise<File>;
+export declare function removeModelFromOpfs(modelId: string): Promise<void>;
+export declare function getOpfsUsage(): Promise<{
+    usedBytes: number;
+    quotaBytes?: number;
+}>;