TanStack AI 1.0 사용법: 업그레이드·에이전트와 안전한 권한 설정
TanStack AI 1.0은 자바스크립트·타입스크립트 앱에서 채팅, 도구 호출, 이미지·음성, MCP, 에이전트를 한 흐름으로 구성하는 오픈소스 툴킷의 첫 안정 버전입니다. 핵심은 “모든 것이 안정화됐다”가 아닙니다. 기존 채팅·도구·미디어·어댑터 중심의 코어 API는 1.0으로 안정화 됐지만, 장시간 작업과 하위 에이전트를 관리하는 새 Agent Harness는 여전히 실험 버전 입니다. 따라서 새 프로젝트는 안정 코어로 작게 시작하고, 기존 0.x 프로젝트는 패키지를 한꺼번에 올린 뒤 타입 검사와 저장 데이터 이전을 마쳐야 합니다. 코딩 에이전트 하네스는 별도 시험 브랜치와 샌드박스에서 평가하는 편이 안전합니다. 핵심 요약 @tanstack/ai* 의 안정 패키지는 1.0으로 함께 업데이트합니다. 클라이언트와 서버 모두 같은 1.0 계열을 사용해야 합니다. threadId 는 브라우저와 서버에서 직접 안정적인 값으로 전달해야 합니다. @tanstack/ai-harness 와 하네스 CLI는 0.x 실험 단계입니다. 권한 플러그인은 승인 흐름이지 샌드박스가 아닙니다. 신뢰하지 않는 코드는 격리 환경에서 실행합니다. TanStack AI 1.0에서 달라진 경계 공식 발표에 따르면 1.0 코어는 23개 공급자 어댑터와 OpenAI 호환 어댑터, 여러 UI 프레임워크, 도구 호출, 미디어 생성, 지속성, MCP를 하나의 타입 시스템 아래 제공합니다. chat() 과 각 프레임워크의 채팅 훅을 이용하는 일반적인 제품 기능은 이제 1.0을 기준으로 설계할 수 있습니다. 반면 Agent Harness는 한 대화가 오래 살아 있으면서 새 메시지를 받고, 승인을 기다리고, 하위 에이전트를 실행하고, 배포나 장애 뒤에도 이어지는 작업을 만들기 위한 별도 계층입니다. 기능은 풍부하지만 관련 패키지가 아직 0.x이고, 마이너 업데이트에서도 API가 바뀔 수 있습니다. 구분 1.0 안정 코어 실험 Agent Harness 주요 목적 채팅, 도구...