@chendpoc/pi-memory 0.1.0

package/dist/preflight/detectIntents.js

@@ -0,0 +1,624 @@
+export const MEMORY_HELPER_TOOL_NAME = "compile_memory_intents";
+export const MEMORY_HELPER_MAX_INPUT_RUNES = 500;
+const exactRelationshipPatterns = [
+    {
+        re: /^\s*(.+?)\s*(?:与|和|跟)\s*我\s*(?:的)?\s*关系\s*[？?。.!！]*\s*$/,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*我\s*(?:与|和|跟)\s*(.+?)\s*(?:是\s*)?(?:什么|什麼|啥|怎样|怎樣)?\s*关系\s*[？?。.!！]*\s*$/,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*我\s*(?:认识|認識|见过|見過)\s*(.+?)\s*(?:吗|嗎)?\s*[？?。.!！]*\s*$/,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*who\s+is\s+(.+?)\s+to\s+me\s*[?.!]*\s*$/i,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*my\s+relationship\s+with\s+(.+?)\s*[?.!]*\s*$/i,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*how\s+do\s+i\s+know\s+(.+?)\s*[?.!]*\s*$/i,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*what\s+is\s+my\s+(?:connection|relationship)\s+(?:to|with)\s+(.+?)\s*[?.!]*\s*$/i,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*(?:do|did)\s+i\s+(?:know|meet)\s+(.+?)\s*[?.!]*\s*$/i,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*where\s+do\s+i\s+know\s+(.+?)\s+from\s*[?.!]*\s*$/i,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*(.+?)\s*と\s*(?:私|わたし|僕|俺|自分)\s*(?:の)?\s*関係\s*[？?。.!！]*\s*$/,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*(?:私|わたし|僕|俺|自分)\s*と\s*(.+?)\s*(?:は|って)?\s*(?:どんな|どういう)?\s*関係\s*[？?。.!！]*\s*$/,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*(.+?)\s*は\s*(?:私|わたし|僕|俺|自分)\s*にとって\s*(?:誰|何)\s*[？?。.!！]*\s*$/,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*(.+?)\s*を\s*(?:どう|どこで)?\s*知って(?:いる|る)?\s*(?:の|か)?\s*[？?。.!！]*\s*$/,
+        anchorGroup: 1,
+    },
+    {
+        re: /^\s*(.+?)\s*に\s*会ったこと(?:が)?ある\s*(?:の|か)?\s*[？?。.!！]*\s*$/,
+        anchorGroup: 1,
+    },
+];
+const latinEntityPattern = /(?:^|[\s"'(（【])([A-Z][\p{L}\p{N}_&.+-]*(?:\s+[A-Z0-9][\p{L}\p{N}_&.+-]*){0,4})/u;
+const privateMemoryCues = [
+    "remember",
+    "recall",
+    "last time",
+    "previously",
+    "before",
+    "we discussed",
+    "we decided",
+    "did we",
+    "have we",
+    "my ",
+    " me ",
+    " i ",
+    "记得",
+    "記得",
+    "回忆",
+    "回憶",
+    "上次",
+    "之前",
+    "以前",
+    "我们聊",
+    "我們聊",
+    "我们说",
+    "我們說",
+    "我",
+    "我的",
+    "覚えて",
+    "思い出",
+    "前回",
+    "以前",
+    "前に",
+    "話した",
+    "決めた",
+    "私",
+    "わたし",
+    "僕",
+    "俺",
+    "自分",
+];
+const relationQuestionCues = [
+    "relationship",
+    "connection",
+    "know",
+    "met",
+    "meet",
+    "worked",
+    "work with",
+    "colleague",
+    "coworker",
+    "classmate",
+    "advisor",
+    "mentor",
+    "friend",
+    "created",
+    "built",
+    "authored",
+    "founded",
+    "owns",
+    "owned",
+    "depends",
+    "requires",
+    "uses",
+    "implemented",
+    "runs on",
+    "integrates",
+    "supports",
+    "released",
+    "published",
+    "forked",
+    "inspired",
+    "customer",
+    "competitor",
+    "email",
+    "handle",
+    "url",
+    "path",
+    "scheduled",
+    "monitors",
+    "what does",
+    "who created",
+    "who owns",
+    "who built",
+    "关系",
+    "關係",
+    "认识",
+    "認識",
+    "见过",
+    "見過",
+    "合作",
+    "同事",
+    "同学",
+    "同學",
+    "导师",
+    "導師",
+    "朋友",
+    "是谁",
+    "是誰",
+    "工作",
+    "任职",
+    "任職",
+    "创建",
+    "創建",
+    "作者",
+    "拥有",
+    "擁有",
+    "依赖",
+    "依賴",
+    "使用",
+    "实现",
+    "實現",
+    "运行",
+    "運行",
+    "集成",
+    "支持",
+    "发布",
+    "發布",
+    "项目",
+    "項目",
+    "関係",
+    "知",
+    "会った",
+    "仕事",
+    "同僚",
+    "友達",
+    "先生",
+    "メンター",
+    "作った",
+    "作者",
+    "所有",
+    "依存",
+    "使",
+    "実装",
+    "動",
+    "統合",
+    "対応",
+    "発表",
+    "公開",
+    "プロジェクト",
+];
+const typedTargetCues = [
+    "which people",
+    "which person",
+    "which company",
+    "which companies",
+    "which project",
+    "which projects",
+    "which tool",
+    "which tools",
+    "which language",
+    "which languages",
+    "what projects",
+    "what tools",
+    "who are",
+    "哪些人",
+    "哪个公司",
+    "哪些公司",
+    "哪些项目",
+    "哪些項目",
+    "哪些工具",
+    "什么项目",
+    "什麼項目",
+    "どの人",
+    "どの会社",
+    "どのプロジェクト",
+    "どのツール",
+    "どの言語",
+    "誰が",
+];
+const publicCurrentFactCues = [
+    "latest",
+    "current",
+    "today's",
+    "news",
+    "stock price",
+    "weather",
+    "president",
+    "ceo of",
+    "exchange rate",
+    "schedule for",
+    "最新",
+    "新闻",
+    "新聞",
+    "股价",
+    "股價",
+    "天气",
+    "天氣",
+    "总统",
+    "總統",
+    "汇率",
+    "匯率",
+    "ニュース",
+    "株価",
+    "天気",
+    "大統領",
+    "為替",
+];
+const knownMemoryRelations = new Set([
+    "employed_at",
+    "previously_employed_at",
+    "works_on",
+    "affiliated_with",
+    "studied_under",
+    "studied_at",
+    "collaborates_with",
+    "follows_person",
+    "followed_by_person",
+    "commented_on",
+    "knows_about",
+    "has_handle_on",
+    "has_email",
+    "created",
+    "created_by",
+    "maintained_by",
+    "develops",
+    "developed_by_org",
+    "owns",
+    "owned_by",
+    "acquired",
+    "acquired_by",
+    "subsidiary_of",
+    "parent_of",
+    "founded",
+    "founded_by",
+    "invested_in",
+    "received_investment_from",
+    "customer_of",
+    "has_customer",
+    "competes_with",
+    "banking_relationship",
+    "uses",
+    "used_by",
+    "depends_on",
+    "implemented_in",
+    "runs_on",
+    "integrates_with",
+    "supports",
+    "powered_by",
+    "loaded_via",
+    "has_component",
+    "part_of",
+    "has_property",
+    "has_path",
+    "stored_at",
+    "monitors",
+    "targets",
+    "enables",
+    "enabled_by",
+    "generates",
+    "generated_from",
+    "implements",
+    "implemented_by",
+    "excludes",
+    "deleted_from",
+    "published_on",
+    "released",
+    "latest_release_tag",
+    "forked_from",
+    "inspired_by",
+    "succeeds",
+    "preceded_by",
+    "describes",
+    "described_in",
+    "category",
+    "has_alias",
+    "has_url",
+    "located_in",
+    "scheduled_for",
+    "ranked_on",
+    "listed_on",
+    "features_project",
+    "related_to",
+    "other",
+]);
+/** JSON schema for forced tool_use compile_memory_intents (helper providers). */
+export const COMPILE_MEMORY_INTENTS_PARAMETERS = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        should_recall: {
+            type: "boolean",
+            description: "True only when the user is asking about their own private episodic memory.",
+        },
+        gate_reason: {
+            type: "string",
+            description: "One short phrase (under 40 chars) describing the gate decision.",
+        },
+        intents: {
+            type: "array",
+            maxItems: 3,
+            items: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    mode: {
+                        type: "string",
+                        enum: ["direct_relation", "path_query", "typed_neighborhood"],
+                    },
+                    anchor_mentions: {
+                        type: "array",
+                        items: { type: "string" },
+                        minItems: 1,
+                        maxItems: 4,
+                    },
+                    relation_constraints: {
+                        type: "array",
+                        items: { type: "string" },
+                        maxItems: 4,
+                    },
+                    candidate_type: { type: "string" },
+                    scope_filter: {
+                        type: "array",
+                        items: { type: "string" },
+                        maxItems: 4,
+                    },
+                    target_slot: { type: "string", enum: ["head", "tail"] },
+                    time_window: { type: "string" },
+                    evidence_budget: { type: "integer", minimum: 1, maximum: 50 },
+                    result_limit: { type: "integer", minimum: 1, maximum: 100 },
+                },
+                required: ["mode", "anchor_mentions"],
+            },
+        },
+    },
+    required: ["should_recall", "intents"],
+};
+export function detectExactMemoryIntents(query) {
+    const q = query.trim();
+    if (!q)
+        return [];
+    for (const p of exactRelationshipPatterns) {
+        const m = q.match(p.re);
+        if (m && m[p.anchorGroup]) {
+            const anchor = cleanMemoryAnchor(m[p.anchorGroup]);
+            if (anchor)
+                return [defaultDirectMemoryIntent(anchor)];
+        }
+    }
+    return [];
+}
+export function defaultDirectMemoryIntent(anchor) {
+    return {
+        mode: "direct_relation",
+        anchor_mentions: [anchor],
+        evidence_budget: 5,
+        result_limit: 10,
+    };
+}
+export function cleanMemoryAnchor(s) {
+    let t = s.trim();
+    t = t.replace(/^[\s"'""''`.,，。?？!！:：;；()[\]【】]+|[\s"'""''`.,，。?？!！:：;；()[\]【】]+$/g, "");
+    if (t.startsWith("the "))
+        t = t.slice(4);
+    if (t.startsWith("The "))
+        t = t.slice(4);
+    for (const prefix of ["关于", "和", "与", "跟", "to ", "with "]) {
+        if (t.startsWith(prefix))
+            t = t.slice(prefix.length).trim();
+    }
+    if (!t || isPronounAnchor(t) || looksLikeTaskText(t))
+        return "";
+    return t;
+}
+export function isPronounAnchor(s) {
+    switch (s.trim().toLowerCase()) {
+        case "i":
+        case "me":
+        case "my":
+        case "mine":
+        case "myself":
+        case "user":
+        case "the user":
+        case "我":
+        case "我的":
+        case "自己":
+        case "本人":
+        case "私":
+        case "わたし":
+        case "僕":
+        case "俺":
+            return true;
+        default:
+            return false;
+    }
+}
+export function looksLikeTaskText(s) {
+    const lower = s.toLowerCase();
+    if (lower.includes("http://") ||
+        lower.includes("https://") ||
+        lower.includes("\n") ||
+        lower.includes("```")) {
+        return true;
+    }
+    for (const marker of [
+        " fix ",
+        " implement ",
+        " debug ",
+        " code ",
+        " file ",
+        " error ",
+        " stack trace ",
+        "修复",
+        "修改",
+        "实现",
+        "代码",
+        "文件",
+        "錯誤",
+        "错误",
+        "测试",
+        "構建",
+        "构建",
+    ]) {
+        if (lower.includes(marker))
+            return true;
+    }
+    return false;
+}
+function truncateRunes(s, max) {
+    const runes = [...s];
+    if (runes.length <= max)
+        return s;
+    return runes.slice(0, max).join("");
+}
+function containsAny(s, markers) {
+    return markers.some((m) => s.includes(m));
+}
+function hasEntityishSurface(s) {
+    if (latinEntityPattern.test(s))
+        return true;
+    if (/["'""''`「」『』]/.test(s))
+        return true;
+    const hasCJKOrKana = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}]/u.test(s);
+    return hasCJKOrKana && [...s].length <= 80;
+}
+export function looksMemoryRelevant(query) {
+    const lower = query.toLowerCase();
+    const hasMemoryCue = containsAny(lower, privateMemoryCues);
+    const hasRelationCue = containsAny(lower, relationQuestionCues);
+    const hasTypedTarget = containsAny(lower, typedTargetCues);
+    const hasEntity = hasEntityishSurface(query);
+    if (!(hasMemoryCue || hasRelationCue || hasTypedTarget || hasEntity))
+        return false;
+    if (containsAny(lower, publicCurrentFactCues) && !hasMemoryCue)
+        return false;
+    return true;
+}
+function isBroadMemoryRelation(rel) {
+    return rel === "related_to" || rel === "other";
+}
+function isSnakeRelation(rel) {
+    let base = rel.replace(/^\^/, "").replace(/\^-1$/, "");
+    if (!base)
+        return false;
+    return /^[a-z0-9_]+$/.test(base);
+}
+function isKnownMemoryRelation(rel) {
+    const base = rel.replace(/^\^/, "").replace(/\^-1$/, "");
+    return knownMemoryRelations.has(base);
+}
+function cleanAnchorList(inAnchors) {
+    const out = [];
+    const seen = new Set();
+    for (const raw of inAnchors) {
+        const anchor = cleanMemoryAnchor(raw);
+        if (!anchor)
+            continue;
+        const key = anchor.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(anchor);
+    }
+    return out;
+}
+function cleanRelationConstraints(inRels) {
+    const out = [];
+    for (const raw of inRels) {
+        const rel = raw.trim();
+        if (!rel || isBroadMemoryRelation(rel) || !isSnakeRelation(rel) || !isKnownMemoryRelation(rel)) {
+            continue;
+        }
+        out.push(rel);
+    }
+    return out;
+}
+export function sanitizeMemoryIntents(intents) {
+    const out = [];
+    const seen = new Set();
+    for (const raw of intents) {
+        const intent = { ...raw };
+        intent.anchor_mentions = cleanAnchorList(intent.anchor_mentions ?? []);
+        if (intent.anchor_mentions.length === 0)
+            continue;
+        if (!intent.mode)
+            intent.mode = "direct_relation";
+        if (!intent.evidence_budget || intent.evidence_budget <= 0 || intent.evidence_budget > 50) {
+            intent.evidence_budget = 5;
+        }
+        if (!intent.result_limit || intent.result_limit <= 0 || intent.result_limit > 100) {
+            intent.result_limit = 10;
+        }
+        intent.relation_constraints = cleanRelationConstraints(intent.relation_constraints ?? []);
+        switch (intent.mode) {
+            case "direct_relation":
+                break;
+            case "path_query": {
+                const rc = intent.relation_constraints ?? [];
+                if (rc.length < 2 || rc.length > 4)
+                    continue;
+                intent.target_slot = "tail";
+                break;
+            }
+            case "typed_neighborhood": {
+                const ct = intent.candidate_type?.trim();
+                const rc = intent.relation_constraints ?? [];
+                if (!ct || rc.length !== 1)
+                    continue;
+                intent.candidate_type = ct;
+                intent.target_slot = "tail";
+                break;
+            }
+            default:
+                continue;
+        }
+        const key = JSON.stringify(intent);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(intent);
+        if (out.length >= 3)
+            break;
+    }
+    return out;
+}
+/**
+ * Compile user message into QueryIntent values.
+ * Regex fast-path bypasses helper; otherwise helper LLM when provided.
+ */
+export async function detectMemoryIntents(query, helper, options = {}) {
+    const exact = detectExactMemoryIntents(query);
+    if (exact.length > 0)
+        return exact;
+    if (!helper)
+        return [];
+    const helperInput = truncateRunes(query, MEMORY_HELPER_MAX_INPUT_RUNES);
+    const trimmed = helperInput.trim();
+    if (!trimmed || [...trimmed].length > MEMORY_HELPER_MAX_INPUT_RUNES)
+        return [];
+    if (looksLikeTaskText(helperInput))
+        return [];
+    if (!options.forceHelper && !looksMemoryRelevant(helperInput))
+        return [];
+    try {
+        const out = await helper.compileIntents(helperInput, options.signal);
+        if (!out.should_recall)
+            return [];
+        const intents = sanitizeMemoryIntents(out.intents ?? []).slice(0, 3);
+        return intents;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=detectIntents.js.map

package/dist/preflight/detectIntents.js.map

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

package/dist/preflight/hook.d.ts

@@ -0,0 +1,58 @@
+import type { RerankOptions } from "../fallback/llmRerank.js";
+import type { MemoryConfig } from "../config.js";
+import type { FallbackQuery } from "../types.js";
+import type { MemoryService } from "../service.js";
+import type { QueryIntent } from "../types.js";
+import { type DetectIntentsOptions, type MemoryHelperLLM } from "./detectIntents.js";
+export type { MemoryHelperLLM };
+export declare const MEMORY_PREFLIGHT_QUERY_TIMEOUT_MS = 2000;
+export interface MemoryPreflightOptions extends DetectIntentsOptions {
+    helper?: MemoryHelperLLM | null;
+    /** When true, run helper even if lexical gate would skip. */
+    forceHelper?: boolean;
+    /** Fallback query for degraded path when sidecar is not ready. */
+    fallback?: FallbackQuery | null;
+    /** LLM rerank options for fallback search results. */
+    rerankOpts?: RerankOptions | null;
+}
+export interface MemoryPreflightResult {
+    /** Full injected user text (scaffold + private memory + payload), or undefined. */
+    injectedText?: string;
+    /** Raw <private_memory> block when context was returned. */
+    privateContext?: string;
+}
+export interface BeforeTurnInput {
+    /** Scaffolded user message text sent to the model (may include date/CWD scaffolding). */
+    scaffoldedText: string;
+    /** Raw user payload without scaffolding — used for intent detection. */
+    userPayload: string;
+    /** First message in conversation — enables forceHelper gate. */
+    isFirstTurn?: boolean;
+    /** Set when preflight injected context (not for persistence). */
+    privateContext?: string;
+    signal?: AbortSignal;
+}
+export type BeforeTurnHook = (input: BeforeTurnInput) => Promise<BeforeTurnInput>;
+/**
+ * Fail-silent implicit episodic preflight: detect intents → batch query → inject
+ * <private_memory> into the in-flight user message. Never throws.
+ */
+export declare function runMemoryPreflight(query: string, service: MemoryService, options?: MemoryPreflightOptions): Promise<MemoryPreflightResult | null>;
+/**
+ * Pi beforeTurn hook factory — wire into pi-coding-agent turn lifecycle.
+ *
+ * ```ts
+ * const hook = createBeforeTurnHook(service, config, { helper: mySmallModel });
+ * api.onBeforeTurn?.(hook);
+ * ```
+ *
+ * On persist/summary, call `stripPrivateMemory` on user message text so recalled
+ * facts are not written to session history.
+ */
+export declare function createBeforeTurnHook(service: MemoryService, config: MemoryConfig, options?: {
+    helper?: MemoryHelperLLM | null;
+    fallback?: FallbackQuery | null;
+}): BeforeTurnHook;
+/** @internal exported for tests */
+export type { QueryIntent };
+//# sourceMappingURL=hook.d.ts.map