@felan-ai/felan 0.12.7 → 0.12.9

package/NOTICE

@@ -6,6 +6,10 @@ This package composes the MIT-licensed @felan-ai/agent-core and Felan extension
 packages listed in package.json. Their package-level LICENSE and NOTICE files
 contain the applicable attribution and source provenance.
 
+The local-first memory integration is original MIT-licensed Felan code from
+@felan-ai/ext-memory. Its package-level LICENSE and NOTICE contain the
+applicable attribution.
+
 The terminal application uses @earendil-works/pi-coding-agent and
 @earendil-works/pi-tui 0.84.2 from https://github.com/earendil-works/pi,
 licensed under the MIT License.

package/README.md

@@ -15,6 +15,72 @@ global settings from `~/.felan/settings.json` and does not load Pi project
 settings. Pi project trust does not apply to Felan's fixed resource policy, so
 Felan starts without a project trust prompt.
 
+Local memory is enabled by default and works without a Felan account or cloud
+connection. It consolidates settled root-session evidence into an inspectable
+Markdown wiki. The canonical project store is outside the customer repository:
+
+```text
+$FELAN_AGENT_DIR/memory/v1/projects/<project-hash>/
+  state.json
+  current/summary.md
+  current/index.md
+  current/pages/...
+```
+
+The project hash is derived from the canonical Git root, or the canonical cwd
+when no repository exists. Root-session storage receives a non-authoritative
+copy at `storage/sessions/<root-id>/.memory`; child sessions can read that copy
+but ordinary edits never publish it. Felan does not create `<repository>/.memory`
+and does not synchronize local memory with cloud team memory.
+Each session receives one hidden persisted memory-context entry at startup;
+provider calls reuse it, and compaction or tree navigation restores it only if
+it is no longer on the active branch. That entry is excluded from memory
+evidence processing. Once it loads successfully, the welcome screen's
+`[Context]` section lists the projected `.memory/summary.md` path alongside
+project instructions so the loaded summary can be opened directly. The summary
+is orientation only: substantive memory-backed answers should follow the
+projected absolute `index.md` links to relevant pages and cite page paths and
+their `Sources` session IDs.
+
+Use `/memory status`, `/memory run`, `/memory enable`, `/memory disable`, or
+`/memory open` to inspect and control local processing. A missing local model
+credential never prevents startup or recall of existing memory; processing
+remains pending until a configured model is available. Processing is idle
+batched while Felan runs and catches up on the next launch after shutdown. The
+enable/disable commands persist `felanTui.memoryProcessing` and do not remove
+the memory recall extension.
+
+After checkpoints are recorded, the TUI coordinator owns idle batching,
+startup recovery, retries, and shutdown cancellation. Each batch runs one
+disposable headless Pi memory-dreamer session against staging. It reads the
+immutable `.dreaming/input` manifest and transcripts, edits staged `.memory`
+files in place, and returns only a concise completion summary. The worker has
+no normal Felan extensions, skills, repository context, credentials, or
+process execution; its active tools are limited to `read`, `ls`, `edit`, and
+`write`. The worker has no separate turn, tool-call, or per-file I/O budgets;
+the only execution failsafe is a one-hour wall-clock timeout. The coordinator
+validates and publishes the staged filesystem output, so model, validation,
+cancellation, timeout, or publication failures leave evidence pending for
+retry. The worker uses the active root-session model when it is authenticated;
+if that model is unavailable, it falls back to another authenticated available
+model. With no authenticated model, evidence remains pending. The portable
+`@felan-ai/ext-memory` extension only recalls memory and records root
+checkpoints; it does not schedule dreaming.
+
+Evidence ingestion is separate from the worker's file-tool policy. The host
+opens each checkpoint's append-only JSONL session with a bounded snapshot and
+streams only the visible active-branch delta; abandoned branches, hidden
+memory-context entries, and unrelated large tool output are not staged. Source
+files may be much larger than the evidence sent to the model. After redaction,
+each staged transcript is capped at 256 KiB. A changed, missing, or malformed
+checkpoint source remains pending without blocking valid checkpoints in the
+same batch; it is retried by `/memory run`, a newer cursor, or a later launch.
+The dreamer updates affected pages and cross-links, preserves valid historical
+source entries, marks superseded or conflicting claims, and performs a bounded
+semantic maintenance pass before publication. Root-index links in each session
+projection are rebased to that projection's absolute `.memory` path; canonical
+memory remains unchanged.
+
 Felan suppresses Pi's version notification, bundled changelog, package update
 notifications, and install/update telemetry. Update behavior is owned by the
 Felan application.
@@ -61,6 +127,7 @@ All built-in extensions are enabled by default. Toggle them in
     "backgroundBash": true,
     "codex": true,
     "rtkOptimizer": true,
+    "memory": true,
     "powerline": false
   }
 }
@@ -79,8 +146,12 @@ confirmation.
 The local transcript groups adjacent tool calls by default, with one concise
 action row per call beneath each group title. Press `Ctrl+O` to show bounded
 result previews. Use `/tools` or `Alt+T` to inspect the complete arguments and
-result for one call. Subagent completion notices stay on one summary line by
-default; `Ctrl+O` shows a bounded preview and `Alt+A` opens full agent details.
+result for one root-session call. Selected subagent transcripts use the same
+grouped or full tool rendering and `Ctrl+O` previews. Subagent completion
+notices stay on one summary line by default; `Ctrl+O` shows a bounded preview
+and `Alt+A` opens full agent details. Grouped reads from projected or canonical
+local memory appear as `Memory Recall`; conservative read-only Codex commands
+receive the same label without hiding mutating or arbitrary shell commands.
 To restore Pi's original ungrouped rendering, set:
 
 ```json
@@ -225,8 +296,10 @@ child in a full-width interactive rail beneath the powerline status rows, or
 beneath the editor when powerline is disabled. Press Down at the editor's newest
 prompt to enter the rail, use Up/Down to select a child, press Up on the first
 child to return to the editor, and press Enter to open that child in the agent
-navigator. Use `/agents` or `Alt+A` to open the navigator directly, follow live
-transcripts, send steering messages, or stop active work.
+navigator. Each child row and the selected-child header show the resolved
+provider/model when available. Use `/agents` or `Alt+A` to open the navigator
+directly, follow live transcripts with the same tool presentation as the main
+agent, send steering messages, or stop active work.
 Runtime shutdown awaits active-child cancellation before Pi teardown.
 Completed-child continuation uses the same child ID and Pi session file while
 replacing the latest result. The default list also
@@ -240,6 +313,15 @@ Local agent definitions are loaded only from bundled Felan definitions,
 bundled definitions; within one scope the Felan-specific directory overrides
 the shared `.agents` directory. Pi ambient agent discovery remains disabled.
 
+The bundled definitions have role-specific model settings: `general` inherits the
+parent model and thinking for implementation or investigation, `explore` uses the
+`low` model tier with thinking `off` for cheap read-only exploration, and `reviewer`
+inherits the parent model and thinking for quality-sensitive review. A definition's
+`model` and `thinking` settings take precedence over `Agent` arguments. When a
+definition omits either setting, the corresponding argument is used; if both omit
+it, the parent setting is inherited. A custom definition with id `explore` replaces
+the bundled definition and can choose its own settings.
+
 Each definition is a Markdown file with flat `key: value` frontmatter and a
 required prompt body. `description` is required; `id` defaults to the filename.
 Optional fields are `model`, `thinking`, `max_turns`, `timeout_seconds`, and

package/dist/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,oBAAqB,SAAQ,8BAA8B;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCrF"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,oBAAqB,SAAQ,8BAA8B;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CrF"}

package/dist/application.js

@@ -1,3 +1,4 @@
+import { join } from 'node:path';
 import { InteractiveMode } from '@earendil-works/pi-coding-agent';
 import { createLocalFelanRuntime, } from './runtime.js';
 import { installFelanStartupHeader } from './startup-header.js';
@@ -15,7 +16,10 @@ export async function runLocalFelan(options = {}) {
             ...(options.initialMessage === undefined ? {} : { initialMessage: options.initialMessage }),
             ...(options.verbose === undefined ? {} : { verbose: options.verbose }),
         });
-        installFelanStartupHeader(mode, { expanded: options.verbose === true });
+        installFelanStartupHeader(mode, {
+            expanded: options.verbose === true,
+            memorySummaryPath: () => join(runtime.services.agentDir, 'storage', 'sessions', encodeURIComponent(runtime.session.sessionManager.getSessionId()), '.memory', 'summary.md'),
+        });
         await mode.run();
     }
     finally {

package/dist/application.js.map

@@ -1 +1 @@
-{"version":3,"file":"application.js","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EACL,uBAAuB,GAExB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAOhF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAgC,EAAE;IACpE,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC3D,MAAM,0BAA0B,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACrE,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,6BAA6B,CAAC,OAAO,CAAC,EAAE;YACvE,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,yBAAyB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;gBACrC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,kBAAkB,CAAC;YACvD,CAAC;YACD,IAAI,0BAA0B,KAAK,SAAS,EAAE,CAAC;gBAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,0BAA0B,CAAC;YACjE,CAAC;YACD,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,mBAAmB,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EACL,uBAAuB,GAExB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAOhF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAgC,EAAE;IACpE,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC3D,MAAM,0BAA0B,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACrE,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,6BAA6B,CAAC,OAAO,CAAC,EAAE;YACvE,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,yBAAyB,CAAC,IAAI,EAAE;YAC9B,QAAQ,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;YAClC,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI,CAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,EACzB,SAAS,EACT,UAAU,EACV,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,EACjE,SAAS,EACT,YAAY,CACb;SACF,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;gBACrC,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,kBAAkB,CAAC;YACvD,CAAC;YACD,IAAI,0BAA0B,KAAK,SAAS,EAAE,CAAC;gBAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,0BAA0B,CAAC;YACjE,CAAC;YACD,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;gBACtC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,mBAAmB,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/extensions.d.ts

@@ -1,10 +1,12 @@
 import type { ExtensionPackageImporter, ModelRuntime } from '@felan-ai/agent-core';
+import { type MemoryHost, type MemoryRole } from '@felan-ai/ext-memory';
 import { type SubagentHost } from '@felan-ai/ext-subagents';
 import { type LocalSubagentNavigatorHost } from './subagents/agent-navigator.js';
 export declare const askUserExtensionPackage = "@felan-ai/ext-ask-user";
 export declare const mcpExtensionPackage = "@felan-ai/ext-mcp";
 export declare const powerlineExtensionPackage = "@felan-ai/ext-powerline";
 export declare const subagentsExtensionPackage = "@felan-ai/ext-subagents";
+export declare const memoryExtensionPackage = "@felan-ai/ext-memory";
 export declare const builtinExtensionPackages: {
     readonly subagents: "@felan-ai/ext-subagents";
     readonly askUser: "@felan-ai/ext-ask-user";
@@ -17,12 +19,17 @@ export declare const builtinExtensionPackages: {
     readonly rtkOptimizer: "@felan-ai/ext-rtk-optimizer";
     readonly markitdown: "@felan-ai/ext-markitdown";
     readonly context: "@felan-ai/ext-context";
+    readonly memory: "@felan-ai/ext-memory";
     readonly powerline: "@felan-ai/ext-powerline";
 };
-export declare const localExtensionPackages: ("@felan-ai/ext-subagents" | "@felan-ai/ext-ask-user" | "@felan-ai/ext-mcp" | "@felan-ai/ext-powerline" | "@felan-ai/ext-tasks" | "@felan-ai/ext-prewalk" | "@felan-ai/ext-web-access" | "@felan-ai/ext-background-bash" | "@felan-ai/ext-codex" | "@felan-ai/ext-rtk-optimizer" | "@felan-ai/ext-markitdown" | "@felan-ai/ext-context")[];
+export declare const localExtensionPackages: ("@felan-ai/ext-subagents" | "@felan-ai/ext-ask-user" | "@felan-ai/ext-tasks" | "@felan-ai/ext-prewalk" | "@felan-ai/ext-mcp" | "@felan-ai/ext-web-access" | "@felan-ai/ext-background-bash" | "@felan-ai/ext-codex" | "@felan-ai/ext-rtk-optimizer" | "@felan-ai/ext-markitdown" | "@felan-ai/ext-context" | "@felan-ai/ext-memory" | "@felan-ai/ext-powerline")[];
 export type BuiltinExtensionName = keyof typeof builtinExtensionPackages;
 export type BuiltinExtensionSettings = Partial<Record<BuiltinExtensionName, boolean>>;
 export declare function resolveBuiltinExtensionPackages(settings: unknown): readonly string[];
 export declare const importLocalExtension: ExtensionPackageImporter;
-export declare function createLocalExtensionImporter(host: SubagentHost & LocalSubagentNavigatorHost, modelRuntime: ModelRuntime, importExtension?: ExtensionPackageImporter, shutdownHost?: () => Promise<void>): ExtensionPackageImporter;
+export interface LocalMemoryExtensionBinding {
+    readonly role: MemoryRole;
+    readonly host: MemoryHost;
+}
+export declare function createLocalExtensionImporter(host: SubagentHost & LocalSubagentNavigatorHost, modelRuntime: ModelRuntime, importExtension?: ExtensionPackageImporter, shutdownHost?: () => Promise<void>, memoryBinding?: LocalMemoryExtensionBinding): ExtensionPackageImporter;
 //# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAInF,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,gCAAgC,CAAC;AAExC,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AACnE,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AACnE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;CAc3B,CAAC;AACX,eAAO,MAAM,sBAAsB,4UAA0C,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,wBAAwB,CAAC;AACzE,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,CAAC;AAItF,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAYpF;AAED,eAAO,MAAM,oBAAoB,EAAE,wBAKlC,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,YAAY,GAAG,0BAA0B,EAC/C,YAAY,EAAE,YAAY,EAC1B,eAAe,GAAE,wBAA+C,EAChE,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACjC,wBAAwB,CAsC1B"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGnF,OAAO,EAAyB,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE/F,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,gCAAgC,CAAC;AAExC,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AACnE,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AACnE,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAC7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;CAe3B,CAAC;AACX,eAAO,MAAM,sBAAsB,qWAA0C,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,wBAAwB,CAAC;AACzE,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,CAAC;AAItF,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAYpF;AAED,eAAO,MAAM,oBAAoB,EAAE,wBAKlC,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,YAAY,GAAG,0BAA0B,EAC/C,YAAY,EAAE,YAAY,EAC1B,eAAe,GAAE,wBAA+C,EAChE,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAClC,aAAa,CAAC,EAAE,2BAA2B,GAC1C,wBAAwB,CA0C1B"}

package/dist/extensions.js

@@ -1,5 +1,6 @@
 import { createAskUserExtension } from '@felan-ai/ext-ask-user';
 import { createTuiAskUserHost } from '@felan-ai/ext-ask-user/tui';
+import { createMemoryExtension } from '@felan-ai/ext-memory';
 import { createPowerlineExtension } from '@felan-ai/ext-powerline';
 import { createSubagentsExtension, } from '@felan-ai/ext-subagents';
 import { createLocalMcpExtension } from './mcp/index.js';
@@ -9,6 +10,7 @@ export const askUserExtensionPackage = '@felan-ai/ext-ask-user';
 export const mcpExtensionPackage = '@felan-ai/ext-mcp';
 export const powerlineExtensionPackage = '@felan-ai/ext-powerline';
 export const subagentsExtensionPackage = '@felan-ai/ext-subagents';
+export const memoryExtensionPackage = '@felan-ai/ext-memory';
 export const builtinExtensionPackages = {
     subagents: subagentsExtensionPackage,
     askUser: askUserExtensionPackage,
@@ -22,6 +24,7 @@ export const builtinExtensionPackages = {
     // Append conversion diagnostics after result optimization, then restore the source path for progressive context.
     markitdown: '@felan-ai/ext-markitdown',
     context: '@felan-ai/ext-context',
+    memory: memoryExtensionPackage,
     powerline: powerlineExtensionPackage,
 };
 export const localExtensionPackages = Object.values(builtinExtensionPackages);
@@ -47,7 +50,7 @@ export const importLocalExtension = async (packageName) => {
     }
     return import(packageName);
 };
-export function createLocalExtensionImporter(host, modelRuntime, importExtension = importLocalExtension, shutdownHost) {
+export function createLocalExtensionImporter(host, modelRuntime, importExtension = importLocalExtension, shutdownHost, memoryBinding) {
     let powerlineLoaded = false;
     let agentRailRenderer;
     const powerline = createPowerlineExtension(createLocalSubscriptionUsageHost(modelRuntime), {
@@ -84,6 +87,11 @@ export function createLocalExtensionImporter(host, modelRuntime, importExtension
             powerlineLoaded = true;
             return { default: powerline };
         }
+        if (packageName === memoryExtensionPackage) {
+            if (!memoryBinding)
+                throw new Error('Local memory extension requires a host binding');
+            return { default: createMemoryExtension(memoryBinding) };
+        }
         return importExtension(packageName);
     };
 }

package/dist/extensions.js.map

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

package/dist/index.d.ts

@@ -8,6 +8,10 @@ export { createLocalFelanRuntime, createLocalModelRuntime, createLocalSessionRun
 export { LocalSubagentHost } from './subagents/host.js';
 export type { CreateLocalSubagentHostOptions, LocalSubagentSettings, LocalSubagentView, } from './subagents/host.js';
 export type { CreateLocalFelanRuntimeOptions, CreateLocalSessionRuntimeFactoryOptions, LocalFelanRuntime, } from './runtime.js';
+export { LocalMemoryCoordinator } from './memory/coordinator.js';
+export { localMemoryProjectDirectory, resolveLocalMemoryProject } from './memory/project.js';
+export type { LocalMemoryCoordinatorOptions, LocalMemorySessionHostOptions, } from './memory/coordinator.js';
+export type { LocalMemoryProject } from './memory/project.js';
 export type { LocalAgentRuntimeFactory, LocalAgentRuntimeFactoryRequest, } from './runtime-factory.js';
 export { createLocalSettingsManager, getFelanSettings } from './settings.js';
 export type { FelanSettings } from './settings.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,8BAA8B,EAC9B,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,8BAA8B,EAC9B,uCAAuC,EACvC,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,8BAA8B,EAC9B,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,8BAA8B,EAC9B,uCAAuC,EACvC,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EACV,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EACV,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -3,6 +3,8 @@ export { runCli } from './cli-main.js';
 export { builtinExtensionPackages, importLocalExtension, localExtensionPackages, resolveBuiltinExtensionPackages, } from './extensions.js';
 export { createLocalFelanRuntime, createLocalModelRuntime, createLocalSessionRuntimeFactory, getLocalAgentDir, getLocalSkillPaths, } from './runtime.js';
 export { LocalSubagentHost } from './subagents/host.js';
+export { LocalMemoryCoordinator } from './memory/coordinator.js';
+export { localMemoryProjectDirectory, resolveLocalMemoryProject } from './memory/project.js';
 export { createLocalSettingsManager, getFelanSettings } from './settings.js';
 export { LOCAL_APPEND_SYSTEM_PROMPT_FILENAME, loadLocalAppendSystemPrompt, } from './system-prompt.js';
 export { FELAN_VERSION } from './version.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAexD,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EACL,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAWxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAU7F,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EACL,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/lock.d.ts

@@ -0,0 +1,15 @@
+import { type LockOptions } from 'proper-lockfile';
+export type LocalFileLockOptions = Omit<LockOptions, 'onCompromised'> & {
+    readonly preservePathOnRelease?: boolean;
+};
+export interface LocalFileLock {
+    readonly compromised: AbortSignal;
+    isCompromised(): boolean;
+    isCurrent(): Promise<boolean>;
+    throwIfCompromised(message?: string): void;
+    retire(staleMs: number): Promise<void>;
+    release(): Promise<void>;
+}
+export declare function withLocalFileLock<T>(path: string, options: LocalFileLockOptions, operation: (lock: LocalFileLock) => Promise<T>): Promise<T>;
+export declare function acquireLocalFileLock(path: string, options?: LocalFileLockOptions): Promise<LocalFileLock>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAEA,OAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,GAAG;IACtE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,aAAa,IAAI,OAAO,CAAC;IACzB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,CAAC,CAcZ;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAqDxB"}

package/dist/lock.js

@@ -0,0 +1,169 @@
+import * as nodeFs from 'node:fs';
+import { lstat, utimes } from 'node:fs/promises';
+import lockfile, {} from 'proper-lockfile';
+export async function withLocalFileLock(path, options, operation) {
+    const lock = await acquireLocalFileLock(path, {
+        ...options,
+        preservePathOnRelease: true,
+    });
+    try {
+        lock.throwIfCompromised();
+        const result = await operation(lock);
+        lock.throwIfCompromised();
+        return result;
+    }
+    finally {
+        await lock.release();
+        await lock.retire(options.stale ?? 10_000);
+    }
+}
+export async function acquireLocalFileLock(path, options = {}) {
+    const controller = new AbortController();
+    let compromiseError;
+    const lockPath = options.lockfilePath ?? `${path}.lock`;
+    const { preservePathOnRelease = false, ...lockOptions } = options;
+    const identityRef = {};
+    const releaseLock = await lockfile.lock(path, {
+        ...lockOptions,
+        fs: createGuardedFs(lockPath, identityRef, preservePathOnRelease),
+        onCompromised: (error) => {
+            compromiseError ??= error;
+            controller.abort(error);
+        },
+    });
+    const lockIdentity = await readLockIdentity(lockPath);
+    if (!lockIdentity) {
+        const error = new Error('Local file lock disappeared during acquisition');
+        compromiseError = error;
+        controller.abort(error);
+        throw error;
+    }
+    identityRef.current = lockIdentity;
+    const isCurrent = async () => {
+        if (compromiseError)
+            return false;
+        const current = await readLockIdentity(lockPath);
+        return current !== undefined && sameLockIdentity(current, lockIdentity);
+    };
+    let released = false;
+    return {
+        compromised: controller.signal,
+        isCompromised: () => compromiseError !== undefined,
+        isCurrent,
+        throwIfCompromised(message) {
+            if (!compromiseError)
+                return;
+            if (message === undefined)
+                throw compromiseError;
+            throw new Error(message, { cause: compromiseError });
+        },
+        async retire(staleMs) {
+            if (!preservePathOnRelease || !(await isCurrent()))
+                return;
+            const retiredAt = new Date(Date.now() - Math.max(staleMs, 2_000) - 1_000);
+            await utimes(lockPath, retiredAt, retiredAt).catch(() => { });
+        },
+        async release() {
+            if (released)
+                return;
+            released = true;
+            try {
+                await releaseLock();
+            }
+            catch (error) {
+                if (!compromiseError && await isCurrent())
+                    throw error;
+            }
+        },
+    };
+}
+function createGuardedFs(lockPath, identityRef, preservePathOnRelease) {
+    const guarded = {
+        ...nodeFs,
+        rmdir(path, callback) {
+            if (path !== lockPath) {
+                nodeFs.rmdir(path, callback);
+                return;
+            }
+            if (!identityRef.current) {
+                nodeFs.rmdir(path, (error) => {
+                    // A populated stale lock is still owned. Let proper-lockfile's
+                    // follow-up mkdir report ELOCKED instead of surfacing ENOTEMPTY.
+                    callback(isNotEmpty(error) ? null : error);
+                });
+                return;
+            }
+            if (preservePathOnRelease) {
+                callback(null);
+                return;
+            }
+            nodeFs.lstat(path, (error, stats) => {
+                if (error) {
+                    if (isMissing(error)) {
+                        callback(null);
+                        return;
+                    }
+                    callback(error);
+                    return;
+                }
+                if (!sameLockIdentity(stats, identityRef.current)) {
+                    callback(null);
+                    return;
+                }
+                nodeFs.rmdir(path, callback);
+            });
+        },
+        rmdirSync(path) {
+            if (path !== lockPath) {
+                nodeFs.rmdirSync(path);
+                return;
+            }
+            if (!identityRef.current) {
+                try {
+                    nodeFs.rmdirSync(path);
+                }
+                catch (error) {
+                    if (!isNotEmpty(error))
+                        throw error;
+                }
+                return;
+            }
+            if (preservePathOnRelease)
+                return;
+            let stats;
+            try {
+                stats = nodeFs.lstatSync(path);
+            }
+            catch (error) {
+                if (isMissing(error))
+                    return;
+                throw error;
+            }
+            if (!sameLockIdentity(stats, identityRef.current))
+                return;
+            nodeFs.rmdirSync(path);
+        },
+    };
+    return guarded;
+}
+async function readLockIdentity(path) {
+    try {
+        const stats = await lstat(path);
+        return { dev: stats.dev, ino: stats.ino, birthtimeMs: stats.birthtimeMs };
+    }
+    catch (error) {
+        if (isMissing(error))
+            return undefined;
+        throw error;
+    }
+}
+function sameLockIdentity(left, right) {
+    return left.dev === right.dev && left.ino === right.ino && left.birthtimeMs === right.birthtimeMs;
+}
+function isMissing(error) {
+    return typeof error === 'object' && error !== null && Reflect.get(error, 'code') === 'ENOENT';
+}
+function isNotEmpty(error) {
+    return typeof error === 'object' && error !== null && Reflect.get(error, 'code') === 'ENOTEMPTY';
+}
+//# sourceMappingURL=lock.js.map

package/dist/lock.js.map

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

package/dist/memory/control.d.ts

@@ -0,0 +1,8 @@
+import type { FelanExtension } from '@felan-ai/agent-core';
+import { LocalMemoryCoordinator } from './coordinator.js';
+export interface CreateLocalMemoryControlExtensionOptions {
+    readonly coordinator: LocalMemoryCoordinator;
+    readonly agentDir: string;
+}
+export declare function createLocalMemoryControlExtension(options: CreateLocalMemoryControlExtensionOptions): FelanExtension;
+//# sourceMappingURL=control.d.ts.map

package/dist/memory/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../src/memory/control.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC,GAChD,cAAc,CAgFhB"}

package/dist/memory/control.js

@@ -0,0 +1,106 @@
+import open from 'open';
+import { setLocalMemoryProcessingEnabled } from '../settings.js';
+import { LocalMemoryCoordinator } from './coordinator.js';
+export function createLocalMemoryControlExtension(options) {
+    return (pi) => {
+        let activeContext;
+        let activeSessionId;
+        let unsubscribeStatus;
+        let statusRefresh = 0;
+        const refreshActiveStatus = async () => {
+            const refresh = ++statusRefresh;
+            const ctx = activeContext;
+            if (!ctx)
+                return;
+            const status = await options.coordinator.status(ctx.cwd);
+            if (activeContext !== ctx || refresh !== statusRefresh)
+                return;
+            updateStatus(ctx, status);
+        };
+        pi.registerCommand('memory', {
+            description: 'Inspect, run, enable, disable, or open local project memory',
+            handler: async (args, ctx) => {
+                const command = args.trim().toLowerCase() || 'status';
+                if (command === 'status') {
+                    await showStatus(options.coordinator, ctx.cwd, ctx);
+                    return;
+                }
+                if (command === 'run' || command === 'process') {
+                    const status = await options.coordinator.runNow(ctx.cwd);
+                    updateStatus(ctx, status);
+                    notify(ctx, formatStatus(status));
+                    return;
+                }
+                if (command === 'enable' || command === 'on') {
+                    await setMemoryEnabled(options, true);
+                    notify(ctx, 'Local memory processing enabled.');
+                    return;
+                }
+                if (command === 'disable' || command === 'off') {
+                    await setMemoryEnabled(options, false);
+                    notify(ctx, 'Local memory processing disabled. Existing memory remains readable.');
+                    return;
+                }
+                if (command === 'open') {
+                    if (!ctx.hasUI || ctx.mode !== 'tui') {
+                        notify(ctx, '/memory open requires interactive TUI mode.', 'warning');
+                        return;
+                    }
+                    const directory = await options.coordinator.canonicalDirectory(ctx.cwd);
+                    await open(directory);
+                    notify(ctx, 'Opened canonical local memory.', 'info');
+                    return;
+                }
+                notify(ctx, 'Usage: /memory status|run|enable|disable|open', 'warning');
+            },
+        });
+        pi.on('session_start', async (_event, ctx) => {
+            activeContext = ctx;
+            activeSessionId = ctx.sessionManager.getSessionId();
+            unsubscribeStatus?.();
+            unsubscribeStatus = options.coordinator.subscribeStatusChanges(() => {
+                void refreshActiveStatus().catch(() => { });
+            });
+            try {
+                await refreshActiveStatus();
+            }
+            catch { }
+        });
+        pi.on('session_shutdown', (_event, ctx) => {
+            if (activeSessionId !== ctx.sessionManager.getSessionId())
+                return;
+            statusRefresh += 1;
+            activeContext = undefined;
+            activeSessionId = undefined;
+            unsubscribeStatus?.();
+            unsubscribeStatus = undefined;
+            ctx.ui.setStatus('memory', undefined);
+        });
+        pi.on('model_select', ({ model }) => {
+            options.coordinator.setSelectedModel(model);
+        });
+    };
+}
+async function setMemoryEnabled(options, enabled) {
+    options.coordinator.setEnabled(enabled);
+    await setLocalMemoryProcessingEnabled(options.agentDir, enabled);
+}
+async function showStatus(coordinator, cwd, ctx, quiet = false) {
+    const status = await coordinator.status(cwd);
+    const message = formatStatus(status);
+    updateStatus(ctx, status);
+    if (!quiet)
+        notify(ctx, message);
+}
+function updateStatus(ctx, status) {
+    ctx.ui.setStatus('memory', status.pendingCheckpoints > 0 ? `Memory: ${status.pendingCheckpoints} pending` : undefined);
+}
+function formatStatus(status) {
+    const enabled = status.enabled ? 'enabled' : 'disabled';
+    const pending = `${status.pendingCheckpoints} pending`;
+    return `Local memory: ${enabled}, ${status.state}, ${pending}${status.message ? ` — ${status.message}` : ''}`;
+}
+function notify(ctx, message, level = 'info') {
+    ctx.ui.notify(message, level);
+}
+//# sourceMappingURL=control.js.map