TinyClaw: Add session tools and orchestration runway (extend #560)
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 25/100
Research direction
Start with crates/terraphim_tinyclaw/src/tools/session_tools.rs and the existing ToolRegistry wiring in tools/mod.rs, then read session.rs and agent/agent_loop.rs for the current session context. Use tests/session_tools_integration.rs as the validation entry point; done means the listed session tools work safely for the current user/session, while spawn and cron remain sequenced through #560 and #594.
Written by the indexing model from the issue text.
Description
Summary
Add session tools and orchestration runway in TinyClaw:
- sessions_list
- sessions_history
- sessions_send
Then sequence spawn/cron extensions without duplicating existing tracked work.
Extend Existing Terraphim Functionality
- Reuse existing issue #560 for spawn implementation baseline.
- Keep orchestration as additive tooling over TinyClaw + Terraphim crates.
Related
- #560 TinyClaw: Add agent spawning tool via terraphim_spawner (existing)
- #594 TinyClaw: add cron orchestration tool after session/spawn baseline (sequenced follow-up)
Implementation Notes
- crates/terraphim_tinyclaw/src/tools/session_tools.rs (new)
- crates/terraphim_tinyclaw/src/tools/agent_spawn.rs (new baseline aligned to #560)
- crates/terraphim_tinyclaw/src/tools/mod.rs
- crates/terraphim_tinyclaw/src/session.rs
- crates/terraphim_tinyclaw/src/main.rs
- crates/terraphim_tinyclaw/src/agent/agent_loop.rs
- crates/terraphim_tinyclaw/tests/session_tools_integration.rs (new)
Acceptance Criteria
- Session tools are exposed in ToolRegistry and work with current session store.
- Session history can be queried safely by current user/session context.
- Spawn integration references and extends #560, not duplicated.
- Cron work is split into a follow-up sequenced sub-issue after session/spawn baseline (#594).
References
- docs/plans/tinyclaw-openclaw-parity-design-2026-02-27.md (Step 5)
- Dominant language
- Rust
- Stars
- 62
- Forks
- 5
- Avg merge
- 2h 27m
- Merged PRs (30d)
- 1
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from terraphim/terraphim-ai
-
Difficulty 5/5 Over a week Newbie friendliness 25/100
terraphim/terraphim-ai#885 ·
-
Difficulty 4/5 3-5 days Newbie friendliness 55/100
terraphim/terraphim-ai#871 ·
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 25/100
terraphim/terraphim-ai#810 · 2 comments ·
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 35/100
terraphim/terraphim-ai#729 ·
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 35/100
terraphim/terraphim-ai#728 ·
All issues in terraphim/terraphim-ai
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
MystenLabs/sui#28056 · 1 comment ·
-
type/bug
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Luminous-Dynamics/mycelix#2577 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
registrystack/registry-stack#1239 ·
-
package-request
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
msys2/MINGW-packages#31806 ·