feat: add runtime lifecycle configuration (idle timeout and max lifetime)

[tejaskash]

Summary

Adds runtime lifecycle configuration support, allowing users to control idle session timeout and max instance lifetime for agent runtimes. Both values are optional and accept a range of 60-28800 seconds.

• New --idle-timeout and --max-lifetime CLI flags on create and add agent commands
• Full TUI support in both the Create (GenerateWizard) and Add Agent (BYO) flows under Advanced settings
• Schema validation with cross-field constraint (idle timeout must be <= max lifetime)
• Shared lifecycle-utils.ts validation module used by both CLI and TUI paths
• Values written to lifecycleConfiguration in agentcore.json and passed through to CDK

TUI: Advanced flow with lifecycle steps

When a user selects "Yes, customize" in the Advanced settings step, the breadcrumb expands to include Idle Timeout and Max Lifetime:

  ✓ Name →  ✓ Type →  ✓ Code →  ✓ Build →  ✓ Model →  ✓ Advanced →  ● Network
  ○ Headers →  ○ Idle Timeout →  ○ Max Lifetime →  ○ Confirm

TUI: Idle Timeout input

  ✓ Headers →  ● Idle Timeout →  ○ Max Lifetime →  ○ Confirm

  ╭──────────────────────────────────────────────────────────╮
  │ Idle session timeout in seconds (60-28800, or press      │
  │ Enter to skip)                                           │
  │ > 600  ✓                                                 │
  ╰──────────────────────────────────────────────────────────╯

TUI: Max Lifetime input

  ✓ Headers →  ✓ Idle Timeout →  ● Max Lifetime →  ○ Confirm

  ╭──────────────────────────────────────────────────────────╮
  │ Max instance lifetime in seconds (60-28800, or press     │
  │ Enter to skip)                                           │
  │ > 14400  ✓                                               │
  ╰──────────────────────────────────────────────────────────╯

TUI: Review screen showing lifecycle values

  ╭──────────────────────────────────────────────────────────╮
  │ Review Configuration                                     │
  │                                                          │
  │   Name: LifecycleAgent                                   │
  │   Type: Bring my own code                                │
  │   Code Location: app/LifecycleAgent/                     │
  │   Entrypoint: main.py                                    │
  │   Build: Direct Code Deploy                              │
  │   Model Provider: Bedrock                                │
  │   Network Mode: PUBLIC                                   │
  │   Headers: Authorization                                 │
  │   Idle Timeout: 600s                                     │
  │   Max Lifetime: 14400s                                   │
  │                                                          │
  │ Enter confirm · Esc back                                 │
  ╰──────────────────────────────────────────────────────────╯

CLI flags

  --idle-timeout <seconds>     Idle session timeout in seconds (60-28800) [non-interactive]
  --max-lifetime <seconds>     Max instance lifetime in seconds (60-28800) [non-interactive]

CDK Companion PR

https://github.com/aws/agentcore-l3-cdk-constructs/pull/109

Test plan

• Unit tests for lifecycle-utils.ts validation (15 tests)
• Schema validation tests for lifecycleConfiguration in AgentEnvSpecSchema (cross-field superRefine)
• useGenerateWizard unit tests for lifecycle state management
• create and add command validation tests for --idle-timeout / --max-lifetime
• schema-mapper tests verifying lifecycle config flows to agent spec
• Integration tests verifying CLI flags produce correct config in agentcore.json
• TUI integration tests (Create flow + BYO flow)
• E2E test support: lifecycle config passed through create, verified via AWS GetAgentRuntime API
• All existing tests pass after rebase on main

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🔵	Lines	45.37%	5982 / 13183
🔵	Statements	44.97%	6355 / 14131
🔵	Functions	44.42%	1111 / 2501
🔵	Branches	45.84%	3953 / 8622

Generated in workflow #1324 for commit ad06702 by the Vitest Coverage Report Action