에러와 실패 모델

import { NoraAuthError, NoraProviderError } from "@conscience-technology/nora-sdk";

try {
  await nora.improvements.approve("imp_1");
} catch (e) {
  if (e instanceof NoraAuthError) {
    // 인증 · 스코프 · 주체 문제
    // 예: read 토큰으로 approve 호출 → e.code === "auth.scope_denied"
  } else if (e instanceof NoraProviderError) {
    // 상위 LLM 프로바이더 문제 (e.retryable 확인)
  }
}

NoraError (base)
  ├── NoraAuthError       : 401 · 스코프 거부 · onBehalfOf 주체 없음
  ├── NoraRequestError    : Flow 없음, 미게시, 필수 스코프 누락
  ├── NoraAccessError     : 리소스 단위 접근 규칙 거부
  ├── NoraProviderError   : 상위 LLM 프로바이더 (.retryable로 판정)
  └── NoraPlatformError   : Nora 서버 5xx, 전송 실패

const nora = createClient({
  // …
  logger: pino(),                       // 여러분의 로깅 스택에 SDK 로그 꽂기
  onLog: (e) => metrics.count(e.event), // SDK 내부 이벤트(재시도, 서킷, 폴백) 관측
  debug: false,                         // true = 요청/응답 본문 포함
});

try {
  return await nora.improvements.approve(id);
} catch (e) {
  if (e instanceof NoraProviderError && e.retryable) {
    // SDK가 이미 maxRetries 안에서 재시도했음. 앱 레벨 재시도는
    // 더 긴 백오프나 dedupe 키 같은 추가 컨텍스트가 있을 때만
    return await withBackoff(() => nora.improvements.approve(id));
  }
  throw e;
}

const r = await nora.flows.run("support", input);

if (r.status === "failed") {
  return { text: fallbackAnswer, traceId: r.traceId, failure: r.failure };
}
if (r.status === "needs_review") {
  await queueForReview(r.traceId);
  return { text: r.outputs.answer, review: true };
}
return { text: r.outputs.answer };

// 답 품질 (사용자가 답을 어떻게 봤는지)
await nora.feedback(traceId, { rating: "dislike", correction: { before, after } });

// 비즈니스 결과 (실제로 다운스트림에서 무슨 일이 있었는지)
await nora.signals.report(traceId, { outcome: "reopened", reason: "다음 날 다시 문의" });