Streamable HTTP CLI flag

[angiejones]

Introduces support for streamable HTTP extensions in the Goose CLI. The changes include updates to the CLI commands, session builder, documentation, and tests to accommodate the new functionality. The most significant changes are grouped below by theme. fixes #3393

Code Changes Made

1. CLI Arguments (crates/goose-cli/src/cli.rs):

   • Added streamable_http_extensions: Vec<String> field to both Session and Run command structs
   • Added proper help text and documentation

2. Session Builder (crates/goose-cli/src/session/builder.rs):

   • Added streamable_http_extensions field to SessionBuilderConfig
   • Added processing loop for streamable HTTP extensions
   • Updated tests to include the new field

3. Session Implementation (crates/goose-cli/src/session/mod.rs):

   • Added add_streamable_http_extension() method that creates ExtensionConfig::StreamableHttp configurations
   • Includes proper error handling and completion cache invalidation

4. Benchmark Support (crates/goose-cli/src/commands/bench.rs):

   • Added the new field to benchmark configuration

Documentation Updates

• Updated the documentation in getting-started/using-extensions.md to include examples and parameters for using streamable HTTP extensions.
• Enhanced the CLI commands documentation in guides/goose-cli-commands.md to describe the new --with-streamable-http-extension option.
• Added examples for running tasks with streamable HTTP extensions in guides/running-tasks.md.

Tests

• Updated session builder tests to validate the functionality of streamable HTTP extensions.

Testing Results

• ✅ Compilation: Code compiles successfully
• ✅ Help Output: New flag appears in --help for both commands
• ✅ Functionality: Flag correctly attempts to create StreamableHttp extensions
• ✅ Error Handling: Gracefully handles connection failures
• ✅ Backward Compatibility: Existing SSE functionality unchanged
• ✅ Code Quality: Passes cargo fmt and cargo clippy checks
• ✅ Unit Tests: All relevant tests pass

Usage Examples

Start a session with a streamable HTTP extension

goose session --with-streamable-http-extension "http://example.com"

Run a task with multiple streamable HTTP extensions

goose run --text "analyze data" \
  --with-streamable-http-extension "http://api1.example.com" \
  --with-streamable-http-extension "http://api2.example.com"

Mix different extension types

goose session \
  --with-extension "echo hello" \
  --with-remote-extension "http://sse.example.com/sse" \
  --with-streamable-http-extension "http://http.example.com" \
  --with-builtin "developer"

[github-actions]

PR Preview Action v1.6.0
Preview removed because the pull request was closed.
2025-07-13 23:11 UTC

[michaelneale]

seems nice - docs and CLI only change