feat: implement zombie turn management with internal API endpoints and add terminationGracePeriodSeconds

[thesujai]

Summary

Closes #

Changes

How was this tested?

Checklist

• I have read the contributing guidelines
• pnpm build, pnpm test, pnpm typecheck, pnpm lint:ci, and pnpm format:check pass locally
• Tests added/updated where it makes sense
• No hand-edits to generated code (packages/trueforge-sdk, python/trueforge_sdk, .github/fern/openapi/openapi.json, docs/openapi.json) — fork PRs omit SDK regen; maintainers regenerate after merge
• Docs / .env.example updated if configuration or behavior changed

---

Note

Medium Risk
Automatically cancels turns based on staleness, which can end agent work if thresholds are wrong or activity is not recorded; Helm default termination grace jumps from ~35s to 300s unless overridden.

Overview
Adds an abandoned-turn closer so long-idle running turns do not stay stuck forever. The controller runs a new periodic loop that calls internal HTTP APIs to list stale running turns (last activity older than ABANDONED_TURN_STALE_MS, default 15m) and close them in batches (ABANDONED_TURN_CLOSE_BATCH / ABANDONED_TURN_CLOSER_INTERVAL_MS), emitting turn.done with CancellationReason.Abandoned.

Session stores gain listStaleRunningTurns (Postgres/SQLite/in-memory) keyed off last event time or turn.created_at. Service-key routes live at /api/internal/turns/abandoned and /close-abandoned, wired through cancelSessionTurn like other cancellations. OpenAPI and TS/Python SDKs are regenerated for client.internal.turns.

Helm now sets pod terminationGracePeriodSeconds from server.terminationGracePeriodSeconds (default 300) instead of gracefulTimeoutSeconds + 5, with docs/env examples for the new knobs.

^{Reviewed by Cursor Bugbot for commit 433eea4. Bugbot is set up for automated code reviews on this repo. Configure here.}

[changeset-bot]

🦋 Changeset detected

Latest commit: e77649f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@truefoundry/trueforge-sdk	Patch
@truefoundry/trueforge-core	Patch
@truefoundry/trueforge	Patch
@truefoundry/trueforge-ui	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want higher recall? High effort reviews run extra passes and find more bugs. A team admin can switch effort levels in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit e77649f. Configure here.}