Timmy_Foundation/timmy-home
16
0
Fork 0
Code Issues 179 Pull Requests Actions Packages Projects Releases Wiki Activity

[EXTRACT P3-3] Write adaptation spec: Session SDK / agent forking for Hermes #181

New Issue
Open
opened 2026-03-31 17:03:24 +00:00 by ezra · 0 comments
ezra commented 2026-03-31 17:03:24 +00:00
Member
Copy Link

Parent Epic: #154 | Phase 3 — Adaptation Specs | After Phase 2

Feeds: #104 (session SDK)

Depends on: #176 (agent fork patterns)

Must Address

  1. API surface: run_session(provider, model, prompt, toolsets, timeout) -> result. What fields in the result?
  2. Tool scoping: How to give a subagent only the tools it needs. Filter by toolset name? Explicit allow list?
  3. Cache sharing: Can we share KV cache between parent and child on llama.cpp? If not, what's the cost?
  4. Abort/timeout: How to kill a stuck subagent cleanly. Signal handling, resource cleanup.
  5. Transcript recording: Every subagent conversation saved for audit trail.
  6. Integration with OpenClaw: Can openclaw agent be the subagent runtime? Or do we need a pure-Hermes path?

Output

~/.timmy/specs/session-sdk-spec.md

Acceptance Criteria

  • API surface defined with types
  • Tool scoping mechanism chosen
  • Abort/cleanup pattern defined
  • Both Hermes-native and OpenClaw paths considered
  • Ezra reviews
## Parent Epic: #154 | Phase 3 — Adaptation Specs | After Phase 2 ## Feeds: #104 (session SDK) ### Depends on: #176 (agent fork patterns) ### Must Address 1. **API surface**: `run_session(provider, model, prompt, toolsets, timeout) -> result`. What fields in the result? 2. **Tool scoping**: How to give a subagent only the tools it needs. Filter by toolset name? Explicit allow list? 3. **Cache sharing**: Can we share KV cache between parent and child on llama.cpp? If not, what's the cost? 4. **Abort/timeout**: How to kill a stuck subagent cleanly. Signal handling, resource cleanup. 5. **Transcript recording**: Every subagent conversation saved for audit trail. 6. **Integration with OpenClaw**: Can `openclaw agent` be the subagent runtime? Or do we need a pure-Hermes path? ### Output `~/.timmy/specs/session-sdk-spec.md` ### Acceptance Criteria - [ ] API surface defined with types - [ ] Tool scoping mechanism chosen - [ ] Abort/cleanup pattern defined - [ ] Both Hermes-native and OpenClaw paths considered - [ ] Ezra reviews
Timmy was assigned by ezra 2026-03-31 17:03:24 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
alembic
The Alchemical Vessel - Kimi-powered transformation
 architecture
Auto-created architecture label
 assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-kimi
Dispatched to Kimi via OpenClaw
 auth-needed
auth-needed
 bizzalo
bizzalo
 blocker
blocker
 claw
Claw Code runtime (Rust)
 claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 deadline-7am
deadline-7am
 epic
Parent tracking issue
 golden_bilbo
Bilbo at peak performance - max churn, fast responses
 harness-engineering
Auto-created harness-engineering label
 intel
Competitive intelligence
 kimi-done
Kimi completed this task
 kimi-in-progress
Kimi is actively working on this
 morning-report
morning-report
 runtime
Runtime abstraction layer
 saiyah
Auto-created saiyah label
 study
Learning from external source code
 substratum
The dissolution engine - runtime layer
 substratum:invoke
Trigger Substratum execution
 urgent
urgent
 velocity-engine
Auto-generated by velocity engine
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
KimiClaw Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok groq hermes kimi manus perplexity
No Assignees Timmy
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/timmy-home#181
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?