lkn
/
ollie-9p
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: update README for refactor (stores, prompts, sandbox)

This commit is contained in:
Levi Neely 2026-04-22 10:35:38 +02:00
parent 2df001a5eb
commit cb206a7387
1 changed files with 7 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
README.md
View File

@ -15,9 +15,6 @@ ollie/
backends read: list of ollie-provided backends backends read: list of ollie-provided backends
help read: help file (backed by ~/.config/ollie/help.md) help read: help file (backed by ~/.config/ollie/help.md)
p/ dir: prompt templates (read, backed by ~/.config/ollie/prompts/) p/ dir: prompt templates (read, backed by ~/.config/ollie/prompts/)
sys-base.md read: tone, accuracy, task execution, environment
sys-ollie.md read: session identity, filesystem layout, session lifecycle
sys-skills.md read: skill discovery and loading
tools-file.md read: text editing instructions tools-file.md read: text editing instructions
tools-reasoning.md read: reasoning instructions tools-reasoning.md read: reasoning instructions
tools-memory.md read: memory instructions tools-memory.md read: memory instructions
@ -25,8 +22,10 @@ ollie/
tools-elevate.md read: controlled escape from execute_code sandbox tools-elevate.md read: controlled escape from execute_code sandbox
Prompt files have no automatic effect. They are injected into the system prompt Prompt files have no automatic effect. They are injected into the system prompt
by the `prime` script (x/prime), typically via agentSpawn hooks in agent configs. by the `prime` script (x/prime), typically via preTurn hooks in agent configs.
The assembled system prompt is visible at s/<id>/systemprompt. The base system prompt (SYSTEM_PROMPT.md) is loaded directly by Go at session
creation and is not served via p/. The assembled system prompt is visible at
s/<id>/systemprompt.
b/ dir: batch jobs and job scripts b/ dir: batch jobs and job scripts
new r/w: read: KV template; write: submit a job spec new r/w: read: KV template; write: submit a job spec
@ -81,21 +80,21 @@ Session IDs are Unix nanosecond timestamps with a random suffix (e.g. `174427668
## Backing stores ## Backing stores
Each 9P directory endpoint is backed by a named store implementing one of the store interfaces (`ReadableStore`, `ReadWriteStore`, `BlobStore`, or `Store`). The server routes all filesystem operations through the store — it has no direct knowledge of what underlies it. Each 9P directory endpoint is backed by a named store implementing the `Store` interface (from `core/pkg/store`). The server routes all filesystem operations through the store — it has no direct knowledge of what underlies it.
| Path | Default backing | Interface | | Path | Default backing | Interface |
|-------|------------------------|-----------------| |-------|------------------------|-----------------|
| `/a` | `FlatDirStore` | `Store` | | `/a` | `FlatDirStore` | `Store` |
| `/b` | `BatchStore` | `Store` | | `/b` | `BatchStore` | `Store` |
| `/m` | `FlatDirStore` | `Store` | | `/m` | `FlatDirStore` | `Store` |
| `/p` | `FlatDirStore` | `ReadableStore` | | `/p` | `FlatDirStore` | `Store` |
| `/sk` | `SkillStore` | `Store` | | `/sk` | `SkillStore` | `Store` |
| `/t` | `ToolStore` | `Store` | | `/t` | `ToolStore` | `Store` |
| `/u` | `UtilStore` | `Store` | | `/u` | `UtilStore` | `Store` |
| `/x` | `ExecStore` | `Store` | | `/x` | `ExecStore` | `Store` |
| `/s` | `SessionStore` | `Store` | | `/s` | `SessionStore` | `Store` |
To swap a backing store (e.g. replace `/pl` with a vector database or `/m` with an object store), implement the appropriate interface and wire it in `New()`. The store interface requires only `Stat`, `List`, `Get`, `Put`, `Delete`, `Create`, and `Rename` — authentication, connection management, and credential rotation are internal concerns of the implementation. To swap a backing store (e.g. replace `/m` with an object store), implement the `Store` interface and wire it in `New()`. The store interface requires only `Stat`, `List`, `Open`, `Create`, `Delete`, and `Rename` — authentication, connection management, and credential rotation are internal concerns of the implementation.
`SessionStore` is the exception: it holds live session state and is tightly coupled to the server's session lifecycle. Replacing it is possible in principle but requires understanding the session management internals. `SessionStore` is the exception: it holds live session state and is tightly coupled to the server's session lifecycle. Replacing it is possible in principle but requires understanding the session management internals.