doc: update for b/ batch namespace
- doc/help.md: add b/ to filesystem layout, remove s/{id}/reply
- README.md: update sub-agents and composability blurbs to reference b/
This commit is contained in:
parent
417e121f29
commit
e32d96962f
|
|
@ -91,11 +91,11 @@ git submodule update --remote
|
|||
|
||||
**Discoverability** — `ls s/{id}/` shows every control surface. `cat t/idx` and `cat sk/idx` list available tools and skills. `cat help` explains the rest.
|
||||
|
||||
**Composability** — Agents can be composed by piping `reply` into another session's `prompt`. Tools can be composed via `execute_pipe`, chaining `execute_code` and `execute_tool` steps the same way Unix pipes chain programs.
|
||||
**Composability** — Tools can be composed via `execute_pipe`, chaining `execute_code` and `execute_tool` steps the same way Unix pipes chain programs. Sessions can be chained by reading `s/{id}/chat` and writing to another session's `prompt` or `enqueue`.
|
||||
|
||||
**Passive memory** — Every session's chat history accumulates at `s/{id}/chat`, searchable with `grep`. An agent doesn't need to actively decide what to remember. This extends across sessions: an agent can search another session's chat for answers that have already been worked through.
|
||||
|
||||
**Sub-agents** — An agent can spin up new sessions by writing to `s/new`, prime each one with a prompt, and collect results by reading their `reply` or having them write back to the parent's `prompt` or `enqueue`. Coordination is not yet fully resolved, but the basic fan-out pattern works today.
|
||||
**Sub-agents** — An agent can fan out work by writing to `b/new` (ephemeral one-shot jobs) or `s/new` (persistent sessions), then collect results from `b/{id}/result` or `s/{id}/chat`. Multiple jobs run concurrently with `parallel=N`; each gets its own result file.
|
||||
|
||||
## Credits
|
||||
|
||||
|
|
|
|||
10
doc/help.md
10
doc/help.md
|
|
@ -24,6 +24,15 @@ ollie/
|
|||
idx memory index (ro) cat
|
||||
p/ prompt templates (ro) ls, cat (rebuilt on new session, /cwd, /agent)
|
||||
pl/ plans (r/w) ls, cat, edit
|
||||
b/ batch jobs (ephemeral) ls
|
||||
idx job index (ro) cat: id status cwd agent, one per line
|
||||
new create job (r/w) cat: KV template; write spec to submit
|
||||
<id>/ job directory rm -r to cancel and remove
|
||||
spec original job spec (ro)
|
||||
status job status (ro) running | done | failed: <reason>
|
||||
result assistant reply (ro)
|
||||
usage token counts (ro)
|
||||
ctxsz context size (ro)
|
||||
s/ sessions ls
|
||||
idx session index (ro) cat: id state cwd backend model, one per line
|
||||
new create session (r/w) cat: KV template; echo "cwd=/path" >
|
||||
|
|
@ -40,7 +49,6 @@ ollie/
|
|||
model active model (r/w)
|
||||
models available models (ro)
|
||||
prompt submit prompt (w)
|
||||
reply last reply (ro)
|
||||
state agent state (ro) idle | thinking | calling: <tool>
|
||||
systemprompt rendered system prompt (ro)
|
||||
usage token counts (ro)
|
||||
|
|
|
|||
Loading…
Reference in New Issue