@chendpoc/pi-memory 0.2.0 → 0.2.2

package/README.md

@@ -1,105 +1,394 @@
-# pi-memory
+<p align="center">
+  <img src="./assets/pi-memory-logo.png" alt="pi-memory logo" width="720" />
+</p>
 
-Cross-session episodic memory for the [Pi coding agent](https://pi.dev): **MEMORY.md** as ground truth, a JSONL Sidecar for vector retrieval, and Preflight injection before each user turn.
+# @chendpoc/pi-memory
 
-## Architecture
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="doc/README-zh.md">简体中文</a>
+</p>
 
-| Layer | Role |
-|-------|------|
-| **Ground Truth** | `MEMORY.md` + `auto-*.md` overflow files |
-| **Vector Index** | `memory.vec.sqlite` (derived; cosine scan + MMR; default top-3, min relevance 0.4) |
-| **Sidecar** | Separate Node process over UDS JSONL (`query`, `reindex`, `ping`) |
-| **Preflight** | QueryIntent → Sidecar → Fallback to MEMORY.md → silent empty inject |
+Cross-session episodic memory for the [Pi coding agent](https://pi.dev).
 
-### Write paths
+`pi-memory` gives Pi a local, auditable memory layer across sessions. It keeps durable facts in **`MEMORY.md` as the source of truth**, derives a vector index in `memory.vec.sqlite`, and injects relevant private context through Preflight before the main model answers.
 
-1. **`/remember`** — sync user-authored append
-2. **Compaction** — dual-purpose summary → `appendFromCompaction` (Compact Delta for subagents)
-3. **Consolidate** — OR trigger (overflow ≥12 / 7 days / daily 03:00 cron)
+## 🧠 What It Does
 
-**Diagnostics:** **`/memory-status`** in session, or **`pi-memory status`** on the CLI.
+Pi already has compaction for long sessions. That solves "this conversation is too long"; it does not solve "a new session forgot my preferences, project conventions, prior decisions, and unresolved todos."
 
-**Shutdown Queue** — `session_shutdown` appends metadata to `.memory_shutdown_queue.jsonl`; **`pi-memory maintenance`** (or `drain-shutdown-queue`) ingests missed facts offline.
+`pi-memory` fills that gap:
 
-### Data directory
+```text
+durable facts -> MEMORY.md -> derived vector index -> per-turn Preflight recall
+```
 
-All memory artifacts share one root directory (the **memory agent dir**):
+It provides:
 
-| File | Purpose |
-|------|---------|
-| `MEMORY.md` | Ground truth |
-| `auto-*.md` | Overflow entries |
-| `memory.vec.sqlite` | Vector index (derived) |
-| `memory.sock` | Sidecar UDS |
+- ✍️ **Explicit memory** through `/remember`.
+- 🔁 **Automatic durable fact export** from Pi compaction.
+- 📥 **Shutdown queue recovery** for short or missed sessions.
+- 🔦 **Per-turn private recall** before the main model runs.
+- 📄 **Human-editable storage** in Markdown, with vector search as a rebuildable index.
+- 🔌 **Local UDS sidecar** for vector retrieval and reindexing, without opening an HTTP port.
+- ⏳ **Daemon-friendly maintenance**: shutdown enqueues metadata, while consolidation and queue draining can run offline.
 
-Resolution order (extension and CLI):
+## 📦 Installation
 
-1. `--agent-dir` / `PI_MEMORY_AGENT_DIR` — explicit override
-2. Default — `~/.pi/pi-memory-data` (no env required)
+Requirements:
 
-### MEMORY.md format
+- Node.js `>=24 <25`
+- pnpm
+- Pi extension runtime packages supplied by Pi
 
-Canonical scaffold (`templates/MEMORY.md.example`):
+Install from Pi:
 
-- Title `# Memory` + HTML comment describing entry format
-- Four sections: **Preferences**, **Conventions**, **Findings**, **Todos**
-- Entries: `- [user] note <!-- id:... user ts:... -->` (via `/remember`) or `- note <!-- id:... ts:... -->`
-- 150-line cap; overflow spills to `auto-*.md`
+```bash
+pi install npm:@chendpoc/pi-memory
+```
 
-**Initialization** (never overwrites a non-empty file):
+For local development from this repository:
 
-1. `pnpm install` → `postinstall` seeds `MEMORY.md` in the memory agent dir
-2. First Pi session → `MemoryStore.ensureInitialized()` on `session_start`
-3. Manual: `pi-memory init`
+```bash
+pnpm install
+pnpm build
+pnpm typecheck
+pnpm test
+```
 
-## Setup
+Enable the extension through Pi's extension loading mechanism. This package declares:
+
+```json
+{
+  "pi": {
+    "extensions": ["./src/pi-extension.ts"]
+  }
+}
+```
 
-1. Install dependencies and build:
+### 🌱 Memory workspace (automatic)
+
+You usually **do not need to run `pi-memory init` manually**. The same bootstrap (`initializeMemoryWorkspace`) runs automatically and **never overwrites a non-empty `MEMORY.md`**:
+
+| When | What happens |
+| --- | --- |
+| **`pnpm install`** | `postinstall` runs `pi-memory init` (or a pre-build fallback) |
+| **First Pi session** | `session_start` → `MemoryStore.ensureInitialized()` |
+| **Manual (optional)** | `pi-memory init` |
+
+Run `pi-memory init` explicitly only when:
+
+- You set **`PI_MEMORY_AGENT_DIR`** after install (postinstall may have seeded the default path).
+- Install scripts were skipped (`--ignore-scripts` or corporate policy).
+- You want to bootstrap before opening Pi, or verify setup with `pi-memory status`.
 
 ```bash
-pnpm install
-pnpm build
+pi-memory init   # optional; see above
+```
+
+## ✨ Why Choose `pi-memory`
+
+### 🔄 Agent Before / After
+
+| Situation | Without `pi-memory` | With `pi-memory` |
+| --- | --- | --- |
+| New session asks "continue the plan from last time" | Agent has to ask for context or guess from the current repo. | Preflight recalls matching `MEMORY.md` facts and injects private reference context. |
+| User says "remember that this repo uses Vitest" | The fact may stay only in the current session summary. | `/remember` writes a `[user]` entry that consolidate must preserve. |
+| Long session compacts | Compaction helps continue that session but does not create durable cross-session facts. | One dual-purpose compact summary keeps session context and exports durable facts. |
+| Subagent is spawned | It may over-recall or duplicate the parent session's memory writes. | Subagents get Memory Cap only and write Compact Delta facts. |
+| Vector sidecar is down | A hard dependency would break the turn. | Preflight silently falls back to Markdown or injects nothing; the model still runs. |
+| Memory grows | A file can become noisy and unbounded. | 150-line `MEMORY.md` cap, `auto-*.md` overflow, consolidate merge/dedupe. |
+
+### 🌟 Key Advantages
+
+- 📓 **Markdown Ground Truth**: `MEMORY.md` and `auto-*.md` can be opened, reviewed, edited, grepped, copied, or versioned.
+- 🏗️ **Derived index, not hidden state**: `memory.vec.sqlite` can be deleted and rebuilt from Markdown.
+- 🔎 **Preflight recall**: Memory is injected before the main model answers instead of hoping the model calls a search tool.
+- ⏱️ **Hot-path budget**: Default Preflight budget is **800ms**, with QueryIntent, sidecar query, and fallback all bounded.
+- 🔒 **Protected user notes**: `/remember` writes `[user]` entries that consolidate must not remove or rewrite.
+- 🔗 **UDS, not HTTP**: the agent talks to the sidecar over `node:net` Unix domain sockets with JSONL frames, so there is no local HTTP server or port to secure.
+- 🏭 **Sidecar process isolation**: embedding, vector scan, MMR, stats, and reindex run in a spawned Node process, while writes stay owned by `MemoryStore`.
+- 💤 **Daemon-safe writes**: `session_shutdown` only appends metadata; heavier consolidation and shutdown-queue draining are intended for `pi-memory maintenance` or background scheduling.
+- 👥 **Subagent policy**: root sessions get Memory Cap + Episodic Preflight; subagents get Memory Cap only by default.
+- ☂️ **Graceful fallback**: if sidecar recall is empty, timed out, or unavailable, the turn still runs.
+
+### ⚙️ Runtime Choices
+
+| Choice | Why it matters |
+| --- | --- |
+| `MEMORY.md` as Ground Truth | Durable memory remains inspectable and editable instead of becoming opaque database state. |
+| UDS JSONL over `node:net` | Local IPC stays private to the machine, avoids HTTP ports, and keeps request/response framing simple. |
+| Spawned sidecar process | Vector query/reindex work is isolated from the Pi extension process; failures degrade to Markdown fallback. |
+| Offline `maintenance` job | Consolidation and shutdown-queue draining can run outside the interactive agent turn. |
+| Bounded Preflight | QueryIntent, sidecar query, cache, and fallback all share a tight latency budget. |
+
+### ⚖️ Comparison
+
+`pi-memory` is not trying to be every memory system. The value is a specific Pi-native loop: Markdown ground truth, Preflight injection, sidecar retrieval, compaction export, and offline maintenance.
+
+| System | Strength | Difference From `@chendpoc/pi-memory` |
+| --- | --- | --- |
+| Cursor Rules / OpenCode `AGENTS.md` | Static project instructions, predictable injection. | Mostly user-authored rules; no automatic durable fact extraction or per-turn episodic Preflight. |
+| Claude Code Auto Memory | Agent can write local memory files. | File-based memory, but no sidecar vector recall or Pi compact/shutdown integration. |
+| `pi-hermes-memory` | Rich Pi package with FTS5, failure memory, correction learning, security scanning. | More automated and feature-heavy; no `<private_memory>` Preflight loop or sidecar-derived vector index. |
+| OpenClaw memory-core | Mature file + index design, dreaming, hybrid search, local embeddings. | Broader memory platform; `pi-memory` is narrower and Pi-extension focused. |
+| Mem0 / Zep | Managed memory APIs with hybrid search, graph, temporal modeling. | Stronger retrieval infrastructure, but external service/database oriented and not Markdown-ground-truth first. |
+| Letta | Context engineering with git-backed memory repos and sleep-time compute. | Powerful for autonomous memory management; heavier mental model than Pi's extension lifecycle. |
+| Cognee | Knowledge engine with graph/vector/relational stores and many retrieval modes. | Better for knowledge graphs; overkill for lightweight coding-agent preferences and conventions. |
+
+Where other systems are stronger:
+
+- `pi-hermes-memory`: failure memory, correction detector, tool quirks, secret scanning.
+- OpenClaw: dreaming stages, memory wiki, hybrid FTS/vector search, local embedding providers.
+- Zep/Cognee: temporal graph reasoning and multi-hop graph retrieval.
+- Mem0: hosted multi-tenant memory API.
+- Letta: autonomous context repositories and sleep-time memory work.
+
+## ⚙️ How It Works
+
+### 🏗️ Architecture
+
+```text
+Pi extension process
+  |- session_start
+  |    |- initialize MEMORY.md
+  |    |- start/warm sidecar
+  |    |- reindex derived vector index
+  |    `- preload Memory Cap
+  |
+  |- before_agent_start / context
+  |    `- Preflight recall -> <private_memory> injection
+  |
+  |- /remember
+  |    `- append [user] Memory Entry
+  |
+  |- session_before_compact / session_compact
+  |    `- dual-purpose summary -> Memory Export ingest
+  |
+  |- session_shutdown
+  |    `- append shutdown metadata only
+  |
+  `- consolidate scheduler
+       `- merge/dedupe -> rewrite Ground Truth -> reindex
+
+Sidecar process over UDS JSONL (`node:net`, no HTTP port)
+  |- ping
+  |- stats
+  |- query: embed -> cosine scan -> MMR
+  `- reindex: upsert chunks into memory.vec.sqlite
 ```
 
-2. Enable as a Pi extension (see `package.json` → `pi.extensions`).
+### 🔎 Read Path
+
+Root session:
+
+```text
+Memory Cap from Ground Truth
+  + Episodic Preflight for the current user message
+  -> merged <private_memory>
+```
+
+Subagent session:
+
+```text
+Memory Cap only
+  -> no episodic QueryIntent / sidecar query by default
+```
+
+Fallback chain:
+
+```text
+Sidecar results
+  -> if empty/error/timeout: MEMORY.md fallback
+  -> if empty: no injection
+```
+
+### ✍️ Write Paths
+
+| Path | Trigger | LLM? | Blocking? | Purpose |
+| --- | --- | --- | --- | --- |
+| `/remember` | User command | No | Yes | Explicit durable note |
+| Compaction | `session_before_compact` + `session_compact` | One summary call | Summary blocks; ingest is background | Continue current session and export durable facts |
+| Shutdown Queue | `session_shutdown` + `pi-memory maintenance` | Only offline, when no compaction summary exists | No during shutdown | Recover facts from short or missed sessions |
+| Consolidate | overflow >= 12, 7 days, or daily cron | Optional | Offline/background | Dedupe, merge, prune obsolete todos |
+
+## 💾 Data And Memory Format
+
+All artifacts live under one memory agent directory.
+
+Resolution order:
+
+1. `--agent-dir` CLI flag
+2. `PI_MEMORY_AGENT_DIR`
+3. default `~/.pi/pi-memory-data`
+
+| File | Role |
+| --- | --- |
+| `MEMORY.md` | Ground Truth file |
+| `auto-*.md` | Overflow files after the 150-line cap |
+| `.memory_gc` | Last consolidate timestamp |
+| `.memory_compactions.json` | Compaction idempotency state |
+| `.memory_shutdown_queue.jsonl` | Append-only shutdown metadata |
+| `.memory_shutdown_processed.json` | Drain idempotency state |
+| `memory.vec.sqlite` | Derived Vector Index |
+| `memory.sock` | Sidecar Unix domain socket |
 
-3. Optional: copy [`.env.example`](./.env.example) to `~/.pi/agent/pi-memory.env` and configure embedder / helper LLM.
+Canonical scaffold: [`templates/MEMORY.md.example`](./templates/MEMORY.md.example)
 
-## Environment
+```markdown
+# Memory
 
-| Variable | Purpose |
-|----------|---------|
-| `PI_MEMORY_AGENT_DIR` | Memory data root (see [Data directory](#data-directory)) |
-| `PI_MEMORY_EMBEDDER` | `hash` (default, offline) \| `ollama` \| `openai` |
-| `PI_MEMORY_HELPER_MODEL` | Helper LLM for QueryIntent + consolidate |
-| `PI_MEMORY_PREFLIGHT_BUDGET_MS` | Preflight shared budget (default 800ms: ~240 intent + ~560 sidecar) |
-| `PI_MEMORY_REINDEX_DEBOUNCE_MS` | Debounced reindex after writes |
-| `PI_MEMORY_DEBUG` | `1` enables debug stderr logs (preflight timings) |
+## Preferences
 
-See [`.env.example`](./.env.example) for full list.
+## Conventions
 
-## CLI
+## Findings
+
+## Todos
+```
+
+Entries are single Markdown bullets:
+
+```markdown
+- [user] Prefer pnpm over npm <!-- id:abc123 user ts:2026-07-04T09:00:00.000+08:00 -->
+- Project tests use Vitest <!-- id:def456 ts:2026-07-04T09:05:00.000+08:00 -->
+```
+
+Rules:
+
+- `/remember` writes `[user]` entries.
+- Consolidate must not remove or rewrite `[user]` entries.
+- `MEMORY.md` is capped at 150 lines.
+- Overflow entries spill to `auto-*.md`, with a pointer in `MEMORY.md`.
+- Vector chunks are derived from entries; by default long entries split beyond `PI_MEMORY_CHUNK_MAX_CHARS=512`.
+
+## 🎛️ Configuration
+
+Optional env file locations are loaded in this order:
+
+1. `PI_MEMORY_ENV_FILE`
+2. project `.env`
+3. project `.env.local`
+4. `~/.pi/agent/pi-memory.env`
+
+Common variables:
+
+| Variable | Default | Purpose |
+| --- | --- | --- |
+| `PI_MEMORY_AGENT_DIR` | `~/.pi/pi-memory-data` | Memory data root |
+| `PI_MEMORY_EMBEDDER` | `hash` | `hash`, `ollama`, or `openai` |
+| `PI_MEMORY_HELPER_MODEL` | `deepseek/deepseek-v4-flash` | Helper model spec for QueryIntent and consolidate |
+| `PI_MEMORY_PREFLIGHT_BUDGET_MS` | `800` | Shared Preflight budget, clamped to 250-1500ms |
+| `PI_MEMORY_INTENT_RETRIES` | `0` | Helper LLM retries after the first attempt |
+| `PI_MEMORY_WARM_SIDECAR` | `1` | Warm sidecar at `session_start` |
+| `PI_MEMORY_INTENT_CACHE` | `1` | Cache QueryIntent per session |
+| `PI_MEMORY_REINDEX_DEBOUNCE_MS` | `500` | Debounce sidecar reindex after writes |
+| `PI_MEMORY_TOP_K` | `3` | Vector recall result count |
+| `PI_MEMORY_MMR_LAMBDA` | `0.8` | MMR relevance/diversity balance |
+| `PI_MEMORY_MIN_RELEVANCE` | `0.4` | Minimum cosine similarity |
+| `PI_MEMORY_CHUNK_MAX_CHARS` | `512` | Split long entries for indexing; `0` disables |
+| `PI_MEMORY_DEBUG` | unset | `1` prints debug timing logs |
+
+See [`.env.example`](./.env.example) for the full list.
+
+### 🛰️ Embedders
+
+| Embedder | Use When | Notes |
+| --- | --- | --- |
+| `hash` | Zero-config local development | Offline, deterministic, lower semantic quality |
+| `ollama` | Local semantic embeddings | Uses `PI_MEMORY_OLLAMA_BASE_URL` and `PI_MEMORY_OLLAMA_EMBED_MODEL` |
+| `openai` | Higher-quality cloud embeddings | Requires `PI_MEMORY_OPENAI_API_KEY` or `OPENAI_API_KEY` |
+
+The Vector Index stores embedding provider, model, and dimension metadata. When they change, old chunks are cleared and rebuilt.
+
+## ⌨️ Commands
+
+Inside Pi:
+
+```text
+/remember [section] <content>
+/memory-status [refresh|expand|collapse|hide]
+```
+
+CLI:
 
 ```bash
-pi-memory init
 pi-memory status
 pi-memory maintenance --cron --verbose
 pi-memory consolidate --force --verbose
 pi-memory drain-shutdown-queue --verbose
+pi-memory init   # optional — usually automatic after install + first session
+```
+
+`maintenance` is the recommended scheduler entrypoint:
+
+```text
+consolidate -> drain-shutdown-queue
 ```
 
-`maintenance` runs **consolidate → drain-shutdown-queue** in one cron window (recommended for OS schedulers).  
-`status` prints MEMORY.md, sidecar, and vector index diagnostics (colored on TTY stderr).  
-Set `PI_MEMORY_DEBUG=1` for preflight timing logs during agent sessions.
+Scheduler templates:
+
+- [`templates/com.pi.memory.consolidate.plist.example`](./templates/com.pi.memory.consolidate.plist.example)
+- [`templates/crontab.example`](./templates/crontab.example)
+- [`templates/consolidate.cmd.example`](./templates/consolidate.cmd.example)
+- [`templates/schtasks.example.txt`](./templates/schtasks.example.txt)
+
+## 🩺 Diagnostics
+
+Use `/memory-status` or `pi-memory status` to inspect:
+
+- memory agent directory
+- `MEMORY.md` line count
+- entry count
+- overflow count
+- last consolidate timestamp
+- sidecar socket status
+- vector index generation and chunk count
+- configured embedder
+- index embedder mismatch
+
+Use `PI_MEMORY_DEBUG=1` to log Preflight timings:
+
+```json
+{
+  "phase": "preflight",
+  "event": "recall",
+  "intent_ms": 0,
+  "intent_skipped": true,
+  "intent_cache_hit": false,
+  "sidecar_ms": 42,
+  "cache_hit": true,
+  "total_ms": 45,
+  "fallback": false,
+  "results": 3
+}
+```
+
+## 🚫 Non-Goals
+
+- Replacing Pi compaction.
+- Replacing session search; use a dedicated session-search extension for old conversations.
+- Maintaining a graph database inside this package.
+- Making the sidecar authoritative.
+- Storing full chat transcripts as memory.
+- Adding multi-second reflection to every user turn.
+
+## 🛠️ Development
+
+```bash
+pnpm typecheck
+pnpm test
+pnpm build
+```
 
-Templates: [`templates/`](./templates/) (launchd, crontab, schtasks).
+The sidecar IPC test opens a Unix domain socket. If it fails with `listen EPERM` inside a restricted sandbox, run the test in a normal local shell.
 
-## Docs
+## 📚 Docs
 
-- [sidecar-local-memory-design.md](./sidecar-local-memory-design.md) — full design
-- [kocoro-memory-pi-agent-guide.md](./kocoro-memory-pi-agent-guide.md) — Kocoro → Pi translation
-- [UBIQUITOUS_LANGUAGE.md](./UBIQUITOUS_LANGUAGE.md) — domain glossary
+- [Chinese README](./doc/README-zh.md)
+- [Roadmap](./doc/ROADMAP.md)
+- [UBIQUITOUS_LANGUAGE.md](./UBIQUITOUS_LANGUAGE.md) - domain glossary
 
-## License
+## 📜 License
 
 MIT

package/dist/config/index.d.ts

@@ -2,6 +2,7 @@ export { KNOWN_EMBED_DIMS, readPiMemoryEnv, resolveEmbedDim, type EmbedderProvid
 export { readRetrievalConfig, type RetrievalConfig } from "./retrieval.js";
 export { readChunkingConfig, type ChunkingConfig } from "./chunking.js";
 export { resolvePreflightBudget, type PreflightBudget } from "./preflightBudget.js";
+export { readPreflightRuntimeConfig, type PreflightRuntimeConfig } from "./preflight.js";
 export { resolveAgentDirFromEnv, resolveMemoryAgentDir, type ResolveMemoryAgentDirOptions } from "./agentDir.js";
 export { loadEnv } from "./loadEnv.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACvH,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,eAAe,CAAC;AACjH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACvH,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,eAAe,CAAC;AACjH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/config/index.js

@@ -2,6 +2,7 @@ export { KNOWN_EMBED_DIMS, readPiMemoryEnv, resolveEmbedDim } from "./env.js";
 export { readRetrievalConfig } from "./retrieval.js";
 export { readChunkingConfig } from "./chunking.js";
 export { resolvePreflightBudget } from "./preflightBudget.js";
+export { readPreflightRuntimeConfig } from "./preflight.js";
 export { resolveAgentDirFromEnv, resolveMemoryAgentDir } from "./agentDir.js";
 export { loadEnv } from "./loadEnv.js";
 //# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAA2C,MAAM,UAAU,CAAC;AACvH,OAAO,EAAE,mBAAmB,EAAwB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAuB,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAwB,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAqC,MAAM,eAAe,CAAC;AACjH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAA2C,MAAM,UAAU,CAAC;AACvH,OAAO,EAAE,mBAAmB,EAAwB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAuB,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAwB,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAA+B,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAqC,MAAM,eAAe,CAAC;AACjH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/config/preflight.d.ts

@@ -0,0 +1,8 @@
+export type PreflightRuntimeConfig = {
+    intentRetries: number;
+    warmSidecar: boolean;
+    intentCache: boolean;
+};
+/** Runtime toggles for preflight latency optimizations. */
+export declare function readPreflightRuntimeConfig(env?: NodeJS.ProcessEnv): PreflightRuntimeConfig;
+//# sourceMappingURL=preflight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/config/preflight.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AASF,2DAA2D;AAC3D,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,sBAAsB,CASxB"}

package/dist/config/preflight.js

@@ -0,0 +1,22 @@
+import { ENV_KEYS } from "../constants/env.js";
+import { DEFAULT_INTENT_CACHE_ENABLED, DEFAULT_INTENT_RETRIES, DEFAULT_WARM_SIDECAR_ENABLED, MAX_INTENT_RETRIES, } from "../constants/preflight.js";
+function parseOnOff(value, defaultOn) {
+    if (value === undefined || value.trim() === "")
+        return defaultOn;
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "0" || normalized === "false" || normalized === "no")
+        return false;
+    return true;
+}
+/** Runtime toggles for preflight latency optimizations. */
+export function readPreflightRuntimeConfig(env = process.env) {
+    const retries = Number.parseInt(env[ENV_KEYS.INTENT_RETRIES] ?? String(DEFAULT_INTENT_RETRIES), 10);
+    return {
+        intentRetries: Number.isFinite(retries)
+            ? Math.min(Math.max(0, retries), MAX_INTENT_RETRIES)
+            : DEFAULT_INTENT_RETRIES,
+        warmSidecar: parseOnOff(env[ENV_KEYS.WARM_SIDECAR], DEFAULT_WARM_SIDECAR_ENABLED),
+        intentCache: parseOnOff(env[ENV_KEYS.INTENT_CACHE], DEFAULT_INTENT_CACHE_ENABLED),
+    };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/config/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/config/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAQnC,SAAS,UAAU,CAAC,KAAyB,EAAE,SAAkB;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACjE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,0BAA0B,CACxC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAE,CAAC,CAAC;IACpG,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,CAAC;YACpD,CAAC,CAAC,sBAAsB;QAC1B,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,4BAA4B,CAAC;QACjF,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,4BAA4B,CAAC;KAClF,CAAC;AACJ,CAAC"}

package/dist/constants/env.d.ts

@@ -24,6 +24,9 @@ export declare const ENV_KEYS: {
     readonly MMR_LAMBDA: "PI_MEMORY_MMR_LAMBDA";
     readonly MIN_RELEVANCE: "PI_MEMORY_MIN_RELEVANCE";
     readonly CHUNK_MAX_CHARS: "PI_MEMORY_CHUNK_MAX_CHARS";
+    readonly INTENT_RETRIES: "PI_MEMORY_INTENT_RETRIES";
+    readonly WARM_SIDECAR: "PI_MEMORY_WARM_SIDECAR";
+    readonly INTENT_CACHE: "PI_MEMORY_INTENT_CACHE";
     readonly AGENT_DIR: "PI_MEMORY_AGENT_DIR";
     readonly ENV_FILE: "PI_MEMORY_ENV_FILE";
     readonly DEBUG: "PI_MEMORY_DEBUG";

package/dist/constants/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,sCAAsC;AACtC,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;IAgBnB,oDAAoD;;;;;;;;;;;CAW5C,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,mBAAmB,CAAC;AAE5D,eAAO,MAAM,gBAAgB,EAAE,gBAAyB,CAAC;AACzD,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAClD,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,yBAAyB,+BAAuD,CAAC;AAE9F,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMnD,CAAC;AAEF,eAAO,MAAM,sBAAsB,MAAM,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,sCAAsC;AACtC,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;IAgBnB,oDAAoD;;;;;;;;;;;;;;CAc5C,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,mBAAmB,CAAC;AAE5D,eAAO,MAAM,gBAAgB,EAAE,gBAAyB,CAAC;AACzD,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AACnE,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAClD,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,yBAAyB,+BAAuD,CAAC;AAE9F,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMnD,CAAC;AAEF,eAAO,MAAM,sBAAsB,MAAM,CAAC"}

package/dist/constants/env.js

@@ -23,6 +23,9 @@ export const ENV_KEYS = {
     MMR_LAMBDA: "PI_MEMORY_MMR_LAMBDA",
     MIN_RELEVANCE: "PI_MEMORY_MIN_RELEVANCE",
     CHUNK_MAX_CHARS: "PI_MEMORY_CHUNK_MAX_CHARS",
+    INTENT_RETRIES: "PI_MEMORY_INTENT_RETRIES",
+    WARM_SIDECAR: "PI_MEMORY_WARM_SIDECAR",
+    INTENT_CACHE: "PI_MEMORY_INTENT_CACHE",
     AGENT_DIR: "PI_MEMORY_AGENT_DIR",
     ENV_FILE: "PI_MEMORY_ENV_FILE",
     DEBUG: "PI_MEMORY_DEBUG",

package/dist/constants/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAEA,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,qBAAqB;IAChC,cAAc,EAAE,0BAA0B;IAC1C,kBAAkB,EAAE,8BAA8B;IAClD,eAAe,EAAE,2BAA2B;IAC5C,kBAAkB,EAAE,8BAA8B;IAClD,mBAAmB,EAAE,+BAA+B;IACpD,gBAAgB,EAAE,4BAA4B;IAC9C,YAAY,EAAE,wBAAwB;IACtC,cAAc,EAAE,0BAA0B;IAC1C,sBAAsB,EAAE,kCAAkC;IAC1D,mBAAmB,EAAE,+BAA+B;IACpD,qBAAqB,EAAE,iCAAiC;IACxD,eAAe,EAAE,2BAA2B;IAC5C,mBAAmB,EAAE,+BAA+B;IACpD,oDAAoD;IACpD,oBAAoB,EAAE,gCAAgC;IACtD,mBAAmB,EAAE,+BAA+B;IACpD,uBAAuB,EAAE,mCAAmC;IAC5D,KAAK,EAAE,iBAAiB;IACxB,UAAU,EAAE,sBAAsB;IAClC,aAAa,EAAE,yBAAyB;IACxC,eAAe,EAAE,2BAA2B;IAC5C,SAAS,EAAE,qBAAqB;IAChC,QAAQ,EAAE,oBAAoB;IAC9B,KAAK,EAAE,iBAAiB;CAChB,CAAC;AAEX,mEAAmE;AACnE,MAAM,CAAC,MAAM,2BAA2B,GAAG,gBAAgB,CAAC;AAE5D,MAAM,CAAC,MAAM,gBAAgB,GAAqB,MAAM,CAAC;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,wBAAwB,CAAC;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAE7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,uBAAuB,IAAI,oBAAoB,EAAE,CAAC;AAE9F,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,wBAAwB,EAAE,IAAI;IAC9B,wBAAwB,EAAE,IAAI;IAC9B,kBAAkB,EAAE,GAAG;IACvB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,GAAG;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/constants/env.ts"],"names":[],"mappings":"AAEA,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,qBAAqB;IAChC,cAAc,EAAE,0BAA0B;IAC1C,kBAAkB,EAAE,8BAA8B;IAClD,eAAe,EAAE,2BAA2B;IAC5C,kBAAkB,EAAE,8BAA8B;IAClD,mBAAmB,EAAE,+BAA+B;IACpD,gBAAgB,EAAE,4BAA4B;IAC9C,YAAY,EAAE,wBAAwB;IACtC,cAAc,EAAE,0BAA0B;IAC1C,sBAAsB,EAAE,kCAAkC;IAC1D,mBAAmB,EAAE,+BAA+B;IACpD,qBAAqB,EAAE,iCAAiC;IACxD,eAAe,EAAE,2BAA2B;IAC5C,mBAAmB,EAAE,+BAA+B;IACpD,oDAAoD;IACpD,oBAAoB,EAAE,gCAAgC;IACtD,mBAAmB,EAAE,+BAA+B;IACpD,uBAAuB,EAAE,mCAAmC;IAC5D,KAAK,EAAE,iBAAiB;IACxB,UAAU,EAAE,sBAAsB;IAClC,aAAa,EAAE,yBAAyB;IACxC,eAAe,EAAE,2BAA2B;IAC5C,cAAc,EAAE,0BAA0B;IAC1C,YAAY,EAAE,wBAAwB;IACtC,YAAY,EAAE,wBAAwB;IACtC,SAAS,EAAE,qBAAqB;IAChC,QAAQ,EAAE,oBAAoB;IAC9B,KAAK,EAAE,iBAAiB;CAChB,CAAC;AAEX,mEAAmE;AACnE,MAAM,CAAC,MAAM,2BAA2B,GAAG,gBAAgB,CAAC;AAE5D,MAAM,CAAC,MAAM,gBAAgB,GAAqB,MAAM,CAAC;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,wBAAwB,CAAC;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAE7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,uBAAuB,IAAI,oBAAoB,EAAE,CAAC;AAE9F,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,wBAAwB,EAAE,IAAI;IAC9B,wBAAwB,EAAE,IAAI;IAC9B,kBAAkB,EAAE,GAAG;IACvB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,GAAG;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}

package/dist/constants/preflight.d.ts

@@ -7,4 +7,11 @@ export declare const PRIVATE_MEMORY_CLOSE = "</private_memory>";
 export declare const MEMORY_CUE_RE: RegExp;
 export declare const PREFLIGHT_SKIP_MIN_LENGTH = 12;
 export declare const PREFLIGHT_EXTRACT_MIN_LENGTH = 24;
+/** Helper LLM retries after the first attempt (0 = single try). */
+export declare const DEFAULT_INTENT_RETRIES = 0;
+export declare const MAX_INTENT_RETRIES = 3;
+/** Sidecar warm start + intent LRU defaults. */
+export declare const DEFAULT_WARM_SIDECAR_ENABLED = true;
+export declare const DEFAULT_INTENT_CACHE_ENABLED = true;
+export declare const INTENT_CACHE_MAX_ENTRIES = 128;
 //# sourceMappingURL=preflight.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/constants/preflight.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,4BAA4B,QAAW,CAAC;AAErD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAC7D,eAAO,MAAM,oBAAoB,sBAA6B,CAAC;AAE/D,qEAAqE;AACrE,eAAO,MAAM,aAAa,QACiF,CAAC;AAE5G,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,4BAA4B,KAAK,CAAC"}
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/constants/preflight.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,4BAA4B,QAAW,CAAC;AAErD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAC7D,eAAO,MAAM,oBAAoB,sBAA6B,CAAC;AAE/D,qEAAqE;AACrE,eAAO,MAAM,aAAa,QACiF,CAAC;AAE5G,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,gDAAgD;AAChD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,wBAAwB,MAAM,CAAC"}

package/dist/constants/preflight.js

@@ -7,4 +7,11 @@ export const PRIVATE_MEMORY_CLOSE = `</${PRIVATE_MEMORY_TAG}>`;
 export const MEMORY_CUE_RE = /(?:\b(recent|recently|last time|continue|previous|remember|recall|before|earlier)\b|之前|上次|继续|记得|回忆|刚才)/i;
 export const PREFLIGHT_SKIP_MIN_LENGTH = 12;
 export const PREFLIGHT_EXTRACT_MIN_LENGTH = 24;
+/** Helper LLM retries after the first attempt (0 = single try). */
+export const DEFAULT_INTENT_RETRIES = 0;
+export const MAX_INTENT_RETRIES = 3;
+/** Sidecar warm start + intent LRU defaults. */
+export const DEFAULT_WARM_SIDECAR_ENABLED = true;
+export const DEFAULT_INTENT_CACHE_ENABLED = true;
+export const INTENT_CACHE_MAX_ENTRIES = 128;
 //# sourceMappingURL=preflight.js.map

package/dist/constants/preflight.js.map

@@ -1 +1 @@
-{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/constants/preflight.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,kBAAkB,GAAG,CAAC;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,kBAAkB,GAAG,CAAC;AAE/D,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GACxB,yGAAyG,CAAC;AAE5G,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC"}
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/constants/preflight.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,kBAAkB,GAAG,CAAC;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,kBAAkB,GAAG,CAAC;AAE/D,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GACxB,yGAAyG,CAAC;AAE5G,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C,mEAAmE;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,gDAAgD;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC"}

package/dist/constants/timing.d.ts

@@ -29,6 +29,8 @@ export declare const SIDECAR_FORCE_KILL_DELAY_MS = 5000;
 export declare const SIDECAR_PING_TIMEOUT_MS = 1000;
 export declare const SIDECAR_QUERY_TIMEOUT_MS = 3000;
 export declare const SIDECAR_REINDEX_TIMEOUT_MS = 10000;
+/** Warm start dummy query (session_start; not counted against Preflight budget). */
+export declare const SIDECAR_WARMUP_QUERY_TIMEOUT_MS = 500;
 /** proper-lockfile on MEMORY.md. */
 export declare const MEMORY_LOCK_RETRIES = 5;
 export declare const MEMORY_LOCK_MIN_TIMEOUT_MS = 100;

package/dist/constants/timing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/constants/timing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,QAAsB,CAAC;AAE9C,2BAA2B;AAC3B,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,8EAA8E;AAC9E,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD,kDAAkD;AAClD,eAAO,MAAM,4BAA4B,MAA8B,CAAC;AAExE,+CAA+C;AAC/C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,uDAAuD;AACvD,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAErD,sEAAsE;AACtE,eAAO,MAAM,qCAAqC,QAAa,CAAC;AAEhE,2CAA2C;AAC3C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,iCAAiC;AACjC,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,mCAAmC;AACnC,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,oCAAoC;AACpC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,0BAA0B,MAAM,CAAC"}
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/constants/timing.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,QAAsB,CAAC;AAE9C,2BAA2B;AAC3B,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,8EAA8E;AAC9E,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD,kDAAkD;AAClD,eAAO,MAAM,4BAA4B,MAA8B,CAAC;AAExE,+CAA+C;AAC/C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,uDAAuD;AACvD,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAErD,sEAAsE;AACtE,eAAO,MAAM,qCAAqC,QAAa,CAAC;AAEhE,2CAA2C;AAC3C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,iCAAiC;AACjC,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAEjD,mCAAmC;AACnC,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,oCAAoC;AACpC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,0BAA0B,MAAM,CAAC"}

package/dist/constants/timing.js

@@ -29,6 +29,8 @@ export const SIDECAR_FORCE_KILL_DELAY_MS = 5_000;
 export const SIDECAR_PING_TIMEOUT_MS = 1_000;
 export const SIDECAR_QUERY_TIMEOUT_MS = 3_000;
 export const SIDECAR_REINDEX_TIMEOUT_MS = 10_000;
+/** Warm start dummy query (session_start; not counted against Preflight budget). */
+export const SIDECAR_WARMUP_QUERY_TIMEOUT_MS = 500;
 /** proper-lockfile on MEMORY.md. */
 export const MEMORY_LOCK_RETRIES = 5;
 export const MEMORY_LOCK_MIN_TIMEOUT_MS = 100;