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

docs: document batch job vs interactive session dirspec distinction 

s/new routes to BatchStore (one-and-done lifecycle) when the write
contains a \n---\n separator, and to SessionStore (multi-turn) otherwise.
Document both dirspecs separately: batch jobs have spec/state/statewait/
result/usage/ctxsz/log; interactive sessions have the full file set.
Also add missing params file to session dirspec.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Levi Neely 2026-04-24 07:14:22 +02:00
parent c464879c1b
commit f1a60264e2
1 changed files with 21 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
README.md
View File

@ -28,16 +28,22 @@ ollie/
s/<id>/systemprompt. s/<id>/systemprompt.
s/ dir: sessions, session management scripts, and batch job scripts s/ dir: sessions, session management scripts, and batch job scripts
new r/w: read: KV template; write: create session new r/w: read: KV template; write: create session or batch job (see below)
idx read: session index (id, state, cwd, backend, model — one per line) idx read: index of all sessions and batch jobs (id, state, cwd, backend/agent — one per line)
sh exec: interactive chat shell sh exec: interactive chat shell
ls exec: list active sessions ls exec: list active sessions
kill exec: kill a session by ID kill exec: kill a session by ID
job exec: core batch job runner (submit, wait, print result) job exec: core batch job runner (submit, wait, print result)
q exec: foreground one-shot query; thin wrapper around job q exec: foreground one-shot query; thin wrapper around job
sched exec: submit background job; prints s/ path; wrapper around job sched exec: submit background job; prints s/ path; wrapper around job
cleanup exec: remove all sessions with state "done" cleanup exec: remove all batch jobs with state "done"
<session-id>/ rm -r to kill session; mv to rename
Writing to s/new creates either an interactive session or a batch job depending on format:
key=value pairs only (no --- separator) => interactive session
key=value pairs + \n---\n + prompt body => batch job (one-and-done lifecycle)
Interactive session directories (multi-turn, idle<=>running):
<session-id>/ rm -r to kill; mv to rename
agent r/w: active agent name agent r/w: active agent name
backend r/w: active backend name backend r/w: active backend name
chat read: cumulative conversation history chat read: cumulative conversation history
@ -50,12 +56,23 @@ ollie/
fifo.out read: pop the next queued prompt fifo.out read: pop the next queued prompt
model r/w: active model name model r/w: active model name
models read: available models from the backend models read: available models from the backend
params r/w: generation parameters (maxTokens, temperature, etc.)
prompt write: submit a prompt to the agent prompt write: submit a prompt to the agent
state read: current agent state (idle, thinking, calling: <tool>) state read: current agent state (idle, thinking, calling: <tool>)
statewait read: blocks until state changes; returns new value statewait read: blocks until state changes; returns new value
systemprompt read: fully rendered system prompt for this session systemprompt read: fully rendered system prompt for this session
usage read: token counts (input, output, requests; [estimated] if not reported by backend) usage read: token counts (input, output, requests; [estimated] if not reported by backend)
usagewait read: blocks until usage changes; returns new value usagewait read: blocks until usage changes; returns new value
Batch job directories (one-and-done: running => done | failed):
<job-id>/ rm -r to cancel and remove
spec read: verbatim spec as submitted to s/new
state read: running | done | failed: <reason>
statewait read: blocks until terminal state; returns final state
result read: assistant reply (populated when done)
usage read: token counts
ctxsz read: context size
log read: raw event log (tool calls, assistant output)
sk/ dir: skills (r/w, from OLLIE_SKILLS_PATH or ~/.config/ollie/skills/) sk/ dir: skills (r/w, from OLLIE_SKILLS_PATH or ~/.config/ollie/skills/)
<name>.md r/w: skill SKILL.md content <name>.md r/w: skill SKILL.md content
t/ dir: tool scripts (r/w, backed by ~/.config/ollie/tools/) t/ dir: tool scripts (r/w, backed by ~/.config/ollie/tools/)