TanStack AI main, 화면용 활동 메시지·ActivityStore 추가

이번 소식

TanStack AI의 main 개발 브랜치에 화면에서 보여 줄 활동 메시지와 선택적 저장소가 추가됐습니다. AI 앱의 진행 상태 등을 대화 화면에 남기되 모델에 보내는 대화 내용과는 분리하는 변경입니다. 정식 패키지 출시 소식은 아닙니다.

달라진 점

• AG-UI의 ACTIVITY_SNAPSHOT·ACTIVITY_DELTA를 role: 'activity' 메시지로 처리합니다. 전체 상태와 이후 변경분을 화면에 전달하는 방식입니다.
• 활동 메시지는 클라이언트에 보관하지만 모델 입력과 메시지 재전송에서는 제외합니다.
• 선택적 ActivityStore를 연결하면 reconstructChat으로 대화를 복원할 때 활동 기록도 되살릴 수 있습니다.

어떤 점이 달라지나요?

TanStack AI로 앱을 만드는 개발자는 화면용 진행 정보와 실제 모델 대화를 따로 관리할 수 있습니다. 예를 들어 작업 상태를 보여 주는 앱에 활용할 수 있지만, 실제 제품에서의 동작이나 비용 절감 효과를 검증한 것은 아닙니다.

사용 전 확인할 점

UIMessage.role을 빠짐없이 분기하는 코드는 activity 처리를 점검해야 합니다. 사용자 정의 저장 어댑터에서 활동 복원을 원하면 stores.activities 구현이 필요합니다. 활동 저장은 실패할 수 있는 방식이므로 새로고침 뒤 기록이 누락될 수 있고, 활동을 포함한 페이지 조회는 전체 스레드를 읽습니다.

공식 출처·변경 시점

main 병합: 2026년 10월 6일 18:35:26 KST. 포함된 정식 릴리스는 확인되지 않았으며, 실제 앱 실행 시험은 수행하지 않았습니다.