Skip to content

Add Session API Design#1

Open
markturansky wants to merge 1 commit intomainfrom
feat/session-api-design
Open

Add Session API Design#1
markturansky wants to merge 1 commit intomainfrom
feat/session-api-design

Conversation

@markturansky
Copy link
Owner

Summary

Proposes a unified Session API that abstracts over different session providers (tmux, Paude, Ambient) while maintaining existing Agent Boss coordination capabilities.

Key Features

  • 🎯 SessionProvider Interface: Standardized create/start/stop/delete/message operations
  • 📋 Unified Session Model: Provider-agnostic status, configuration, and metadata
  • 🔗 REST API: Complete HTTP endpoints that integrate with existing architecture
  • 🔄 Backward Compatibility: Existing agent coordination unchanged
  • ⚙️ Multi-Provider Support: tmux (local), Paude (containers), Ambient (cloud)
  • 📝 Declarative Configuration: Space-specific overrides and agent templates

Implementation Plan

Phase 1: Core abstraction + TmuxProvider
Phase 2: PaudeProvider integration
Phase 3: Enhanced management + monitoring
Phase 4: AmbientProvider + cloud sessions

Benefits

  • Unified Management: Same API across local/container/cloud
  • Provider Choice: Optimal session type per use case
  • Clean Architecture: Session management separated from coordination
  • Future-Proof: Easy to add new providers (K8s, Lambda, etc.)

This design enables Agent Boss to scale from local development to production cloud deployment while keeping the coordination model that makes it effective.

🤖 Generated with Claude Code

Proposes unified session abstraction over tmux, Paude, and Ambient providers.

Key features:
- SessionProvider interface for create/start/stop/delete/message operations
- REST API endpoints for session management
- Provider-agnostic Session model with unified status/config
- Backward compatibility with existing agent coordination
- Configuration system with space-specific overrides
- 4-phase implementation plan

Enables consistent session management across local, container, and cloud
environments while maintaining Agent Boss coordination capabilities.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant