메인 콘텐츠로 건너뛰기
Nora 클라이언트는 npm 패키지로 배포됩니다. TypeScript 우선(타입 포함), fetch와 globalThis를 지원하는 Node 18+ · Deno · Bun · 엣지 워커 어디서든 돕니다.
상태 (2026-09-06): 리포에 구현·tsc 통과, 현재 0.0.1. 공용 npm scope로 게시가 진행 중입니다. 그때까지는 내부 레지스트리에서 설치합니다 (플랫폼 리포 접근 있으면 packages/nora-agents 소스를 vendor로 걸어 씀). API 계약은 안정적이라 공용 게시 시 install URL만 바꾸면 됩니다.

​
설치

​
import

패키지 루트에서 노출되는 이름:
  • createClient(opts) NoraClient를 반환하는 팩토리.
  • NoraClient new로 직접 만들고 싶으면 클래스 자체.
  • 타입: ClientOptions, RunResult, Improvement, Change, Logger, LogEvent.
  • 에러 클래스: NoraError, NoraAuthError, NoraRequestError, NoraAccessError, NoraProviderError, NoraPlatformError. 에러 참고.
  • 트레이스 헬퍼: traceRef, withTrace, currentTrace, injectHeaders, extractTrace, TRACE_HEADER.

​
사전 조건

  • Node 18+ (또는 전역 fetch 있는 런타임). 폴리필 불필요.
  • ESM 전용. 패키지가 "type": "module"로 배포됩니다. 프로젝트가 CommonJS면 dynamic import()를 쓰거나 진입점을 ESM으로 옮기세요.
  • 서버 사이드 전용. 브라우저에서 초기화하면 예외를 던집니다 (PAT · 트리거 시크릿 유출 방지). 개요 · 서버 사이드 전용 참고.

​
버전 pin

프로덕션에서는 다시 설치해도 버전이 밀리지 않도록 정확한 버전을 고정하세요.
업그레이드 때는 semver를 따르세요. 클라이언트 계약은 안정적이지만 옵션 모양은 minor 사이에 확장될 수 있습니다.

​
다음

  • Auth PAT · 트리거 시크릿 발급과 스코프 선택.
  • 클라이언트 옵션 ClientOptions 전체 레퍼런스(baseUrl · 재시도 · 로깅 · 커스텀 fetch · …).