@chendpoc/pi-memory 0.1.0 → 0.1.12

package/README.md

@@ -1,32 +1,29 @@
 # @chendpoc/pi-memory
 
-Pi Agent 本地情景记忆（**模式 B**）— TLM sidecar + `memory_recall` 工具 + **隐式 episodic preflight**。
+[![npm](https://img.shields.io/npm/v/@chendpoc/pi-memory)](https://www.npmjs.com/package/@chendpoc/pi-memory)
 
-与 [Kocoro](https://github.com/Kocoro-lab/Kocoro) 的 TLM 协议对齐：`QueryIntent` → Unix socket `POST /query` → `ResponseEnvelope`。
+Local episodic memory for [Pi](https://pi.dev) coding agent. Automatically recalls past sessions, people, projects, and decisions during conversations.
 
-## 前置条件
+**No external binaries required** --- pure TypeScript, runs entirely inside Pi.
 
-1. **安装 `tlm` sidecar**（与 Kocoro 相同，建议 v0.6.x+）并加入 `PATH`，或配置 `tlmPath` 绝对路径。
-2. **准备本地 bundle**（自行训练或从测试环境拷贝）：
+## Features
 
-```text
-~/.pi/memory/
-├── current  →  bundles/2026-06-01T00-00-00Z   # symlink
-└── bundles/
-    └── 2026-06-01T00-00-00Z/
-        ├── manifest.json
-        └── …
-```
-
-`current` 目录下必须有可解析的 `manifest.json`（与 Kocoro `currentBundleReadable` 一致）。
+- **Implicit memory preflight** --- automatically detects memory-relevant questions (Chinese/English/Japanese) and injects `<private_memory>` context before each LLM call
+- **`memory_recall` tool** --- LLM can explicitly query the knowledge graph by entity/relationship
+- **`memory_append` tool** --- persist user preferences and facts to `MEMORY.md`
+- **Local trainer** --- extracts entities, relations, and events from Pi session history (regex or LLM-powered)
+- **FTS5 search** --- SQLite full-text index for keyword fallback
+- **LLM rerank** --- reranks keyword search results using `deepseek-v4-flash` for relevance scoring
+- **Session dedup** --- content-hash deduplication in both trainer and indexer
+- **Zero config** --- works out of the box with `pi install`
 
-3. （可选）`~/.pi/MEMORY.md` — sidecar 不可用时的 fallback 关键词匹配；`~/.pi/sessions/*.json` — session 关键词 fallback。
+## Install
 
-## 安装
-
-### 作为 Pi package（推荐）
+```bash
+pi install npm:@chendpoc/pi-memory
+```
 
-本地开发（settings 相对路径）：
+Or for local development:
 
 ```json
 {
@@ -34,147 +31,195 @@ Pi Agent 本地情景记忆（**模式 B**）— TLM sidecar + `memory_recall`
 }
 ```
 
-或发布后：
+Pi reads `package.json` > `pi.extensions` and auto-loads the extension via [jiti](https://github.com/unjs/jiti) (TypeScript, no build step needed).
+
+## Quick Start
 
 ```bash
+# 1. Install the package
 pi install npm:@chendpoc/pi-memory
-```
-
-`package.json` 中已声明 `pi.extensions`，Pi 会自动加载 `src/pi-extension.ts`。
 
-### 构建 CLI / 库
+# 2. Train a memory bundle from your session history
+npx pi-memory train --full
 
-```bash
-cd agent/extensions/pi-memory
-npm install
-npm run build
+# 3. Restart Pi --- memory is now active
+# Try asking: "What projects have I worked on?"
 ```
 
-## CLI 手动测试
+After training, Pi will:
+- Show `status: ready, mode: local_graph` when you type `/memory`
+- Automatically inject past context when you ask relationship questions
+- Let the LLM call `memory_recall` for explicit lookups
 
-```bash
-# 检查 sidecar 健康（会尝试 spawn tlm）
-npx pi-memory health
-
-# 结构化查询
-npx pi-memory query '{"mode":"direct_relation","anchor_mentions":["Alice"]}'
+## How It Works
 
-# 安装本地 bundle（staging → bundles/<ts> → current symlink，sidecar 在跑时会 /bundle/reload）
-npx pi-memory install-bundle ./path/to/bundle-dir
+```
+Pi session files (.jsonl)
+    |
+    v
+Trainer (regex or LLM extraction)
+    |
+    v
+graph.json bundle (entities + relations + events)
+    |
+    v
+LocalGraphQuerier (in-memory graph query)
+    |
+    v
+memory_recall tool / implicit preflight injection
 ```
 
-## 在 Pi Agent 中启用
-
-本包已对接 `@earendil-works/pi-coding-agent` 的 `ExtensionAPI`：
+### Query Backends
 
-| 旧 stub API | Pi 真实 API |
-|-------------|-------------|
-| factory 内 `service.start()` | `session_start` |
-| `onUnload` | `session_shutdown` |
-| `registerTool` | `pi.registerTool`（TypeBox 参数） |
-| `onBeforeTurn` | `context` 事件（LLM 调用前注入，不写入 session） |
+The service automatically selects the best available backend:
 
-扩展加载后：
+| Priority | Backend | Requires |
+|----------|---------|----------|
+| 1 | **LocalGraphQuerier** (in-process) | bundle only |
+| 2 | **FTS5 + keyword fallback** | `better-sqlite3` (optional) |
 
-1. **`session_start`** — `MemoryService.start()` spawn `tlm serve`
-2. 注册 **`memory_recall`** 工具（sidecar 不可用时 fallback 到 session JSON + MEMORY.md）
-3. 注册 **`memory_append`** 工具（追加 `~/.pi/MEMORY.md`）
-4. **`context` 事件** — 隐式 preflight，注入 `<private_memory>` 到当次 LLM 请求的 messages 副本
+The default backend is LocalGraphQuerier --- pure TypeScript, no external dependencies.
 
-Helper 小模型通过 `@earendil-works/pi-ai/compat` 的 `complete()` 调用，默认 `deepseek/deepseek-v4-flash`：
+## Commands
 
-```bash
-pi --memory-helper-model deepseek/deepseek-v4-flash
-```
+| Command | Description |
+|---------|-------------|
+| `/memory` | Show service status, query mode, and bundle info |
 
-### Pi 命令
+## CLI
 
-- `/memory` — 显示 sidecar 状态、reason 与 health 摘要
+```bash
+# Train a bundle from session history
+npx pi-memory train --full                    # full rebuild
+npx pi-memory train                           # incremental (only new sessions)
+npx pi-memory train --extractor llm           # use LLM for deeper extraction
+npx pi-memory train --extractor llm --model deepseek/deepseek-v4-flash
 
-也可程序化 import：
+# Query the knowledge graph
+npx pi-memory query '{"mode":"direct_relation","anchor_mentions":["Alice"]}'
 
-```typescript
-import piMemory from "@chendpoc/pi-memory/extension";
-export default piMemory;
-```
+# Service diagnostics
+npx pi-memory health
+npx pi-memory status
 
-**持久化：** `context` 事件修改的是 messages 深拷贝，`<private_memory>` 不会写入 session JSON，无需额外 `stripPrivateMemory`。
+# Manage bundles
+npx pi-memory install-bundle ./path/to/bundle
 
-## 隐式 Episodic Preflight
+# Rebuild FTS5 search index
+npx pi-memory index
 
-在每轮 LLM 调用**之前**，通过 `context` 事件检测是否需要召回私人情景记忆，并将结果注入 `<private_memory>` 块。
+# Continuous training (watch mode)
+npx pi-memory train --watch
+```
 
-### 工作流程
+## Flags
 
-1. **Intent 检测** — 中/英/日关系问句正则快路径；可选 `MemoryHelperLLM`（`compile_memory_intents` forced tool_use，由 `complete()` 驱动）。
-2. **批量查询** — 对最多 3 个 intent 并发调用 sidecar，`2s` 超时，失败静默跳过。
-3. **渲染** — 组装 `<private_memory>` 正文，**8192 字节**上限。
-4. **注入** — 通过 `context` 事件写回最后一条 user message。
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--memory-helper-model` | LLM model for intent detection and rerank | `deepseek/deepseek-v4-flash` |
 
-### Helper LLM（Pi 集成）
+```bash
+pi --memory-helper-model deepseek/deepseek-v4-flash
+```
 
-```typescript
-import { resolveMemoryHelperLLM } from "@chendpoc/pi-memory";
+## Data Layout
 
-// 在 extension 的 context handler 中：
-const helper = await resolveMemoryHelperLLM(ctx, pi.getFlag("memory-helper-model"));
+```
+~/.pi/
+├── memory/
+│   ├── current/              # active bundle (symlink)
+│   │   ├── manifest.json
+│   │   └── graph.json        # entities, edges, events
+│   ├── bundles/              # historical bundles
+│   ├── sessions.db           # FTS5 search index
+│   └── .train_marker         # incremental training timestamp
+├── agent/sessions/           # Pi session files (.jsonl)
+└── MEMORY.md                 # persistent notes (memory_append target)
 ```
 
-`helper` 为 `null` 时仅走正则快路径（fail-silent）。
+## Programmatic API
 
-## 架构
+```typescript
+import {
+  MemoryService,
+  defaultMemoryConfig,
+  trainBundle,
+  LocalGraphQuerier,
+  createLLMFactExtractor,
+  createStandaloneLLMClient,
+  rerankWithLLM,
+} from "@chendpoc/pi-memory";
+
+// --- Query the graph directly ---
+const querier = new LocalGraphQuerier("/Users/you/.pi/memory");
+querier.load();
+const result = querier.query({
+  mode: "direct_relation",
+  anchor_mentions: ["Alice"],
+});
 
-| 模块 | 作用 |
-|------|------|
-| `src/pi-extension.ts` | Pi ExtensionAPI 入口 |
-| `src/adapters/piComplete.ts` | `complete()` 适配（helper + trainer LLM） |
-| `SidecarProcess` | spawn / waitReady / stop |
-| `SidecarClient` | `/health`, `/query`, `/bundle/reload` |
-| `MemoryService` | 本地模式生命周期 + query / queryBatch |
-| `MemoryRecallTool` | Agent 工具 + session/MEMORY.md fallback |
-| `memory_append` | 追加 MEMORY.md |
-| `preflight/*` | 隐式 preflight detect → query → render → inject/strip |
-| `bundle/install` | `install-bundle` CLI |
+// --- Train a bundle ---
+const result = await trainBundle({
+  sessionsDir: "~/.pi/agent/sessions",
+  bundleRoot: "~/.pi/memory",
+  full: true,
+});
 
-## LLM 深度提取（Trainer）
+// --- Train with LLM extraction ---
+const client = createStandaloneLLMClient("deepseek/deepseek-v4-flash");
+const extractor = createLLMFactExtractor({ client, batchSize: 10 });
+await trainBundle({ extractOpts: { llmExtractor: extractor } });
 
-使用 `@earendil-works/pi-ai/compat` 的 `complete()`，不绑定具体 LLM 厂商：
+// --- Use as Pi extension ---
+import piMemory from "@chendpoc/pi-memory/extension";
+export default piMemory;
+```
 
-```typescript
-import { createLLMFactExtractor, createStandaloneLLMClient, trainBundle } from "@chendpoc/pi-memory";
+## Architecture
 
-const extractor = createLLMFactExtractor({
-  client: createStandaloneLLMClient("deepseek/deepseek-v4-flash"),
-  batchSize: 10,
-});
-```
+| Module | Purpose |
+|--------|---------|
+| `src/pi-extension.ts` | Pi ExtensionAPI entry point |
+| `src/local/graphQuery.ts` | In-process graph query engine |
+| `src/adapters/piComplete.ts` | LLM adapter via `@earendil-works/pi-ai/compat` |
+| `src/service.ts` | Service lifecycle and query routing |
+| `src/trainer/` | Session loader, fact extraction, entity resolution, bundle builder |
+| `src/fallback/` | FTS5 index, keyword search, LLM rerank |
+| `src/preflight/` | Intent detection, private memory render/inject/strip |
+| `src/tools/` | `memory_recall` and `memory_append` tool definitions |
 
-CLI：
+## Implicit Preflight
 
-```bash
-pi-memory train --extractor llm
-pi-memory train --extractor llm --model deepseek/deepseek-v4-flash
-pi-memory train --extractor regex
-```
+On every LLM call, the `context` event:
 
-需配置对应 provider 的环境变量（如 `DEEPSEEK_API_KEY`）。LLM 不可用时 CLI 自动回退 regex。
+1. Detects memory-relevant intents via regex (Chinese/English/Japanese relationship patterns)
+2. Optionally calls a helper LLM (`compile_memory_intents` forced tool_use)
+3. Queries the graph for matching entities/relations
+4. Injects a `<private_memory>` block into the user message (deep copy, not persisted to session)
+5. Results are cached per agent loop to avoid redundant queries during multi-tool turns
 
-## peerDependencies
+## Peer Dependencies
 
-Pi 核心包由 host 提供，列在 `peerDependencies` 中，勿 bundle：
+These are provided by the Pi host and should not be bundled:
 
+- `@earendil-works/pi-agent-core`
 - `@earendil-works/pi-ai`
 - `@earendil-works/pi-coding-agent`
 - `typebox`
 
-## 开发
+## Optional Dependencies
+
+- `better-sqlite3` --- enables FTS5 session search index (graceful degradation if absent)
+
+## Development
 
 ```bash
-npm test
-npm run typecheck
+npm install
 npm run build
+npm test          # 129 tests
+npm run typecheck
 ```
 
-## 许可
+## License
 
 MIT

package/dist/adapters/ollamaClient.d.ts

@@ -0,0 +1,11 @@
+import type { LLMClient } from "../trainer/llmExtractor.js";
+import type { MemoryHelperLLM } from "../preflight/detectIntents.js";
+export interface OllamaConfig {
+    baseUrl: string;
+    model: string;
+}
+export declare const DEFAULT_OLLAMA_CONFIG: OllamaConfig;
+export declare function ollamaHealthCheck(baseUrl: string): Promise<boolean>;
+export declare function createOllamaLLMClient(cfg: OllamaConfig): LLMClient;
+export declare function createOllamaMemoryHelper(cfg: OllamaConfig): MemoryHelperLLM;
+//# sourceMappingURL=ollamaClient.d.ts.map

package/dist/adapters/ollamaClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollamaClient.d.ts","sourceRoot":"","sources":["../../src/adapters/ollamaClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAOrE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,qBAAqB,EAAE,YAGnC,CAAC;AAiFF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAezE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,CAgBlE;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,YAAY,GAAG,eAAe,CA2C3E"}

package/dist/adapters/ollamaClient.js

@@ -0,0 +1,122 @@
+import http from "node:http";
+import https from "node:https";
+import { COMPILE_MEMORY_INTENTS_PARAMETERS, MEMORY_HELPER_TOOL_NAME, } from "../preflight/detectIntents.js";
+export const DEFAULT_OLLAMA_CONFIG = {
+    baseUrl: "http://localhost:11434",
+    model: "qwen3:8b",
+};
+async function ollamaRequest(baseUrl, path, body) {
+    const url = new URL(path, baseUrl);
+    const mod = url.protocol === "https:" ? https : http;
+    const payload = JSON.stringify(body);
+    return new Promise((resolve, reject) => {
+        const req = mod.request(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(payload),
+            },
+            timeout: 60_000,
+        }, (res) => {
+            const chunks = [];
+            res.on("data", (c) => chunks.push(c));
+            res.on("end", () => {
+                const text = Buffer.concat(chunks).toString("utf8");
+                try {
+                    resolve(JSON.parse(text));
+                }
+                catch {
+                    reject(new Error(`Ollama: invalid JSON response: ${text.slice(0, 200)}`));
+                }
+            });
+        });
+        req.on("error", (err) => reject(new Error(`Ollama: ${err.message}`)));
+        req.on("timeout", () => {
+            req.destroy();
+            reject(new Error("Ollama: request timeout"));
+        });
+        req.write(payload);
+        req.end();
+    });
+}
+export async function ollamaHealthCheck(baseUrl) {
+    try {
+        const url = new URL("/api/tags", baseUrl);
+        const mod = url.protocol === "https:" ? https : http;
+        return new Promise((resolve) => {
+            const req = mod.get(url, { timeout: 3_000 }, (res) => {
+                res.resume();
+                resolve(res.statusCode === 200);
+            });
+            req.on("error", () => resolve(false));
+            req.on("timeout", () => { req.destroy(); resolve(false); });
+        });
+    }
+    catch {
+        return false;
+    }
+}
+export function createOllamaLLMClient(cfg) {
+    return {
+        async complete(prompt) {
+            const body = {
+                model: cfg.model,
+                messages: [{ role: "user", content: prompt }],
+                stream: false,
+                options: { num_predict: 8192 },
+            };
+            const resp = await ollamaRequest(cfg.baseUrl, "/api/chat", body);
+            if (resp.error)
+                throw new Error(`Ollama: ${resp.error}`);
+            const text = resp.message?.content?.trim();
+            if (!text)
+                throw new Error("Ollama: empty response");
+            return text;
+        },
+    };
+}
+export function createOllamaMemoryHelper(cfg) {
+    return {
+        async compileIntents(text) {
+            const body = {
+                model: cfg.model,
+                messages: [
+                    {
+                        role: "user",
+                        content: `Analyze whether the user message requires recalling private episodic memory.\n\n<message>\n${text}\n</message>`,
+                    },
+                ],
+                stream: false,
+                tools: [
+                    {
+                        type: "function",
+                        function: {
+                            name: MEMORY_HELPER_TOOL_NAME,
+                            description: "Decide whether to recall private episodic memory and compile structured query intents.",
+                            parameters: COMPILE_MEMORY_INTENTS_PARAMETERS,
+                        },
+                    },
+                ],
+                options: { num_predict: 2048 },
+            };
+            const resp = await ollamaRequest(cfg.baseUrl, "/api/chat", body);
+            if (resp.error)
+                throw new Error(`Ollama: ${resp.error}`);
+            const toolCall = resp.message?.tool_calls?.[0]?.function;
+            if (toolCall?.name === MEMORY_HELPER_TOOL_NAME && toolCall.arguments) {
+                return toolCall.arguments;
+            }
+            const raw = resp.message?.content?.trim();
+            if (!raw)
+                return { should_recall: false, intents: [] };
+            try {
+                const cleaned = raw.replace(/^```(?:json)?\s*/m, "").replace(/\s*```\s*$/m, "").trim();
+                return JSON.parse(cleaned);
+            }
+            catch {
+                return { should_recall: false, intents: [] };
+            }
+        },
+    };
+}
+//# sourceMappingURL=ollamaClient.js.map

package/dist/adapters/ollamaClient.js.map

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

package/dist/adapters/openaiCompatClient.d.ts

@@ -0,0 +1,11 @@
+import type { LLMClient } from "../trainer/llmExtractor.js";
+import type { MemoryHelperLLM } from "../preflight/detectIntents.js";
+export interface OpenAICompatConfig {
+    baseUrl: string;
+    model: string;
+    apiKey?: string;
+}
+export declare function openaiCompatHealthCheck(baseUrl: string): Promise<boolean>;
+export declare function createOpenAICompatLLMClient(cfg: OpenAICompatConfig): LLMClient;
+export declare function createOpenAICompatMemoryHelper(cfg: OpenAICompatConfig): MemoryHelperLLM;
+//# sourceMappingURL=openaiCompatClient.d.ts.map

package/dist/adapters/openaiCompatClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiCompatClient.d.ts","sourceRoot":"","sources":["../../src/adapters/openaiCompatClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAOrE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyDD,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAe/E;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,CAgB9E;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,kBAAkB,GAAG,eAAe,CA+CvF"}

package/dist/adapters/openaiCompatClient.js

@@ -0,0 +1,118 @@
+import http from "node:http";
+import https from "node:https";
+import { COMPILE_MEMORY_INTENTS_PARAMETERS, MEMORY_HELPER_TOOL_NAME, } from "../preflight/detectIntents.js";
+async function postJSON(url, body, apiKey) {
+    const mod = url.protocol === "https:" ? https : http;
+    const payload = JSON.stringify(body);
+    return new Promise((resolve, reject) => {
+        const headers = {
+            "Content-Type": "application/json",
+            "Content-Length": String(Buffer.byteLength(payload)),
+        };
+        if (apiKey)
+            headers["Authorization"] = `Bearer ${apiKey}`;
+        const req = mod.request(url, { method: "POST", headers, timeout: 120_000 }, (res) => {
+            const chunks = [];
+            res.on("data", (c) => chunks.push(c));
+            res.on("end", () => {
+                const text = Buffer.concat(chunks).toString("utf8");
+                try {
+                    resolve(JSON.parse(text));
+                }
+                catch {
+                    reject(new Error(`OpenAI-compat: invalid JSON: ${text.slice(0, 200)}`));
+                }
+            });
+        });
+        req.on("error", (err) => reject(new Error(`OpenAI-compat: ${err.message}`)));
+        req.on("timeout", () => { req.destroy(); reject(new Error("OpenAI-compat: timeout")); });
+        req.write(payload);
+        req.end();
+    });
+}
+export async function openaiCompatHealthCheck(baseUrl) {
+    try {
+        const url = new URL("/v1/models", baseUrl);
+        const mod = url.protocol === "https:" ? https : http;
+        return new Promise((resolve) => {
+            const req = mod.get(url, { timeout: 3_000 }, (res) => {
+                res.resume();
+                resolve(res.statusCode === 200);
+            });
+            req.on("error", () => resolve(false));
+            req.on("timeout", () => { req.destroy(); resolve(false); });
+        });
+    }
+    catch {
+        return false;
+    }
+}
+export function createOpenAICompatLLMClient(cfg) {
+    return {
+        async complete(prompt) {
+            const url = new URL("/v1/chat/completions", cfg.baseUrl);
+            const body = {
+                model: cfg.model,
+                messages: [{ role: "user", content: prompt }],
+                max_tokens: 8192,
+            };
+            const resp = await postJSON(url, body, cfg.apiKey);
+            if (resp.error?.message)
+                throw new Error(`OpenAI-compat: ${resp.error.message}`);
+            const text = resp.choices?.[0]?.message?.content?.trim();
+            if (!text)
+                throw new Error("OpenAI-compat: empty response");
+            return text;
+        },
+    };
+}
+export function createOpenAICompatMemoryHelper(cfg) {
+    return {
+        async compileIntents(text) {
+            const url = new URL("/v1/chat/completions", cfg.baseUrl);
+            const body = {
+                model: cfg.model,
+                messages: [
+                    {
+                        role: "user",
+                        content: `Analyze whether the user message requires recalling private episodic memory.\n\n<message>\n${text}\n</message>`,
+                    },
+                ],
+                max_tokens: 2048,
+                tools: [
+                    {
+                        type: "function",
+                        function: {
+                            name: MEMORY_HELPER_TOOL_NAME,
+                            description: "Decide whether to recall private episodic memory and compile structured query intents.",
+                            parameters: COMPILE_MEMORY_INTENTS_PARAMETERS,
+                        },
+                    },
+                ],
+                tool_choice: { type: "function", function: { name: MEMORY_HELPER_TOOL_NAME } },
+            };
+            const resp = await postJSON(url, body, cfg.apiKey);
+            if (resp.error?.message)
+                throw new Error(`OpenAI-compat: ${resp.error.message}`);
+            const msg = resp.choices?.[0]?.message;
+            const toolCall = msg?.tool_calls?.[0]?.function;
+            if (toolCall?.name === MEMORY_HELPER_TOOL_NAME && toolCall.arguments) {
+                try {
+                    return JSON.parse(toolCall.arguments);
+                }
+                catch { /* fall through */ }
+            }
+            const raw = msg?.content?.trim();
+            if (!raw)
+                return { should_recall: false, intents: [] };
+            try {
+                const cleaned = raw.replace(/^```(?:json)?\s*/m, "").replace(/\s*```\s*$/m, "").trim();
+                return JSON.parse(cleaned);
+            }
+            catch {
+                return { should_recall: false, intents: [] };
+            }
+        },
+    };
+}
+//# sourceMappingURL=openaiCompatClient.js.map

package/dist/adapters/openaiCompatClient.js.map

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

package/dist/cli.js

@@ -3,7 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { createStandaloneLLMClient } from "./adapters/piComplete.js";
 import { installBundle } from "./bundle/install.js";
-import { defaultMemoryConfig } from "./config.js";
+import { loadMemoryConfig } from "./settings.js";
 import { openSessionIndex } from "./fallback/sessionIndex.js";
 import { SidecarClient } from "./sidecar/client.js";
 import { MemoryService } from "./service.js";
@@ -31,7 +31,7 @@ async function main() {
         printHelp();
         process.exit(0);
     }
-    const cfg = defaultMemoryConfig();
+    const cfg = loadMemoryConfig();
     const service = new MemoryService(cfg);
     if (cmd === "health") {
         await service.start();