SDK 개요
공개된 4개 패키지의 역할과 레퍼런스입니다.
SNA는 네 개 패키지를 계층별로 배포합니다.
@sna-sdk/core
서버, session manager, runtime adapter, completion().
@sna-sdk/client
TypeScript 클라이언트. HTTP + WebSocket 전송.
@sna-sdk/react
React 훅 + 드롭인 채팅 UI.
@sna-sdk/testing
Mock LLM API + 격리된 실제 런타임 테스트 helper.
버저닝
네 패키지는 함께 릴리즈됩니다. 버전은 SNA 프로토콜 버전입니다. SNA가
0.x.x 라인에 있는 동안에는 마이너 릴리즈에서도 SDK나 런타임 동작이
바뀔 수 있으므로, 프로덕션 앱에서는 네 패키지를 모두 같은 정확한 버전으로
고정하십시오. 릴리즈별 공개 API 변경은 CHANGELOG에
정리됩니다.
라이브 OpenAPI 스펙
실행 중인 서버는 자신의 OpenAPI 3.1 스펙을 직접 제공합니다. Swagger UI는
http://localhost:3099/docs, 원시 JSON은
http://localhost:3099/openapi.json, 평문은
http://localhost:3099/spec. 스펙은 라우트가 쓰는 같은 Zod 스키마
에서 생성되므로 실제 핸들러와 드리프트할 수 없습니다.