@seanhogg/builderforce-memory 2026.6.18

package/dist/distillation/index.d.ts

@@ -0,0 +1,3 @@
+export { DistillationEngine } from './DistillationEngine.js';
+export type { DistillOptions, DistillResult, DistillBatchResult, DistillationLog, QualityGate } from './DistillationEngine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/distillation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/distillation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/distillation/index.js

@@ -0,0 +1,2 @@
+export { DistillationEngine } from './DistillationEngine.js';
+//# sourceMappingURL=index.js.map

package/dist/distillation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/distillation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/errors/SSMError.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SSMError – typed error class for SSM.js runtime-level failures.
+ *
+ * Session-layer failures (GPU init, tokenizer, checkpoint) throw SessionError.
+ * Runtime-level failures (bridge, distillation, memory) throw SSMError.
+ * Both carry a typed `code` discriminant for programmatic handling.
+ */
+export type SSMErrorCode = 'RUNTIME_DESTROYED' | 'BRIDGE_REQUEST_FAILED' | 'BRIDGE_RESPONSE_INVALID' | 'MEMORY_UNAVAILABLE' | 'DISTILL_FAILED' | 'UNKNOWN';
+export declare class SSMError extends Error {
+    readonly code: SSMErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(code: SSMErrorCode, message: string, cause?: unknown | undefined);
+}
+//# sourceMappingURL=SSMError.d.ts.map

package/dist/errors/SSMError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SSMError.d.ts","sourceRoot":"","sources":["../../src/errors/SSMError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAClB,mBAAmB,GACnB,uBAAuB,GACvB,yBAAyB,GACzB,oBAAoB,GACpB,gBAAgB,GAChB,SAAS,CAAC;AAEhB,qBAAa,QAAS,SAAQ,KAAK;aAEX,IAAI,EAAE,YAAY;aAElB,KAAK,CAAC,EAAE,OAAO;gBAFf,IAAI,EAAE,YAAY,EAClC,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKtC"}

package/dist/errors/SSMError.js

@@ -0,0 +1,18 @@
+/**
+ * SSMError – typed error class for SSM.js runtime-level failures.
+ *
+ * Session-layer failures (GPU init, tokenizer, checkpoint) throw SessionError.
+ * Runtime-level failures (bridge, distillation, memory) throw SSMError.
+ * Both carry a typed `code` discriminant for programmatic handling.
+ */
+export class SSMError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'SSMError';
+    }
+}
+//# sourceMappingURL=SSMError.js.map

package/dist/errors/SSMError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SSMError.js","sourceRoot":"","sources":["../../src/errors/SSMError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAEX;IAEA;IAHpB,YACoB,IAAkB,EAClC,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAc;QAElB,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IAC3B,CAAC;CACJ"}

package/dist/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { SSMError } from './SSMError.js';
+export type { SSMErrorCode } from './SSMError.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,2 @@
+export { SSMError } from './SSMError.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SSM.js – JavaScript-native AI runtime.
+ *
+ * Layer stack:
+ *   MambaCode.js  →  WebGPU kernels (WGSL, Mamba-1/2/3 SSM math)
+ *   SSM.js        →  Session layer + Runtime orchestration (this package)
+ *
+ * Quick start:
+ *   import { SSM, AnthropicBridge } from 'ssmjs';
+ *
+ *   const ai = await SSM.create({
+ *     session    : { modelSize: 'small' },
+ *     bridge     : new AnthropicBridge({ apiKey: '...' }),
+ *   });
+ *
+ *   await ai.adapt(myDocs);
+ *   const answer = await ai.generate('How does MambaKit work?');
+ */
+export { MambaSession } from './session/index.js';
+export { SessionError } from './session/index.js';
+export { MODEL_PRESETS, resolveLayerSchedule, resolveModelConfig } from './session/index.js';
+export type { SessionErrorCode } from './session/index.js';
+export type { LayerSchedulePreset } from './session/index.js';
+export type { MambaSessionOptions, CompleteOptions, AdaptOptions, AdaptResult, SaveOptions, LoadOptions, StorageTarget, CreateProgressEvent, CreateStage, CreateCallbacks, SessionInternals, GpuMode, Tokenizer, } from './session/index.js';
+export { SSMRuntime } from './runtime/SSMRuntime.js';
+export type { SSMRuntimeOptions, GenerateOptions } from './runtime/SSMRuntime.js';
+export type { TransformerBridge, BridgeGenerateOptions } from './bridges/TransformerBridge.js';
+export { OpenAIBridge } from './bridges/OpenAIBridge.js';
+export { AnthropicBridge } from './bridges/AnthropicBridge.js';
+export { FetchBridge } from './bridges/FetchBridge.js';
+export { CachingBridge } from './bridges/CachingBridge.js';
+export { SemanticCachingBridge } from './bridges/SemanticCachingBridge.js';
+export { ResponseCache, buildCacheKey } from './bridges/ResponseCache.js';
+export type { OpenAIBridgeOptions } from './bridges/OpenAIBridge.js';
+export type { AnthropicBridgeOptions } from './bridges/AnthropicBridge.js';
+export type { FetchBridgeOptions } from './bridges/FetchBridge.js';
+export type { CachingBridgeOptions } from './bridges/CachingBridge.js';
+export type { SemanticCachingBridgeOptions } from './bridges/SemanticCachingBridge.js';
+export type { ResponseCacheOptions } from './bridges/ResponseCache.js';
+export { SemanticCache } from './cache/SemanticCache.js';
+export { FetchSemanticCacheBackend } from './cache/FetchSemanticCacheBackend.js';
+export type { Embedder, SemanticCacheBackend, SemanticCacheHit, SemanticCacheOptions, FetchSemanticCacheBackendOptions, } from './cache/index.js';
+export { cosineSimilarity, jaccardSimilarity, tokenize } from './similarity/index.js';
+export { InferenceRouter } from './router/InferenceRouter.js';
+export type { RoutingStrategy, RoutingDecision, RouterContext, InferenceRouterOptions, RoutingAuditEntry, } from './router/InferenceRouter.js';
+export { MemoryStore } from './memory/MemoryStore.js';
+export type { MemoryEntry, MemoryStoreOptions, RememberOptions, FactType, } from './memory/MemoryStore.js';
+export { DistillationEngine } from './distillation/DistillationEngine.js';
+export type { DistillOptions, DistillResult, DistillBatchResult, DistillationLog, QualityGate, } from './distillation/DistillationEngine.js';
+export { SSMAgent } from './agent/SSMAgent.js';
+export type { SSMAgentOptions, ThinkOptions, AgentMessage, MessageRole } from './agent/SSMAgent.js';
+export { SSMError } from './errors/SSMError.js';
+export type { SSMErrorCode } from './errors/SSMError.js';
+import { SSMRuntime } from './runtime/SSMRuntime.js';
+import type { SSMRuntimeOptions } from './runtime/SSMRuntime.js';
+export declare const SSM: {
+    /**
+     * Creates a new SSMRuntime.
+     *
+     * Shorthand for `SSMRuntime.create(opts)`.
+     * Can throw `SessionError` for GPU / tokenizer failures during init.
+     */
+    readonly create: (opts: SSMRuntimeOptions) => Promise<SSMRuntime>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,59 @@
+/**
+ * SSM.js – JavaScript-native AI runtime.
+ *
+ * Layer stack:
+ *   MambaCode.js  →  WebGPU kernels (WGSL, Mamba-1/2/3 SSM math)
+ *   SSM.js        →  Session layer + Runtime orchestration (this package)
+ *
+ * Quick start:
+ *   import { SSM, AnthropicBridge } from 'ssmjs';
+ *
+ *   const ai = await SSM.create({
+ *     session    : { modelSize: 'small' },
+ *     bridge     : new AnthropicBridge({ apiKey: '...' }),
+ *   });
+ *
+ *   await ai.adapt(myDocs);
+ *   const answer = await ai.generate('How does MambaKit work?');
+ */
+// ── Session layer ─────────────────────────────────────────────────────────────
+export { MambaSession } from './session/index.js';
+export { SessionError } from './session/index.js';
+export { MODEL_PRESETS, resolveLayerSchedule, resolveModelConfig } from './session/index.js';
+// ── Runtime ───────────────────────────────────────────────────────────────────
+export { SSMRuntime } from './runtime/SSMRuntime.js';
+export { OpenAIBridge } from './bridges/OpenAIBridge.js';
+export { AnthropicBridge } from './bridges/AnthropicBridge.js';
+export { FetchBridge } from './bridges/FetchBridge.js';
+export { CachingBridge } from './bridges/CachingBridge.js';
+export { SemanticCachingBridge } from './bridges/SemanticCachingBridge.js';
+export { ResponseCache, buildCacheKey } from './bridges/ResponseCache.js';
+// ── Semantic cache (embedding-keyed, L1 local + L2 shared) ─────────────────────
+export { SemanticCache } from './cache/SemanticCache.js';
+export { FetchSemanticCacheBackend } from './cache/FetchSemanticCacheBackend.js';
+// ── Similarity primitives ──────────────────────────────────────────────────────
+export { cosineSimilarity, jaccardSimilarity, tokenize } from './similarity/index.js';
+// ── Router ────────────────────────────────────────────────────────────────────
+export { InferenceRouter } from './router/InferenceRouter.js';
+// ── Memory ────────────────────────────────────────────────────────────────────
+export { MemoryStore } from './memory/MemoryStore.js';
+// ── Distillation ──────────────────────────────────────────────────────────────
+export { DistillationEngine } from './distillation/DistillationEngine.js';
+// ── Agent ─────────────────────────────────────────────────────────────────────
+export { SSMAgent } from './agent/SSMAgent.js';
+// ── Errors ────────────────────────────────────────────────────────────────────
+export { SSMError } from './errors/SSMError.js';
+// ── Top-level SSM namespace ───────────────────────────────────────────────────
+// Allows the `SSM.create()` pattern from the spec:
+//   const ai = await SSM.create({ session: { modelSize: 'nano' } });
+import { SSMRuntime } from './runtime/SSMRuntime.js';
+export const SSM = {
+    /**
+     * Creates a new SSMRuntime.
+     *
+     * Shorthand for `SSMRuntime.create(opts)`.
+     * Can throw `SessionError` for GPU / tokenizer failures during init.
+     */
+    create: (opts) => SSMRuntime.create(opts),
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAmB,oBAAoB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAmB,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAoB7F,iFAAiF;AACjF,OAAO,EAAE,UAAU,EAAE,MAAS,yBAAyB,CAAC;AAKxD,OAAO,EAAE,YAAY,EAAE,MAAS,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAU,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAQ,4BAA4B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAQ1E,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AASjF,kFAAkF;AAClF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtF,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAS9D,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,MAAO,yBAAyB,CAAC;AAQvD,iFAAiF;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAS1E,iFAAiF;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAO,qBAAqB,CAAC;AAGhD,iFAAiF;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAO,sBAAsB,CAAC;AAGjD,iFAAiF;AACjF,mDAAmD;AACnD,qEAAqE;AAErE,OAAO,EAAE,UAAU,EAAE,MAAe,yBAAyB,CAAC;AAG9D,MAAM,CAAC,MAAM,GAAG,GAAG;IACf;;;;;OAKG;IACH,MAAM,EAAE,CAAC,IAAuB,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;CACtD,CAAC"}

package/dist/memory/MemoryStore.d.ts

@@ -0,0 +1,152 @@
+/**
+ * MemoryStore – persistent key-value fact store and weight checkpoint helper.
+ *
+ * Uses IndexedDB with a dedicated 'ssmjs' database containing two object stores:
+ *   - 'facts'   : MemoryEntry records keyed by the fact key string
+ *   - 'weights' : a single ArrayBuffer keyed by `weightsKey`
+ *
+ * Weight save/load is delegated to the SSMRuntime passed to saveWeights/loadWeights.
+ */
+export type FactType = 'text' | 'json' | 'number' | 'boolean';
+export interface MemoryEntry {
+    key: string;
+    content: string;
+    timestamp: number;
+    /**
+     * Monotonic write sequence, used only to break `timestamp` ties so that
+     * ordering stays deterministic when several entries are written within the
+     * same millisecond (Date.now() resolution). Higher = written later.
+     * Optional for backward compatibility with entries persisted/imported
+     * before this field existed (those sort as seq 0).
+     */
+    seq?: number;
+    /** Optional time-to-live in milliseconds. */
+    ttlMs?: number;
+    /** Semantic type of the stored value. Default: 'text'. */
+    type?: FactType;
+    /** Tags for grouping and filtering. */
+    tags?: string[];
+    /** Importance weight in the range 0–1. Default: 0.5. */
+    importance?: number;
+}
+export interface RememberOptions {
+    /** Override the store-level defaultTtlMs for this entry. */
+    ttlMs?: number;
+    type?: FactType;
+    tags?: string[];
+    importance?: number;
+}
+export interface MemoryStoreOptions {
+    /** IndexedDB database name. Default: 'ssmjs'. */
+    dbName?: string;
+    /** Key used for weight storage within the 'weights' object store. Default: 'ssmjs-weights'. */
+    weightsKey?: string;
+    /**
+     * IDBFactory to use instead of the global `indexedDB`.
+     * Use this in Node.js environments with fake-indexeddb:
+     *   import { IDBFactory } from 'fake-indexeddb';
+     *   const idbFactory = new IDBFactory();
+     */
+    idbFactory?: IDBFactory;
+    /**
+     * Default TTL applied to new entries when no per-entry ttlMs is provided.
+     * Entries with an expired TTL are filtered from recallAll() and related methods.
+     */
+    defaultTtlMs?: number;
+}
+interface SaveLoadRuntime {
+    save(opts?: {
+        storage: 'indexedDB';
+        key: string;
+    }): Promise<void>;
+    load(opts?: {
+        key: string;
+    }): Promise<boolean>;
+}
+type SSMRuntimeRef = any;
+export declare class MemoryStore {
+    private readonly _dbName;
+    private readonly _weightsKey;
+    private readonly _idb;
+    private readonly _defaultTtl;
+    private _db;
+    /** Content → L2-normalised embedding cache, used by recallSimilar. */
+    private readonly _embedCache;
+    constructor(opts?: MemoryStoreOptions);
+    private _open;
+    private _isExpired;
+    /** Stores or overwrites a fact. */
+    remember(key: string, content: string, opts?: RememberOptions): Promise<void>;
+    /**
+     * Retrieves a fact by key.
+     * Returns `undefined` if the key does not exist or the entry has expired.
+     */
+    recall(key: string): Promise<MemoryEntry | undefined>;
+    /** Returns all non-expired stored facts, newest first. */
+    recallAll(): Promise<MemoryEntry[]>;
+    /**
+     * Returns the N most recently updated non-expired facts.
+     * Equivalent to `recallAll()` truncated to `n` entries.
+     */
+    recallRecent(n: number): Promise<MemoryEntry[]>;
+    /**
+     * Returns all non-expired entries that contain the given tag.
+     */
+    recallByTag(tag: string): Promise<MemoryEntry[]>;
+    /**
+     * Finds the top-K semantically similar entries to `query`.
+     *
+     * When `runtime` exposes an `embed()` method (the SSMRuntime does), similarity
+     * is computed as cosine distance between SSM hidden-state embeddings — i.e. the
+     * memory layer uses the very model it is attached to, and recall quality
+     * improves automatically as that model is adapted/distilled. Embeddings are
+     * cached per content string to avoid recomputing across calls.
+     *
+     * If no embedding-capable runtime is provided, or embedding fails for any
+     * reason, it transparently falls back to Jaccard word-overlap similarity.
+     */
+    recallSimilar(query: string, topK: number, runtime?: SSMRuntimeRef): Promise<MemoryEntry[]>;
+    /**
+     * Returns a cached embedding for `text`, computing it via `runtime.embed()`
+     * on a cache miss. Returns `null` (never throws) when embedding is
+     * unavailable so callers can fall back to lexical similarity.
+     */
+    private _embedWithCache;
+    /**
+     * Hard-deletes all entries whose TTL has expired.
+     * @returns The number of entries deleted.
+     */
+    purgeExpired(): Promise<number>;
+    /** Deletes a single fact. No-op if key does not exist. */
+    forget(key: string): Promise<void>;
+    /** Deletes all facts. Does not affect saved weights. */
+    clear(): Promise<void>;
+    /**
+     * Returns all non-expired facts as a plain array for export.
+     * Suitable for serialisation and import into another MemoryStore instance.
+     */
+    exportAll(): Promise<MemoryEntry[]>;
+    /**
+     * Imports entries from an external array.
+     *
+     * - `'merge'`     : only writes an entry if no existing entry with the same
+     *                   key exists, or if the incoming entry has a newer timestamp.
+     * - `'overwrite'` : writes all entries unconditionally.
+     */
+    importAll(entries: MemoryEntry[], strategy: 'merge' | 'overwrite'): Promise<void>;
+    /** Writes a raw MemoryEntry directly (preserves original timestamp / metadata). */
+    private _putRaw;
+    /**
+     * Saves SSM weights via `runtime.save()`.
+     * The weights are stored under `weightsKey` in this store's IndexedDB,
+     * separate from MambaSession's own key.
+     */
+    saveWeights(runtime: SaveLoadRuntime): Promise<void>;
+    /**
+     * Loads SSM weights via `runtime.load()`.
+     * Returns `false` when no saved weights exist under `weightsKey`.
+     */
+    loadWeights(runtime: SaveLoadRuntime): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=MemoryStore.d.ts.map

package/dist/memory/MemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStore.d.ts","sourceRoot":"","sources":["../../src/memory/MemoryStore.ts"],"names":[],"mappings":"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"}