AgentSquad Runtime — Current Implementation Map

AgentSquad 런타임 — 현재 구현 지도

현재 경로

AgentSquad 실행은 단일 제어 경로를 사용합니다.

Studio command
  -> Temporal StudioRunWorkflow
  -> studio_run_activity
  -> execute_pending_run_execution
  -> Studio execute_run
  -> Daytona provider process

기존 Temporal -> LangGraph Agent Server -> Studio -> Daytona 경로는 제거됐습니다. 별도 agent-server 이미지, Argo Application, OpenBao workload identity, queue polling, graph checkpoint는 AgentSquad 실행에 존재하지 않습니다.

한 틱이 하는 일

Studio execute_run은 다음 순서로 상태를 조정합니다.

실행 중 provider process와 first-tool 증거를 관찰합니다.
mailbox handoff가 도착한 terminal session을 같은 profile로 되살립니다.
wall, retry, process-restart intent를 적용합니다.
admission을 통과한 session을 Daytona에 실행합니다.
결과와 delivery evidence를 기록하고 terminal run을 닫습니다.

Temporal은 이 틱을 durable하게 깨우고 재시도하지만 내부 결정을 복제하지 않습니다. Daytona는 workspace/toolbox I/O만 제공합니다.

리소스 모델

목표 토폴로지는 프로젝트당 Daytona sandbox 하나, 영구 profile 여덟 개, 동시 provider process 최대 네 개입니다. 현재 코드는 process cap과 shared-workspace 경로를 갖지만, generation lease, continuity capsule, Git broker, graceful/crash takeover의 전체 실배포 증명은 아직 ADR-0011의 release gate입니다.

프로세스 장애에는 같은 workspace에서 process만 교체합니다. workspace/toolbox death 증거와 정책 승인이 함께 있을 때만 sandbox recovery를 허용합니다.

협업 상태

Handoff는 Studio mailbox의 구조화된 상태입니다. stdout, final prose, lifecycle summary는 handoff 진실이 아닙니다. 최초 launch에는 compact roster snapshot을 주고, 이후 변경은 revisioned delta만 보냅니다. 수신 profile, delivery reference, 요청 내용이 없는 lifecycle noise는 relay하지 않습니다.

운영 증명

완료 판정에는 다음 live evidence가 필요합니다.

배포 digest와 BuildKit 산출 digest 일치
profile 8개, active process peak 4개, project sandbox 1개
Codex→Claude graceful takeover와 crash takeover
dual writer 0건과 stale generation 거부
미인가 MCP 호출 HTTP 403
roster snapshot/delta 전달 및 lifecycle-noise 억제
24시간 resource leak-free soak

소스 테스트나 PR 병합만으로 실런타임 완료를 선언하지 않습니다.