mindkeeper-openclaw 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+import type { Vault } from "mindkeeper";
+export declare function registerVaultCli(api: {
+    registerCli?(registrar: (program: unknown) => void): void;
+}, vault: Vault): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE;IAAE,WAAW,CAAC,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;CAAE,EAClE,KAAK,EAAE,KAAK,GACX,IAAI,CAyCN"}

package/dist/cli.js

@@ -0,0 +1,37 @@
+export function registerVaultCli(api, vault) {
+    if (!api.registerCli)
+        return;
+    api.registerCli((program) => {
+        const cmd = program;
+        const vaultCmd = cmd.command("mind");
+        addSubcommand(vaultCmd, "status", "Show vault status", async () => {
+            const status = await vault.status();
+            console.log(`Workspace: ${status.workDir}`);
+            console.log(`Pending changes: ${status.pendingChanges.length}`);
+            console.log(`Named snapshots: ${status.snapshots.length}`);
+        });
+        addSubcommand(vaultCmd, "history [file]", "View change history", async (...args) => {
+            const file = args[0];
+            const commits = await vault.history({ file, limit: 20 });
+            if (commits.length === 0) {
+                console.log("No history found.");
+                return;
+            }
+            for (const c of commits) {
+                const date = c.date.toISOString().replace("T", " ").slice(0, 19);
+                console.log(`${c.oid.slice(0, 8)}  ${date}  ${c.message}`);
+            }
+        });
+        addSubcommand(vaultCmd, "snapshot [name]", "Create a named snapshot", async (...args) => {
+            const name = args[0];
+            const commit = await vault.snapshot({ name });
+            console.log(`Snapshot created: ${commit.oid.slice(0, 8)} ${commit.message}`);
+            if (name)
+                console.log(`Tagged as: ${name}`);
+        });
+    });
+}
+function addSubcommand(parent, name, description, handler) {
+    parent.command(name).description(description).action(handler);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,GAAkE,EAClE,KAAY;IAEZ,IAAI,CAAC,GAAG,CAAC,WAAW;QAAE,OAAO;IAE7B,GAAG,CAAC,WAAW,CAAC,CAAC,OAAgB,EAAE,EAAE;QACnC,MAAM,GAAG,GAAG,OAEX,CAAC;QAEF,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrC,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,QAAQ,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;YAC5F,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAuB,CAAC;YAC3C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBACjC,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,aAAa,CACX,QAAQ,EACR,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAuB,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7E,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAQD,SAAS,aAAa,CACpB,MAAsB,EACtB,IAAY,EACZ,WAAmB,EACnB,OAA8C;IAE9C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * OpenClaw Plugin entry point.
+ * Called by OpenClaw's plugin loader with the Plugin API.
+ */
+export default function mindkeeperPlugin(api: OpenClawPluginApi): Promise<void>;
+/**
+ * Minimal type definition for OpenClaw Plugin API.
+ * Only the methods mindkeeper uses are declared here.
+ * In a real build, this would import from openclaw/plugin-sdk.
+ */
+interface OpenClawPluginApi {
+    config?: unknown;
+    pluginConfig?: Record<string, unknown>;
+    getWorkspaceDir?(): string;
+    registerTool?(tool: PluginTool, opts?: Record<string, unknown>): void;
+    registerCli?(registrar: (program: unknown) => void): void;
+    registerService?(service: PluginService): void;
+    registerHook?(events: string[], handler: (...args: unknown[]) => void): void;
+    log?: {
+        info?(...args: unknown[]): void;
+        warn?(...args: unknown[]): void;
+        error?(...args: unknown[]): void;
+    };
+}
+interface PluginTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    handler(args: Record<string, unknown>): Promise<unknown>;
+}
+interface PluginService {
+    name: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export {};
+//# 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":"AAMA;;;GAGG;AACH,wBAA8B,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,iBAyBpE;AAED;;;;GAIG;AACH,UAAU,iBAAiB;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,eAAe,CAAC,IAAI,MAAM,CAAC;IAC3B,YAAY,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtE,WAAW,CAAC,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1D,eAAe,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/C,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7E,GAAG,CAAC,EAAE;QACJ,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;KAClC,CAAC;CACH;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/index.js

@@ -0,0 +1,31 @@
+import { Vault } from "mindkeeper";
+import { registerVaultTools } from "./tools.js";
+import { registerVaultCli } from "./cli.js";
+import { createWatcherService } from "./service.js";
+import { createOpenClawLlmProvider } from "./llm-provider.js";
+/**
+ * OpenClaw Plugin entry point.
+ * Called by OpenClaw's plugin loader with the Plugin API.
+ */
+export default async function mindkeeperPlugin(api) {
+    const workspaceDir = api.getWorkspaceDir?.() ?? process.env.OPENCLAW_WORKSPACE;
+    if (!workspaceDir) {
+        api.log?.warn?.("[mindkeeper] No workspace directory found. Plugin disabled.");
+        return;
+    }
+    const llmProvider = await createOpenClawLlmProvider({
+        config: api.config,
+        pluginConfig: api.pluginConfig,
+        log: api.log,
+    });
+    const vault = new Vault({
+        workDir: workspaceDir,
+        llmProvider: llmProvider ?? undefined,
+    });
+    registerVaultTools(api, vault);
+    registerVaultCli(api, vault);
+    const watcherService = createWatcherService(vault, api);
+    api.registerService?.(watcherService);
+    api.log?.info?.("[mindkeeper] Plugin loaded.");
+}
+//# 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,OAAO,EAAE,KAAK,EAAgB,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAsB;IACnE,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC/E,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,6DAA6D,CAAC,CAAC;QAC/E,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,yBAAyB,CAAC;QAClD,MAAM,EAAE,GAAG,CAAC,MAA6C;QACzD,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,GAAG,EAAE,GAAG,CAAC,GAAG;KACb,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,WAAW,IAAI,SAAS;KACtC,CAAC,CAAC;IAEH,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE7B,MAAM,cAAc,GAAG,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxD,GAAG,CAAC,eAAe,EAAE,CAAC,cAAc,CAAC,CAAC;IAEtC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,6BAA6B,CAAC,CAAC;AACjD,CAAC"}

package/dist/llm-provider.d.ts

@@ -0,0 +1,13 @@
+import type { LlmProvider } from "mindkeeper";
+interface PluginApi {
+    config?: Record<string, unknown>;
+    pluginConfig?: Record<string, unknown>;
+    log?: {
+        info?(...args: unknown[]): void;
+        warn?(...args: unknown[]): void;
+        error?(...args: unknown[]): void;
+    };
+}
+export declare function createOpenClawLlmProvider(api: PluginApi): Promise<LlmProvider | null>;
+export {};
+//# sourceMappingURL=llm-provider.d.ts.map

package/dist/llm-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../src/llm-provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AA8B1D,UAAU,SAAS;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,GAAG,CAAC,EAAE;QACJ,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;KAClC,CAAC;CACH;AAMD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,SAAS,GACb,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA6C7B"}

package/dist/llm-provider.js

@@ -0,0 +1,286 @@
+import fsPromises from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+const SYSTEM_PROMPT = "You are a version control assistant for AI agent configuration files " +
+    "(personality, rules, memory, skills). Given the diffs, write a single-line " +
+    "commit message (max 72 chars). Describe WHAT changed semantically, not " +
+    "technically. No quotes, no conventional-commit prefix. Return ONLY the message.";
+const LLM_TIMEOUT_MS = 15_000;
+const MAX_DIFF_CHARS = 4_000;
+const MAX_TOKENS = 100;
+// --------------------------------------------------------------------------
+// Public entry
+// --------------------------------------------------------------------------
+export async function createOpenClawLlmProvider(api) {
+    const modelSpec = resolveModelFromConfig(api.config);
+    if (!modelSpec) {
+        api.log?.warn?.("[mindkeeper] No default model configured in OpenClaw — LLM commit messages disabled.");
+        return null;
+    }
+    // OAuth-based providers don't carry an extractable API key
+    if (isOAuthProvider(modelSpec.provider)) {
+        api.log?.warn?.(`[mindkeeper] Provider "${modelSpec.provider}" uses OAuth — LLM commit messages not supported, falling back to template.`);
+        return null;
+    }
+    const apiKey = await resolveApiKey(modelSpec.provider);
+    if (!apiKey) {
+        api.log?.warn?.(`[mindkeeper] No API key found for provider "${modelSpec.provider}" — LLM commit messages disabled.`);
+        return null;
+    }
+    api.log?.info?.(`[mindkeeper] LLM commit messages enabled (${modelSpec.provider}/${modelSpec.model}).`);
+    return {
+        async generateCommitMessage(diffs) {
+            const diffText = diffs
+                .map((d) => `--- ${d.file} ---\n${d.unified}`)
+                .join("\n")
+                .slice(0, MAX_DIFF_CHARS);
+            return callLlm({
+                provider: modelSpec.provider,
+                model: modelSpec.model,
+                apiKey,
+                userPrompt: diffText,
+                baseUrl: modelSpec.baseUrl,
+            });
+        },
+    };
+}
+function isOAuthProvider(provider) {
+    const normalized = normalizeProvider(provider);
+    return normalized.includes("portal") || normalized.includes("oauth");
+}
+// --------------------------------------------------------------------------
+// Model resolution
+// --------------------------------------------------------------------------
+function resolveModelFromConfig(config) {
+    const agents = config?.agents;
+    const defaults = agents?.defaults;
+    const raw = defaults?.model;
+    let spec;
+    if (typeof raw === "string") {
+        spec = raw.trim();
+    }
+    else if (raw && typeof raw === "object") {
+        const primary = raw.primary;
+        if (typeof primary === "string")
+            spec = primary.trim();
+    }
+    if (!spec?.includes("/"))
+        return null;
+    const slashIdx = spec.indexOf("/");
+    const provider = spec.slice(0, slashIdx);
+    const model = spec.slice(slashIdx + 1);
+    // Read baseUrl from models.providers[provider] if configured by the user
+    const providers = config?.models
+        ?.providers;
+    const providerCfg = providers?.[provider];
+    const baseUrl = typeof providerCfg?.baseUrl === "string" ? providerCfg.baseUrl.trim() : undefined;
+    return { provider, model, baseUrl };
+}
+// --------------------------------------------------------------------------
+// API key resolution (3-tier)
+// --------------------------------------------------------------------------
+async function resolveApiKey(provider) {
+    // Tier 1 & 2: auth-profiles.json (key field + keyRef env resolution)
+    const profileKey = await readAuthProfileKey(provider);
+    if (profileKey)
+        return profileKey;
+    // Tier 3: environment variables
+    return readEnvApiKey(provider);
+}
+async function readAuthProfileKey(provider) {
+    const candidates = buildAuthProfilePaths();
+    for (const filepath of candidates) {
+        try {
+            const content = await fsPromises.readFile(filepath, "utf-8");
+            const store = JSON.parse(content);
+            if (!store.profiles || typeof store.profiles !== "object")
+                continue;
+            const normalized = normalizeProvider(provider);
+            for (const credential of Object.values(store.profiles)) {
+                if (normalizeProvider(credential.provider) !== normalized)
+                    continue;
+                // Tier 1: plain-text key in file
+                if (credential.type === "api_key" && credential.key) {
+                    return credential.key;
+                }
+                if (credential.type === "token" && credential.token) {
+                    return credential.token;
+                }
+                // Tier 2: keyRef / tokenRef with source=env
+                const ref = credential.keyRef ?? credential.tokenRef;
+                if (ref?.source === "env" && ref.key) {
+                    const envVal = process.env[ref.key];
+                    if (envVal)
+                        return envVal;
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+function buildAuthProfilePaths() {
+    const home = os.homedir();
+    const paths = [];
+    const envHome = process.env.OPENCLAW_HOME;
+    if (envHome) {
+        paths.push(path.join(envHome, "auth-profiles.json"));
+    }
+    paths.push(path.join(home, ".openclaw", "auth-profiles.json"), path.join(home, ".config", "openclaw", "auth-profiles.json"));
+    return paths;
+}
+function readEnvApiKey(provider) {
+    const normalized = normalizeProvider(provider);
+    const map = {
+        // International
+        anthropic: ["ANTHROPIC_API_KEY"],
+        openai: ["OPENAI_API_KEY"],
+        openaicodex: ["OPENAI_API_KEY"],
+        openrouter: ["OPENROUTER_API_KEY"],
+        google: ["GEMINI_API_KEY", "GOOGLE_API_KEY", "GOOGLE_GENERATIVE_AI_API_KEY"],
+        groq: ["GROQ_API_KEY"],
+        mistral: ["MISTRAL_API_KEY"],
+        deepseek: ["DEEPSEEK_API_KEY"],
+        xai: ["XAI_API_KEY"],
+        together: ["TOGETHER_API_KEY"],
+        venice: ["VENICE_API_KEY"],
+        // Chinese providers
+        moonshot: ["MOONSHOT_API_KEY"], // Kimi (international)
+        moonshotcn: ["MOONSHOT_API_KEY"], // Kimi (CN endpoint)
+        minimax: ["MINIMAX_API_KEY"],
+        minimaxcn: ["MINIMAX_API_KEY"],
+        zai: ["ZAI_API_KEY", "Z_AI_API_KEY"], // Zhipu ZAI
+        qianfan: ["QIANFAN_API_KEY"], // Baidu Qianfan
+        volcengine: ["VOLCANO_ENGINE_API_KEY"], // ByteDance Volcano (Doubao)
+        byteplus: ["BYTEPLUS_API_KEY"],
+        dashscope: ["DASHSCOPE_API_KEY"], // Alibaba DashScope (Qwen API)
+        xiaomi: ["XIAOMI_API_KEY"],
+        kilocode: ["KILOCODE_API_KEY"],
+        litellm: ["LITELLM_API_KEY"],
+    };
+    const envKeys = map[normalized] ??
+        [`${provider.toUpperCase().replace(/-/g, "_")}_API_KEY`];
+    for (const envKey of envKeys) {
+        const val = process.env[envKey];
+        if (val)
+            return val;
+    }
+    return null;
+}
+function normalizeProvider(provider) {
+    return provider.toLowerCase().replace(/-/g, "").replace(/_/g, "");
+}
+// --------------------------------------------------------------------------
+// LLM HTTP calls
+// --------------------------------------------------------------------------
+async function callLlm(params) {
+    const normalized = normalizeProvider(params.provider);
+    if (normalized === "anthropic") {
+        return callAnthropic(params);
+    }
+    if (normalized === "google") {
+        return callGoogle(params);
+    }
+    // Default: OpenAI-compatible (covers all Chinese providers)
+    return callOpenAiCompatible(params);
+}
+async function callAnthropic(params) {
+    const res = await fetch("https://api.anthropic.com/v1/messages", {
+        method: "POST",
+        headers: {
+            "x-api-key": params.apiKey,
+            "content-type": "application/json",
+            "anthropic-version": "2023-06-01",
+        },
+        body: JSON.stringify({
+            model: params.model,
+            max_tokens: MAX_TOKENS,
+            system: SYSTEM_PROMPT,
+            messages: [{ role: "user", content: params.userPrompt }],
+        }),
+        signal: AbortSignal.timeout(LLM_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        throw new Error(`Anthropic API ${res.status}: ${await res.text().catch(() => "")}`);
+    }
+    const data = (await res.json());
+    return data.content?.[0]?.text?.trim() ?? "";
+}
+async function callOpenAiCompatible(params) {
+    const baseUrl = resolveOpenAiBaseUrl(params.provider, params.baseUrl);
+    const res = await fetch(`${baseUrl}/chat/completions`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${params.apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            model: params.model,
+            max_tokens: MAX_TOKENS,
+            messages: [
+                { role: "system", content: SYSTEM_PROMPT },
+                { role: "user", content: params.userPrompt },
+            ],
+        }),
+        signal: AbortSignal.timeout(LLM_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        throw new Error(`OpenAI-compatible API ${res.status}: ${await res.text().catch(() => "")}`);
+    }
+    const data = (await res.json());
+    return data.choices?.[0]?.message?.content?.trim() ?? "";
+}
+async function callGoogle(params) {
+    const url = `https://generativelanguage.googleapis.com/v1beta/models/${params.model}:generateContent?key=${params.apiKey}`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            system_instruction: { parts: [{ text: SYSTEM_PROMPT }] },
+            contents: [{ parts: [{ text: params.userPrompt }] }],
+            generationConfig: { maxOutputTokens: MAX_TOKENS },
+        }),
+        signal: AbortSignal.timeout(LLM_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        throw new Error(`Google AI API ${res.status}: ${await res.text().catch(() => "")}`);
+    }
+    const data = (await res.json());
+    return data.candidates?.[0]?.content?.parts?.[0]?.text?.trim() ?? "";
+}
+function resolveOpenAiBaseUrl(provider, configuredBaseUrl) {
+    // Highest priority: baseUrl explicitly set in OpenClaw's models.providers config
+    if (configuredBaseUrl)
+        return configuredBaseUrl.replace(/\/$/, "");
+    const normalized = normalizeProvider(provider);
+    const map = {
+        // International
+        openai: "https://api.openai.com/v1",
+        openaicodex: "https://api.openai.com/v1",
+        openrouter: "https://openrouter.ai/api/v1",
+        groq: "https://api.groq.com/openai/v1",
+        mistral: "https://api.mistral.ai/v1",
+        deepseek: "https://api.deepseek.com/v1",
+        xai: "https://api.x.ai/v1",
+        together: "https://api.together.xyz/v1",
+        venice: "https://api.venice.ai/api/v1",
+        kilocode: "https://api.kilo.ai/api/gateway",
+        litellm: "http://127.0.0.1:4000", // self-hosted default
+        // Chinese providers
+        moonshot: "https://api.moonshot.ai/v1", // Kimi (international)
+        moonshotcn: "https://api.moonshot.cn/v1", // Kimi (CN)
+        minimax: "https://api.minimax.io/v1", // MiniMax (international)
+        minimaxcn: "https://api.minimaxi.com/v1", // MiniMax (CN)
+        zai: "https://api.z.ai/v1", // Zhipu ZAI (international)
+        zaicn: "https://open.bigmodel.cn/api/paas/v4", // Zhipu (CN)
+        qianfan: "https://qianfan.baidubce.com/v2", // Baidu Qianfan
+        volcengine: "https://ark.cn-beijing.volces.com/api/v3", // Volcano (Doubao)
+        byteplus: "https://api.byteplus.com/v1",
+        dashscope: "https://dashscope.aliyuncs.com/compatible-mode/v1", // Alibaba DashScope
+        xiaomi: "https://api.xiaomi.com/v1",
+    };
+    return map[normalized] ?? `https://api.${provider}.com/v1`;
+}
+//# sourceMappingURL=llm-provider.js.map

package/dist/llm-provider.js.map

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

package/dist/service.d.ts

@@ -0,0 +1,16 @@
+import { Vault } from "mindkeeper";
+interface PluginService {
+    name: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+interface PluginApi {
+    log?: {
+        info?(...args: unknown[]): void;
+        warn?(...args: unknown[]): void;
+        error?(...args: unknown[]): void;
+    };
+}
+export declare function createWatcherService(vault: Vault, api: PluginApi): PluginService;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgB,MAAM,YAAY,CAAC;AAEjD,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,UAAU,SAAS;IACjB,GAAG,CAAC,EAAE;QACJ,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;KAClC,CAAC;CACH;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,aAAa,CAmChF"}

package/dist/service.js

@@ -0,0 +1,29 @@
+import { VaultWatcher } from "mindkeeper";
+export function createWatcherService(vault, api) {
+    let watcher = null;
+    return {
+        name: "mindkeeper-watcher",
+        async start() {
+            await vault.init();
+            watcher = new VaultWatcher({
+                vault,
+                onSnapshot: (commit) => {
+                    api.log?.info?.(`[mindkeeper] Auto-snapshot ${commit.oid.slice(0, 8)}: ${commit.message}`);
+                },
+                onError: (err) => {
+                    api.log?.error?.(`[mindkeeper] Watcher error: ${err.message}`);
+                },
+            });
+            await watcher.start();
+            api.log?.info?.(`[mindkeeper] Watching ${vault.workDir} (debounce: ${vault.getConfig().snapshot.debounceMs}ms)`);
+        },
+        async stop() {
+            if (watcher) {
+                await watcher.stop();
+                watcher = null;
+                api.log?.info?.("[mindkeeper] Watcher stopped.");
+            }
+        },
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,YAAY,EAAE,MAAM,YAAY,CAAC;AAgBjD,MAAM,UAAU,oBAAoB,CAAC,KAAY,EAAE,GAAc;IAC/D,IAAI,OAAO,GAAwB,IAAI,CAAC;IAExC,OAAO;QACL,IAAI,EAAE,oBAAoB;QAE1B,KAAK,CAAC,KAAK;YACT,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YAEnB,OAAO,GAAG,IAAI,YAAY,CAAC;gBACzB,KAAK;gBACL,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;oBACrB,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CACb,8BAA8B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAC1E,CAAC;gBACJ,CAAC;gBACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;oBACf,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,+BAA+B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjE,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CACb,yBAAyB,KAAK,CAAC,OAAO,eAAe,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,UAAU,KAAK,CAChG,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI;YACR,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrB,OAAO,GAAG,IAAI,CAAC;gBACf,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,13 @@
+import type { Vault } from "mindkeeper";
+type RegisterTool = (tool: PluginTool, opts?: Record<string, unknown>) => void;
+interface PluginTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    handler(args: Record<string, unknown>): Promise<unknown>;
+}
+export declare function registerVaultTools(api: {
+    registerTool?: RegisterTool;
+}, vault: Vault): void;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAuC,MAAM,YAAY,CAAC;AAE7E,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAE/E,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE;IAAE,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,EACpC,KAAK,EAAE,KAAK,GACX,IAAI,CAmIN"}

package/dist/tools.js

@@ -0,0 +1,156 @@
+export function registerVaultTools(api, vault) {
+    if (!api.registerTool)
+        return;
+    api.registerTool({
+        name: "mind_history",
+        description: "View version history of agent context files. " +
+            "Optionally filter by a specific file. Returns commit hashes, dates, and messages.",
+        parameters: {
+            type: "object",
+            properties: {
+                file: {
+                    type: "string",
+                    description: "File path to filter history (e.g. 'SOUL.md'). Omit for all files.",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of entries to return (default: 10).",
+                },
+            },
+        },
+        handler: async (args) => {
+            const commits = await vault.history({
+                file: args.file,
+                limit: args.limit ?? 10,
+            });
+            return formatHistoryResult(commits);
+        },
+    });
+    api.registerTool({
+        name: "mind_diff",
+        description: "Compare two versions of an agent context file. " +
+            "Shows additions, deletions, and a unified diff.",
+        parameters: {
+            type: "object",
+            properties: {
+                file: { type: "string", description: "File path to compare (e.g. 'SOUL.md')." },
+                from: { type: "string", description: "Source commit hash." },
+                to: { type: "string", description: "Target commit hash (defaults to HEAD)." },
+            },
+            required: ["file", "from"],
+        },
+        handler: async (args) => {
+            const result = await vault.diff({
+                file: args.file,
+                from: args.from,
+                to: args.to,
+            });
+            return formatDiffResult(result);
+        },
+    });
+    api.registerTool({
+        name: "mind_rollback",
+        description: "Rollback an agent context file to a previous version. " +
+            "First call with preview=true to see the diff, then call again without preview to execute.",
+        parameters: {
+            type: "object",
+            properties: {
+                file: { type: "string", description: "File path to rollback (e.g. 'SOUL.md')." },
+                to: { type: "string", description: "Commit hash to rollback to." },
+                preview: {
+                    type: "boolean",
+                    description: "If true, show diff preview without executing rollback. Default: true.",
+                },
+            },
+            required: ["file", "to"],
+        },
+        handler: async (args) => {
+            const file = args.file;
+            const to = args.to;
+            const preview = args.preview ?? true;
+            if (preview) {
+                const diff = await vault.diff({ file, from: to, to: "HEAD" });
+                return {
+                    preview: true,
+                    diff: formatDiffResult(diff),
+                    instruction: "Show this diff to the user. If they confirm, call mind_rollback again with preview=false.",
+                };
+            }
+            const commit = await vault.rollback({ file, to });
+            return {
+                preview: false,
+                success: true,
+                commit: { oid: commit.oid.slice(0, 8), message: commit.message },
+                note: "Tell the user to run /new to apply the changes to the current session.",
+            };
+        },
+    });
+    api.registerTool({
+        name: "mind_snapshot",
+        description: "Create a named checkpoint of the current state of all agent context files. " +
+            "Useful before making significant changes.",
+        parameters: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Snapshot name (e.g. 'personality-v2')." },
+                message: { type: "string", description: "Optional description of this snapshot." },
+            },
+            required: ["name"],
+        },
+        handler: async (args) => {
+            const commit = await vault.snapshot({
+                name: args.name,
+                message: args.message,
+            });
+            return {
+                success: true,
+                snapshot: args.name,
+                commit: { oid: commit.oid.slice(0, 8), message: commit.message },
+            };
+        },
+    });
+    api.registerTool({
+        name: "mind_status",
+        description: "Show the current status of the context vault: tracked files, pending changes, and named snapshots.",
+        parameters: { type: "object", properties: {} },
+        handler: async () => {
+            const status = await vault.status();
+            return formatStatusResult(status);
+        },
+    });
+}
+function formatHistoryResult(commits) {
+    return {
+        count: commits.length,
+        entries: commits.map((c) => ({
+            oid: c.oid.slice(0, 8),
+            date: c.date.toISOString().replace("T", " ").slice(0, 19),
+            message: c.message,
+        })),
+    };
+}
+function formatDiffResult(result) {
+    return {
+        file: result.file,
+        from: result.fromVersion,
+        to: result.toVersion,
+        additions: result.additions,
+        deletions: result.deletions,
+        unified: result.unified,
+    };
+}
+function formatStatusResult(status) {
+    return {
+        initialized: status.initialized,
+        workDir: status.workDir,
+        pendingChanges: status.pendingChanges.map((e) => ({
+            file: e.filepath,
+            status: e.status,
+        })),
+        snapshots: status.snapshots.map((s) => ({
+            name: s.name,
+            oid: s.oid.slice(0, 8),
+        })),
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,72 @@
+{
+  "id": "mindkeeper",
+  "name": "Mindkeeper",
+  "description": "Time machine for your AI's brain. Auto-snapshots every change to agent context files (AGENTS.md, SOUL.md, MEMORY.md, skills, etc.) with full history, visual diffs, and one-command rollback.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "tracking": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "include": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Glob patterns for files to track"
+          },
+          "exclude": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Glob patterns for files to exclude"
+          }
+        }
+      },
+      "snapshot": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "debounceMs": {
+            "type": "number",
+            "description": "Debounce interval for auto-snapshots (ms)",
+            "default": 30000
+          }
+        }
+      },
+      "commitMessage": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "mode": {
+            "type": "string",
+            "enum": ["template", "llm"],
+            "default": "template",
+            "description": "How to generate commit messages: 'template' (fast, no API call) or 'llm' (uses your configured model)"
+          }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "tracking.include": {
+      "label": "Tracked file patterns",
+      "placeholder": "AGENTS.md, memory/**/*.md, skills/**/*.md"
+    },
+    "tracking.exclude": {
+      "label": "Excluded file patterns",
+      "placeholder": "BOOTSTRAP.md, canvas/**"
+    },
+    "snapshot.debounceMs": {
+      "label": "Auto-snapshot interval (ms)",
+      "placeholder": "30000"
+    },
+    "commitMessage.mode": {
+      "label": "Commit message mode"
+    }
+  },
+  "install": {
+    "npmSpec": "mindkeeper-openclaw",
+    "defaultChoice": "npm"
+  },
+  "skills": ["skills"]
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "mindkeeper-openclaw",
+  "version": "0.1.0",
+  "description": "OpenClaw plugin for mindkeeper: auto-snapshot, diff, and rollback for agent context files",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "mindkeeper",
+    "agent",
+    "version-control",
+    "snapshot",
+    "rollback"
+  ],
+  "homepage": "https://github.com/seekcontext/mindkeeper#readme",
+  "bugs": {
+    "url": "https://github.com/seekcontext/mindkeeper/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/seekcontext/mindkeeper.git",
+    "directory": "packages/openclaw"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "skills",
+    "openclaw.plugin.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run clean && pnpm run build"
+  },
+  "openclaw": {
+    "extensions": ["./dist/index.js"]
+  },
+  "dependencies": {
+    "mindkeeper": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/mindkeeper/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: mindkeeper
+description: Version control for agent context files — view history, compare versions, and rollback changes
+version: 1.0.0
+metadata:
+  openclaw:
+    requires:
+      config: ["workspace.dir"]
+---
+
+# Mindkeeper — Version Control for Agent Context
+
+Use the vault tools when the user asks about changes, history, or versions of their agent context files (AGENTS.md, SOUL.md, USER.md, IDENTITY.md, TOOLS.md, MEMORY.md, memory/, skills/).
+
+## Available Tools
+
+- **mind_history** — View change history of context files
+- **mind_diff** — Compare two versions of a file
+- **mind_rollback** — Restore a file to a previous version (always preview first)
+- **mind_snapshot** — Create a named checkpoint before major changes
+- **mind_status** — Show current tracking status
+
+## When to Use
+
+Use these tools when the user:
+- Asks what changed in their agent configuration ("what changed in SOUL.md?")
+- Wants to compare versions ("show me the diff from last week")
+- Wants to undo a change ("rollback AGENTS.md to yesterday")
+- Wants to save a checkpoint ("save a snapshot called stable-v1")
+- Asks about the state of their agent context files
+
+## Rollback Procedure
+
+Always follow this sequence for rollbacks:
+1. Call `mind_history` to find the target version
+2. Call `mind_rollback` with `preview=true` to show the user what will change
+3. Only after user confirms, call `mind_rollback` with `preview=false`
+4. After successful rollback, tell the user to run `/new` to apply changes
+
+## Important Notes
+
+- Rollback only affects the specified file, not all files
+- Every rollback is recorded as a new commit (can be undone)
+- Auto-snapshots happen in the background; the user does not need to manually save
+- Named snapshots (via mind_snapshot) are useful before significant personality or rule changes