@chendpoc/pi-memory 0.1.0

package/dist/pi-extension.js

@@ -0,0 +1,224 @@
+import { StringEnum } from "@earendil-works/pi-ai";
+import { truncateHead } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { createPiLLMClient, DEFAULT_HELPER_MODEL, DEFAULT_HELPER_PROVIDER, resolveMemoryHelperLLM, } from "./adapters/piComplete.js";
+import { defaultMemoryConfig } from "./config.js";
+import { createFallbackQuery } from "./fallback/index.js";
+import { runMemoryPreflight } from "./preflight/hook.js";
+import { injectPrivateMemoryContext } from "./preflight/strip.js";
+import { MemoryService } from "./service.js";
+import { createMemoryAppendTool, MEMORY_APPEND_DESCRIPTION, MEMORY_APPEND_NAME, MEMORY_APPEND_PROMPT_GUIDELINES, MEMORY_APPEND_PROMPT_SNIPPET, } from "./tools/memoryAppend.js";
+import { createMemoryRecallTool, MEMORY_RECALL_DESCRIPTION, MEMORY_RECALL_NAME, MEMORY_RECALL_PROMPT_GUIDELINES, MEMORY_RECALL_PROMPT_SNIPPET, } from "./tools/memoryRecall.js";
+const MemoryRecallParams = Type.Object({
+    mode: Type.Optional(StringEnum(["direct_relation", "path_query", "typed_neighborhood"])),
+    anchor_mentions: Type.Array(Type.String()),
+    relation_constraints: Type.Optional(Type.Array(Type.String())),
+    candidate_type: Type.Optional(Type.String()),
+    scope_filter: Type.Optional(Type.Array(Type.String())),
+    target_slot: Type.Optional(StringEnum(["head", "tail"])),
+    time_window: Type.Optional(Type.String()),
+    evidence_budget: Type.Optional(Type.Number()),
+    result_limit: Type.Optional(Type.Number()),
+});
+const MemoryAppendParams = Type.Object({
+    content: Type.String({ description: "New entries to append (markdown bullet points)." }),
+});
+const RECALL_MAX_LINES = 200;
+const RECALL_MAX_BYTES = 32_000;
+let sharedService = null;
+let sessionCfg = null;
+let sharedHelper = null;
+let sharedLLMClient = null;
+let preflightCache = null;
+export function getSharedMemoryService() {
+    return sharedService;
+}
+async function refreshMemoryHelper(ctx, pi) {
+    sharedHelper = await resolveMemoryHelperLLM(ctx, pi.getFlag("memory-helper-model"));
+    sharedLLMClient = createPiLLMClient(ctx, pi.getFlag("memory-helper-model"));
+}
+function getRerankOpts() {
+    if (!sharedLLMClient)
+        return null;
+    return { client: sharedLLMClient };
+}
+function getUserMessageText(message) {
+    if (message.role !== "user")
+        return null;
+    const user = message;
+    if (typeof user.content === "string")
+        return user.content;
+    return user.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("\n");
+}
+function setUserMessageText(message, text) {
+    return { ...message, content: text };
+}
+function findLastUserMessageIndex(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        if (messages[i]?.role === "user")
+            return i;
+    }
+    return -1;
+}
+function formatMemoryStatus(service) {
+    const snap = service.getStatus();
+    const lines = [
+        `status: ${snap.status}`,
+        snap.reason ? `reason: ${snap.reason}` : null,
+        snap.health ? `health: ${JSON.stringify(snap.health)}` : null,
+    ].filter(Boolean);
+    return lines.join("\n");
+}
+export default function piMemoryExtension(pi) {
+    pi.registerFlag("memory-helper-model", {
+        description: `Model for memory intent helper (default: ${DEFAULT_HELPER_PROVIDER}/${DEFAULT_HELPER_MODEL})`,
+        type: "string",
+    });
+    pi.on("session_start", async (_event, ctx) => {
+        const cfg = defaultMemoryConfig();
+        sessionCfg = cfg;
+        preflightCache = null;
+        sharedHelper = null;
+        if (cfg.provider === "disabled")
+            return;
+        const service = new MemoryService(cfg);
+        sharedService = service;
+        try {
+            await service.start();
+            service.startSessionIndex();
+            if (cfg.trainer.auto_interval) {
+                service.startAutoTrainer();
+            }
+            await refreshMemoryHelper(ctx, pi);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (ctx.hasUI) {
+                ctx.ui.notify(`pi-memory: sidecar start failed (${message}) — fallback mode active`, "warning");
+            }
+        }
+    });
+    pi.on("session_shutdown", async () => {
+        if (sharedService) {
+            await sharedService.stop();
+            sharedService = null;
+        }
+        sessionCfg = null;
+        sharedHelper = null;
+        sharedLLMClient = null;
+        preflightCache = null;
+    });
+    pi.on("model_select", async (_event, ctx) => {
+        await refreshMemoryHelper(ctx, pi);
+    });
+    pi.on("agent_start", () => {
+        preflightCache = null;
+    });
+    const fallback = createFallbackQuery({
+        sessionsDir: defaultMemoryConfig().sessionsDir,
+        memoryMdPaths: defaultMemoryConfig().memoryMdPaths,
+    });
+    pi.registerCommand("memory", {
+        description: "Show pi-memory sidecar status and bundle info",
+        handler: async (_args, ctx) => {
+            const service = sharedService;
+            if (!service) {
+                ctx.ui.notify("pi-memory: service not started", "warning");
+                return;
+            }
+            ctx.ui.notify(formatMemoryStatus(service), "info");
+        },
+    });
+    pi.registerTool({
+        name: MEMORY_RECALL_NAME,
+        label: "Memory Recall",
+        description: MEMORY_RECALL_DESCRIPTION,
+        promptSnippet: MEMORY_RECALL_PROMPT_SNIPPET,
+        promptGuidelines: [...MEMORY_RECALL_PROMPT_GUIDELINES],
+        parameters: MemoryRecallParams,
+        async execute(_toolCallId, params, signal) {
+            const service = sharedService;
+            if (!service) {
+                return {
+                    content: [{ type: "text", text: "Memory service not started." }],
+                    details: { truncated: false },
+                    isError: true,
+                };
+            }
+            const tool = createMemoryRecallTool(service, fallback, getRerankOpts());
+            const result = await tool.run(JSON.stringify(params), signal);
+            const truncated = truncateHead(result.content, {
+                maxLines: RECALL_MAX_LINES,
+                maxBytes: RECALL_MAX_BYTES,
+            });
+            let text = truncated.content;
+            if (truncated.truncated) {
+                text += `\n\n[truncated: ${truncated.totalLines} lines, ${truncated.totalBytes} bytes]`;
+            }
+            return {
+                content: [{ type: "text", text }],
+                details: { truncated: truncated.truncated },
+                isError: result.isError ?? false,
+            };
+        },
+    });
+    const memoryMdPath = defaultMemoryConfig().memoryMdPaths[0];
+    if (memoryMdPath) {
+        const appendTool = createMemoryAppendTool(memoryMdPath);
+        pi.registerTool({
+            name: MEMORY_APPEND_NAME,
+            label: "Memory Append",
+            description: MEMORY_APPEND_DESCRIPTION,
+            promptSnippet: MEMORY_APPEND_PROMPT_SNIPPET,
+            promptGuidelines: [...MEMORY_APPEND_PROMPT_GUIDELINES],
+            parameters: MemoryAppendParams,
+            async execute(_toolCallId, params) {
+                const result = await appendTool.run(JSON.stringify(params));
+                return {
+                    content: [{ type: "text", text: result.content }],
+                    details: {},
+                    isError: result.isError ?? false,
+                };
+            },
+        });
+    }
+    pi.on("context", async (event, ctx) => {
+        const service = sharedService;
+        const cfg = sessionCfg;
+        if (!service || !cfg || cfg.provider === "disabled")
+            return;
+        const userIndex = findLastUserMessageIndex(event.messages);
+        if (userIndex < 0)
+            return;
+        const userText = getUserMessageText(event.messages[userIndex]);
+        if (!userText?.trim())
+            return;
+        let privateContext;
+        if (preflightCache?.userText === userText) {
+            privateContext = preflightCache.privateContext;
+        }
+        else {
+            const userTurnCount = event.messages.filter((m) => m.role === "user").length;
+            const preflight = await runMemoryPreflight(userText, service, {
+                helper: sharedHelper,
+                forceHelper: userTurnCount === 1,
+                fallback,
+                signal: ctx.signal,
+                rerankOpts: getRerankOpts(),
+            });
+            if (!preflight?.privateContext)
+                return;
+            privateContext = preflight.privateContext;
+            preflightCache = { userText, privateContext };
+        }
+        const injectedText = injectPrivateMemoryContext(userText, userText, privateContext);
+        const messages = [...event.messages];
+        messages[userIndex] = setUserMessageText(messages[userIndex], injectedText);
+        return { messages };
+    });
+}
+export { piMemoryExtension };
+//# sourceMappingURL=pi-extension.js.map

package/dist/pi-extension.js.map

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

package/dist/preflight/detectIntents.d.ts

@@ -0,0 +1,102 @@
+import type { QueryIntent } from "../types.js";
+export declare const MEMORY_HELPER_TOOL_NAME = "compile_memory_intents";
+export declare const MEMORY_HELPER_MAX_INPUT_RUNES = 500;
+export interface CompileMemoryIntentsResult {
+    should_recall: boolean;
+    gate_reason?: string;
+    intents: QueryIntent[];
+}
+/** Optional small-model helper; null → regex fast-path only (fail-silent). */
+export interface MemoryHelperLLM {
+    compileIntents(text: string, signal?: AbortSignal): Promise<CompileMemoryIntentsResult>;
+}
+export interface DetectIntentsOptions {
+    forceHelper?: boolean;
+    signal?: AbortSignal;
+}
+/** JSON schema for forced tool_use compile_memory_intents (helper providers). */
+export declare const COMPILE_MEMORY_INTENTS_PARAMETERS: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly should_recall: {
+            readonly type: "boolean";
+            readonly description: "True only when the user is asking about their own private episodic memory.";
+        };
+        readonly gate_reason: {
+            readonly type: "string";
+            readonly description: "One short phrase (under 40 chars) describing the gate decision.";
+        };
+        readonly intents: {
+            readonly type: "array";
+            readonly maxItems: 3;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly mode: {
+                        readonly type: "string";
+                        readonly enum: readonly ["direct_relation", "path_query", "typed_neighborhood"];
+                    };
+                    readonly anchor_mentions: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly minItems: 1;
+                        readonly maxItems: 4;
+                    };
+                    readonly relation_constraints: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly maxItems: 4;
+                    };
+                    readonly candidate_type: {
+                        readonly type: "string";
+                    };
+                    readonly scope_filter: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly maxItems: 4;
+                    };
+                    readonly target_slot: {
+                        readonly type: "string";
+                        readonly enum: readonly ["head", "tail"];
+                    };
+                    readonly time_window: {
+                        readonly type: "string";
+                    };
+                    readonly evidence_budget: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 50;
+                    };
+                    readonly result_limit: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 100;
+                    };
+                };
+                readonly required: readonly ["mode", "anchor_mentions"];
+            };
+        };
+    };
+    readonly required: readonly ["should_recall", "intents"];
+};
+export declare function detectExactMemoryIntents(query: string): QueryIntent[];
+export declare function defaultDirectMemoryIntent(anchor: string): QueryIntent;
+export declare function cleanMemoryAnchor(s: string): string;
+export declare function isPronounAnchor(s: string): boolean;
+export declare function looksLikeTaskText(s: string): boolean;
+export declare function looksMemoryRelevant(query: string): boolean;
+export declare function sanitizeMemoryIntents(intents: QueryIntent[]): QueryIntent[];
+/**
+ * Compile user message into QueryIntent values.
+ * Regex fast-path bypasses helper; otherwise helper LLM when provided.
+ */
+export declare function detectMemoryIntents(query: string, helper: MemoryHelperLLM | null | undefined, options?: DetectIntentsOptions): Promise<QueryIntent[]>;
+//# sourceMappingURL=detectIntents.d.ts.map

package/dist/preflight/detectIntents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectIntents.d.ts","sourceRoot":"","sources":["../../src/preflight/detectIntents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAE1D,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA2VD,iFAAiF;AACjF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDpC,CAAC;AAEX,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAWrE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAOrE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAUnD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAqBlD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAgCpD;AAmBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAS1D;AA2CD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CA0C3E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC1C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC,CAoBxB"}