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

1,012 B
Raw Blame History

Spec: Command + Shell Execution

Proposed API Changes

  • Add command execution APIs to the core session manager (non-PTY, single-shot).
  • Define output capture and error handling semantics in the session event stream.

Summary OpenCode routes for command/shell execution should run real commands in the session context and stream outputs to OpenCode message parts and events.

OpenCode Endpoints (Reference)

  • GET /opencode/command
  • POST /opencode/session/{sessionID}/command
  • POST /opencode/session/{sessionID}/shell

Core Functionality Required

  • Execute commands with cwd/env + timeout support.
  • Capture stdout/stderr, exit code, and duration.
  • Optional streaming output to session events.
  • Map command output into OpenCode message.part.updated events.

OpenCode Compat Wiring + Tests

  • Replace stubs for /command, /session/{sessionID}/command, /session/{sessionID}/shell.
  • Add E2E tests to run a simple command and validate output is returned and events are emitted.