@reopt-ai/brandapp-sdk 4.7.0-rc.6 → 4.7.0-rc.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/CHANGELOG.md +72 -0
  2. package/README.md +1 -0
  3. package/dist/ai/index.d.ts +2 -2
  4. package/dist/ai/index.js +1 -1
  5. package/dist/ai-provider/index.d.ts +31 -3
  6. package/dist/ai-provider/index.js +317 -107
  7. package/dist/analytics/index.js +1 -1
  8. package/dist/auth/index.js +1 -1
  9. package/dist/better-auth/index.js +2 -2
  10. package/dist/{client-C7k9bCwh.js → client-8-voCIn6.js} +2 -2
  11. package/dist/{client-CLsqp1Jn.js → client-B1Yh78Q2.js} +2 -2
  12. package/dist/{client-DEMD0Wo5.js → client-B3mfgfKm.js} +4 -4
  13. package/dist/{client-BrR3dzC_.js → client-C8Fs2kuo.js} +8 -5
  14. package/dist/{client-Dsz0BzpO.d.ts → client-CD6uK0dA.d.ts} +3 -2
  15. package/dist/{client-DVIuxsN7.js → client-CZZ_ENbq.js} +2 -2
  16. package/dist/{client-DMvufVds.js → client-CeRmh20T.js} +22 -13
  17. package/dist/{client-Bi-KSU_r.d.ts → client-Cm7LK9If.d.ts} +52 -12
  18. package/dist/{client-UI1-_F9P.js → client-DM4rX1ng.js} +11 -5
  19. package/dist/{client-DZZEzs2l.js → client-DMKaOPgU.js} +2 -2
  20. package/dist/{client-C1yI9DiK.js → client-DrTi1wIz.js} +2 -2
  21. package/dist/{client-COlwskCB.js → client-GRG2iZTx.js} +2 -2
  22. package/dist/{client-t7ASsw2Q.js → client-IT-ulPXq.js} +2 -2
  23. package/dist/{client-4x4xlk9N.js → client-UlK_7r41.js} +3 -3
  24. package/dist/cms/index.js +1 -1
  25. package/dist/{config-Cb96ydFD.js → config-C4uJ8ixE.js} +16 -3
  26. package/dist/eav/index.js +2 -2
  27. package/dist/feedback/index.js +1 -1
  28. package/dist/files/index.js +1 -1
  29. package/dist/{http-client-DIewtTz2.js → http-client-DdW_W7IB.js} +29 -6
  30. package/dist/{index-VolJHcFS.d.ts → index-Dd_2Eq1a.d.ts} +23 -4
  31. package/dist/index.d.ts +2 -2
  32. package/dist/index.js +12 -12
  33. package/dist/installation/index.js +3 -3
  34. package/dist/logout/index.js +1 -1
  35. package/dist/machine/index.js +1 -1
  36. package/dist/plans/index.d.ts +1 -1
  37. package/dist/plans/index.js +1 -1
  38. package/dist/push/index.js +1 -1
  39. package/dist/{query-jbkDQ1o2.js → query-okRw8nVs.js} +2 -2
  40. package/dist/react/hooks.d.ts +2 -2
  41. package/dist/social/index.d.ts +284 -0
  42. package/dist/social/index.js +306 -0
  43. package/dist/terms/index.js +1 -1
  44. package/dist/testing/index.d.ts +1 -1
  45. package/dist/workspace/index.js +1 -1
  46. package/docs/api-reference.md +66 -11
  47. package/docs/machine.md +5 -0
  48. package/docs/social.md +92 -0
  49. package/package.json +7 -3
package/CHANGELOG.md CHANGED
@@ -7,6 +7,78 @@ This project adheres to [Semantic Versioning](https://semver.org/).
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [4.7.0-rc.8] — 2026-10-29
11
+
12
+ Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 도구 루프 정산·경고·끊김 처리.
13
+
14
+ ### Added
15
+
16
+ - `usage.creditCostMilli`·`providerMetadata.brandapp.creditCostMilli` — 실제 사용량(1/1000 크레딧).
17
+ `creditCost`는 올림한 정수 표시값이라 1크레딧 미만 단계도 1로 보인다. 도구 루프처럼 한 턴에 여러 단계를
18
+ 부르는 앱은 milli를 더한 뒤 한 번만 올림한다. 옛 서버 응답에는 없으므로 선택 필드다.
19
+ - 서버·모델 경고가 AI SDK의 `warnings`로 온다 — 모델이 무시한 설정, 도구 강제로 꺼진 thinking 등. 비스트리밍은
20
+ 응답 `warnings`, 스트리밍은 첫 `warnings` SSE 이벤트(SDK가 `stream-start`에 합친다). `sdk.ai` 타입에
21
+ `CompletionWarning`을 더했다.
22
+ - 403 `CLIENT_TOOLS_DISABLED`·`CLIENT_TOOLS_PLAN_REQUIRED`의 `diagnostic`이 고칠 자리(AI 설정의 도구 호출
23
+ 허용 · Business 플랜)를 가리킨다.
24
+
25
+ ### Changed
26
+
27
+ - 비스트리밍(`generateText`)의 기본 한도를 응답 전체 300초로 늘렸다 — 예전에는 스트리밍 유휴 한도와 같은
28
+ 60초가 응답 본문까지 덮어 추론·긴 JSON 응답이 끊겼다. 스트리밍은 그대로 청크 사이 60초다. `timeout`을
29
+ 지정하면 둘 다 그 값이다.
30
+ - 서버: 호출 앱이 연결을 끊으면(`abortSignal`, 탭 닫기) 모델 호출도 멈춘다 — 예전에는 끝까지 생성하고 전액
31
+ 과금했다. 끊긴 단계는 읽은 입력 + 이미 보낸 출력으로 과금한다.
32
+ - 서버: `maxTokens`(AI SDK `maxOutputTokens`)를 주지 않으면 4096이 아니라 앱 AI 설정의 최대 출력 토큰
33
+ (기본 8192)까지 쓴다 — 추론 모델과 큰 JSON 응답이 잘렸다.
34
+ - 서버: `-thinking` Anthropic 모델에 사고 요약(`display: "summarized"`)을 요청한다 — Claude 5 계열 기본값
35
+ (`omitted`)에서는 추론 파트가 텍스트 없이 서명만 왔다.
36
+
37
+ ## [4.7.0-rc.7] — 2026-10-28
38
+
39
+ Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — AI SDK provider의 도구 호출·구조화 출력·추론 파트 왕복.
40
+
41
+ ### Added
42
+
43
+ - `createBrandappProvider` — **도구 호출·구조화 출력·추론 파트 왕복**. `tools`·`toolChoice`(auto·none·required·
44
+ 특정 도구), `responseFormat: json`을 더 이상 `UnsupportedFunctionalityError`로 거절하지 않는다. 도구는 앱이
45
+ 실행하고 서버는 호출만 돌려준다 — `ToolLoopAgent`·`streamText` + `stopWhen` 루프가 그대로 동작하고, 단계마다
46
+ `providerMetadata.brandapp.creditCost`가 실린다. 스트림은 `reasoning-start/delta/end`·`tool-input-start/delta/end`·
47
+ `tool-call`(한 단계에 여럿 가능) 파트를 내고, 추론 파트의 `providerMetadata`(Anthropic 서명 등)를 다음 요청으로
48
+ 되돌린다. 도구 결과는 `execution-denied`·`content`(텍스트)까지 손실 없이 옮긴다(예전에는 텍스트로 뭉갰다).
49
+ `usage`에 캐시 읽기·쓰기·추론 토큰이 채워진다. 추론 강도는 `providerOptions.brandapp.reasoningEffort`
50
+ (또는 `anthropic.effort`·`openai.reasoningEffort`). 그 밖의 요청 단위 `providerOptions`는 무시한다.
51
+ **서버 쪽 전제**: 브랜드앱 AI 설정의 "도구 호출·구조화 출력 허용" + Business 플랜 — 아니면
52
+ `403 CLIENT_TOOLS_DISABLED` / `CLIENT_TOOLS_PLAN_REQUIRED`.
53
+ - `/ai` 타입 — `CompletionResult.content`(응답 파트), `CompletionUsage`(캐시·추론 토큰), `CompletionContentPart`,
54
+ `PartProviderMetadata`.
55
+
56
+ ### Changed
57
+
58
+ - provider 실행 도구(`type: "provider"`)는 요청 전에 `UnsupportedFunctionalityError`로 거절한다. 비전·파일 입력은
59
+ 여전히 거절한다.
60
+
61
+ - `@reopt-ai/brandapp-sdk/social` — 소셜 운영 플랫폼 API(RFC-0037 §7) 클라이언트 `createSocialClient`(scope
62
+ `social:read`·`social:write`): `accounts.list`, `contents.list/convert`, `posts.list/get/transition/propose`,
63
+ `reviews.run`. 모든 채널은 직접 게시라 플랫폼에 올리는 호출은 없고, 승인·게시 기록·취소는 승인함 **제안**이다.
64
+ - `/social` 계정 `profile.reviewChecklist`(RFC-0038) — 계정별 검수 기준 항목 `{text, severity}`. 응답·저장 스키마 둘 다 선택 칸.
65
+ `/workspace`와 요청기를 공유한다(`createPlatformRequester`). 문서 `docs/social.md`.
66
+ - `/social` — 글(`SocialPost`)에 `links`(변환이 본문 URL을 바꿔 넣은 추적 링크: `originalUrl`·`shortUrl`·`clicks`).
67
+ `clicks`는 리옵트 링크 원장의 누적 클릭이지 플랫폼 반응이 아니다.
68
+
69
+ ### Fixed
70
+
71
+ - 기계 자격(`authorization: machine.headers`, RFC-0034)이 **손으로 짠 요청 경로**에도 실린다 —
72
+ `ai.stream()`·`ai.streamWithMetadata()`(SSE), `files.upload()`, `files.readContent()`,
73
+ `createBrandappProvider`(언어·이미지 모델). 지금까지 이 경로들은 정적 `Basic base64("<clientId>:")`를
74
+ 보내 `401 Missing clientId or clientSecret`로 실패했다(`http.fetch`를 타는 `models`·`complete` 등은 정상).
75
+ DPoP 증명은 요청마다, 스트림 연결 재시도마다 새로 받는다. `createBrandappProvider`가 `authorization`을 받는다.
76
+ 손으로 요청을 짜는 코드는 `http.authorizationHeader` 대신 `http.requestAuthHeaders({ method, url })`를 쓴다.
77
+
78
+ - 서버 — `changePlan`으로 바꾼 플랜의 `paymentEnvironment`가 `null`로 오던 것. 바뀐 플랜에는 자기 체크아웃이 없어
79
+ "모름"이 됐고, 그 값으로 실 결제·테스트 결제만 인정하는 앱은 올린 고객의 이용권을 거뒀다. 이제 그 구독을 시작한
80
+ 체크아웃의 환경을 말한다(SDK 코드 변경 없음, 문서만).
81
+
10
82
  ## [4.7.0-rc.6] — 2026-10-15
11
83
 
12
84
  Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — 해지 예약 구독 재개(`plans.resume`)와 해지 기간 중 새 결제 차단.
package/README.md CHANGED
@@ -405,6 +405,7 @@ const meta = asJson<Meta>(record.values.meta); // Meta | undefined
405
405
  | `"./webhooks"` | `createWebhookHandler`, `verifySignature` | No |
406
406
  | `"./react/hooks"` | TanStack Query hooks (`useAiCredits`, `useEavRecords`, …) | No |
407
407
  | `"./workspace"` | `createPlatformClient` — workspace-scoped platform API (**server-only**) | No |
408
+ | `"./social"` | `createSocialClient` — social operations platform API: convert · review · submit · propose (**server-only**) | No |
408
409
  | `"./machine"` | `createMachineClient`, `readClientKeyRing`, `buildClientJwks` — machine credentials (**server-only**) | No (`@better-auth/core`) |
409
410
  | `"./resource"` | `createResourceVerifier`, `createRedisDpopReplayStore` — verify reopt machine tokens on your API (**server-only**) | No (`@better-auth/core`) |
410
411
  | `"./superadmin"` | `requireOperator`, `evaluateOperator`, `decodeIdTokenClaims` — operator guard from reopt id-token claims | No |
@@ -1,2 +1,2 @@
1
- import { a as CompletionOptions, c as FinishReason, d as MessageRole, f as ModelInfo, i as ChatMessage, l as ImageGenerateOptions, m as StreamEvent, n as createReoptAiClient, o as CompletionResult, p as StreamDoneData, r as AgentInfo, s as CreditInfo, t as ReoptAiClient, u as ImageGenerateResult } from "../client-Bi-KSU_r.js";
2
- export { type AgentInfo, type ChatMessage, type CompletionOptions, type CompletionResult, type CreditInfo, type FinishReason, type ImageGenerateOptions, type ImageGenerateResult, type MessageRole, type ModelInfo, ReoptAiClient, type StreamDoneData, type StreamEvent, createReoptAiClient };
1
+ import { _ as StreamDoneData, a as CompletionContentPart, c as CompletionUsage, d as FinishReason, f as ImageGenerateOptions, g as PartProviderMetadata, h as ModelInfo, i as ChatMessage, l as CompletionWarning, m as MessageRole, n as createReoptAiClient, o as CompletionOptions, p as ImageGenerateResult, r as AgentInfo, s as CompletionResult, t as ReoptAiClient, u as CreditInfo, v as StreamEvent } from "../client-Cm7LK9If.js";
2
+ export { type AgentInfo, type ChatMessage, type CompletionContentPart, type CompletionOptions, type CompletionResult, type CompletionUsage, type CompletionWarning, type CreditInfo, type FinishReason, type ImageGenerateOptions, type ImageGenerateResult, type MessageRole, type ModelInfo, type PartProviderMetadata, ReoptAiClient, type StreamDoneData, type StreamEvent, createReoptAiClient };
package/dist/ai/index.js CHANGED
@@ -1,3 +1,3 @@
1
- import { n as createReoptAiClient, t as ReoptAiClient } from "../client-BrR3dzC_.js";
1
+ import { n as createReoptAiClient, t as ReoptAiClient } from "../client-C8Fs2kuo.js";
2
2
 
3
3
  export { ReoptAiClient, createReoptAiClient };
@@ -1,12 +1,26 @@
1
+ import { n as ReoptSDKConfig } from "../config-BGT9h1OW.js";
1
2
  import { ImageModelV3, ImageModelV3CallOptions, LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, ProviderV3 } from "@ai-sdk/provider";
2
3
  //#region src/ai-provider/brandapp-language-model.d.ts
3
4
  type BrandappLanguageModelConfig = {
4
5
  /** BrandApp API base URL */
5
6
  baseUrl: string;
6
- /** Basic Auth 헤더 (base64 인코딩된 clientId:clientSecret) */
7
+ /** 정적 Authorization 헤더 (Basic 또는 Bearer) — `authorization`이 없을 때만 쓴다 */
7
8
  authHeader: string;
8
- /** 요청 타임아웃 (ms) */
9
+ /**
10
+ * 요청별 인증 헤더 제공자(RFC-0034 기계 클라이언트 DPoP). 있으면 `authHeader` 대신 매 요청
11
+ * 새로 받는다 — DPoP 증명은 메서드·URL에 묶이고 jti를 한 번만 쓸 수 있다.
12
+ */
13
+ authorization?: (request: {
14
+ method: string;
15
+ url: string;
16
+ }) => Promise<Record<string, string>>;
17
+ /** 요청 타임아웃 (ms) — 스트리밍에서는 청크 사이의 유휴 한도다. */
9
18
  timeout: number;
19
+ /**
20
+ * 비스트리밍(`doGenerate`)의 전체 한도(ms) — 응답 본문까지 기다린다. 추론·긴 JSON 응답은
21
+ * 60초를 넘기 쉬워 따로 둔다. 없으면 `timeout`.
22
+ */
23
+ generateTimeout?: number;
10
24
  /** SDK 버전 문자열 */
11
25
  sdkVersion: string;
12
26
  /** BrandappCustomer ID (사용량 추적) */
@@ -14,10 +28,14 @@ type BrandappLanguageModelConfig = {
14
28
  /** 커스텀 fetch 함수 */
15
29
  fetch?: typeof globalThis.fetch;
16
30
  };
31
+ /** 추론 강도 — 지원 모델에만 전달된다(서버가 판정). */
32
+ type BrandappReasoningEffort = "low" | "medium" | "high";
17
33
  /** BrandApp 프로바이더 옵션 (providerOptions.brandapp으로 전달) */
18
34
  type BrandappProviderOptions = {
19
35
  /** BrandappCustomer ID (사용량 추적) */
20
36
  customerId?: string;
37
+ /** 추론 강도. 없으면 `anthropic.effort`·`openai.reasoningEffort`를 읽는다. */
38
+ reasoningEffort?: BrandappReasoningEffort;
21
39
  };
22
40
  declare class BrandappLanguageModel implements LanguageModelV3 {
23
41
  readonly specificationVersion: "v3";
@@ -70,6 +88,13 @@ type BrandappProviderConfig = {
70
88
  brandappId: string;
71
89
  /** Short-lived service token minted by `/token/mint`. */
72
90
  token?: string;
91
+ /**
92
+ * RFC-0034 per-request auth header provider — pass `machine.headers` from
93
+ * `createMachineClient`. Every request then carries `Authorization: DPoP …`
94
+ * plus a fresh `DPoP` proof, and no clientSecret is needed (same contract as
95
+ * `ReoptSDKConfig.authorization`).
96
+ */
97
+ authorization?: ReoptSDKConfig["authorization"];
73
98
  /**
74
99
  * 프로덕션 환경 여부.
75
100
  * - `true`: https://brandapp.reopt.ai
@@ -79,7 +104,10 @@ type BrandappProviderConfig = {
79
104
  isProduction?: boolean;
80
105
  /** 커스텀 base URL */
81
106
  baseUrl?: string;
82
- /** 요청 타임아웃 ms (기본 60000 — AI 응답은 시간이 걸림) */
107
+ /**
108
+ * 요청 타임아웃 ms. 스트리밍은 청크 사이 유휴 한도(기본 60000), 비스트리밍(`generateText`)은
109
+ * 응답 전체 한도(기본 300000 — 추론·긴 JSON 응답). 지정하면 둘 다 이 값이다.
110
+ */
83
111
  timeout?: number;
84
112
  /** 기본 customerId (모든 요청에 적용) */
85
113
  customerId?: string;