David Snelling
266715aeee
Brainy 8.0 is server-only. This commit takes the consequences seriously and
removes everything that was only there to keep browser/cloud/threading
surfaces alive.
Browser support drop (per the @deprecated notes in environment.ts):
- isBrowser, isWebWorker, areWebWorkersAvailable, navigator.deviceMemory
paths, window/document/self.onmessage code.
- browser console.log in unified.ts, the 'browser' branch in
autoConfiguration.ts (env enum + scaleUp cases), 'browser-cache' model
path, MCP service environment value.
- package.json browser field.
- src/worker.ts (Web Worker entrypoint) deleted.
Cloud SDK removal (the four adapters were dropped in Phase 7; the SDKs
were the lingering tax):
- @aws-sdk/client-s3, @azure/identity, @azure/storage-blob, and
@google-cloud/storage removed from package.json. Lockfile drops the
entire @aws/@azure/@google-cloud/@smithy transitive tree.
- EnhancedS3Clear class deleted from enhancedClearOperations.ts (the
only @aws-sdk/client-s3 consumer; the dynamic import sites went with
it). EnhancedFileSystemClear stays.
- src/utils/adaptiveSocketManager.ts deleted entirely (474 LOC of HTTPS
socket-pool management for the dropped cloud HTTP handler).
performanceMonitor.ts no longer reports a socketConfig; socket
utilization is fixed at 0.
Dead threading subsystem:
- executeInThread was imported by distance.ts and hnswIndex.ts but
never called. It was scaffolding for a future "off-main-thread
distance batch" optimization that never shipped.
- src/utils/workerUtils.ts deleted (Web Worker code path + an
unreachable Node Worker Threads code path).
- environment.ts loses isThreadingAvailable, isThreadingAvailableAsync,
areWorkerThreadsAvailable, areWorkerThreadsAvailableSync. All exports
purged from index.ts and unified.ts.
- autoConfiguration.ts drops AutoConfigResult.threadingAvailable.
Legacy plugin/augmentation pipeline:
- src/pipeline.ts deleted. The whole file was a no-op stub for
backwards compat — Pipeline class had no methods, no lifecycle hooks,
no before/after callbacks. AugmentationPipeline, augmentationPipeline,
createPipeline, createStreamingPipeline, StreamlinedPipelineOptions,
StreamlinedPipelineResult, StreamlinedExecutionMode were all aliases
for the same stub.
- src/mcp/mcpAugmentationToolset.ts deleted. executePipeline always
threw "deprecated", isValidAugmentationType always returned false,
getAvailableTools always returned []. Dead surface.
- BrainyMCPService no longer instantiates a toolset. TOOL_EXECUTION
requests now return the standard UNSUPPORTED_REQUEST_TYPE error.
'availableTools' system-info returns [] (was the same in practice).
Net: 22 files changed, ~6400 LOC deleted (including legacy code +
mechanical lockfile churn). Build clean, 1409/1409 tests pass.
75 lines
1.9 KiB
TypeScript
75 lines
1.9 KiB
TypeScript
/**
|
|
* Model Configuration
|
|
* Brainy uses Q8 WASM embeddings - no configuration needed (zero-config)
|
|
*/
|
|
|
|
import { isNode } from '../utils/environment.js'
|
|
|
|
interface ModelConfigResult {
|
|
precision: 'q8'
|
|
reason: string
|
|
autoSelected: boolean
|
|
}
|
|
|
|
/**
|
|
* Get model precision configuration
|
|
* Always returns Q8 - the optimal balance of size and accuracy
|
|
*/
|
|
export function getModelPrecision(): ModelConfigResult {
|
|
return {
|
|
precision: 'q8',
|
|
reason: 'Q8 WASM (23MB bundled, no downloads)',
|
|
autoSelected: true
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Check if running in a serverless environment
|
|
*/
|
|
function isServerlessEnvironment(): boolean {
|
|
if (!isNode()) return false
|
|
|
|
return !!(
|
|
process.env.AWS_LAMBDA_FUNCTION_NAME ||
|
|
process.env.VERCEL ||
|
|
process.env.NETLIFY ||
|
|
process.env.CLOUDFLARE_WORKERS ||
|
|
process.env.FUNCTIONS_WORKER_RUNTIME ||
|
|
process.env.K_SERVICE // Google Cloud Run
|
|
)
|
|
}
|
|
|
|
/**
|
|
* Check if models need to be downloaded
|
|
* With bundled WASM model, this is rarely needed
|
|
*/
|
|
export function shouldAutoDownloadModels(): boolean {
|
|
// Model is bundled - no downloads needed in normal operation
|
|
// This flag exists for edge cases only
|
|
const explicitlyDisabled = process.env.BRAINY_ALLOW_REMOTE_MODELS === 'false'
|
|
return !explicitlyDisabled
|
|
}
|
|
|
|
/**
|
|
* Get the model path
|
|
* With bundled WASM model, this points to the package assets
|
|
*/
|
|
export function getModelPath(): string {
|
|
// Check if user explicitly set a path (for advanced users)
|
|
if (process.env.BRAINY_MODELS_PATH) {
|
|
return process.env.BRAINY_MODELS_PATH
|
|
}
|
|
|
|
// Serverless - use /tmp for ephemeral storage
|
|
if (isServerlessEnvironment()) {
|
|
return '/tmp/.brainy/models'
|
|
}
|
|
|
|
// Node.js - use home directory for persistent storage
|
|
if (isNode()) {
|
|
const homeDir = process.env.HOME || process.env.USERPROFILE || '~'
|
|
return `${homeDir}/.brainy/models`
|
|
}
|
|
|
|
return './.brainy/models'
|
|
}
|