@alexandrgreen/anchorclaw 0.0.3

package/dist/migrations.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it, vi } from "vitest";
+import { applyMigrations } from "./migrations.js";
+describe("applyMigrations", () => {
+    it("runs each migration inside a dedicated client transaction", async () => {
+        const clientCalls = [];
+        const client = {
+            query: vi.fn(async (sql, args = []) => {
+                clientCalls.push({ sql, args });
+                return { rows: [] };
+            }),
+            release: vi.fn(),
+        };
+        const poolQuery = vi.fn(async (sql) => {
+            if (sql.includes("SELECT id, applied_at FROM schema_migrations")) {
+                return { rows: [] };
+            }
+            return { rows: [] };
+        });
+        const pool = {
+            query: poolQuery,
+            connect: vi.fn(async () => client),
+        };
+        const got = await applyMigrations({
+            pool,
+            migrations: [{ filename: "0001_init.sql", sql: "CREATE TABLE demo(id int);" }],
+        });
+        expect(got).toEqual({ applied: ["0001"] });
+        expect(pool.connect).toHaveBeenCalledTimes(1);
+        expect(clientCalls.map((call) => call.sql)).toEqual([
+            "BEGIN",
+            "CREATE TABLE demo(id int);",
+            "INSERT INTO schema_migrations (id) VALUES ($1)",
+            "COMMIT",
+        ]);
+        expect(client.release).toHaveBeenCalledTimes(1);
+    });
+    it("rolls back and releases the client when a migration query fails", async () => {
+        const clientCalls = [];
+        const client = {
+            query: vi.fn(async (sql) => {
+                clientCalls.push(sql);
+                if (sql === "BROKEN SQL") {
+                    throw new Error("boom");
+                }
+                return { rows: [] };
+            }),
+            release: vi.fn(),
+        };
+        const pool = {
+            query: vi.fn(async (sql) => {
+                if (sql.includes("SELECT id, applied_at FROM schema_migrations")) {
+                    return { rows: [] };
+                }
+                return { rows: [] };
+            }),
+            connect: vi.fn(async () => client),
+        };
+        await expect(applyMigrations({
+            pool,
+            migrations: [{ filename: "0001_init.sql", sql: "BROKEN SQL" }],
+        })).rejects.toThrow("boom");
+        expect(clientCalls).toEqual(["BEGIN", "BROKEN SQL", "ROLLBACK"]);
+        expect(client.release).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=migrations.test.js.map

package/dist/migrations.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.test.js","sourceRoot":"","sources":["../src/migrations.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,WAAW,GAA4C,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,OAAkB,EAAE,EAAE,EAAE;gBACvD,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;YACtB,CAAC,CAAC;YACF,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;SACjB,CAAC;QACF,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;YAC5C,IAAI,GAAG,CAAC,QAAQ,CAAC,8CAA8C,CAAC,EAAE,CAAC;gBACjE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;YACtB,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC;SAC5B,CAAC;QAET,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC;YAChC,IAAI;YACJ,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,4BAA4B,EAAE,CAAC;SAC/E,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YAClD,OAAO;YACP,4BAA4B;YAC5B,gDAAgD;YAChD,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;gBACjC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACtB,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;oBACzB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC1B,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;YACtB,CAAC,CAAC;YACF,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;SACjB,CAAC;QACF,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;gBACjC,IAAI,GAAG,CAAC,QAAQ,CAAC,8CAA8C,CAAC,EAAE,CAAC;oBACjE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;gBACtB,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;YACtB,CAAC,CAAC;YACF,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC;SAC5B,CAAC;QAET,MAAM,MAAM,CACV,eAAe,CAAC;YACd,IAAI;YACJ,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;SAC/D,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE1B,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/plugin/capability.d.ts

@@ -0,0 +1,7 @@
+import type { PluginRuntimeContext } from "./runtime-context.js";
+export declare function registerAnchorClawMemoryCapability(params: {
+    ctx: PluginRuntimeContext;
+    refreshPromptCache: () => void;
+    ensureSessionsIndexBootstrapped: () => Promise<void>;
+}): void;
+//# sourceMappingURL=capability.d.ts.map

package/dist/plugin/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/plugin/capability.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,wBAAgB,kCAAkC,CAAC,MAAM,EAAE;IACzD,GAAG,EAAE,oBAAoB,CAAC;IAC1B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,+BAA+B,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD,QA6FA"}

package/dist/plugin/capability.js

@@ -0,0 +1,92 @@
+import { registerMemoryCapability } from "../api.js";
+import { createAnchorClawMemorySearchManager, } from "../memory/manager.js";
+export function registerAnchorClawMemoryCapability(params) {
+    const { ctx, refreshPromptCache, ensureSessionsIndexBootstrapped } = params;
+    const api = ctx.api;
+    registerMemoryCapability("anchorclaw", {
+        promptBuilder: (params) => {
+            if (ctx.disabledReason) {
+                return [`AnchorClaw memory is disabled until configured (${ctx.disabledReason}).`];
+            }
+            if (!ctx.promptCache.lines && !ctx.promptCache.error) {
+                refreshPromptCache();
+            }
+            const cached = ctx.promptCache.lines ?? [];
+            const cacheNotice = ctx.promptCache.error
+                ? [`[AnchorClaw durable memory cache unavailable: ${ctx.promptCache.error}]`, ""]
+                : cached.length === 0
+                    ? ["[AnchorClaw durable memory cache is warming up...]", ""]
+                    : [];
+            const sdkNotice = ctx.sdkHealth.degraded
+                ? [
+                    `[AnchorClaw sessions SDK is degraded: ${ctx.sdkHealth.reason ?? "unknown error"}; operation=${ctx.sdkHealth.affectedOperation ?? "unknown"}]`,
+                    "",
+                ]
+                : [];
+            const hasMemorySearch = Boolean(params?.availableTools?.has?.("memory_search"));
+            const hasMemoryGet = Boolean(params?.availableTools?.has?.("memory_get"));
+            let toolGuidance = "";
+            if (hasMemorySearch && hasMemoryGet) {
+                toolGuidance =
+                    "Before answering anything about prior work, decisions, dates, people, preferences, or todos: run memory_search; then use memory_get to pull only the needed lines. For one exact marker/id/key value questions, prioritize literal evidence from memory_search/memory_recall. If any memory_search or memory_recall result has details.meta.exactTop1=true, return details.meta.exactTop1Value verbatim immediately; do not substitute nearby/recent markers. Never use empty memory_recall as a tie-breaker for exact lookups. If no exactTop1 is found, say you checked and give the best candidate with uncertainty. For broad agreement/policy/decision questions, use memory_search/memory_recall to gather closest evidence; if no direct agreement record is found, report not found with a brief summary of closest evidence.";
+            }
+            else if (hasMemorySearch) {
+                toolGuidance =
+                    "Before answering anything about prior work, decisions, dates, people, preferences, or todos: run memory_search and answer from matching results. For one exact marker/id/key value questions, prioritize literal evidence from memory_search/memory_recall. If any memory_search or memory_recall result has details.meta.exactTop1=true, return details.meta.exactTop1Value verbatim immediately; do not substitute nearby/recent markers. Never use empty memory_recall as a tie-breaker for exact lookups. If no exactTop1 is found, say you checked and give the best candidate with uncertainty. For broad agreement/policy/decision questions, use memory_search/memory_recall to gather closest evidence; if no direct agreement record is found, report not found with a brief summary of closest evidence.";
+            }
+            else if (hasMemoryGet) {
+                toolGuidance =
+                    "Before answering anything about prior work, decisions, dates, people, preferences, or todos that already point to a specific memory item: run memory_get to pull only the needed lines. If low confidence after reading them, say you checked.";
+            }
+            const citationsMode = params?.citationsMode ?? "inline";
+            const citationsLine = citationsMode === "off"
+                ? "Citations are disabled: do not mention file paths or line numbers in replies unless the user explicitly asks."
+                : "Citations: include Source: <path#line> when it helps the user verify memory snippets.";
+            return [
+                "AnchorClaw durable memory is enabled (Postgres-backed).",
+                "",
+                ...(toolGuidance ? ["## Memory Recall", toolGuidance, citationsLine, ""] : []),
+                "MVP usage rules:",
+                "- Save durable memory with memory_store({ content, canonicalKey?, type? }).",
+                "- Use canonicalKey only for updateable facts/preferences/settings (so updates overwrite instead of duplicating).",
+                "- Find memory with memory_search({ query, corpus? }).",
+                "- Read items with memory_get({ lookup: \"db-memory/items/<uuid>.md\" | \"sessions/<agentId>/<file>\", fromLine?, lineCount? }).",
+                "- Shortcut recall: memory_recall({ query? }) (without query returns top important recent items).",
+                "- Forget items with memory_forget({ lookup }) or memory_forget({ id }).",
+                "",
+                "Notes:",
+                "- memory_search supports corpus=\"memory\" (Postgres durable), corpus=\"sessions\" (Postgres sessions index, DB-first), and corpus=\"all\" (merge). corpus=\"wiki\" is deferred; use wiki_search/wiki_get when installed.",
+                "",
+                ...cacheNotice,
+                ...sdkNotice,
+                ...cached,
+            ];
+        },
+        runtime: {
+            async getMemorySearchManager(params) {
+                if (ctx.disabledReason) {
+                    return {
+                        manager: null,
+                        error: `anchorclaw: disabled until configured (${ctx.disabledReason})`,
+                    };
+                }
+                ctx.getPool();
+                return {
+                    manager: createAnchorClawMemorySearchManager({
+                        api,
+                        cfg: ctx.cfg,
+                        ensureReady: ctx.ensureReady,
+                        ensureSessionsIndexBootstrapped,
+                        getPool: ctx.getPool,
+                        agentId: params.agentId,
+                        purpose: params.purpose,
+                    }),
+                };
+            },
+            resolveMemoryBackendConfig(_params) {
+                return { backend: "builtin" };
+            },
+        },
+    });
+}
+//# sourceMappingURL=capability.js.map

package/dist/plugin/capability.js.map

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

package/dist/plugin/capability.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capability.test.d.ts.map

package/dist/plugin/capability.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.test.d.ts","sourceRoot":"","sources":["../../src/plugin/capability.test.ts"],"names":[],"mappings":""}

package/dist/plugin/capability.test.js

@@ -0,0 +1,75 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const { registerMemoryCapabilityMock, managerFactoryMock } = vi.hoisted(() => ({
+    registerMemoryCapabilityMock: vi.fn(),
+    managerFactoryMock: vi.fn(() => ({})),
+}));
+vi.mock("../api.js", () => ({
+    registerMemoryCapability: registerMemoryCapabilityMock,
+}));
+vi.mock("../memory/manager.js", () => ({
+    createAnchorClawMemorySearchManager: managerFactoryMock,
+}));
+import { registerAnchorClawMemoryCapability } from "./capability.js";
+describe("registerAnchorClawMemoryCapability prompt guidance", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("uses narrow one-exact-value guidance for marker/id/key questions", () => {
+        const ctx = {
+            api: {},
+            disabledReason: null,
+            promptCache: { lines: ["(cached memory block)"], error: null },
+            sdkHealth: { degraded: false },
+            cfg: {},
+            ensureReady: vi.fn(async () => undefined),
+            getPool: vi.fn(() => ({ query: vi.fn() })),
+        };
+        registerAnchorClawMemoryCapability({
+            ctx,
+            refreshPromptCache: vi.fn(),
+            ensureSessionsIndexBootstrapped: vi.fn(async () => undefined),
+        });
+        expect(registerMemoryCapabilityMock).toHaveBeenCalledTimes(1);
+        const capabilityDef = registerMemoryCapabilityMock.mock.calls[0]?.[1];
+        const lines = capabilityDef.promptBuilder({
+            availableTools: new Set(["memory_search", "memory_get"]),
+            citationsMode: "inline",
+        });
+        const text = lines.join("\n");
+        expect(text).toContain("For one exact marker/id/key value questions");
+        expect(text).toContain("prioritize literal evidence from memory_search/memory_recall");
+        expect(text).toContain("If any memory_search or memory_recall result has details.meta.exactTop1=true");
+        expect(text).toContain("Never use empty memory_recall as a tie-breaker for exact lookups.");
+        expect(text).toContain("If no exactTop1 is found, say you checked and give the best candidate with uncertainty.");
+        expect(text).not.toContain("For exact marker/id/key questions");
+        expect(text).not.toContain("make at most two memory_search/memory_recall attempts");
+    });
+    it("keeps broad-memory-search guidance for non-exact overview questions", () => {
+        const ctx = {
+            api: {},
+            disabledReason: null,
+            promptCache: { lines: ["(cached memory block)"], error: null },
+            sdkHealth: { degraded: false },
+            cfg: {},
+            ensureReady: vi.fn(async () => undefined),
+            getPool: vi.fn(() => ({ query: vi.fn() })),
+        };
+        registerAnchorClawMemoryCapability({
+            ctx,
+            refreshPromptCache: vi.fn(),
+            ensureSessionsIndexBootstrapped: vi.fn(async () => undefined),
+        });
+        const capabilityDef = registerMemoryCapabilityMock.mock.calls[0]?.[1];
+        const lines = capabilityDef.promptBuilder({
+            availableTools: new Set(["memory_search", "memory_get"]),
+            citationsMode: "inline",
+        });
+        const text = lines.join("\n");
+        expect(text).toContain("Before answering anything about prior work, decisions, dates, people, preferences, or todos: run memory_search; then use memory_get to pull only the needed lines.");
+        expect(text).toContain("If no exactTop1 is found, say you checked and give the best candidate with uncertainty.");
+        expect(text).toContain("For broad agreement/policy/decision questions, use memory_search/memory_recall to gather closest evidence");
+        expect(text).toContain("if no direct agreement record is found, report not found with a brief summary of closest evidence.");
+        expect(text).not.toContain("cap retrieval at two memory_search queries plus at most one memory_recall fallback");
+    });
+});
+//# sourceMappingURL=capability.test.js.map

package/dist/plugin/capability.test.js.map

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

package/dist/plugin/lifecycle.d.ts

@@ -0,0 +1,6 @@
+import type { OpenClawPluginApi } from "../api.js";
+export declare function registerSessionDeltaLifecycle(params: {
+    api: OpenClawPluginApi;
+    cleanupSessionDelta: () => void;
+}): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/plugin/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/plugin/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,GAAG,EAAE,iBAAiB,CAAC;IACvB,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC,QAiCA"}

package/dist/plugin/lifecycle.js

@@ -0,0 +1,31 @@
+export function registerSessionDeltaLifecycle(params) {
+    const { api, cleanupSessionDelta } = params;
+    const registerRuntimeLifecycle = api?.lifecycle?.registerRuntimeLifecycle;
+    const registerRuntimeLifecycleCompat = typeof registerRuntimeLifecycle === "function"
+        ? registerRuntimeLifecycle.bind(api.lifecycle)
+        : typeof api?.registerRuntimeLifecycle === "function"
+            ? api.registerRuntimeLifecycle.bind(api)
+            : null;
+    if (typeof registerRuntimeLifecycle === "function") {
+        api.logger.info("anchorclaw: runtime lifecycle API detected (api.lifecycle.registerRuntimeLifecycle)");
+    }
+    else if (typeof api?.registerRuntimeLifecycle === "function") {
+        api.logger.warn("anchorclaw: using legacy runtime lifecycle API (api.registerRuntimeLifecycle); host SDK appears older than grouped lifecycle surface");
+    }
+    else if (!registerRuntimeLifecycleCompat) {
+        const logError = typeof api.logger?.error === "function"
+            ? api.logger.error.bind(api.logger)
+            : api.logger.warn.bind(api.logger);
+        logError("anchorclaw: no runtime lifecycle registration API available; listener cleanup on reload/disable is unavailable");
+    }
+    if (registerRuntimeLifecycleCompat) {
+        registerRuntimeLifecycleCompat({
+            id: "anchorclaw-sessions-delta-listener",
+            description: "Cleans up transcript update listener and pending debounce timer.",
+            cleanup: async () => {
+                cleanupSessionDelta();
+            },
+        });
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/plugin/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/plugin/lifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,6BAA6B,CAAC,MAG7C;IACC,MAAM,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAAC;IAC5C,MAAM,wBAAwB,GAAI,GAAW,EAAE,SAAS,EAAE,wBAAwB,CAAC;IACnF,MAAM,8BAA8B,GAClC,OAAO,wBAAwB,KAAK,UAAU;QAC5C,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAE,GAAW,CAAC,SAAS,CAAC;QACvD,CAAC,CAAC,OAAQ,GAAW,EAAE,wBAAwB,KAAK,UAAU;YAC5D,CAAC,CAAE,GAAW,CAAC,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC;YACjD,CAAC,CAAC,IAAI,CAAC;IACb,IAAI,OAAO,wBAAwB,KAAK,UAAU,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC;IACzG,CAAC;SAAM,IAAI,OAAQ,GAAW,EAAE,wBAAwB,KAAK,UAAU,EAAE,CAAC;QACxE,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,sIAAsI,CACvI,CAAC;IACJ,CAAC;SAAM,IAAI,CAAC,8BAA8B,EAAE,CAAC;QAC3C,MAAM,QAAQ,GACZ,OAAQ,GAAG,CAAC,MAAc,EAAE,KAAK,KAAK,UAAU;YAC9C,CAAC,CAAE,GAAG,CAAC,MAAc,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAC5C,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,QAAQ,CACN,gHAAgH,CACjH,CAAC;IACJ,CAAC;IACD,IAAI,8BAA8B,EAAE,CAAC;QACnC,8BAA8B,CAAC;YAC7B,EAAE,EAAE,oCAAoC;YACxC,WAAW,EAAE,kEAAkE;YAC/E,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,mBAAmB,EAAE,CAAC;YACxB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/plugin/prompt-cache.d.ts

@@ -0,0 +1,10 @@
+import type { OpenClawPluginApi } from "../api.js";
+import type { PluginRuntimeContext } from "./runtime-context.js";
+export type PromptCacheRuntime = {
+    refreshPromptCache: () => void;
+};
+export declare function createPromptCacheRuntime(params: {
+    api: OpenClawPluginApi;
+    ctx: PluginRuntimeContext;
+}): PromptCacheRuntime;
+//# sourceMappingURL=prompt-cache.d.ts.map

package/dist/plugin/prompt-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.d.ts","sourceRoot":"","sources":["../../src/plugin/prompt-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,GAAG,EAAE,iBAAiB,CAAC;IACvB,GAAG,EAAE,oBAAoB,CAAC;CAC3B,GAAG,kBAAkB,CAsDrB"}

package/dist/plugin/prompt-cache.js

@@ -0,0 +1,58 @@
+import { resolveUserAndWorkspaceScope } from "../identity.js";
+import { buildPromptMemorySection, queryPromptMemoryItems } from "../memory/prompt.js";
+export function createPromptCacheRuntime(params) {
+    const { api, ctx } = params;
+    const refreshPromptCache = () => {
+        if (!ctx.cfg) {
+            ctx.promptCache.lines = null;
+            ctx.promptCache.error = ctx.disabledReason ?? "invalid config";
+            return;
+        }
+        if (ctx.promptCache.refreshPromise) {
+            return;
+        }
+        ctx.promptCache.refreshPromise = (async () => {
+            try {
+                await ctx.ensureReady();
+                const scope = await resolveUserAndWorkspaceScope({
+                    api,
+                    pool: ctx.getPool(),
+                    agentId: api?.runtime?.agentId,
+                    sessionKey: api?.runtime?.sessionKey,
+                    configuredExternalId: ctx.cfg?.identity?.externalId,
+                });
+                const items = await queryPromptMemoryItems({
+                    pool: ctx.getPool(),
+                    userId: scope.userId,
+                    workspaceId: scope.workspaceId,
+                    limit: 50,
+                    // MVP: durable injection focuses on facts and notes.
+                    // TODO: extend prompt injection policy for other types:
+                    // profile/config/skill/summary/automation (safe ordering + size budgets + canonicalKey conventions).
+                    types: ["fact", "note"],
+                });
+                ctx.promptCache.lines = buildPromptMemorySection({
+                    items,
+                    maxTotalChars: 12_000,
+                    maxTitleChars: 120,
+                    policy: {
+                        // MVP: durable injection focuses on facts and notes.
+                        maxItemsByType: { fact: 6, note: 4 },
+                        defaultMaxItemChars: 1_200,
+                    },
+                });
+                ctx.promptCache.error = null;
+            }
+            catch (error) {
+                ctx.promptCache.lines = null;
+                ctx.promptCache.error = error instanceof Error ? error.message : String(error);
+                api.logger.warn(`anchorclaw: prompt cache refresh failed (${ctx.promptCache.error})`);
+            }
+            finally {
+                ctx.promptCache.refreshPromise = null;
+            }
+        })();
+    };
+    return { refreshPromptCache };
+}
+//# sourceMappingURL=prompt-cache.js.map

package/dist/plugin/prompt-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.js","sourceRoot":"","sources":["../../src/plugin/prompt-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAOvF,MAAM,UAAU,wBAAwB,CAAC,MAGxC;IACC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAE5B,MAAM,kBAAkB,GAAG,GAAG,EAAE;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;YAC7B,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,GAAG,CAAC,cAAc,IAAI,gBAAgB,CAAC;YAC/D,OAAO;QACT,CAAC;QACD,IAAI,GAAG,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,GAAG,CAAC,WAAW,CAAC,cAAc,GAAG,CAAC,KAAK,IAAI,EAAE;YAC3C,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,MAAM,4BAA4B,CAAC;oBAC/C,GAAG;oBACH,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE;oBACnB,OAAO,EAAG,GAAW,EAAE,OAAO,EAAE,OAAO;oBACvC,UAAU,EAAG,GAAW,EAAE,OAAO,EAAE,UAAU;oBAC7C,oBAAoB,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU;iBACpD,CAAC,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC;oBACzC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE;oBACnB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,KAAK,EAAE,EAAE;oBACT,qDAAqD;oBACrD,wDAAwD;oBACxD,qGAAqG;oBACrG,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;iBACxB,CAAC,CAAC;gBACH,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,wBAAwB,CAAC;oBAC/C,KAAK;oBACL,aAAa,EAAE,MAAM;oBACrB,aAAa,EAAE,GAAG;oBAClB,MAAM,EAAE;wBACN,qDAAqD;wBACrD,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;wBACpC,mBAAmB,EAAE,KAAK;qBAC3B;iBACF,CAAC,CAAC;gBACH,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;gBAC7B,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/E,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,4CAA4C,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC;YACxF,CAAC;oBAAS,CAAC;gBACT,GAAG,CAAC,WAAW,CAAC,cAAc,GAAG,IAAI,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC;IAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAChC,CAAC"}

package/dist/plugin/runtime-context.d.ts

@@ -0,0 +1,27 @@
+import type { OpenClawPluginApi } from "../api.js";
+import type { AnchorClawConfig } from "../config.js";
+import { type PostgresPool } from "../postgres.js";
+import type { PromptCacheState, SdkHealthState, SessionDeltaRuntimeState, SessionsIndexState } from "./types.js";
+export type PluginRuntimeContext = {
+    api: OpenClawPluginApi;
+    cfg: AnchorClawConfig | undefined;
+    disabledReason: string | undefined;
+    pool: PostgresPool | undefined;
+    migrationsApplied: Promise<void> | undefined;
+    promptCache: PromptCacheState;
+    sessionsIndex: SessionsIndexState;
+    sessionDelta: SessionDeltaRuntimeState;
+    sdkHealth: SdkHealthState;
+    resolveActor: () => string;
+    getPool: () => PostgresPool;
+    ensureReady: () => Promise<void>;
+    markSdkError: (operation: string, error: unknown) => void;
+    markSdkSuccess: () => void;
+    listVisibleAgentIds: () => Promise<string[]>;
+};
+export declare function createPluginRuntimeContext(params: {
+    api: OpenClawPluginApi;
+    cfg: AnchorClawConfig | undefined;
+    disabledReason: string | undefined;
+}): PluginRuntimeContext;
+//# sourceMappingURL=runtime-context.d.ts.map

package/dist/plugin/runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/plugin/runtime-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,iBAAiB,CAAC;IACvB,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IAC/B,iBAAiB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAC7C,WAAW,EAAE,gBAAgB,CAAC;IAC9B,aAAa,EAAE,kBAAkB,CAAC;IAClC,YAAY,EAAE,wBAAwB,CAAC;IACvC,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC9C,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,GAAG,EAAE,iBAAiB,CAAC;IACvB,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GAAG,oBAAoB,CA0FvB"}

package/dist/plugin/runtime-context.js

@@ -0,0 +1,91 @@
+import { resolveActor } from "./runtime-helpers.js";
+import { createPostgresPool, } from "../postgres.js";
+import { loadBundledMigrationsFromDisk } from "../migrations-fs.js";
+import { applyMigrations } from "../migrations.js";
+import { listKnownAgentIds } from "../memory/sessions.js";
+const SDK_RECOVERY_SUCCESS_THRESHOLD = 3;
+export function createPluginRuntimeContext(params) {
+    const ctx = {
+        api: params.api,
+        cfg: params.cfg,
+        disabledReason: params.disabledReason,
+        pool: undefined,
+        migrationsApplied: undefined,
+        promptCache: {
+            lines: null,
+            error: null,
+            refreshPromise: null,
+        },
+        sessionsIndex: {
+            bootstrapPromise: null,
+            bootstrapped: false,
+        },
+        sessionDelta: {
+            pendingFiles: new Set(),
+            timer: null,
+            syncInFlight: null,
+            unsubscribe: null,
+            closed: false,
+            ignoredPathCounts: new Map(),
+            stateByPath: new Map(),
+        },
+        sdkHealth: {
+            degraded: false,
+            consecutiveSuccesses: 0,
+        },
+        resolveActor: () => resolveActor(params.api),
+        getPool: () => {
+            if (!ctx.cfg) {
+                throw new Error(`anchorclaw: disabled until configured (${ctx.disabledReason ?? "invalid config"})`);
+            }
+            ctx.pool ??= createPostgresPool({ cfg: ctx.cfg });
+            ctx.migrationsApplied ??= (async () => {
+                if (ctx.cfg?.postgres?.schema) {
+                    const schema = ctx.cfg.postgres.schema.trim();
+                    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(schema)) {
+                        throw new Error("postgres.schema must be a simple identifier (letters/numbers/underscore)");
+                    }
+                    await ctx.pool.query(`CREATE SCHEMA IF NOT EXISTS ${schema}`);
+                }
+                const migrations = await loadBundledMigrationsFromDisk();
+                const result = await applyMigrations({ pool: ctx.pool, migrations });
+                if (result.applied.length > 0) {
+                    params.api.logger.info(`anchorclaw: applied migrations: ${result.applied.join(", ")}`);
+                }
+            })();
+            return ctx.pool;
+        },
+        ensureReady: async () => {
+            ctx.getPool();
+            await ctx.migrationsApplied;
+        },
+        markSdkError: (operation, error) => {
+            ctx.sdkHealth.degraded = true;
+            ctx.sdkHealth.consecutiveSuccesses = 0;
+            ctx.sdkHealth.affectedOperation = operation;
+            ctx.sdkHealth.reason = error instanceof Error ? error.message : String(error);
+            ctx.sdkHealth.lastErrorAt = new Date().toISOString();
+        },
+        markSdkSuccess: () => {
+            if (!ctx.sdkHealth.degraded) {
+                return;
+            }
+            ctx.sdkHealth.consecutiveSuccesses += 1;
+            if (ctx.sdkHealth.consecutiveSuccesses < SDK_RECOVERY_SUCCESS_THRESHOLD) {
+                return;
+            }
+            ctx.sdkHealth.degraded = false;
+            ctx.sdkHealth.reason = undefined;
+            ctx.sdkHealth.affectedOperation = undefined;
+            ctx.sdkHealth.lastErrorAt = undefined;
+            ctx.sdkHealth.consecutiveSuccesses = 0;
+        },
+        listVisibleAgentIds: async () => {
+            const currentAgentId = String(params.api?.runtime?.agentId ?? "main");
+            const agentIds = await listKnownAgentIds();
+            return [currentAgentId, ...agentIds.filter((agentId) => agentId !== currentAgentId)];
+        },
+    };
+    return ctx;
+}
+//# sourceMappingURL=runtime-context.js.map

package/dist/plugin/runtime-context.js.map

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

package/dist/plugin/runtime-helpers.d.ts

@@ -0,0 +1,3 @@
+import type { OpenClawPluginApi } from "../api.js";
+export declare function resolveActor(api: OpenClawPluginApi): string;
+//# sourceMappingURL=runtime-helpers.d.ts.map

package/dist/plugin/runtime-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-helpers.d.ts","sourceRoot":"","sources":["../../src/plugin/runtime-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAU3D"}

package/dist/plugin/runtime-helpers.js

@@ -0,0 +1,12 @@
+export function resolveActor(api) {
+    const agentId = api?.runtime?.agentId;
+    if (typeof agentId === "string" && agentId.trim()) {
+        return `openclaw:agent:${agentId.trim()}`;
+    }
+    const sessionKey = api?.runtime?.sessionKey;
+    if (typeof sessionKey === "string" && sessionKey.trim()) {
+        return `openclaw:session:${sessionKey.trim()}`;
+    }
+    return "openclaw";
+}
+//# sourceMappingURL=runtime-helpers.js.map

package/dist/plugin/runtime-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-helpers.js","sourceRoot":"","sources":["../../src/plugin/runtime-helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,GAAsB;IACjD,MAAM,OAAO,GAAI,GAAW,EAAE,OAAO,EAAE,OAAO,CAAC;IAC/C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,OAAO,kBAAkB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,UAAU,GAAI,GAAW,EAAE,OAAO,EAAE,UAAU,CAAC;IACrD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QACxD,OAAO,oBAAoB,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/plugin/session-delta-helpers.d.ts

@@ -0,0 +1,11 @@
+import { type AnchorClawConfig } from "../config.js";
+import type { SessionDeltaThresholds } from "./types.js";
+export declare function isSessionArchiveArtifactPath(sessionFile: string): boolean;
+export declare function countNewlinesFromChunk(chunk: string): number;
+export declare function countNewlinesInRange(params: {
+    filePath: string;
+    start: number;
+    end: number;
+}): Promise<number>;
+export declare function resolveSessionDeltaThresholds(cfg: AnchorClawConfig | undefined): SessionDeltaThresholds;
+//# sourceMappingURL=session-delta-helpers.d.ts.map

package/dist/plugin/session-delta-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-delta-helpers.d.ts","sourceRoot":"","sources":["../../src/plugin/session-delta-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAMtB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIzD,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAMzE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAChC,sBAAsB,CAaxB"}