@engramx/client 0.16.0-rc.2 → 0.16.0-rc.21

package/dist/openclaw-local.js

@@ -0,0 +1,332 @@
+// Where OpenClaw keeps things on this machine, and the format of the database backups the OpenClaw
+// plugin uploads and `migrate --recover` restores. ONE module for both halves.
+//
+// ⟨2026-10-13, the bloat audit⟩ WHY THIS FILE EXISTS. "Find OpenClaw's directory, read its config,
+// find its memory directory and its databases" was written three times — in migrate.ts, in
+// openclaw-setup.ts and in the plugin (integrations/openclaw/index.ts) — and the copies had drifted:
+// different environment variables for the directory (OPENCLAW_STATE_DIR in the plugin,
+// OPENCLAW_CONFIG_DIR here), different places for the builtin SQLite store (`<dir>/*.sqlite` in
+// migrate, the configured store path or `<dir>/memory` in the plugin), and different database type
+// names. The last one was a real defect: the plugin tagged its backups `openclaw-sqlite`,
+// `openclaw-qmd` and `openclaw-lancedb`, and `migrate --recover` branched on `sqlite`, `qmd` and
+// `lancedb`, which nothing writes — so every backup the plugin ever made fell into the restore's
+// tar-extract branch: a single SQLite file (uploaded raw) failed to extract, and a QMD archive
+// landed in the wrong folder under its encoded names. The writer and the reader of one format now
+// live here, beside each other, and test/openclaw-local.test.ts round-trips them.
+//
+// THE BACKUP FORMAT (since 2026-10-13). SQLite and QMD: a gzipped tar of one entry per database
+// file, each named `<base64url(path relative to the OpenClaw directory)>.sqlite` (an absolute path
+// for a store configured outside it), so a restore knows where every file goes — on another
+// machine too. (Until then a lone builtin SQLite file was
+// uploaded raw, with no path at all, and QMD entries carried ABSOLUTE paths.) LanceDB: a gzipped tar
+// of the store directory. A restore never writes outside the OpenClaw directory, and a backup in
+// the old raw form is refused in words rather than guessed at.
+// WHAT WOULD MAKE THIS WRONG: OpenClaw moving its builtin store away from the configured
+// `agents.defaults.memorySearch.store.path` (default `<dir>/memory`), or the plugin writing a
+// backup through anything but `encodeDatabaseBackup`.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import { tmpdir } from 'node:os';
+/**
+ * OpenClaw's directory: `OPENCLAW_STATE_DIR` (OpenClaw's own variable, which the plugin read), else
+ * `OPENCLAW_CONFIG_DIR` (which this package's CLI read), else `~/.openclaw`.
+ */
+export function getOpenClawDir() {
+    return (process.env['OPENCLAW_STATE_DIR'] ||
+        process.env['OPENCLAW_CONFIG_DIR'] ||
+        path.join(process.env['HOME'] || '', '.openclaw'));
+}
+/** openclaw.json (or `OPENCLAW_CONFIG_PATH`), or `{}` when it is absent or not JSON. Read-only:
+ *  the paths that WRITE the config parse it strictly instead (openclaw-setup.ts readJsonConfig). */
+export function loadOpenClawConfig(openclawDir) {
+    const configPath = process.env['OPENCLAW_CONFIG_PATH'] ?? path.join(openclawDir, 'openclaw.json');
+    if (!fs.existsSync(configPath))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * The memory directory: the plugin's own `memoryDir` (relative to the OpenClaw directory), else the
+ * base directory of the configured store path when it exists, else `<dir>/memory`.
+ */
+export function resolveMemoryDir(openclawDir, ocConfig) {
+    const dir = ocConfig.plugins?.entries?.['memory-engramx']?.config?.memoryDir;
+    if (dir)
+        return path.isAbsolute(dir) ? dir : path.join(openclawDir, dir);
+    const storePath = ocConfig.agents?.defaults?.memorySearch?.store?.path;
+    if (storePath) {
+        // The store path may carry an {agentId} token: its base directory is what holds the files.
+        const withoutToken = storePath.replace(/\{agentId\}.*$/, '');
+        const resolved = path.isAbsolute(withoutToken)
+            ? path.dirname(withoutToken)
+            : path.join(openclawDir, path.dirname(withoutToken));
+        if (fs.existsSync(resolved))
+            return resolved;
+    }
+    return path.join(openclawDir, 'memory');
+}
+/** What a memory repo made by `git-setup`, `pair --git-remote` or the plugin leaves out. */
+export const GITIGNORE_CONTENT = [
+    '# Auto-generated by memory-engramx',
+    '*.sqlite',
+    '*.sqlite-wal',
+    '*.sqlite-shm',
+    '*.db',
+    '*.db-wal',
+    '*.db-shm',
+    'lancedb/',
+    '.DS_Store',
+    // ⟨2026-10-13, the second review⟩ The OpenClaw plugin's record of the paths it has synced with the
+    // engram, and its write-in-progress copy (integrations/openclaw/index.ts · knownPathsFile): this
+    // machine's state, not memory. Held by test/openclaw-setup.test.ts.
+    '.engramx-sync.json*',
+    '',
+].join('\n');
+/** The backup type names on the engram, one per kind of database. The ONLY spelling. */
+export const DB_TYPES = {
+    sqlite: 'openclaw-sqlite',
+    qmd: 'openclaw-qmd',
+    lancedb: 'openclaw-lancedb',
+};
+function findFilesByExt(dir, ext) {
+    if (!fs.existsSync(dir))
+        return [];
+    try {
+        return fs
+            .readdirSync(dir, { withFileTypes: true })
+            .filter((e) => e.isFile() && e.name.endsWith(ext))
+            .map((e) => path.join(dir, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+/** The builtin SQLite store's directory: the configured store path's base, or `<dir>/memory`. */
+function sqliteStoreDir(openclawDir, ocConfig) {
+    const storePath = ocConfig.agents?.defaults?.memorySearch?.store?.path;
+    if (!storePath)
+        return path.join(openclawDir, 'memory');
+    let baseDir = path.dirname(storePath.replace(/\{agentId\}/g, '*'));
+    if (baseDir.includes('*'))
+        baseDir = path.dirname(storePath.replace(/\{agentId\}.*$/, ''));
+    return path.isAbsolute(baseDir) ? baseDir : path.join(openclawDir, baseDir);
+}
+/** The configured LanceDB store directory. */
+function lancedbDir(openclawDir, ocConfig) {
+    return (ocConfig.plugins?.entries?.['memory-lancedb']?.config?.dbPath ??
+        path.join(openclawDir, 'memory', 'lancedb'));
+}
+/** The databases openclaw.json says are active, and the files they are made of. */
+export function detectDatabases(openclawDir, ocConfig = loadOpenClawConfig(openclawDir)) {
+    const detected = [];
+    const backend = ocConfig.memory?.backend ?? 'builtin';
+    // SQLite (builtin) — active when memory.backend is "builtin" or absent.
+    if (backend === 'builtin') {
+        const files = findFilesByExt(sqliteStoreDir(openclawDir, ocConfig), '.sqlite');
+        if (files.length > 0) {
+            detected.push({
+                dbType: DB_TYPES.sqlite,
+                suffix: 'sqlite',
+                label: 'SQLite (builtin)',
+                filePaths: files,
+                isDirectory: false,
+            });
+        }
+    }
+    // QMD — active when memory.backend === "qmd": agents/*/qmd/*.sqlite and *.db.
+    if (backend === 'qmd') {
+        const agentsDir = path.join(openclawDir, 'agents');
+        const files = [];
+        if (fs.existsSync(agentsDir)) {
+            for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
+                if (!entry.isDirectory())
+                    continue;
+                const qmdDir = path.join(agentsDir, entry.name, 'qmd');
+                files.push(...findFilesByExt(qmdDir, '.sqlite'), ...findFilesByExt(qmdDir, '.db'));
+            }
+        }
+        if (files.length > 0) {
+            detected.push({
+                dbType: DB_TYPES.qmd,
+                suffix: 'qmd',
+                label: 'QMD (experimental)',
+                filePaths: files,
+                isDirectory: false,
+            });
+        }
+    }
+    // LanceDB — active when plugins.slots.memory === "memory-lancedb" and not disabled.
+    if (ocConfig.plugins?.slots?.memory === 'memory-lancedb') {
+        if (ocConfig.plugins?.entries?.['memory-lancedb']?.enabled !== false) {
+            const dbPath = lancedbDir(openclawDir, ocConfig);
+            if (fs.existsSync(dbPath) && fs.statSync(dbPath).isDirectory()) {
+                detected.push({
+                    dbType: DB_TYPES.lancedb,
+                    suffix: 'lancedb',
+                    label: 'LanceDB (plugin)',
+                    filePaths: [dbPath],
+                    isDirectory: true,
+                });
+            }
+        }
+    }
+    return detected;
+}
+// ── The backup format ─────────────────────────────────────────────────────────────────────────
+const SQLITE3_TIMEOUT_MS = 30000;
+const TAR_TIMEOUT_MS = 120000;
+const ENTRY_SUFFIX = '.sqlite';
+/** A consistent copy of a SQLite file through the sqlite3 CLI (`.backup`), or the file as it is
+ *  when the CLI is not installed (WAL contents may then be missing, and the logger says so). */
+export function snapshotSqliteFile(dbPath, logger) {
+    const tmpPath = path.join(fs.mkdtempSync(path.join(tmpdir(), 'engramx-sqlite-')), `backup-${randomBytes(8).toString('hex')}.sqlite`);
+    try {
+        execFileSync('sqlite3', [dbPath, `.backup '${tmpPath.replace(/'/g, "''")}'`], {
+            timeout: SQLITE3_TIMEOUT_MS,
+            stdio: 'pipe',
+        });
+        return fs.readFileSync(tmpPath);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('ENOENT') || msg.includes('not found')) {
+            logger?.warn('memory-engramx: sqlite3 CLI not available, falling back to direct file read. ' +
+                'WAL data may not be included.');
+            return fs.readFileSync(dbPath);
+        }
+        throw err;
+    }
+    finally {
+        fs.rmSync(path.dirname(tmpPath), { recursive: true, force: true });
+    }
+}
+function inside(base, p) {
+    const rel = path.relative(base, p);
+    return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
+}
+function tarGz(cwd, entries) {
+    const tmp = fs.mkdtempSync(path.join(tmpdir(), 'engramx-tar-'));
+    const tarPath = path.join(tmp, 'backup.tar.gz');
+    try {
+        execFileSync('tar', ['-czf', tarPath, '-C', cwd, ...entries], {
+            timeout: TAR_TIMEOUT_MS,
+            stdio: 'pipe',
+        });
+        return fs.readFileSync(tarPath);
+    }
+    finally {
+        fs.rmSync(tmp, { recursive: true, force: true });
+    }
+}
+function untarGz(data) {
+    const tmp = fs.mkdtempSync(path.join(tmpdir(), 'engramx-restore-'));
+    const tarPath = path.join(tmp, 'backup.tar.gz');
+    const out = path.join(tmp, 'out');
+    fs.mkdirSync(out);
+    fs.writeFileSync(tarPath, data);
+    try {
+        execFileSync('tar', ['--no-same-owner', '-xzf', tarPath, '-C', out], {
+            timeout: TAR_TIMEOUT_MS,
+            stdio: 'pipe',
+        });
+    }
+    catch (err) {
+        fs.rmSync(tmp, { recursive: true, force: true });
+        throw new Error(`the backup is not a gzipped tar archive (${err instanceof Error ? err.message.split('\n')[0] : String(err)})`, { cause: err });
+    }
+    return out;
+}
+/**
+ * The bytes the plugin uploads for one detected database (see THE BACKUP FORMAT above).
+ * `snapshot` reads one SQLite file; it is a parameter so a test can pack files that are not
+ * SQLite databases.
+ */
+export function encodeDatabaseBackup(openclawDir, db, opts = {}) {
+    const snapshot = opts.snapshot ?? snapshotSqliteFile;
+    if (db.suffix === 'lancedb') {
+        const dir = db.filePaths[0];
+        return tarGz(path.dirname(dir), [path.basename(dir)]);
+    }
+    const staging = fs.mkdtempSync(path.join(tmpdir(), 'engramx-dbpack-'));
+    try {
+        const names = [];
+        for (const fp of db.filePaths) {
+            // Relative to the OpenClaw directory when inside it (a restore on another machine lands in
+            // that machine's directory); absolute for a store configured elsewhere.
+            const named = inside(openclawDir, fp) ? path.relative(openclawDir, fp) : path.resolve(fp);
+            const name = Buffer.from(named).toString('base64url') + ENTRY_SUFFIX;
+            fs.writeFileSync(path.join(staging, name), snapshot(fp, opts.logger));
+            names.push(name);
+        }
+        return tarGz(staging, names);
+    }
+    finally {
+        fs.rmSync(staging, { recursive: true, force: true });
+    }
+}
+/** SQLite's file header — the start of a lone database uploaded raw before 2026-10-13. */
+const SQLITE_HEADER = Buffer.from('SQLite format 3\0', 'latin1');
+/**
+ * Write a downloaded backup back where it came from. Returns the paths written.
+ * Throws, writing nothing, for a type it does not know, a backup in the pre-2026-10-13 raw form, an
+ * archive that is not one, or an entry that would land outside the OpenClaw directory.
+ */
+export function restoreDatabaseBackup(openclawDir, ocConfig, dbType, data) {
+    const known = Object.values(DB_TYPES);
+    if (!known.includes(dbType)) {
+        throw new Error(`unknown backup type "${dbType}" — this version restores ${known.join(', ')}; nothing was written.`);
+    }
+    if (Buffer.from(data.subarray(0, SQLITE_HEADER.length)).equals(SQLITE_HEADER)) {
+        throw new Error('this backup is a lone SQLite file in the form used before 2026-10-13, which records no path, ' +
+            'so this version cannot tell where it belongs. Nothing was written. Download it with the ' +
+            "client's pullBackupChunk and copy it into the builtin store directory by hand.");
+    }
+    const out = untarGz(data);
+    const tmpRoot = path.dirname(out);
+    try {
+        if (dbType === DB_TYPES.lancedb) {
+            const tops = fs.readdirSync(out);
+            if (tops.length !== 1 || !fs.statSync(path.join(out, tops[0])).isDirectory()) {
+                throw new Error('a LanceDB backup holds one directory; this one does not. Nothing was written.');
+            }
+            const dest = lancedbDir(openclawDir, ocConfig);
+            fs.rmSync(dest, { recursive: true, force: true });
+            fs.mkdirSync(path.dirname(dest), { recursive: true });
+            fs.cpSync(path.join(out, tops[0]), dest, { recursive: true });
+            return [dest];
+        }
+        // SQLite and QMD: every entry first, so a bad one writes nothing.
+        const plan = [];
+        for (const name of fs.readdirSync(out)) {
+            if (!name.endsWith(ENTRY_SUFFIX)) {
+                throw new Error(`unexpected entry "${name}" in a ${dbType} backup. Nothing was written.`);
+            }
+            const rel = Buffer.from(name.slice(0, -ENTRY_SUFFIX.length), 'base64url').toString('utf-8');
+            // A relative name lands in this OpenClaw directory. An absolute one (a store configured
+            // outside it, or a QMD backup written before 2026-10-13) is kept only when it lies inside
+            // this directory or, for SQLite, inside the store directory this machine's config names.
+            const to = path.resolve(openclawDir, rel);
+            const allowed = inside(openclawDir, to) ||
+                (dbType === DB_TYPES.sqlite && inside(sqliteStoreDir(openclawDir, ocConfig), to));
+            if (!allowed) {
+                throw new Error(`the backup names ${rel}, which is outside the OpenClaw directory ${openclawDir}. Nothing was written.`);
+            }
+            plan.push({ from: path.join(out, name), to });
+        }
+        for (const { from, to } of plan) {
+            fs.mkdirSync(path.dirname(to), { recursive: true });
+            fs.copyFileSync(from, to);
+        }
+        return plan.map((p) => p.to);
+    }
+    finally {
+        fs.rmSync(tmpRoot, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=openclaw-local.js.map

package/dist/openclaw-local.js.map

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

package/dist/openclaw-setup.d.ts

@@ -1,3 +1,5 @@
+import { getOpenClawDir } from './openclaw-local.js';
+export { getOpenClawDir };
 export interface OpenClawSetupOptions {
     canisterId: string;
     sessionKeyPath: string;
@@ -5,11 +7,89 @@ export interface OpenClawSetupOptions {
 }
 export interface OpenClawSetupResult {
     configPath: string;
+    /** True only when this run installed the plugin. */
     pluginInstalled: boolean;
-    pluginMethod: 'cli' | 'manual-npm' | 'skipped';
+    /**
+     * What happened to the plugin: installed through OpenClaw's installer (`cli`) or with npm
+     * (`manual-npm`), already at this kit's version so nothing ran (`current`), or not installed
+     * (`skipped`). ⟨2026-10-13, the second review⟩ `current` is new; before it, a plugin already in
+     * pair's npm folder — at any version — was `skipped`, and pair printed "Installed" over it.
+     */
+    pluginMethod: 'cli' | 'manual-npm' | 'current' | 'skipped';
+    /** Where the plugin is (`manual-npm`, `current`), or why nothing was installed (`skipped`). */
+    pluginNote?: string;
 }
-export declare function getOpenClawDir(): string;
 export declare function setupOpenClaw(options: OpenClawSetupOptions): Promise<OpenClawSetupResult>;
+/**
+ * The plugin `pair --target openclaw` installs: `@engramx/openclaw@<this kit's version>`.
+ *
+ * ⟨ADDED 2026-10-13, on the review of the owner's "fix … the MCP version in rc.12"⟩ WHY. Both installs
+ * below named the bare `@engramx/openclaw`, which installs npm's `latest` — the last FINAL release,
+ * 0.15.0 while 0.16.0's candidates soak under `next` (npm dist-tags, read 2026-10-13) — a plugin that
+ * cannot talk to this release's engram. The packages are released in lockstep (version.ts), so this
+ * kit's version is the plugin's. OpenClaw's installer takes the versioned name: its registry-spec
+ * parser (openclaw 2026.10.3, the npm `latest` read that day, `parseRegistryNpmSpecResult`) accepts
+ * `<name>@<exact version>`, and for a pre-release such as `0.16.0-rc.12` only when it is named
+ * exactly — a bare name that resolved to one is refused — while `@engramx/openclaw@<version>` (this
+ * kit's unread-version blank) is refused — neither an exact version nor a tag — as npm refuses it.
+ * Measured by running that parser on these four spellings (the fix notes keep the log).
+ * WHAT WOULD MAKE THIS WRONG: the packages no longer sharing one version number, or an OpenClaw
+ * release whose installer refuses an exact version. Held by test/openclaw-plugin-pinned.test.ts.
+ */
+export declare const OPENCLAW_PLUGIN: string;
+/** A copy of @engramx/openclaw found on this machine. */
+export interface InstalledOpenClawPlugin {
+    /** The package's folder, `…/node_modules/@engramx/openclaw`. */
+    dir: string;
+    /** The npm project holding it: the folder `npm install` ran in. */
+    project: string;
+    /** The version its package.json names, or null when that cannot be read. */
+    version: string | null;
+    /** Who put it there, which decides the command that upgrades it. */
+    installer: 'npm' | 'openclaw';
+}
+/**
+ * Every copy of @engramx/openclaw in the places a plugin install puts it, under `openclawDir`:
+ * pair's own npm fallback (`extensions/memory-engramx`), and OpenClaw's installer — one npm project
+ * per package under `npm/projects/` (a package keeps more than one after an upgrade: OpenClaw's
+ * docs say upgrades "retain generation paths that running plugins may still need"), and the single
+ * `npm/` project it used before 2026.5.28. Read from openclaw 2026.10.3's own code
+ * (`resolvePluginNpmProjectDir`, `resolvePluginInstallRoots`) and docs
+ * (plugins/dependency-resolution.md, "Install roots"); no real OpenClaw was run.
+ * WHAT WOULD MAKE THIS WRONG: an OpenClaw that keeps its plugins elsewhere — `OPENCLAW_STATE_DIR`
+ * set apart from the folder pair reads (OPENCLAW_CONFIG_DIR or ~/.openclaw), a plugin loaded from a
+ * `plugins.load.paths` entry or a workspace's `.openclaw/extensions` — is not seen here.
+ */
+export declare function findInstalledOpenClawPlugins(openclawDir?: string): InstalledOpenClawPlugin[];
+/**
+ * The copies `pair` will not point at an engram: any in its own npm folder that is not this kit's
+ * version, and OpenClaw's copies when none of them is (an older folder beside a current one is what
+ * an upgrade leaves, so it is not counted against a current copy).
+ *
+ * ⟨ADDED 2026-10-13, the second review of the owner's "fix the pairing migration"⟩ WHY. pair skipped
+ * the install whenever any @engramx/openclaw sat in its npm folder, whatever its version, then wrote
+ * openclaw.json and printed "Installed EngramX plugin for OpenClaw" — and on a gateway that was not
+ * running, the same line over no install at all. The plugin that ran at OpenClaw's next start was
+ * the one already there, and one from 0.16.0-rc.11 or earlier deletes every local memory file the
+ * engram does not list before it pushes (unless more than five and more than half would go) — the
+ * files `pair` now leaves where they are without --migrate. So a different version is never
+ * configured: `pair` stops before pairing and prints the command that upgrades it
+ * (cli.ts · Step 1's check), and setupOpenClaw refuses the same before writing openclaw.json.
+ * Refusing, not upgrading in place: the refusal comes before the invite is used, so running the
+ * same pair command again afterwards works, and pair runs nothing on someone's OpenClaw that it
+ * cannot check (how OpenClaw's `plugins update` behaves without a terminal was not run). Held by
+ * test/openclaw-plugin-pinned.test.ts and test/pair-migrate.test.ts.
+ * WHAT WOULD MAKE THIS WRONG: a copy outside the places findInstalledOpenClawPlugins reads (it
+ * says which), or OpenClaw loading an older retained folder over a current one.
+ */
+export declare function outdatedOpenClawPlugins(copies?: InstalledOpenClawPlugin[]): InstalledOpenClawPlugin[];
+/** The command that puts `copy` at this kit's version, exact, to run as printed. */
+export declare function pluginUpgradeCommand(copy: InstalledOpenClawPlugin): string;
+/** pair's refusal: each copy and its version, and the commands that upgrade them. */
+export declare class OpenClawPluginOutdatedError extends Error {
+    readonly outdated: InstalledOpenClawPlugin[];
+    constructor(outdated: InstalledOpenClawPlugin[]);
+}
 export declare class OpenClawNotFoundError extends Error {
     constructor(message: string);
 }
@@ -20,5 +100,4 @@ export interface GitSetupResult {
 export declare function isGitRepo(dir: string): boolean;
 /** Resolve the memory directory from openclaw.json config. */
 export declare function getMemoryDir(): string;
-export declare function resolveMemoryDirFromConfig(openclawDir: string, config: Record<string, unknown>): string;
 export declare function setupGitVersioning(remoteUrl: string): GitSetupResult;