Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
#!/usr/bin/env node
/**
* Status report for the OpenViking memory plugin — invoked by the `/ov`
* slash command. Prints a tight human-readable summary covering:
* - Server URL + /health probe
* - Resolved identity (account/user)
* - Last session-start injection (size, age, audit path)
* - Last auto-recall (item count, token budget use)
* - Toggle state for the three injection paths
* - Auth source — which file/env actually drove url + api_key, mirroring
* config.mjs's priority chain (env → ovcli.conf → ov.conf → default)
*
* Reads the same state files the statusline uses (~/.openviking/state/)
* plus the audit file written by session-start.mjs.
*/
import { existsSync, readFileSync, statSync } from "node:fs";
import { homedir } from "node:os";
import { join, resolve as resolvePath } from "node:path";
import { isPluginEnabled, loadConfig } from "./config.mjs";
import { makeFetchJSON } from "./lib/ov-session.mjs";
import { readJsonState } from "./lib/state.mjs";
function expandHome(p) {
return p ? resolvePath(p.replace(/^~(?=$|\/)/, homedir())) : p;
}
function tryReadJson(path) {
try {
return JSON.parse(readFileSync(path, "utf-8"));
} catch {
return null;
}
}
function fmtBytes(n) {
if (n == null) return "?";
if (n < 1024) return `${n} B`;
if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`;
return `${(n / 1024 / 1024).toFixed(1)} MB`;
}
function fmtAge(ts) {
if (!ts) return "never";
const sec = Math.floor((Date.now() - ts) / 1000);
if (sec < 0) return "just now";
if (sec < 60) return `${sec}s ago`;
if (sec < 3600) return `${Math.floor(sec / 60)}m ago`;
if (sec < 86400) return `${Math.floor(sec / 3600)}h ago`;
return `${Math.floor(sec / 86400)}d ago`;
}
function homeShort(path) {
const h = homedir();
return path && path.startsWith(h) ? "~" + path.slice(h.length) : path;
}
async function main() {
if (!isPluginEnabled()) {
console.log("OpenViking plugin: DISABLED (OPENVIKING_MEMORY_ENABLED=0 or no config found)");
return;
}
const cfg = loadConfig();
const fetchJSON = makeFetchJSON(cfg, "timeoutMs");
// 1. Server / identity
const t0 = Date.now();
const health = await fetchJSON("/health");
const latency = Date.now() - t0;
console.log(`OpenViking — ${cfg.baseUrl} (${health.ok ? "✓" : "✗"} /health ${latency}ms)`);
console.log(
`Identity: account=${cfg.accountId || "(unset)"} ` +
`user=${cfg.userId || "(server-resolved)"}`,
);
console.log("");
// 2. Last session-start injection
const lastInjectPath = join(homedir(), ".openviking", "last_inject.md");
let injSize = null, injMtime = null;
try {
const st = statSync(lastInjectPath);
injSize = st.size; injMtime = st.mtimeMs;
} catch { /* none yet */ }
if (injMtime) {
console.log(`Last session-start injection: ${fmtAge(injMtime)}, ${fmtBytes(injSize)}`);
console.log(` audit: ${homeShort(lastInjectPath)}`);
} else {
console.log("Last session-start injection: (none yet)");
}
// 3. Last auto-recall
const recall = readJsonState("last-recall.json");
if (recall) {
const used = recall.tokens_used ?? 0;
const budget = recall.tokens_budget ?? 0;
console.log(
`Last auto-recall: ${fmtAge(recall.ts)} — ${recall.count ?? 0} items, ` +
`${used}/${budget} tokens (${recall.reason || "ok"})`,
);
} else {
console.log("Last auto-recall: (none yet)");
}
console.log("");
// 4. Toggles
console.log("Toggles:");
console.log(` auto-inject: ${cfg.noAutoInject ? "OFF" : "on"} (profile budget=${cfg.profileTokenBudget})`);
console.log(` auto-recall: ${cfg.autoRecall ? "on" : "OFF"} (recall budget=${cfg.recallTokenBudget})`);
console.log(` auto-capture: ${cfg.autoCapture ? "on" : "OFF"}`);
if (cfg.bypassSession) console.log(` ⚠ session bypass: GLOBAL ON`);
if (cfg.bypassSessionPatterns?.length) {
console.log(` bypass patterns: ${cfg.bypassSessionPatterns.join(", ")}`);
}
console.log("");
// 5. Auth source — which file/env actually drove each value, mirroring
// config.mjs's priority chain (env → ovcli.conf → ov.conf → default).
// Computed rather than file-listed so we never advertise a source that
// isn't actually in play.
const cliConfPath = expandHome(process.env.OPENVIKING_CLI_CONFIG_FILE
|| join(homedir(), ".openviking", "ovcli.conf"));
const ovConfPath = expandHome(process.env.OPENVIKING_CONFIG_FILE
|| join(homedir(), ".openviking", "ov.conf"));
const cliConf = tryReadJson(cliConfPath);
const ovConf = tryReadJson(ovConfPath);
const cliShort = homeShort(cliConfPath);
const ovShort = homeShort(ovConfPath);
const urlSrc = (process.env.OPENVIKING_URL || process.env.OPENVIKING_BASE_URL) ? "env"
: (cliConf?.url) ? cliShort
: (ovConf?.server?.url) ? ovShort
: "default";
// Taken from loadConfig() so this line and the MCP proxy always name the
// same file.
const keySrc = cfg.apiKeySource === "env" ? "env"
: cfg.credentialPath ? homeShort(cfg.credentialPath)
: "(none)";
console.log(`Auth: url from ${urlSrc}, api_key from ${keySrc}`);
}
main().catch((err) => {
console.error("ov-status failed:", err?.message || err);
process.exit(1);
});