TanStack AI 1.0: 안정 API 약속의 AI 개발 툴킷 정식 출시, 하네스 실험적

TanStack 공식 블로그 · ax-trend 이슈 #3490 · 2026-10-23 발표

TanStack AI 1.0 — 안정 API 약속과 실험적 에이전트 하네스
개요 — TanStack이 10월 23일 AI 개발 툴킷 TanStack AI 1.0을 정식 출시했다

1.0의 약속은 기능이 아니라 계약이다

TanStack은 10월 23일 공식 블로그에서 TanStack AI 1.0을 발표했다. 발표자는 Alem Tuzlak, Jack Herrington, Tom Beckenham, Tanner Linsley 4명이다. 1.0의 핵심 약속은 코어 API의 안정화다. 공식 문장은 이렇다.

"1.0 is our formal commitment to the APIs you build on"

2025년 12월 alpha 이후 0.x에서 deprecated로 표시된 API는 전부 제거됐고, 대체 API는 이미 0.x에 들어와 있다. 1.0은 새 기능을 쏟아내는 릴리스가 아니라, 그 위에 제품을 올려도 된다는 계약을 굳히는 릴리스에 가깝다. 같은 팀의 TanStack Start도 10월 13일에 1.0을 찍었다.

묶은 것의 규모 — 어댑터 23개, 프레임워크 9종, 샌드박스 11곳

1.0이 한 번에 묶은 지원 규모는 세 숫자로 요약된다. 프로바이더 어댑터 23개, UI 프레임워크 9종, 샌드박스 프로바이더 11곳이다.

1.0이 묶은 지원 규모 — 프로바이더 어댑터 23개, UI 프레임워크 9종, 샌드박스 프로바이더 11곳
지원 규모 — 프로바이더 어댑터 23개, UI 프레임워크 9종, 샌드박스 프로바이더 11곳 (TanStack 공식 블로그 10/23 기준)

프로바이더 어댑터 23개에 openaiCompatible이 추가됐다. OpenAI 스타일 API면 무엇이든 연결된다는 뜻이라, 모델을 바꾸는 비용이 설정 한 줄 수준으로 줄어든다. UI 프레임워크는 React, Vue, Solid, Svelte, Preact, Angular, Octane, Remix, vanilla JS 9종이다. 코딩 에이전트 통합은 Claude Code, Codex, OpenCode, Grok Build와 모든 ACP(Agent Client Protocol) 에이전트를 지원하고, 샌드박스는 E2B, Blaxel, Upstash Box, boxd, Railway 등 11곳을 붙인다. 슬로건은 "Your provider, your framework, your sandbox" — 특정 클라우드나 프레임워크에 종속되지 않겠다는 약속을 1.0에서 API 계약으로 굳힌 셈이다.

1.0까지의 길 — alpha에서 10개월

TanStack AI 1.0까지의 길 — 2025-12 alpha, 2026-06 Beta, 2026-08 RC, 2026-10-23 1.0
타임라인 — 2025년 12월 alpha(chat() 하나, 프로바이더 4개) → 2026년 6월 Beta → 2026년 8월 RC → 2026년 10월 23일 1.0

TanStack AI는 2025년 12월 alpha(chat() 하나, 프로바이더 4개)로 출발해 2026년 6월 Beta와 2026 Open Source Awards 'AI Project of the Year', 8월 RC(아키텍처 고정)를 거쳤다. RC(8/21) 이후 추가된 기능도 1.0에 들어와 있다. chat()·useChat의 서브에이전트, 형이 있는 선택·점수·불리언 판단을 하는 decide(), 어떤 도구 호출 모델이든 SKILL.md를 필요할 때 로드하는 Portable Agent Skills, Compaction, 스크린샷으로 웹페이지를 조작하는 Computer use(OpenAI·Anthropic 동일 코드), 양방향 WebMCP, 자신의 TanStack 도구를 Claude Desktop·Cursor용 MCP 서버로 제공하는 createMCPServer다.

실험실에 남은 하네스 — 안정 코어와는 선이 다르다

실험적 에이전트 하네스 @tanstack/ai-harness도 함께 공개됐다. durable session(크래시·배포 후에도 턴이 이어짐), 형이 있는 에이전트(예산·타임아웃), 플러그인, 백그라운드 작업, 터미널용 자체 코딩 에이전트(runCli)까지 만든다. 다만 하네스 패키지는 0.x라 API가 minor 버전에서 바뀔 수 있다. 복구에도 한계가 명시돼 있다. in-memory 자식 에이전트 대기는 호스트를 넘나들며 재개되지 않는다.

안정 코어와 실험 하네스의 경계가 문서상 명확하지만, 실제 마이그레이션에서 어디까지가 "안정"인지 팀별 판단이 필요하다. 하네스에 기대는 설계는 0.x 변경 가능성을 전제로 짜는 편이 맞다.

올릴 때 확인할 것 — codemod 1회, 서버·클라이언트 동반 상승

0.x 사용자는 codemod 1회와 타입 체크로 업그레이드한다. 1.0 클라이언트는 1.0 서버가 필요해 안정 패키지는 함께 올려야 한다. @tanstack/ai-react-ui·ai-solid-ui·ai-vue-ui 3개는 1.0이 없으니 createChatHook 계열로 바꿔야 한다. 문서 페이지는 전부 다시 썼다. 작은 팀(메인테이너 3명)이지만 컨트리뷰터 143명이 참여했다.

아직 확인되지 않은 것

발표에 없는 것은 없는 것으로 읽는 편이 맞다. 아래는 발표에서 확인되지 않은 부분이다.

실무에서 가져갈 것

앱에 AI 기능을 넣는 개발자에게 프로바이더 교체 비용이 곧바로 줄어든다. 23개 어댑터와 openaiCompatible이면 모델 교체가 설정 변경에 가까워진다.

AX TF 관점에서는 "에이전트 기능을 제품에 넣을 때의 하네스" 레퍼런스로 쓸 만하다. 특히 durable session과 approval 대기 구조는 백그라운드 에이전트 설계의 교본이 된다. 코딩 에이전트를 샌드박스에서 돌리는 패턴(어느 CLI든 ACP로 붙임)이 표준화된다는 점도, 에이전트 실행 환경을 설계할 때 참고할 만하다.

원문 이슈

AX TrendAI 코딩