Skip to content

Add per-session PTY timeout support#35

Open
Llacoste2000 wants to merge 3 commits intoshekohex:mainfrom
Llacoste2000:feat/pty-timeout-pr
Open

Add per-session PTY timeout support#35
Llacoste2000 wants to merge 3 commits intoshekohex:mainfrom
Llacoste2000:feat/pty-timeout-pr

Conversation

@Llacoste2000
Copy link
Copy Markdown
Contributor

@Llacoste2000 Llacoste2000 commented Apr 16, 2026

Summary

  • add an optional timeoutSeconds spawn parameter and enforce per-session PTY timeouts in the lifecycle manager while preserving session logs after auto-stop
  • expose timeout metadata in PTY outputs, notifications, and REST session creation so agents can distinguish timed-out sessions from regular exits
  • document timeout usage guidance and add focused coverage across tool, notification, web, and integration flows

Allow PTY sessions to carry timeoutSeconds through the public spawn
contract and enforce the timeout in the lifecycle manager.

This stops orphaned PTY commands automatically while preserving
session logs and exposing timeout context in list, read, and exit
notifications.
Add focused coverage for timeoutSeconds plumbing, timedOut metadata,
REST validation, and timeout-driven session termination.

This keeps the new PTY timeout behavior locked down across tool,
notification, web, and integration surfaces.
Update the public PTY contract to show timeoutSeconds in examples
and explain when agents should avoid or prefer a timeout.

This keeps long-lived sessions like dev servers alive by default
while encouraging timeouts for builds and finite test runs.
@shekohex shekohex added the enhancement New feature or request label Apr 16, 2026
@shekohex shekohex self-requested a review April 16, 2026 20:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants