harivansh-afk/sandbox-agent
1
0
Fork 0
mirror of https://github.com/harivansh-afk/sandbox-agent.git synced 2026-04-15 14:03:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
sandbox-agent/research/specs/toolcall-file-actions.md
Nathan Flurry 8a31519786
chore: specs for unimplemented work (#70)
2026-02-04 13:45:31 -08:00

1.1 KiB
Raw Permalink Blame History

Spec: Tool Calls + File Actions (Session Manager)

Proposed API Changes

  • Add tool call lifecycle tracking in the core session manager (call started, delta, completed, result).
  • Add file action integration (write/patch/rename/delete) with audited events.

Summary OpenCode expects tool calls and file actions to surface through message parts and events. The core session manager must track tool call lifecycles and file actions reliably.

OpenCode Endpoints (Reference)

  • GET /opencode/event
  • GET /opencode/global/event
  • POST /opencode/session/{sessionID}/message

Core Functionality Required

  • Explicit tool call tracking with call IDs, arguments, outputs, timing, and status.
  • File action execution (write/patch/rename/delete) with safe path scoping.
  • Emission of file edit events tied to actual writes.
  • Mapping tool call and file action data into universal events for conversion.

OpenCode Compat Wiring + Tests

  • Replace stubbed tool/file part generation with real data sourced from session manager tool/file APIs.
  • Add E2E tests to validate tool call lifecycle events and file edit events.