abmind 0.0.1 → 0.1.1

package/dist/src/deploy-lib/paths.js

@@ -0,0 +1,40 @@
+/**
+ * Runtime directory resolution for deploy-lib consumers.
+ *
+ * Rules:
+ *   - abtars runtime root: $ABTARS_HOME ?? ~/.abtars
+ *   - abmind runtime root:      $ABMIND_HOME ?? ~/.abmind
+ *   - user bin dir:             ~/.local/bin (always, XDG convention)
+ *
+ * All callers use these resolvers — never hardcode paths. Required by
+ * plan #158 v7 (Ag2 round-2 nit): cross-repo manifest reads must respect
+ * env-var overrides, not assume default locations.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export function resolveAbtarsHome() {
+    return process.env['ABTARS_HOME'] ?? join(homedir(), '.abtars');
+}
+export function resolveAbmindHome() {
+    return process.env['ABMIND_HOME'] ?? join(homedir(), '.abmind');
+}
+export function resolvePackageHome(pkg) {
+    return pkg === 'abtars' ? resolveAbtarsHome() : resolveAbmindHome();
+}
+export function resolveUserBinDir() {
+    return join(homedir(), '.local', 'bin');
+}
+export function packagePaths(pkg) {
+    const home = resolvePackageHome(pkg);
+    return {
+        home,
+        config: join(home, 'config'),
+        releases: join(home, 'releases'),
+        current: join(home, 'current'),
+        nodeModules: join(home, 'node_modules'),
+        bin: join(home, 'bin'),
+        manifest: join(home, 'manifest.json'),
+        lock: join(home, '.update.lock'),
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/deploy-lib/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/deploy-lib/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAgB;IACjD,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAaD,MAAM,UAAU,YAAY,CAAC,GAAgB;IAC3C,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC5B,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAChC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QAC9B,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;QACvC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;QACtB,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;QACrC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/src/deploy-lib/releases.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Release management: stage / activate (flip symlink) / prune.
+ *
+ * Invariants (per plan §"Directory layout"):
+ *   - releases/<version>/dist/ holds only compiled code, no node_modules
+ *   - node_modules/ lives at the package home root, shared across releases
+ *   - current is a symlink to releases/<version>/
+ *   - Retention = 3 (plan §"Key invariants"); oldest pruned on activate
+ *
+ * Activation is atomic via rename(2): write current.new → rename to current.
+ * This replaces the existing symlink in one syscall; readers never see a
+ * broken state.
+ */
+declare const RETENTION = 3;
+export interface StagedRelease {
+    readonly version: string;
+    readonly stagedPath: string;
+    readonly commit: string | null;
+    readonly packageLockHash: string | null;
+    readonly source: 'local' | 'npm' | 'github';
+}
+/**
+ * List release versions in a releases/ dir, newest-activation-first as
+ * reported by the caller (this function sorts lexicographically; callers
+ * with a preferred order should rely on manifest priorReleases).
+ */
+export declare function listReleases(releasesDir: string): Promise<string[]>;
+/**
+ * Resolve the currently active release version from the `current` symlink.
+ * Returns null if the symlink is missing or dangling.
+ */
+export declare function readCurrent(currentLink: string): Promise<string | null>;
+/**
+ * Atomically flip the `current` symlink to point at releases/<version>/.
+ * Link target is relative (so moves of the package home don't break it).
+ */
+export declare function activate(currentLink: string, version: string): Promise<void>;
+/**
+ * Prune old releases, keeping the `keep` newest (by activation order provided
+ * by caller, most-recent-first). Never removes the currently-active release
+ * even if it falls outside the window.
+ */
+export declare function pruneReleases(releasesDir: string, activatedOrder: readonly string[], currentVersion: string, keep?: number): Promise<string[]>;
+export declare function hashFile(path: string): Promise<string | null>;
+/**
+ * Validate that `releases/<version>/` exists and has a dist/ subdir. Used by
+ * rollback to refuse flipping to a pruned or partial release.
+ */
+export declare function releaseExists(releasesDir: string, version: string): Promise<boolean>;
+export { RETENTION };
+export declare const _dirname: (path: string) => string;
+//# sourceMappingURL=releases.d.ts.map

package/dist/src/deploy-lib/releases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../../src/deploy-lib/releases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,QAAA,MAAM,SAAS,IAAI,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQzE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAY7E;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlF;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,MAAkB,GACvB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQnE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO1F;AAED,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,eAAO,MAAM,QAAQ,0BAAU,CAAC"}

package/dist/src/deploy-lib/releases.js

@@ -0,0 +1,119 @@
+/**
+ * Release management: stage / activate (flip symlink) / prune.
+ *
+ * Invariants (per plan §"Directory layout"):
+ *   - releases/<version>/dist/ holds only compiled code, no node_modules
+ *   - node_modules/ lives at the package home root, shared across releases
+ *   - current is a symlink to releases/<version>/
+ *   - Retention = 3 (plan §"Key invariants"); oldest pruned on activate
+ *
+ * Activation is atomic via rename(2): write current.new → rename to current.
+ * This replaces the existing symlink in one syscall; readers never see a
+ * broken state.
+ */
+import { createHash } from 'node:crypto';
+import { readFile, readdir, rename, rm, stat, symlink, unlink } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+const RETENTION = 3;
+/**
+ * List release versions in a releases/ dir, newest-activation-first as
+ * reported by the caller (this function sorts lexicographically; callers
+ * with a preferred order should rely on manifest priorReleases).
+ */
+export async function listReleases(releasesDir) {
+    try {
+        const entries = await readdir(releasesDir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+}
+/**
+ * Resolve the currently active release version from the `current` symlink.
+ * Returns null if the symlink is missing or dangling.
+ */
+export async function readCurrent(currentLink) {
+    try {
+        const s = await stat(currentLink);
+        if (!s.isDirectory())
+            return null;
+        const { readlink } = await import('node:fs/promises');
+        const target = await readlink(currentLink);
+        // Target is like "releases/vX.Y.Z" or absolute path ending in vX.Y.Z.
+        return basename(target);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+/**
+ * Atomically flip the `current` symlink to point at releases/<version>/.
+ * Link target is relative (so moves of the package home don't break it).
+ */
+export async function activate(currentLink, version) {
+    const tmp = `${currentLink}.new`;
+    // Relative symlink target: "releases/<version>"
+    const target = join('releases', version);
+    // Clear any leftover tmp from a crashed prior run.
+    try {
+        await unlink(tmp);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
+    await symlink(target, tmp);
+    await rename(tmp, currentLink);
+}
+/**
+ * Prune old releases, keeping the `keep` newest (by activation order provided
+ * by caller, most-recent-first). Never removes the currently-active release
+ * even if it falls outside the window.
+ */
+export async function pruneReleases(releasesDir, activatedOrder, currentVersion, keep = RETENTION) {
+    const retained = new Set([currentVersion]);
+    for (const v of activatedOrder.slice(0, keep))
+        retained.add(v);
+    const all = await listReleases(releasesDir);
+    const pruned = [];
+    for (const version of all) {
+        if (retained.has(version))
+            continue;
+        await rm(join(releasesDir, version), { recursive: true, force: true });
+        pruned.push(version);
+    }
+    return pruned;
+}
+export async function hashFile(path) {
+    try {
+        const buf = await readFile(path);
+        return createHash('sha256').update(buf).digest('hex');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+/**
+ * Validate that `releases/<version>/` exists and has a dist/ subdir. Used by
+ * rollback to refuse flipping to a pruned or partial release.
+ */
+export async function releaseExists(releasesDir, version) {
+    try {
+        const s = await stat(join(releasesDir, version, 'dist'));
+        return s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export { RETENTION };
+// dirname import preserves tree-shake correctness with downstream tooling
+export const _dirname = dirname;
+//# sourceMappingURL=releases.js.map

package/dist/src/deploy-lib/releases.js.map

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

package/dist/src/deploy-lib/safe-copy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Safe recursive copy that skips non-regular-file entries Node's cp()
+ * refuses to handle (EINVAL on sockets). Real runtime roots can contain
+ * UNIX sockets (browser.sock, memory.sock, etc.) which are ephemeral IPC
+ * endpoints — not data we want or can back up.
+ *
+ * Skipped: sockets, FIFOs, block devices, character devices.
+ * Copied:  regular files, directories, symlinks.
+ */
+export interface SafeCopyOptions {
+    readonly preserveTimestamps?: boolean;
+    /** Overwrite existing entries at the destination. Default: false. */
+    readonly force?: boolean;
+}
+export declare function safeCopyTree(src: string, dst: string, opts?: SafeCopyOptions): Promise<void>;
+//# sourceMappingURL=safe-copy.d.ts.map

package/dist/src/deploy-lib/safe-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-copy.d.ts","sourceRoot":"","sources":["../../../src/deploy-lib/safe-copy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAeD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOtG"}

package/dist/src/deploy-lib/safe-copy.js

@@ -0,0 +1,32 @@
+/**
+ * Safe recursive copy that skips non-regular-file entries Node's cp()
+ * refuses to handle (EINVAL on sockets). Real runtime roots can contain
+ * UNIX sockets (browser.sock, memory.sock, etc.) which are ephemeral IPC
+ * endpoints — not data we want or can back up.
+ *
+ * Skipped: sockets, FIFOs, block devices, character devices.
+ * Copied:  regular files, directories, symlinks.
+ */
+import { cp, lstat } from 'node:fs/promises';
+async function shouldCopy(src) {
+    try {
+        const s = await lstat(src);
+        if (s.isSocket() || s.isFIFO() || s.isBlockDevice() || s.isCharacterDevice()) {
+            return false;
+        }
+        return true;
+    }
+    catch {
+        // Let the subsequent cp call surface the real error if any.
+        return true;
+    }
+}
+export async function safeCopyTree(src, dst, opts = {}) {
+    await cp(src, dst, {
+        recursive: true,
+        preserveTimestamps: opts.preserveTimestamps === true,
+        force: opts.force === true,
+        filter: shouldCopy,
+    });
+}
+//# sourceMappingURL=safe-copy.js.map

package/dist/src/deploy-lib/safe-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-copy.js","sourceRoot":"","sources":["../../../src/deploy-lib/safe-copy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAQ7C,KAAK,UAAU,UAAU,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAC7E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,GAAW,EAAE,OAAwB,EAAE;IACrF,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE;QACjB,SAAS,EAAE,IAAI;QACf,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,KAAK,IAAI;QACpD,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/embedding-health.d.ts

@@ -0,0 +1,12 @@
+/**
+ * embedding-health.ts — Check ollama + embedding model availability.
+ * Single source of truth for embedding health checks.
+ */
+export interface EmbeddingHealth {
+    reachable: boolean;
+    modelPulled: boolean;
+    modelsAvailable: string[];
+    error?: string;
+}
+export declare function checkEmbeddingHealth(endpoint?: string, model?: string): Promise<EmbeddingHealth>;
+//# sourceMappingURL=embedding-health.d.ts.map

package/dist/src/embedding-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-health.d.ts","sourceRoot":"","sources":["../../src/embedding-health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,SAA2B,EACnC,KAAK,SAAqB,GACzB,OAAO,CAAC,eAAe,CAAC,CAU1B"}

package/dist/src/embedding-health.js

@@ -0,0 +1,18 @@
+/**
+ * embedding-health.ts — Check ollama + embedding model availability.
+ * Single source of truth for embedding health checks.
+ */
+export async function checkEmbeddingHealth(endpoint = "http://localhost:11434", model = "nomic-embed-text") {
+    try {
+        const res = await fetch(`${endpoint}/api/tags`, { signal: AbortSignal.timeout(5000) });
+        if (!res.ok)
+            return { reachable: false, modelPulled: false, modelsAvailable: [], error: `${res.status} ${res.statusText}` };
+        const data = await res.json();
+        const models = (data.models ?? []).map(m => m.name.replace(/:latest$/, ""));
+        return { reachable: true, modelPulled: models.some(m => m === model || m.startsWith(model + ":")), modelsAvailable: models };
+    }
+    catch (err) {
+        return { reachable: false, modelPulled: false, modelsAvailable: [], error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=embedding-health.js.map

package/dist/src/embedding-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-health.js","sourceRoot":"","sources":["../../src/embedding-health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAQ,GAAG,wBAAwB,EACnC,KAAK,GAAG,kBAAkB;IAE1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;QAC5H,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA0C,CAAC;QACtE,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5E,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC/H,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChI,CAAC;AACH,CAAC"}

package/dist/src/embedding-provider.d.ts

@@ -0,0 +1,48 @@
+/**
+ * #173 — Embedding provider slot.
+ *
+ * Pluggable embedding backend. Pick once at install via EMBEDDING_PROVIDER env var.
+ * Switching providers on a live DB requires `abmind embed --reset` to drop all
+ * embeddings (dimension mismatch is a hard boot error — no silent corruption).
+ *
+ * Two built-in providers:
+ * - OllamaProvider: default. POST {url}/api/embed, body { model, input }
+ * - OpenAIProvider: covers OpenAI + any OpenAI-compatible API (Voyage, Together,
+ *   local vLLM). POST {url}/embeddings, body { model, input: string[] }.
+ *   Real batch support: 100 texts per HTTP request.
+ */
+export interface IEmbeddingProvider {
+    /** Embed a single text. Returns null on failure (network, disabled, etc). */
+    embedText(text: string): Promise<Float32Array | null>;
+    /** Batch embed. Provider may chunk internally for efficiency. */
+    batchEmbed(texts: string[]): Promise<Array<Float32Array | null>>;
+    /** Expected embedding dimensions. Comes from EMBEDDING_DIMENSIONS env. */
+    readonly dimensions: number;
+    /** Human-readable provider name for logs/status. */
+    readonly name: string;
+}
+export declare class OllamaProvider implements IEmbeddingProvider {
+    private url;
+    private model;
+    readonly name = "ollama";
+    readonly dimensions: number;
+    private warnedOnce;
+    constructor(url: string, model: string, dimensions: number);
+    embedText(text: string): Promise<Float32Array | null>;
+    batchEmbed(texts: string[]): Promise<Array<Float32Array | null>>;
+}
+export declare class OpenAIProvider implements IEmbeddingProvider {
+    private url;
+    private model;
+    private apiKey;
+    readonly name = "openai";
+    readonly dimensions: number;
+    private warnedOnce;
+    constructor(url: string, model: string, apiKey: string, dimensions: number);
+    embedText(text: string): Promise<Float32Array | null>;
+    batchEmbed(texts: string[]): Promise<Array<Float32Array | null>>;
+    private callBatch;
+}
+/** Create the configured embedding provider from env. */
+export declare function createEmbeddingProvider(): IEmbeddingProvider;
+//# sourceMappingURL=embedding-provider.d.ts.map

package/dist/src/embedding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../src/embedding-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACtD,iEAAiE;IACjE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IACjE,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAID,qBAAa,cAAe,YAAW,kBAAkB;IAMrD,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,KAAK;IANf,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,UAAU,CAAS;gBAGjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM;IAKd,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAmBrD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CAMvE;AAMD,qBAAa,cAAe,YAAW,kBAAkB;IAMrD,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IAPhB,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,UAAU,CAAS;gBAGjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM;IAKd,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAKrD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;YAWxD,SAAS;CA+BxB;AAcD,yDAAyD;AACzD,wBAAgB,uBAAuB,IAAI,kBAAkB,CAU5D"}

package/dist/src/embedding-provider.js

@@ -0,0 +1,145 @@
+/**
+ * #173 — Embedding provider slot.
+ *
+ * Pluggable embedding backend. Pick once at install via EMBEDDING_PROVIDER env var.
+ * Switching providers on a live DB requires `abmind embed --reset` to drop all
+ * embeddings (dimension mismatch is a hard boot error — no silent corruption).
+ *
+ * Two built-in providers:
+ * - OllamaProvider: default. POST {url}/api/embed, body { model, input }
+ * - OpenAIProvider: covers OpenAI + any OpenAI-compatible API (Voyage, Together,
+ *   local vLLM). POST {url}/embeddings, body { model, input: string[] }.
+ *   Real batch support: 100 texts per HTTP request.
+ */
+import { getAbmindEnv } from "./env-schema.js";
+import { logWarn } from "./mem-logger.js";
+const TAG = "embed-provider";
+// ── Ollama ──────────────────────────────────────────────────────────────────
+export class OllamaProvider {
+    url;
+    model;
+    name = "ollama";
+    dimensions;
+    warnedOnce = false;
+    constructor(url, model, dimensions) {
+        this.url = url;
+        this.model = model;
+        this.dimensions = dimensions;
+    }
+    async embedText(text) {
+        try {
+            const res = await fetch(`${this.url}/api/embed`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ model: this.model, input: text }),
+            });
+            if (!res.ok)
+                throw new Error(`ollama ${res.status}`);
+            const data = await res.json();
+            return new Float32Array(data.embeddings[0]);
+        }
+        catch (err) {
+            if (!this.warnedOnce) {
+                logWarn(TAG, `ollama unavailable — Se disabled: ${err instanceof Error ? err.message : String(err)}`);
+                this.warnedOnce = true;
+            }
+            return null;
+        }
+    }
+    async batchEmbed(texts) {
+        // Ollama does not support batch input — fall back to sequential calls.
+        const out = [];
+        for (const text of texts)
+            out.push(await this.embedText(text));
+        return out;
+    }
+}
+// ── OpenAI / OpenAI-compatible ──────────────────────────────────────────────
+const OPENAI_BATCH_CEILING = 100;
+export class OpenAIProvider {
+    url;
+    model;
+    apiKey;
+    name = "openai";
+    dimensions;
+    warnedOnce = false;
+    constructor(url, model, apiKey, dimensions) {
+        this.url = url;
+        this.model = model;
+        this.apiKey = apiKey;
+        this.dimensions = dimensions;
+    }
+    async embedText(text) {
+        const result = await this.batchEmbed([text]);
+        return result[0] ?? null;
+    }
+    async batchEmbed(texts) {
+        if (texts.length === 0)
+            return [];
+        const out = [];
+        for (let i = 0; i < texts.length; i += OPENAI_BATCH_CEILING) {
+            const chunk = texts.slice(i, i + OPENAI_BATCH_CEILING);
+            const embeddings = await this.callBatch(chunk);
+            out.push(...embeddings);
+        }
+        return out;
+    }
+    async callBatch(chunk) {
+        try {
+            const body = { model: this.model, input: chunk };
+            // OpenAI text-embedding-3-* supports dimension shortening; pass through.
+            if (this.dimensions > 0)
+                body.dimensions = this.dimensions;
+            const res = await fetch(`${this.url}/embeddings`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(body),
+            });
+            if (!res.ok)
+                throw new Error(`openai ${res.status}: ${await res.text().catch(() => "?")}`);
+            const data = await res.json();
+            // Ensure order matches input (OpenAI returns `index` field)
+            const ordered = new Array(chunk.length).fill(null);
+            for (const item of data.data) {
+                if (item.index >= 0 && item.index < chunk.length) {
+                    ordered[item.index] = new Float32Array(item.embedding);
+                }
+            }
+            return ordered;
+        }
+        catch (err) {
+            if (!this.warnedOnce) {
+                logWarn(TAG, `openai-compatible endpoint unavailable — Se disabled: ${maskErrorApiKey(err, this.apiKey)}`);
+                this.warnedOnce = true;
+            }
+            return new Array(chunk.length).fill(null);
+        }
+    }
+}
+/**
+ * Strip an API key from an error message if it accidentally got embedded
+ * (some HTTP clients stringify headers on error).
+ */
+function maskErrorApiKey(err, apiKey) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (!apiKey || apiKey.length < 8)
+        return msg;
+    return msg.split(apiKey).join("***");
+}
+// ── Factory ─────────────────────────────────────────────────────────────────
+/** Create the configured embedding provider from env. */
+export function createEmbeddingProvider() {
+    const env = getAbmindEnv();
+    const dims = env.embeddingDimensions;
+    if (env.embeddingProvider === "openai") {
+        if (!env.embeddingApiKey) {
+            logWarn(TAG, "EMBEDDING_PROVIDER=openai but EMBEDDING_API_KEY is empty — calls will fail");
+        }
+        return new OpenAIProvider(env.embeddingUrl, env.embeddingModel, env.embeddingApiKey, dims);
+    }
+    return new OllamaProvider(env.embeddingUrl, env.embeddingModel, dims);
+}
+//# sourceMappingURL=embedding-provider.js.map

package/dist/src/embedding-provider.js.map

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

package/dist/src/embedding-quantize.d.ts

@@ -0,0 +1,11 @@
+/**
+ * embedding-quantize.ts — int8 quantization for embeddings.
+ * Reduces float32 (1536 bytes) to int8 (384 bytes) with ~1-2% recall quality drop.
+ */
+/** Quantize float32 embedding to int8. 4× smaller. */
+export declare function quantizeToInt8(float32: Float32Array): Int8Array;
+/** Dequantize int8 back to float32 (approximate). Needs original min/max for exact reconstruction. */
+export declare function dequantizeToFloat32(int8: Int8Array, min: number, max: number): Float32Array;
+/** Cosine similarity between two int8 vectors (approximate). */
+export declare function cosineSimInt8(a: Int8Array, b: Int8Array): number;
+//# sourceMappingURL=embedding-quantize.d.ts.map

package/dist/src/embedding-quantize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-quantize.d.ts","sourceRoot":"","sources":["../../src/embedding-quantize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAU/D;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAQ3F;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAShE"}

package/dist/src/embedding-quantize.js

@@ -0,0 +1,38 @@
+/**
+ * embedding-quantize.ts — int8 quantization for embeddings.
+ * Reduces float32 (1536 bytes) to int8 (384 bytes) with ~1-2% recall quality drop.
+ */
+/** Quantize float32 embedding to int8. 4× smaller. */
+export function quantizeToInt8(float32) {
+    const min = float32.reduce((a, b) => Math.min(a, b), Infinity);
+    const max = float32.reduce((a, b) => Math.max(a, b), -Infinity);
+    const range = max - min || 1;
+    const scale = 255 / range;
+    const int8 = new Int8Array(float32.length);
+    for (let i = 0; i < float32.length; i++) {
+        int8[i] = Math.round((float32[i] - min) * scale) - 128;
+    }
+    return int8;
+}
+/** Dequantize int8 back to float32 (approximate). Needs original min/max for exact reconstruction. */
+export function dequantizeToFloat32(int8, min, max) {
+    const range = max - min || 1;
+    const scale = range / 255;
+    const float32 = new Float32Array(int8.length);
+    for (let i = 0; i < int8.length; i++) {
+        float32[i] = (int8[i] + 128) * scale + min;
+    }
+    return float32;
+}
+/** Cosine similarity between two int8 vectors (approximate). */
+export function cosineSimInt8(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom > 0 ? dot / denom : 0;
+}
+//# sourceMappingURL=embedding-quantize.js.map

package/dist/src/embedding-quantize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-quantize.js","sourceRoot":"","sources":["../../src/embedding-quantize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,mBAAmB,CAAC,IAAe,EAAE,GAAW,EAAE,GAAW;IAC3E,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,KAAK,GAAG,GAAG,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,CAAY,EAAE,CAAY;IACtD,IAAI,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACvB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/dist/src/emotion-arc.d.ts

@@ -0,0 +1,17 @@
+/**
+ * emotion-arc.ts — Track emotional trajectory per topic over time.
+ * Built during sleep from emotion_tags on recent memories.
+ */
+import type { EmotionTag } from "./emotion-tagger.js";
+export type ArcDirection = "rising" | "falling" | "volatile" | "stable";
+export interface EmotionArc {
+    tags: EmotionTag[];
+    direction: ArcDirection;
+    symbol: string;
+}
+/** Build emotional arc from a sequence of memories (ordered by time). */
+export declare function buildArc(memories: ReadonlyArray<{
+    emotion_tags: string;
+    created_at: number;
+}>): EmotionArc;
+//# sourceMappingURL=emotion-arc.d.ts.map

package/dist/src/emotion-arc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotion-arc.d.ts","sourceRoot":"","sources":["../../src/emotion-arc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAeD,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,UAAU,CAoC1G"}