프로젝트 소개

이 패키지는 터미널 기반 AI 코딩 어시스턴트인 OpenCode와 통합되는 Vercel AI SDK용 커뮤니티 프로바이더입니다. 개발자가 OpenCode에 구성된 AI 프로바이더(Anthropic, OpenAI, Google 등)를 표준 AI SDK 인터페이스를 통해 사용할 수 있게 해줍니다. 주요 기능은 다음과 같습니다: - `generateText()` 및 `streamText()`를 통한 텍스트 생성 - SSE를 통한 실시간 스트리밍 - 세션 관리를 통한 다중 턴 대화 - 도구 관찰(서버 측 실행, 사용자 정의 도구 없음) - 도구 승인 흐름 - `onQuestion` 콜백을 통한 대화형 질문 처리 - 파일 및 소스 스트리밍 파트 - 네이티브 JSON 스키마 및 폴백 패턴을 통한 구조화된 출력 - 중단/취소 지원 - AI SDK 오류 유형을 통한 오류 처리 버전 호환성: - v4.x는 AI SDK v7용(최신) - v3.x는 AI SDK v6용(유지보수, 태그 `ai-sdk-v6`) - v2.x 및 v1.x는 v6용 레거시 - v0.x는 v5용(태그 `ai-sdk-v5`) Node.js >= 22 및 OpenCode CLI 설치가 필요합니다. 모델은 `providerID/modelID` 형식으로 지정되며, 예를 들어 `opencode("openai/gpt-5.3-codex-spark")`와 같습니다. 프로바이더 설정을 통해 사용자 지정 호스트 이름, 포트, 서버 자동 시작, 클라이언트 옵션 및 기본 설정을 지정할 수 있습니다. 모델 설정에는 세션 ID, 에이전트 선택, 권한, 변형, 디렉터리 및 질문 정책이 포함됩니다. 이 패키지는 고급 사용자를 위한 고급 유틸리티를 내보내며, 예를 들어 런타임 클래스, 유효성 검사 헬퍼, 이벤트 변환 함수 등이 있습니다. 기본 사용법, 스트리밍, 대화 기록, 구조화된 출력, 도구 관찰, 질문 처리, 중단 신호, 이미지 입력, 사용자 지정 구성, 클라이언트 옵션, 제한 사항 및 장기 실행 작업에 대한 예제가 제공됩니다. 라이선스: MIT