@synthaer/resonance 0.1.0

package/dist/embedding-provider.js

@@ -0,0 +1,62 @@
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { mkdir } from 'node:fs/promises';
+const DEFAULT_MODEL = 'Xenova/all-MiniLM-L6-v2';
+const MODEL_DIMENSIONS = 384;
+const DEFAULT_CACHE_DIR = join(homedir(), '.partitura', 'models');
+export class LocalEmbeddingProvider {
+    _model;
+    _cacheDir;
+    _pipeline = null;
+    _initPromise = null;
+    _ready = false;
+    dimensions = MODEL_DIMENSIONS;
+    constructor(options) {
+        this._model = options?.model ?? DEFAULT_MODEL;
+        this._cacheDir = options?.cacheDir ?? DEFAULT_CACHE_DIR;
+    }
+    get ready() {
+        return this._ready;
+    }
+    async ensureInitialized() {
+        if (this._ready)
+            return;
+        if (!this._initPromise) {
+            this._initPromise = this._initialize();
+        }
+        await this._initPromise;
+    }
+    async _initialize() {
+        await mkdir(this._cacheDir, { recursive: true });
+        const { pipeline, env } = await import('@xenova/transformers');
+        env.cacheDir = this._cacheDir;
+        env.allowLocalModels = true;
+        this._pipeline = await pipeline('feature-extraction', this._model, {
+            quantized: true,
+        });
+        this._ready = true;
+    }
+    async embed(text) {
+        await this.ensureInitialized();
+        const output = await this._pipeline(text, {
+            pooling: 'mean',
+            normalize: true,
+        });
+        return Array.from(output.data);
+    }
+    async embedBatch(texts) {
+        if (texts.length === 0)
+            return [];
+        await this.ensureInitialized();
+        const results = [];
+        for (const text of texts) {
+            const output = await this._pipeline(text, {
+                pooling: 'mean',
+                normalize: true,
+            });
+            results.push(Array.from(output.data));
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=embedding-provider.js.map

package/dist/embedding-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.js","sourceRoot":"","sources":["../src/embedding-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AASzC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAChD,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAOlE,MAAM,OAAO,sBAAsB;IACzB,MAAM,CAAS;IACf,SAAS,CAAS;IAClB,SAAS,GAAY,IAAI,CAAC;IAC1B,YAAY,GAAyB,IAAI,CAAC;IAC1C,MAAM,GAAG,KAAK,CAAC;IAEd,UAAU,GAAG,gBAAgB,CAAC;IAEvC,YAAY,OAAuC;QACjD,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,KAAK,IAAI,aAAa,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAC;IAC1D,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,iBAAiB;QAC7B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC/D,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAE5B,IAAI,CAAC,SAAS,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,IAAI,CAAC,MAAM,EAAE;YACjE,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE/B,MAAM,MAAM,GAAG,MAAO,IAAI,CAAC,SAAiB,CAAC,IAAI,EAAE;YACjD,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE/B,MAAM,OAAO,GAAe,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAO,IAAI,CAAC,SAAiB,CAAC,IAAI,EAAE;gBACjD,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/embeddings/local.d.ts

@@ -0,0 +1,31 @@
+export interface EmbeddingProvider {
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+    readonly dimensions: number;
+    readonly ready: boolean;
+}
+/**
+ * Local embedding provider using @xenova/transformers.
+ *
+ * The model (~23MB) is downloaded on first use and cached in the
+ * models directory. All subsequent calls are fully offline.
+ */
+export declare class LocalEmbeddingProvider implements EmbeddingProvider {
+    private _model;
+    private _cacheDir;
+    private _pipeline;
+    private _initPromise;
+    private _ready;
+    readonly dimensions = 384;
+    constructor(cacheDir: string, model?: string);
+    get ready(): boolean;
+    /**
+     * Lazily initialize the embedding pipeline.
+     * Shows a progress message on first download.
+     */
+    ensureInitialized(): Promise<void>;
+    private _initialize;
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/embeddings/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAKD;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,MAAM,CAAS;IAEvB,QAAQ,CAAC,UAAU,OAAoB;gBAE3B,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAK5C,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;YAQ1B,WAAW;IAoBnB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAevD"}

package/dist/embeddings/local.js

@@ -0,0 +1,72 @@
+import { mkdir } from 'node:fs/promises';
+const DEFAULT_MODEL = 'Xenova/all-MiniLM-L6-v2';
+const MODEL_DIMENSIONS = 384;
+/**
+ * Local embedding provider using @xenova/transformers.
+ *
+ * The model (~23MB) is downloaded on first use and cached in the
+ * models directory. All subsequent calls are fully offline.
+ */
+export class LocalEmbeddingProvider {
+    _model;
+    _cacheDir;
+    _pipeline = null;
+    _initPromise = null;
+    _ready = false;
+    dimensions = MODEL_DIMENSIONS;
+    constructor(cacheDir, model) {
+        this._model = model ?? DEFAULT_MODEL;
+        this._cacheDir = cacheDir;
+    }
+    get ready() {
+        return this._ready;
+    }
+    /**
+     * Lazily initialize the embedding pipeline.
+     * Shows a progress message on first download.
+     */
+    async ensureInitialized() {
+        if (this._ready)
+            return;
+        if (!this._initPromise) {
+            this._initPromise = this._initialize();
+        }
+        await this._initPromise;
+    }
+    async _initialize() {
+        await mkdir(this._cacheDir, { recursive: true });
+        process.stderr.write(`[resonance] Loading embedding model (${this._model})...\n` +
+            `[resonance] First run downloads ~23MB. Cached at: ${this._cacheDir}\n`);
+        const { pipeline, env } = await import('@xenova/transformers');
+        env.cacheDir = this._cacheDir;
+        env.allowLocalModels = true;
+        this._pipeline = await pipeline('feature-extraction', this._model, {
+            quantized: true,
+        });
+        this._ready = true;
+        process.stderr.write('[resonance] Embedding model ready.\n');
+    }
+    async embed(text) {
+        await this.ensureInitialized();
+        const output = await this._pipeline(text, {
+            pooling: 'mean',
+            normalize: true,
+        });
+        return Array.from(output.data);
+    }
+    async embedBatch(texts) {
+        if (texts.length === 0)
+            return [];
+        await this.ensureInitialized();
+        const results = [];
+        for (const text of texts) {
+            const output = await this._pipeline(text, {
+                pooling: 'mean',
+                normalize: true,
+            });
+            results.push(Array.from(output.data));
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/embeddings/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AASzC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAChD,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IACzB,MAAM,CAAS;IACf,SAAS,CAAS;IAClB,SAAS,GAAY,IAAI,CAAC;IAC1B,YAAY,GAAyB,IAAI,CAAC;IAC1C,MAAM,GAAG,KAAK,CAAC;IAEd,UAAU,GAAG,gBAAgB,CAAC;IAEvC,YAAY,QAAgB,EAAE,KAAc;QAC1C,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,aAAa,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB;QACrB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wCAAwC,IAAI,CAAC,MAAM,QAAQ;YAC3D,qDAAqD,IAAI,CAAC,SAAS,IAAI,CACxE,CAAC;QAEF,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC/D,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAE5B,IAAI,CAAC,SAAS,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,IAAI,CAAC,MAAM,EAAE;YACjE,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE/B,MAAM,MAAM,GAAG,MAAO,IAAI,CAAC,SAAiB,CAAC,IAAI,EAAE;YACjD,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE/B,MAAM,OAAO,GAAe,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAO,IAAI,CAAC,SAAiB,CAAC,IAAI,EAAE;gBACjD,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/encryption.d.ts

@@ -0,0 +1,22 @@
+/**
+ * encryption.ts — AES-256-GCM encryption for knowledge content.
+ *
+ * The encryption key derives from the user's cloud auth token.
+ * Without a valid token, knowledge cannot be stored or read.
+ * Experiences are NOT encrypted (private scratch data).
+ */
+/**
+ * Derive an AES-256 key from the user's auth token.
+ * No token = no key = no knowledge access.
+ */
+export declare function deriveLocalKey(authToken: string): Buffer;
+/**
+ * Encrypt plaintext content using AES-256-GCM.
+ * Returns base64(iv + authTag + ciphertext).
+ */
+export declare function encryptContent(plaintext: string, key: Buffer): string;
+/**
+ * Decrypt base64(iv + authTag + ciphertext) back to plaintext.
+ */
+export declare function decryptContent(encrypted: string, key: Buffer): string;
+//# sourceMappingURL=encryption.d.ts.map

package/dist/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQrE"}

package/dist/encryption.js

@@ -0,0 +1,39 @@
+/**
+ * encryption.ts — AES-256-GCM encryption for knowledge content.
+ *
+ * The encryption key derives from the user's cloud auth token.
+ * Without a valid token, knowledge cannot be stored or read.
+ * Experiences are NOT encrypted (private scratch data).
+ */
+import { createCipheriv, createDecipheriv, randomBytes, createHash } from 'node:crypto';
+/**
+ * Derive an AES-256 key from the user's auth token.
+ * No token = no key = no knowledge access.
+ */
+export function deriveLocalKey(authToken) {
+    return createHash('sha256').update(authToken).digest();
+}
+/**
+ * Encrypt plaintext content using AES-256-GCM.
+ * Returns base64(iv + authTag + ciphertext).
+ */
+export function encryptContent(plaintext, key) {
+    const iv = randomBytes(12);
+    const cipher = createCipheriv('aes-256-gcm', key, iv);
+    const encrypted = Buffer.concat([cipher.update(plaintext, 'utf8'), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    return Buffer.concat([iv, tag, encrypted]).toString('base64');
+}
+/**
+ * Decrypt base64(iv + authTag + ciphertext) back to plaintext.
+ */
+export function decryptContent(encrypted, key) {
+    const buf = Buffer.from(encrypted, 'base64');
+    const iv = buf.subarray(0, 12);
+    const tag = buf.subarray(12, 28);
+    const ciphertext = buf.subarray(28);
+    const decipher = createDecipheriv('aes-256-gcm', key, iv);
+    decipher.setAuthTag(tag);
+    return decipher.update(ciphertext) + decipher.final('utf8');
+}
+//# sourceMappingURL=encryption.js.map

package/dist/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAExF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,GAAW;IAC3D,MAAM,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,GAAW;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC9D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @synthaer/resonance — Local-first AI memory for agents.
+ *
+ * Programmatic API entry point. For CLI usage, see cli.ts.
+ */
+export { resolveMode, resolveDataDir, ensureDataDir } from './config.js';
+export type { ResonanceMode } from './config.js';
+export { initLocalDb, createVectorIndexes, getDb, closeDb } from './db/local.js';
+export { LocalEmbeddingProvider } from './embeddings/local.js';
+export type { EmbeddingProvider } from './embeddings/local.js';
+export { startServer } from './server.js';
+export type { ResonanceServerOptions } from './server.js';
+export { handleStoreKnowledge, handleRecallKnowledge, handleSemanticSearch, handleEndorseKnowledge, handleChallengeKnowledge, } from './tools/knowledge.js';
+export type { StoreKnowledgeInput, RecallKnowledgeInput, SearchKnowledgeInput, EndorseInput, ChallengeInput, } from './tools/knowledge.js';
+export { handleStoreExperience, handleRecallExperiences, } from './tools/experiences.js';
+export type { StoreExperienceInput, RecallExperiencesInput, } from './tools/experiences.js';
+export { handleSessionResume, handleMemoryCheckpoint, } from './tools/sessions.js';
+export type { SessionResumeInput, MemoryCheckpointInput, } from './tools/sessions.js';
+export { handleGetTrust, handleUpdateTrust, } from './tools/trust.js';
+export type { GetTrustInput, UpdateTrustInput, } from './tools/trust.js';
+export { isCloudOnlyTool, cloudRequiredError, } from './tools/cloud-gate.js';
+//# 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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @synthaer/resonance — Local-first AI memory for agents.
+ *
+ * Programmatic API entry point. For CLI usage, see cli.ts.
+ */
+export { resolveMode, resolveDataDir, ensureDataDir } from './config.js';
+export { initLocalDb, createVectorIndexes, getDb, closeDb } from './db/local.js';
+export { LocalEmbeddingProvider } from './embeddings/local.js';
+export { startServer } from './server.js';
+export { handleStoreKnowledge, handleRecallKnowledge, handleSemanticSearch, handleEndorseKnowledge, handleChallengeKnowledge, } from './tools/knowledge.js';
+export { handleStoreExperience, handleRecallExperiences, } from './tools/experiences.js';
+export { handleSessionResume, handleMemoryCheckpoint, } from './tools/sessions.js';
+export { handleGetTrust, handleUpdateTrust, } from './tools/trust.js';
+export { isCloudOnlyTool, cloudRequiredError, } from './tools/cloud-gate.js';
+//# 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;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EACL,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,362 @@
+import { Router } from 'express';
+import type { LocalResonance } from './index.js';
+import { type DikwStage } from './types.js';
+import type { LocalIdentity, PKIConfig, ContentSignature } from './pki.js';
+export interface LocalMcpLimits {
+    edition: string;
+    maxProjects: number;
+    maxConcurrentFleet: number;
+    recallWindowSize: number;
+    allowedDikwStages: DikwStage[];
+    allowMassImport: boolean;
+    allowFleetKnowledge: boolean;
+    allowFullPromotion: boolean;
+}
+export interface LocalMcpRuntime {
+    listTools: () => Readonly<typeof MCP_TOOLS>;
+    callTool: (name: string, args?: Record<string, unknown>) => Promise<unknown>;
+}
+export interface CreateLocalMcpRouterOptions {
+    limits?: Partial<LocalMcpLimits>;
+    serverName?: string;
+    pkiConfig?: PKIConfig;
+}
+export declare function getPkiIdentity(): LocalIdentity | null;
+export declare function isPkiReady(): boolean;
+/**
+ * Initialize PKI. Called once on server start. If a signed certificate is
+ * not yet available, the identity is created but writes that require signing
+ * will be blocked until the certificate is obtained.
+ */
+export declare function initializeServerPKI(config: PKIConfig): Promise<LocalIdentity>;
+/**
+ * Request certificate signing from cloud PKI and update the local identity.
+ */
+export declare function requestServerCertSigning(authToken: string): Promise<LocalIdentity>;
+/**
+ * Sign content using the local identity for ratification.
+ */
+export declare function signContentWithLocalIdentity(content: string): ContentSignature | null;
+export type LocalMcpToolName = (typeof MCP_TOOLS)[number]['name'];
+declare const MCP_TOOLS: readonly [{
+    readonly name: "store_knowledge";
+    readonly description: "Store a knowledge item in local Resonance memory.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly content: {
+                readonly type: "string";
+            };
+            readonly kind: {
+                readonly type: readonly ["number", "string"];
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly projectId: {
+                readonly type: "string";
+            };
+            readonly dikwStage: {
+                readonly type: "string";
+                readonly enum: DikwStage[];
+            };
+        };
+        readonly required: readonly ["content"];
+    };
+}, {
+    readonly name: "recall_knowledge";
+    readonly description: "Keyword search across stored knowledge.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+            readonly minStrength: {
+                readonly type: "number";
+            };
+            readonly projectId: {
+                readonly type: "string";
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "get_knowledge";
+    readonly description: "Fetch a single knowledge item by id.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "promote_knowledge";
+    readonly description: "Promote a knowledge item to a higher DIKW stage.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly toStage: {
+                readonly type: "string";
+                readonly enum: DikwStage[];
+            };
+            readonly reason: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id", "toStage", "reason"];
+    };
+}, {
+    readonly name: "store_experience";
+    readonly description: "Store an agent experience record.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly content: {
+                readonly type: "string";
+            };
+            readonly kind: {
+                readonly type: readonly ["number", "string"];
+            };
+            readonly agentId: {
+                readonly type: "string";
+            };
+            readonly sessionId: {
+                readonly type: "string";
+            };
+            readonly projectId: {
+                readonly type: "string";
+            };
+            readonly relatedKnowledgeIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly required: readonly ["content"];
+    };
+}, {
+    readonly name: "recall_experiences";
+    readonly description: "Keyword search across stored experiences.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+            readonly projectId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "semantic_search";
+    readonly description: "Hybrid semantic search across knowledge + experiences.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+            readonly minStrength: {
+                readonly type: "number";
+            };
+            readonly projectId: {
+                readonly type: "string";
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "session_resume";
+    readonly description: "Resume or create session memory for agent/project.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly agentId: {
+                readonly type: "string";
+            };
+            readonly projectId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["agentId", "projectId"];
+    };
+}, {
+    readonly name: "memory_append";
+    readonly description: "Append a memory item to an active session.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sessionId: {
+                readonly type: "string";
+            };
+            readonly role: {
+                readonly type: "string";
+                readonly enum: readonly ["system", "user", "assistant"];
+            };
+            readonly content: {
+                readonly type: "string";
+            };
+            readonly timestamp: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["sessionId", "role", "content"];
+    };
+}, {
+    readonly name: "memory_checkpoint";
+    readonly description: "Persist a checkpoint for a session memory thread.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sessionId: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["sessionId"];
+    };
+}, {
+    readonly name: "update_experience";
+    readonly description: "Update an existing experience record.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly content: {
+                readonly type: "string";
+            };
+            readonly kind: {
+                readonly type: readonly ["number", "string"];
+            };
+            readonly agentId: {
+                readonly type: "string";
+            };
+            readonly sessionId: {
+                readonly type: "string";
+            };
+            readonly projectId: {
+                readonly type: "string";
+            };
+            readonly relatedKnowledgeIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "delete_experience";
+    readonly description: "Delete an experience record by id.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "get_experience";
+    readonly description: "Fetch a single experience record by id.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "update_knowledge";
+    readonly description: "Update an existing knowledge item.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly content: {
+                readonly type: "string";
+            };
+            readonly kind: {
+                readonly type: readonly ["number", "string"];
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly projectId: {
+                readonly type: "string";
+            };
+            readonly dikwStage: {
+                readonly type: "string";
+                readonly enum: DikwStage[];
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "delete_knowledge";
+    readonly description: "Delete a knowledge item by id.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "health";
+    readonly description: "Return local MCP health and knowledge counts.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}];
+export declare function createLocalMcpRuntime(localResonance: LocalResonance, limits?: Partial<LocalMcpLimits>): LocalMcpRuntime;
+export declare function createResonanceMcpRouter(localResonance: LocalResonance, options?: CreateLocalMcpRouterOptions): Router;
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAiC,KAAK,SAAS,EAAuC,MAAM,YAAY,CAAC;AAChH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA8B3E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,SAAS,EAAE,CAAC;IAC/B,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,QAAQ,CAAC,OAAO,SAAS,CAAC,CAAC;IAC5C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAUD,wBAAgB,cAAc,IAAI,aAAa,GAAG,IAAI,CAErD;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAInF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAexF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAKrF;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AA2BlE,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwML,CAAC;AAsXX,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,cAAc,EAC9B,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,eAAe,CAajB;AAED,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,cAAc,EAC9B,OAAO,CAAC,EAAE,2BAA2B,GACpC,MAAM,CAkGR"}