@openlines/nmnm-pi

Pi package for the nanomneme SQLite memory adapter. It imports @openlines/nmnm-core directly and never shells out to the CLI.

Features

• Native memory tools: model-invoked retain, recall, retrieve, and remove operations over nmnm-core; project operations require Pi project trust, while global operations remain available in untrusted projects. Model-visible JSON is bounded to 50 KiB, with explicit summaries for oversized results.

• Project and global memory: explicit store selection with canonical records and no custom database-path parsing.

• Bounded automatic context: transient autoretention guidance and the first-prompt memory index share one configurable character budget; pinned entries come first, with recent active fallback, store and recorded-source labels, unresolved-pin reporting, and refresh after successful compaction or memory mutations.

• Opt-in autoretention: project/global JSONC rules guide the active model's retain_memory calls without a nested model, worker, or direct adapter write.

• Adapter-owned configuration: optional JSONC settings and separate JSON pin files, with project and global locations.

• Direct user controls: /memory refresh, status, list, remove, pin, and unpin without model involvement; status reports injection state, autoretention, the effective index budget, current full-payload character count, and lifecycle metadata without exposing memory content.

  

• Native memory browser: /memory and /memory browse show the shared status card before opening; record details stay inside a native action dialog, so the card remains visible on return. Search and store controls stay above each record page. Standard selection keys honor Pi's configured tui.select.* bindings; h/j/k/l remain available.

  

  

  

• Readable list UX: project-first combined listing, pagination, [project] and [global] labels, exact-store * pin markers, and 60-character previews; browser rows omit IDs, which remain in details.

  

• Safety boundaries: validated pin targets, ambiguity-safe removal, soft-only slash removal, non-creating native reads, and durable unresolved pins.

Quickstart

Version 0.2.0 targets Pi 0.87.0 and Node.js 22.19 or newer. Install it globally with Pi:

pi install npm:@openlines/nmnm-pi

From a repository checkout, load it for one run:

pi -e ./adapters/pi/extensions/index.js

To add this checkout as a project-local Pi package:

pi install -l "$(pwd)/adapters/pi"

New retain_memory entries record metadata.source as "pi"; ID-based patches preserve an existing source. In an untrusted Pi project, automatic context reads only global settings, pins, and memory. Model-facing project operations are rejected, global operations continue, and explicit user /memory project commands remain available. Oversized successful tool results return valid bounded summary JSON without changing the canonical stored record. Retain scope selects the matching write store: omit it for project or use scope: "global" for global. The browser and /memory list can show all records or Pi-source records. The model-facing remove_memory tool and /memory remove are soft-only; irreversible purge remains an explicit CLI operation. Run /memory or /memory browse for the model-free custom browser: left/right changes Status, All, Project, and Global tabs. Record details remain in a native action dialog; search and source controls remain in each store tab. /memory status remains available for an on-demand card. Explicit list, refresh, pin, unpin, and soft-remove subcommands remain available.

See the Pi Adapter Manual for npm, Git, and local installation, tools, JSONC settings, pins, list and removal controls, native-read behavior, reinjection, and transient index lifecycle.