@reopt-ai/brandapp-sdk 4.7.0-rc.7 → 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 (43) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/dist/ai/index.d.ts +2 -2
  3. package/dist/ai/index.js +1 -1
  4. package/dist/ai-provider/index.d.ts +10 -2
  5. package/dist/ai-provider/index.js +48 -15
  6. package/dist/analytics/index.js +1 -1
  7. package/dist/auth/index.js +1 -1
  8. package/dist/better-auth/index.js +2 -2
  9. package/dist/{client-B6_Xb3wb.js → client-8-voCIn6.js} +2 -2
  10. package/dist/{client-CSgUG6cr.js → client-B1Yh78Q2.js} +2 -2
  11. package/dist/{client-DsDLAw6j.js → client-B3mfgfKm.js} +4 -4
  12. package/dist/{client-DzT410Wt.js → client-C8Fs2kuo.js} +4 -4
  13. package/dist/{client-eFjdCptM.js → client-CZZ_ENbq.js} +2 -2
  14. package/dist/{client-BPkjuPIU.js → client-CeRmh20T.js} +3 -3
  15. package/dist/{client-CRgkPwMT.d.ts → client-Cm7LK9If.d.ts} +22 -2
  16. package/dist/{client-CRpW6BTX.js → client-DM4rX1ng.js} +3 -3
  17. package/dist/{client-B-Zlh9In.js → client-DMKaOPgU.js} +2 -2
  18. package/dist/{client-B1KTMiad.js → client-DrTi1wIz.js} +2 -2
  19. package/dist/{client-CRa691YR.js → client-GRG2iZTx.js} +2 -2
  20. package/dist/{client-Ds11v9rE.js → client-IT-ulPXq.js} +2 -2
  21. package/dist/{client-XKbUKjFD.js → client-UlK_7r41.js} +3 -3
  22. package/dist/cms/index.js +1 -1
  23. package/dist/{config-2_4Q71Vj.js → config-C4uJ8ixE.js} +16 -3
  24. package/dist/eav/index.js +2 -2
  25. package/dist/feedback/index.js +1 -1
  26. package/dist/files/index.js +1 -1
  27. package/dist/{http-client-DUR4EBMw.js → http-client-DdW_W7IB.js} +2 -2
  28. package/dist/{index-Bxfokriz.d.ts → index-Dd_2Eq1a.d.ts} +2 -2
  29. package/dist/index.d.ts +2 -2
  30. package/dist/index.js +12 -12
  31. package/dist/installation/index.js +3 -3
  32. package/dist/logout/index.js +1 -1
  33. package/dist/machine/index.js +1 -1
  34. package/dist/plans/index.js +1 -1
  35. package/dist/push/index.js +1 -1
  36. package/dist/{query-CXZTvFbH.js → query-okRw8nVs.js} +2 -2
  37. package/dist/react/hooks.d.ts +2 -2
  38. package/dist/social/index.js +1 -1
  39. package/dist/terms/index.js +1 -1
  40. package/dist/testing/index.d.ts +1 -1
  41. package/dist/workspace/index.js +1 -1
  42. package/docs/api-reference.md +16 -6
  43. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,33 @@ 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
+
10
37
  ## [4.7.0-rc.7] — 2026-10-28
11
38
 
12
39
  Pre-release (`npm i @reopt-ai/brandapp-sdk@next`) — AI SDK provider의 도구 호출·구조화 출력·추론 파트 왕복.
@@ -1,2 +1,2 @@
1
- import { _ as StreamEvent, a as CompletionContentPart, c as CompletionUsage, d as ImageGenerateOptions, f as ImageGenerateResult, g as StreamDoneData, h as PartProviderMetadata, i as ChatMessage, l as CreditInfo, m as ModelInfo, n as createReoptAiClient, o as CompletionOptions, p as MessageRole, r as AgentInfo, s as CompletionResult, t as ReoptAiClient, u as FinishReason } from "../client-CRgkPwMT.js";
2
- export { type AgentInfo, type ChatMessage, type CompletionContentPart, type CompletionOptions, type CompletionResult, type CompletionUsage, type CreditInfo, type FinishReason, type ImageGenerateOptions, type ImageGenerateResult, type MessageRole, type ModelInfo, type PartProviderMetadata, 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-DzT410Wt.js";
1
+ import { n as createReoptAiClient, t as ReoptAiClient } from "../client-C8Fs2kuo.js";
2
2
 
3
3
  export { ReoptAiClient, createReoptAiClient };
@@ -14,8 +14,13 @@ type BrandappLanguageModelConfig = {
14
14
  method: string;
15
15
  url: string;
16
16
  }) => Promise<Record<string, string>>;
17
- /** 요청 타임아웃 (ms) */
17
+ /** 요청 타임아웃 (ms) — 스트리밍에서는 청크 사이의 유휴 한도다. */
18
18
  timeout: number;
19
+ /**
20
+ * 비스트리밍(`doGenerate`)의 전체 한도(ms) — 응답 본문까지 기다린다. 추론·긴 JSON 응답은
21
+ * 60초를 넘기 쉬워 따로 둔다. 없으면 `timeout`.
22
+ */
23
+ generateTimeout?: number;
19
24
  /** SDK 버전 문자열 */
20
25
  sdkVersion: string;
21
26
  /** BrandappCustomer ID (사용량 추적) */
@@ -99,7 +104,10 @@ type BrandappProviderConfig = {
99
104
  isProduction?: boolean;
100
105
  /** 커스텀 base URL */
101
106
  baseUrl?: string;
102
- /** 요청 타임아웃 ms (기본 60000 — AI 응답은 시간이 걸림) */
107
+ /**
108
+ * 요청 타임아웃 ms. 스트리밍은 청크 사이 유휴 한도(기본 60000), 비스트리밍(`generateText`)은
109
+ * 응답 전체 한도(기본 300000 — 추론·긴 JSON 응답). 지정하면 둘 다 이 값이다.
110
+ */
103
111
  timeout?: number;
104
112
  /** 기본 customerId (모든 요청에 적용) */
105
113
  customerId?: string;
@@ -1,4 +1,4 @@
1
- import { i as resolveBaseUrl, j as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig, r as assertBrowserSafe } from "../config-2_4Q71Vj.js";
1
+ import { i as resolveBaseUrl, j as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig, r as assertBrowserSafe } from "../config-C4uJ8ixE.js";
2
2
  import { t as createManagedAbort } from "../abort--nOBFN4M.js";
3
3
  import { t as createAuthHeader } from "../encoding-Bwfm3iaE.js";
4
4
  import { t as createSSELineProcessor } from "../sse-parser-FMjxM7sY.js";
@@ -326,6 +326,22 @@ function pickReasoningEffort(providerOptions) {
326
326
  providerOptions?.openai?.reasoningEffort
327
327
  ].find((v) => typeof v === "string" && REASONING_EFFORTS.has(v));
328
328
  }
329
+ /** `warnings` SSE 이벤트 본문 — 깨졌으면 버린다(경고 때문에 스트림을 죽이지 않는다). */
330
+ function parseWarnings(data) {
331
+ try {
332
+ const parsed = JSON.parse(data);
333
+ return Array.isArray(parsed) ? parsed : [];
334
+ } catch {
335
+ return [];
336
+ }
337
+ }
338
+ /**
339
+ * 실제 사용량(1/1000 크레딧)을 providerMetadata.brandapp에 싣는다 — `creditCost`는 올림한
340
+ * 표시값이라 단계마다 더하면 과대 계상된다. 옛 서버는 보내지 않으므로 있을 때만 싣는다.
341
+ */
342
+ function milliOf(usage) {
343
+ return Number.isFinite(usage.creditCostMilli) ? { creditCostMilli: usage.creditCostMilli } : {};
344
+ }
329
345
  function toV3Usage(usage) {
330
346
  const cacheRead = usage.cacheReadTokens;
331
347
  const cacheWrite = usage.cacheWriteTokens;
@@ -384,7 +400,10 @@ var BrandappLanguageModel = class {
384
400
  const fetchFn = this.config.fetch ?? globalThis.fetch;
385
401
  const url = `${this.config.baseUrl}/chat/completions`;
386
402
  const requestId = newRequestId(this.config.sdkVersion);
387
- const response = await fetchWithTimeout(this.config, fetchFn, url, {
403
+ const response = await fetchWithTimeout({
404
+ ...this.config,
405
+ timeout: this.config.generateTimeout ?? this.config.timeout
406
+ }, fetchFn, url, {
388
407
  method: "POST",
389
408
  headers: mergeProviderHeaders({
390
409
  ...this.baseHeaders,
@@ -419,6 +438,7 @@ var BrandappLanguageModel = class {
419
438
  usage: toV3Usage(data.usage),
420
439
  providerMetadata: { brandapp: {
421
440
  creditCost: data.usage.creditCost,
441
+ ...milliOf(data.usage),
422
442
  creditsRemaining: data.creditsRemaining,
423
443
  responseId: data.id
424
444
  } },
@@ -428,7 +448,7 @@ var BrandappLanguageModel = class {
428
448
  body: json,
429
449
  modelId: data.model
430
450
  },
431
- warnings
451
+ warnings: [...warnings, ...data.warnings ?? []]
432
452
  };
433
453
  }
434
454
  async doStream(options) {
@@ -705,6 +725,7 @@ var BrandappLanguageModel = class {
705
725
  },
706
726
  providerMetadata: { brandapp: {
707
727
  creditCost: meta.usage.creditCost,
728
+ ...milliOf(meta.usage),
708
729
  creditsRemaining: meta.creditsRemaining
709
730
  } }
710
731
  });
@@ -759,19 +780,30 @@ var BrandappLanguageModel = class {
759
780
  return body.pipeThrough(new TransformStream({
760
781
  transform(chunk, controller) {
761
782
  managed.kick();
762
- if (!emittedStreamStart) {
763
- controller.enqueue({
764
- type: "stream-start",
765
- warnings
766
- });
767
- controller.enqueue({
768
- type: "response-metadata",
769
- timestamp: /* @__PURE__ */ new Date(),
770
- modelId
771
- });
772
- emittedStreamStart = true;
773
- }
774
783
  if (!processor) processor = createSSELineProcessor((sseEvent) => {
784
+ if (!emittedStreamStart) {
785
+ const serverWarnings = sseEvent.event === "warnings" ? parseWarnings(sseEvent.data) : [];
786
+ controller.enqueue({
787
+ type: "stream-start",
788
+ warnings: [...warnings, ...serverWarnings]
789
+ });
790
+ controller.enqueue({
791
+ type: "response-metadata",
792
+ timestamp: /* @__PURE__ */ new Date(),
793
+ modelId
794
+ });
795
+ emittedStreamStart = true;
796
+ if (sseEvent.event === "warnings") {
797
+ if (includeRawChunks) controller.enqueue({
798
+ type: "raw",
799
+ rawValue: {
800
+ event: sseEvent.event,
801
+ data: sseEvent.data
802
+ }
803
+ });
804
+ return;
805
+ }
806
+ }
775
807
  processSSEEvent(sseEvent, controller);
776
808
  });
777
809
  processor.feed(decoder.decode(chunk, { stream: true }));
@@ -916,6 +948,7 @@ function createBrandappProvider(config) {
916
948
  authHeader: createAuthHeader(sdkConfig),
917
949
  authorization: config.authorization,
918
950
  timeout: config.timeout ?? 6e4,
951
+ generateTimeout: config.timeout ?? 3e5,
919
952
  sdkVersion: SDK_VERSION,
920
953
  customerId: config.customerId,
921
954
  fetch: config.fetch
@@ -1,4 +1,4 @@
1
- import { n as createReoptAnalyticsClient, t as ReoptAnalyticsClient } from "../client-CRa691YR.js";
1
+ import { n as createReoptAnalyticsClient, t as ReoptAnalyticsClient } from "../client-GRG2iZTx.js";
2
2
  import { getInstance, identify, init, pageView, setConsent, track } from "@reopt-ai/data-sdk";
3
3
 
4
4
  //#region src/analytics/browser.ts
@@ -1,4 +1,4 @@
1
- import { n as createReoptAuthClient, t as ReoptAuthClient } from "../client-B-Zlh9In.js";
1
+ import { n as createReoptAuthClient, t as ReoptAuthClient } from "../client-DMKaOPgU.js";
2
2
 
3
3
  //#region src/auth/session.ts
4
4
  /**
@@ -1,5 +1,5 @@
1
- import { O as isReoptSDKError, S as ReoptSDKError, a as resolveIdBaseUrl, s as AuthError, t as REOPT_BASE_URLS, w as ServerError, x as RateLimitError } from "../config-2_4Q71Vj.js";
2
- import { t as BaseHttpClient } from "../http-client-DUR4EBMw.js";
1
+ import { O as isReoptSDKError, S as ReoptSDKError, a as resolveIdBaseUrl, s as AuthError, t as REOPT_BASE_URLS, w as ServerError, x as RateLimitError } from "../config-C4uJ8ixE.js";
2
+ import { t as BaseHttpClient } from "../http-client-DdW_W7IB.js";
3
3
  import { o as readClientKeyRing } from "../keys-B_R_lsyF.js";
4
4
  import { a as STEP_UP_MAX_AUTH_AGE_SECONDS, i as REOPT_STEP_UP_PROVIDER_ID, n as REOPT_PROVIDER_ID, r as REOPT_PROVIDER_IDS, t as REOPT_DEFAULT_SCOPES } from "../types-DGAVaUCc.js";
5
5
  import { createAdapterFactory } from "better-auth/adapters";
@@ -1,4 +1,4 @@
1
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
1
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
2
2
 
3
3
  //#region src/push/client.ts
4
4
  var ReoptPushClient = class {
@@ -25,4 +25,4 @@ function createReoptPushClient(config) {
25
25
 
26
26
  //#endregion
27
27
  export { createReoptPushClient as n, ReoptPushClient as t };
28
- //# sourceMappingURL=client-B6_Xb3wb.js.map
28
+ //# sourceMappingURL=client-8-voCIn6.js.map
@@ -1,4 +1,4 @@
1
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
1
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
2
2
 
3
3
  //#region src/plans/client.ts
4
4
  function unwrap(body) {
@@ -143,4 +143,4 @@ function createReoptPlansClient(config) {
143
143
 
144
144
  //#endregion
145
145
  export { createReoptPlansClient as n, ReoptPlansClient as t };
146
- //# sourceMappingURL=client-CSgUG6cr.js.map
146
+ //# sourceMappingURL=client-B1Yh78Q2.js.map
@@ -1,6 +1,6 @@
1
- import { S as ReoptSDKError, u as BadRequestError } from "./config-2_4Q71Vj.js";
2
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
3
- import { t as buildQuery } from "./query-CXZTvFbH.js";
1
+ import { S as ReoptSDKError, u as BadRequestError } from "./config-C4uJ8ixE.js";
2
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
3
+ import { t as buildQuery } from "./query-okRw8nVs.js";
4
4
 
5
5
  //#region src/eav/cache.ts
6
6
  var SchemaCache = class {
@@ -603,4 +603,4 @@ function createReoptEavClient(config) {
603
603
 
604
604
  //#endregion
605
605
  export { RECORDS_PAGE_LIMIT_MAX as i, ATTRIBUTE_FILTER_LIST_MAX as n, ATTRIBUTE_FILTER_OPERATORS as r, createReoptEavClient as t };
606
- //# sourceMappingURL=client-DsDLAw6j.js.map
606
+ //# sourceMappingURL=client-B3mfgfKm.js.map
@@ -1,6 +1,6 @@
1
- import { S as ReoptSDKError, j as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig } from "./config-2_4Q71Vj.js";
1
+ import { S as ReoptSDKError, j as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig } from "./config-C4uJ8ixE.js";
2
2
  import { t as createManagedAbort } from "./abort--nOBFN4M.js";
3
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
3
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
4
4
  import { n as parseSSEStream } from "./sse-parser-FMjxM7sY.js";
5
5
 
6
6
  //#region src/ai/client.ts
@@ -231,7 +231,7 @@ var ReoptAiClient = class {
231
231
  }
232
232
  async fetchSSE(options) {
233
233
  const url = `${this.http.requestBaseUrl}/chat/completions`;
234
- const requestId = globalThis.crypto?.randomUUID?.() ?? `sdk-${"4.7.0-rc.7"}-${url.length}`;
234
+ const requestId = globalThis.crypto?.randomUUID?.() ?? `sdk-${"4.7.0-rc.8"}-${url.length}`;
235
235
  const ctx = {
236
236
  method: "POST",
237
237
  url,
@@ -312,4 +312,4 @@ function createReoptAiClient(config) {
312
312
 
313
313
  //#endregion
314
314
  export { createReoptAiClient as n, ReoptAiClient as t };
315
- //# sourceMappingURL=client-DzT410Wt.js.map
315
+ //# sourceMappingURL=client-C8Fs2kuo.js.map
@@ -1,4 +1,4 @@
1
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
1
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
2
2
 
3
3
  //#region src/feedback/client.ts
4
4
  function buildListQuery(query) {
@@ -83,4 +83,4 @@ function createReoptFeedbackClient(config) {
83
83
 
84
84
  //#endregion
85
85
  export { createReoptFeedbackClient as n, ReoptFeedbackClient as t };
86
- //# sourceMappingURL=client-eFjdCptM.js.map
86
+ //# sourceMappingURL=client-CZZ_ENbq.js.map
@@ -1,6 +1,6 @@
1
- import { n as SDK_VERSION } from "./config-2_4Q71Vj.js";
1
+ import { n as SDK_VERSION } from "./config-C4uJ8ixE.js";
2
2
  import { o as readClientKeyRing } from "./keys-B_R_lsyF.js";
3
- import { r as createMachineClient } from "./client-Ds11v9rE.js";
3
+ import { r as createMachineClient } from "./client-IT-ulPXq.js";
4
4
  import { z } from "zod";
5
5
 
6
6
  //#region src/workspace/schemas.ts
@@ -742,4 +742,4 @@ function createPlatformClient(config) {
742
742
 
743
743
  //#endregion
744
744
  export { platformWebhookUpsertInputSchema as $, platformEavSchemaOperationSchema as A, platformPipelineResourceSchema as B, platformBrandappResourceSchema as C, platformEavEntityResourceSchema as D, platformEavBrandappResourcesSchema as E, platformMeSchema as F, platformResourcesSchema as G, platformPipelineStageInputSchema as H, platformOAuthClientImportInputSchema as I, platformTaskStageInputSchema as J, platformResourcesV2Schema as K, platformOAuthClientResourceSchema as L, platformExternalIdSchema as M, platformLockAcquiredSchema as N, platformEavSchemaApplyInputSchema as O, platformLockReleasedSchema as P, platformWebhookSchema as Q, platformOAuthClientUpsertInputSchema as R, platformBrandUpsertInputSchema as S, platformCustomerUpsertInputSchema as T, platformPipelineUpsertInputSchema as U, platformPipelineSchema as V, platformResourceKeySchema as W, platformTaskUpsertInputSchema as X, platformTaskStageSchema as Y, platformWebhookResourceSchema as Z, PLATFORM_TASK_PRIORITIES as _, createPlatformClient as a, platformBrandImportInputSchema as b, PLATFORM_ADMIN_SCOPE as c, PLATFORM_MANAGED_BY_VALUES as d, platformWorkTaskStageChangedEventSchema as et, PLATFORM_OAUTH_APPLICATION_TYPES as f, PLATFORM_TASK_OUTCOMES as g, PLATFORM_STAGE_COLORS as h, REOPT_PLATFORM_URLS as i, platformErrorSchema as j, platformEavSchemaApplyResultSchema as k, PLATFORM_BRANDAPP_STATUSES as l, PLATFORM_OAUTH_GRANT_TYPES as m, PlatformApiError as n, createPlatformRequester as o, PLATFORM_OAUTH_CLIENT_PURPOSES as p, platformTaskSchema as q, REOPT_PLATFORM_ID_URLS as r, resolvePlatformUrls as s, DEFAULT_PLATFORM_SCOPES as t, platformWriteMetaSchema as tt, PLATFORM_DOMAIN_STATUSES as u, PLATFORM_TOKEN_ENDPOINT_AUTH_METHODS as v, platformBrandappUpsertInputSchema as w, platformBrandResourceSchema as x, PLATFORM_WEBHOOK_TRIGGERS as y, platformPipelineImportInputSchema as z };
745
- //# sourceMappingURL=client-BPkjuPIU.js.map
745
+ //# sourceMappingURL=client-CeRmh20T.js.map
@@ -48,11 +48,29 @@ type CompletionContentPart = {
48
48
  toolName: string;
49
49
  input: string;
50
50
  };
51
+ /**
52
+ * 모델·서버 경고 — AI SDK의 `SharedV3Warning`과 같은 모양이다. 무시된 설정(temperature 등)·도구 강제
53
+ * 해제처럼 요청이 말한 대로 실행되지 않은 것. AI SDK provider는 이것을 `warnings`로 넘긴다.
54
+ */
55
+ type CompletionWarning = {
56
+ type: "unsupported" | "compatibility";
57
+ feature: string;
58
+ details?: string;
59
+ } | {
60
+ type: "other";
61
+ message: string;
62
+ };
51
63
  /** AI 사용량 — 캐시·추론 토큰은 각각 prompt·completion 토큰의 부분집합이다. */
52
64
  type CompletionUsage = {
53
65
  promptTokens: number;
54
66
  completionTokens: number;
67
+ /** 올림한 정수 표시값 — 1크레딧 미만 호출도 1로 보인다. 합산은 `creditCostMilli`로 한다. */
55
68
  creditCost: number;
69
+ /**
70
+ * 실제 사용량(1/1000 크레딧). 1크레딧 미만은 잔액이 아니라 우수리에 쌓였다가 1000을 넘을 때
71
+ * 떼어지므로, 여러 호출을 한 턴으로 묶는 앱은 이 값을 더한 뒤 한 번만 올림한다.
72
+ */
73
+ creditCostMilli?: number;
56
74
  cacheReadTokens?: number;
57
75
  cacheWriteTokens?: number;
58
76
  reasoningTokens?: number;
@@ -77,6 +95,8 @@ type CompletionResult = {
77
95
  * 0으로 소진). 다음 호출은 사전 사용량 체크에서 차단된다 — "1회 후 차단" 의도.
78
96
  */
79
97
  creditLimited?: boolean;
98
+ /** 요청대로 실행되지 않은 것 — 있을 때만 온다. */
99
+ warnings?: CompletionWarning[];
80
100
  };
81
101
  /** 사용량 잔액 정보 */
82
102
  type CreditInfo = {
@@ -300,5 +320,5 @@ declare class ReoptAiClient {
300
320
  }
301
321
  declare function createReoptAiClient(config: ReoptSDKConfig): ReoptAiClient;
302
322
  //#endregion
303
- export { StreamEvent as _, CompletionContentPart as a, CompletionUsage as c, ImageGenerateOptions as d, ImageGenerateResult as f, StreamDoneData as g, PartProviderMetadata as h, ChatMessage as i, CreditInfo as l, ModelInfo as m, createReoptAiClient as n, CompletionOptions as o, MessageRole as p, AgentInfo as r, CompletionResult as s, ReoptAiClient as t, FinishReason as u };
304
- //# sourceMappingURL=client-CRgkPwMT.d.ts.map
323
+ export { StreamDoneData as _, CompletionContentPart as a, CompletionUsage as c, FinishReason as d, ImageGenerateOptions as f, PartProviderMetadata as g, ModelInfo as h, ChatMessage as i, CompletionWarning as l, MessageRole as m, createReoptAiClient as n, CompletionOptions as o, ImageGenerateResult as p, AgentInfo as r, CompletionResult as s, ReoptAiClient as t, CreditInfo as u, StreamEvent as v };
324
+ //# sourceMappingURL=client-Cm7LK9If.d.ts.map
@@ -1,6 +1,6 @@
1
- import { S as ReoptSDKError, j as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig } from "./config-2_4Q71Vj.js";
1
+ import { S as ReoptSDKError, j as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig } from "./config-C4uJ8ixE.js";
2
2
  import { t as createManagedAbort } from "./abort--nOBFN4M.js";
3
- import { n as parseFieldErrors, t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
3
+ import { n as parseFieldErrors, t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
4
4
 
5
5
  //#region src/files/client.ts
6
6
  var ReoptFileClient = class {
@@ -276,4 +276,4 @@ function createReoptFileClient(config) {
276
276
 
277
277
  //#endregion
278
278
  export { createReoptFileClient as n, ReoptFileClient as t };
279
- //# sourceMappingURL=client-CRpW6BTX.js.map
279
+ //# sourceMappingURL=client-DM4rX1ng.js.map
@@ -1,4 +1,4 @@
1
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
1
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
2
2
 
3
3
  //#region src/auth/client.ts
4
4
  function unwrap(body) {
@@ -50,4 +50,4 @@ function createReoptAuthClient(config) {
50
50
 
51
51
  //#endregion
52
52
  export { createReoptAuthClient as n, ReoptAuthClient as t };
53
- //# sourceMappingURL=client-B-Zlh9In.js.map
53
+ //# sourceMappingURL=client-DMKaOPgU.js.map
@@ -1,4 +1,4 @@
1
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
1
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
2
2
 
3
3
  //#region src/terms/client.ts
4
4
  function unwrap(body) {
@@ -80,4 +80,4 @@ function createReoptTermsClient(config) {
80
80
 
81
81
  //#endregion
82
82
  export { createReoptTermsClient as n, ReoptTermsClient as t };
83
- //# sourceMappingURL=client-B1KTMiad.js.map
83
+ //# sourceMappingURL=client-DrTi1wIz.js.map
@@ -1,4 +1,4 @@
1
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
1
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
2
2
 
3
3
  //#region src/analytics/client.ts
4
4
  var ReoptAnalyticsClient = class {
@@ -17,4 +17,4 @@ function createReoptAnalyticsClient(config) {
17
17
 
18
18
  //#endregion
19
19
  export { createReoptAnalyticsClient as n, ReoptAnalyticsClient as t };
20
- //# sourceMappingURL=client-CRa691YR.js.map
20
+ //# sourceMappingURL=client-GRG2iZTx.js.map
@@ -1,4 +1,4 @@
1
- import { a as resolveIdBaseUrl } from "./config-2_4Q71Vj.js";
1
+ import { a as resolveIdBaseUrl } from "./config-C4uJ8ixE.js";
2
2
  import { o as readClientKeyRing, s as toPublicJwk } from "./keys-B_R_lsyF.js";
3
3
  import { createPrivateKeyJwtClientAssertionGetter } from "@better-auth/core/oauth2";
4
4
  import * as jose from "jose";
@@ -191,4 +191,4 @@ function createMachineClient(config) {
191
191
 
192
192
  //#endregion
193
193
  export { createDpopProof as n, createMachineClient as r, MachineTokenError as t };
194
- //# sourceMappingURL=client-Ds11v9rE.js.map
194
+ //# sourceMappingURL=client-IT-ulPXq.js.map
@@ -1,5 +1,5 @@
1
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
2
- import { t as buildQuery } from "./query-CXZTvFbH.js";
1
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
2
+ import { t as buildQuery } from "./query-okRw8nVs.js";
3
3
 
4
4
  //#region src/cms/client.ts
5
5
  function createReoptCmsClient(config) {
@@ -52,4 +52,4 @@ async list(query) {
52
52
 
53
53
  //#endregion
54
54
  export { createReoptCmsClient as t };
55
- //# sourceMappingURL=client-XKbUKjFD.js.map
55
+ //# sourceMappingURL=client-UlK_7r41.js.map
package/dist/cms/index.js CHANGED
@@ -1,4 +1,4 @@
1
- import { t as createReoptCmsClient } from "../client-XKbUKjFD.js";
1
+ import { t as createReoptCmsClient } from "../client-UlK_7r41.js";
2
2
 
3
3
  //#region src/cms/helpers.ts
4
4
  function joinUrl(siteUrl, path) {
@@ -100,9 +100,22 @@ var BadRequestError = class extends ReoptSDKError {
100
100
  this.name = "BadRequestError";
101
101
  }
102
102
  };
103
+ /** 403 중 고칠 자리가 정해진 코드 — 일반 문구 대신 그 자리를 가리킨다. */
104
+ const FORBIDDEN_DIAGNOSTICS = {
105
+ CLIENT_TOOLS_DISABLED: {
106
+ cause: "이 BrandApp에서 도구 호출·구조화 출력(tools·responseFormat)이 꺼져 있음",
107
+ fix: "Studio → BrandApp → AI API 설정에서 '도구 호출 허용'을 켜고 설정 저장",
108
+ doc: "docs/api-reference.md"
109
+ },
110
+ CLIENT_TOOLS_PLAN_REQUIRED: {
111
+ cause: "도구 호출·구조화 출력은 Business 플랜 이상 워크스페이스에서만 쓸 수 있음",
112
+ fix: "워크스페이스 플랜을 Business 이상으로 올리거나 tools·responseFormat 없이 호출",
113
+ doc: "docs/api-reference.md"
114
+ }
115
+ };
103
116
  var ForbiddenError = class extends ReoptSDKError {
104
117
  constructor(message = "Forbidden", context, code = "FORBIDDEN") {
105
- super(message, 403, code, context, {
118
+ super(message, 403, code, context, FORBIDDEN_DIAGNOSTICS[code] ?? {
106
119
  cause: "해당 리소스에 대한 접근 권한이 없음",
107
120
  fix: "OAuth 스코프, 워크스페이스 권한, 또는 authUserId를 확인"
108
121
  });
@@ -322,7 +335,7 @@ function mapHttpStatusToError(status, code, message, ctx, fieldErrors) {
322
335
 
323
336
  //#endregion
324
337
  //#region src/core/config.ts
325
- const SDK_VERSION = "4.7.0-rc.7";
338
+ const SDK_VERSION = "4.7.0-rc.8";
326
339
  /**
327
340
  * Default API host for EAV / AI / Files / CMS / Terms. Consumers can override
328
341
  * via `config.baseUrl` or the `REOPT_BASE_URL` env var.
@@ -504,4 +517,4 @@ function deriveIdFromBaseUrl(baseUrl) {
504
517
 
505
518
  //#endregion
506
519
  export { isValidationError as A, RequiredTermsError as C, isModelAccessError as D, isCreditLimitError as E, isReoptSDKError as O, ReoptSDKError as S, ValidationError as T, ModelAccessError as _, resolveIdBaseUrl as a, PreconditionFailedError as b, AuthUserNotFoundError as c, ConflictError as d, ContentFilterError as f, LimitExceededError as g, ForbiddenError as h, resolveBaseUrl as i, mapHttpStatusToError as j, isRequiredTermsError as k, AuthUserRecordExistsError as l, DuplicateAuthUserError as m, SDK_VERSION as n, validateConfig as o, CreditLimitError as p, assertBrowserSafe as r, AuthError as s, REOPT_BASE_URLS as t, BadRequestError as u, ModelNotFoundError as v, ServerError as w, RateLimitError as x, NotFoundError as y };
507
- //# sourceMappingURL=config-2_4Q71Vj.js.map
520
+ //# sourceMappingURL=config-C4uJ8ixE.js.map
package/dist/eav/index.js CHANGED
@@ -1,5 +1,5 @@
1
- import { c as AuthUserNotFoundError, g as LimitExceededError, l as AuthUserRecordExistsError, m as DuplicateAuthUserError } from "../config-2_4Q71Vj.js";
2
- import { i as RECORDS_PAGE_LIMIT_MAX, n as ATTRIBUTE_FILTER_LIST_MAX, r as ATTRIBUTE_FILTER_OPERATORS, t as createReoptEavClient } from "../client-DsDLAw6j.js";
1
+ import { c as AuthUserNotFoundError, g as LimitExceededError, l as AuthUserRecordExistsError, m as DuplicateAuthUserError } from "../config-C4uJ8ixE.js";
2
+ import { i as RECORDS_PAGE_LIMIT_MAX, n as ATTRIBUTE_FILTER_LIST_MAX, r as ATTRIBUTE_FILTER_OPERATORS, t as createReoptEavClient } from "../client-B3mfgfKm.js";
3
3
 
4
4
  //#region src/eav/verify.ts
5
5
  async function verifyEavSchema(input) {
@@ -1,3 +1,3 @@
1
- import { n as createReoptFeedbackClient, t as ReoptFeedbackClient } from "../client-eFjdCptM.js";
1
+ import { n as createReoptFeedbackClient, t as ReoptFeedbackClient } from "../client-CZZ_ENbq.js";
2
2
 
3
3
  export { ReoptFeedbackClient, createReoptFeedbackClient };
@@ -1,4 +1,4 @@
1
- import { n as createReoptFileClient, t as ReoptFileClient } from "../client-CRpW6BTX.js";
1
+ import { n as createReoptFileClient, t as ReoptFileClient } from "../client-DM4rX1ng.js";
2
2
 
3
3
  //#region src/files/helpers.ts
4
4
  const REOPT_IMAGE_REMOTE_PATTERNS = [{
@@ -1,4 +1,4 @@
1
- import { S as ReoptSDKError, a as resolveIdBaseUrl, i as resolveBaseUrl, j as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig, w as ServerError, x as RateLimitError } from "./config-2_4Q71Vj.js";
1
+ import { S as ReoptSDKError, a as resolveIdBaseUrl, i as resolveBaseUrl, j as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig, w as ServerError, x as RateLimitError } from "./config-C4uJ8ixE.js";
2
2
  import { t as createAuthHeader } from "./encoding-Bwfm3iaE.js";
3
3
 
4
4
  //#region src/core/debug.ts
@@ -412,4 +412,4 @@ function parseFieldErrors(body) {
412
412
 
413
413
  //#endregion
414
414
  export { parseFieldErrors as n, BaseHttpClient as t };
415
- //# sourceMappingURL=http-client-DUR4EBMw.js.map
415
+ //# sourceMappingURL=http-client-DdW_W7IB.js.map
@@ -1,5 +1,5 @@
1
1
  import { l as SchemaDef, n as ReoptSDKConfig } from "./config-BGT9h1OW.js";
2
- import { t as ReoptAiClient } from "./client-CRgkPwMT.js";
2
+ import { t as ReoptAiClient } from "./client-Cm7LK9If.js";
3
3
  import { t as ReoptAnalyticsClient } from "./client-CJFsLk3_.js";
4
4
  import { t as ReoptAuthClient } from "./client-BL-Ljwki.js";
5
5
  import { t as ReoptCmsClient } from "./client-NUhpPkl2.js";
@@ -197,4 +197,4 @@ type ReoptSDK<S extends SchemaDef = SchemaDef> = {
197
197
  declare function createReoptSDK<S extends SchemaDef = SchemaDef>(config: ReoptSDKConfig<S>): ReoptSDK<S>;
198
198
  //#endregion
199
199
  export { initReoptSDK as a, getReoptSDK as i, createReoptSDK as n, resetSDK as o, createLazySDK as r, BaseHttpClient as s, ReoptSDK as t };
200
- //# sourceMappingURL=index-Bxfokriz.d.ts.map
200
+ //# sourceMappingURL=index-Dd_2Eq1a.d.ts.map
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { a as DebugLogger, i as DebugLevel, n as ReoptSDKConfig, r as resolveBaseUrl, t as REOPT_BASE_URLS } from "./config-BGT9h1OW.js";
2
- import { _ as StreamEvent, d as ImageGenerateOptions, f as ImageGenerateResult, g as StreamDoneData, i as ChatMessage, l as CreditInfo, m as ModelInfo, o as CompletionOptions, p as MessageRole, r as AgentInfo, s as CompletionResult, u as FinishReason } from "./client-CRgkPwMT.js";
2
+ import { _ as StreamDoneData, d as FinishReason, f as ImageGenerateOptions, h as ModelInfo, i as ChatMessage, m as MessageRole, o as CompletionOptions, p as ImageGenerateResult, r as AgentInfo, s as CompletionResult, u as CreditInfo, v as StreamEvent } from "./client-Cm7LK9If.js";
3
3
  import { C as isCreditLimitError, D as isValidationError, E as isRequiredTermsError, O as mapHttpStatusToError, S as ValidationError, T as isReoptSDKError, _ as RateLimitError, a as ConflictError, b as RequiredTermsError, c as DuplicateAuthUserError, d as ForbiddenError, f as LimitExceededError, g as PreconditionFailedError, h as NotFoundError, i as BadRequestError, l as ErrorDiagnostic, m as ModelNotFoundError, n as AuthUserNotFoundError, o as ContentFilterError, p as ModelAccessError, r as AuthUserRecordExistsError, s as CreditLimitError, t as AuthError, u as FieldError, v as ReoptSDKError, w as isModelAccessError, x as ServerError, y as ReoptSDKErrorContext } from "./errors-D-Va8oeC.js";
4
4
  import { i as TypedEavRecord, r as EntityClient } from "./client-CJRjPSf7.js";
5
- import { a as initReoptSDK, i as getReoptSDK, n as createReoptSDK, o as resetSDK, r as createLazySDK, s as BaseHttpClient, t as ReoptSDK } from "./index-Bxfokriz.js";
5
+ import { a as initReoptSDK, i as getReoptSDK, n as createReoptSDK, o as resetSDK, r as createLazySDK, s as BaseHttpClient, t as ReoptSDK } from "./index-Dd_2Eq1a.js";
6
6
  export { type AgentInfo, AuthError, AuthUserNotFoundError, AuthUserRecordExistsError, BadRequestError, BaseHttpClient, type ChatMessage, type CompletionOptions, type CompletionResult, ConflictError, ContentFilterError, type CreditInfo, CreditLimitError, type DebugLevel, type DebugLogger, DuplicateAuthUserError, type EntityClient, type ErrorDiagnostic, type FieldError, type FinishReason, ForbiddenError, type ImageGenerateOptions, type ImageGenerateResult, LimitExceededError, type MessageRole, ModelAccessError, type ModelInfo, ModelNotFoundError, NotFoundError, PreconditionFailedError, REOPT_BASE_URLS, RateLimitError, ReoptSDK, type ReoptSDKConfig, ReoptSDKError, type ReoptSDKErrorContext, RequiredTermsError, ServerError, type StreamDoneData, type StreamEvent, type TypedEavRecord, ValidationError, createLazySDK, createReoptSDK, getReoptSDK, initReoptSDK, isCreditLimitError, isModelAccessError, isReoptSDKError, isRequiredTermsError, isValidationError, mapHttpStatusToError, resetSDK, resolveBaseUrl };
package/dist/index.js CHANGED
@@ -1,15 +1,15 @@
1
- import { A as isValidationError, C as RequiredTermsError, D as isModelAccessError, E as isCreditLimitError, O as isReoptSDKError, S as ReoptSDKError, T as ValidationError, _ as ModelAccessError, b as PreconditionFailedError, c as AuthUserNotFoundError, d as ConflictError, f as ContentFilterError, g as LimitExceededError, h as ForbiddenError, i as resolveBaseUrl, j as mapHttpStatusToError, k as isRequiredTermsError, l as AuthUserRecordExistsError, m as DuplicateAuthUserError, p as CreditLimitError, r as assertBrowserSafe, s as AuthError, t as REOPT_BASE_URLS, u as BadRequestError, v as ModelNotFoundError, w as ServerError, x as RateLimitError, y as NotFoundError } from "./config-2_4Q71Vj.js";
2
- import { t as BaseHttpClient } from "./http-client-DUR4EBMw.js";
3
- import { n as createReoptAiClient } from "./client-DzT410Wt.js";
4
- import { n as createReoptAuthClient } from "./client-B-Zlh9In.js";
5
- import { t as createReoptCmsClient } from "./client-XKbUKjFD.js";
6
- import { t as createReoptEavClient } from "./client-DsDLAw6j.js";
7
- import { n as createReoptFeedbackClient } from "./client-eFjdCptM.js";
8
- import { n as createReoptFileClient } from "./client-CRpW6BTX.js";
9
- import { n as createReoptAnalyticsClient } from "./client-CRa691YR.js";
10
- import { n as createReoptPlansClient } from "./client-CSgUG6cr.js";
11
- import { n as createReoptPushClient } from "./client-B6_Xb3wb.js";
12
- import { n as createReoptTermsClient } from "./client-B1KTMiad.js";
1
+ import { A as isValidationError, C as RequiredTermsError, D as isModelAccessError, E as isCreditLimitError, O as isReoptSDKError, S as ReoptSDKError, T as ValidationError, _ as ModelAccessError, b as PreconditionFailedError, c as AuthUserNotFoundError, d as ConflictError, f as ContentFilterError, g as LimitExceededError, h as ForbiddenError, i as resolveBaseUrl, j as mapHttpStatusToError, k as isRequiredTermsError, l as AuthUserRecordExistsError, m as DuplicateAuthUserError, p as CreditLimitError, r as assertBrowserSafe, s as AuthError, t as REOPT_BASE_URLS, u as BadRequestError, v as ModelNotFoundError, w as ServerError, x as RateLimitError, y as NotFoundError } from "./config-C4uJ8ixE.js";
2
+ import { t as BaseHttpClient } from "./http-client-DdW_W7IB.js";
3
+ import { n as createReoptAiClient } from "./client-C8Fs2kuo.js";
4
+ import { n as createReoptAuthClient } from "./client-DMKaOPgU.js";
5
+ import { t as createReoptCmsClient } from "./client-UlK_7r41.js";
6
+ import { t as createReoptEavClient } from "./client-B3mfgfKm.js";
7
+ import { n as createReoptFeedbackClient } from "./client-CZZ_ENbq.js";
8
+ import { n as createReoptFileClient } from "./client-DM4rX1ng.js";
9
+ import { n as createReoptAnalyticsClient } from "./client-GRG2iZTx.js";
10
+ import { n as createReoptPlansClient } from "./client-B1Yh78Q2.js";
11
+ import { n as createReoptPushClient } from "./client-8-voCIn6.js";
12
+ import { n as createReoptTermsClient } from "./client-DrTi1wIz.js";
13
13
 
14
14
  //#region src/singleton.ts
15
15
  let _instance;
@@ -1,7 +1,7 @@
1
- import { n as SDK_VERSION } from "../config-2_4Q71Vj.js";
1
+ import { n as SDK_VERSION } from "../config-C4uJ8ixE.js";
2
2
  import { o as readClientKeyRing } from "../keys-B_R_lsyF.js";
3
- import { r as createMachineClient } from "../client-Ds11v9rE.js";
4
- import { S as platformBrandUpsertInputSchema, U as platformPipelineUpsertInputSchema, W as platformResourceKeySchema, j as platformErrorSchema, n as PlatformApiError, p as PLATFORM_OAUTH_CLIENT_PURPOSES, s as resolvePlatformUrls, w as platformBrandappUpsertInputSchema, y as PLATFORM_WEBHOOK_TRIGGERS } from "../client-BPkjuPIU.js";
3
+ import { r as createMachineClient } from "../client-IT-ulPXq.js";
4
+ import { S as platformBrandUpsertInputSchema, U as platformPipelineUpsertInputSchema, W as platformResourceKeySchema, j as platformErrorSchema, n as PlatformApiError, p as PLATFORM_OAUTH_CLIENT_PURPOSES, s as resolvePlatformUrls, w as platformBrandappUpsertInputSchema, y as PLATFORM_WEBHOOK_TRIGGERS } from "../client-CeRmh20T.js";
5
5
  import * as jose from "jose";
6
6
  import { z } from "zod";
7
7
 
@@ -1,4 +1,4 @@
1
- import { S as ReoptSDKError, a as resolveIdBaseUrl } from "../config-2_4Q71Vj.js";
1
+ import { S as ReoptSDKError, a as resolveIdBaseUrl } from "../config-C4uJ8ixE.js";
2
2
 
3
3
  //#region src/logout/verify.ts
4
4
  /**
@@ -1,4 +1,4 @@
1
1
  import { a as parseClientPrivateJwk, i as generateClientKeyPair, n as DEFAULT_CLIENT_KEY_ALGORITHM, o as readClientKeyRing, r as buildClientJwks, s as toPublicJwk, t as CLIENT_JWKS_PATH } from "../keys-B_R_lsyF.js";
2
- import { n as createDpopProof, r as createMachineClient, t as MachineTokenError } from "../client-Ds11v9rE.js";
2
+ import { n as createDpopProof, r as createMachineClient, t as MachineTokenError } from "../client-IT-ulPXq.js";
3
3
 
4
4
  export { CLIENT_JWKS_PATH, DEFAULT_CLIENT_KEY_ALGORITHM, MachineTokenError, buildClientJwks, createDpopProof, createMachineClient, generateClientKeyPair, parseClientPrivateJwk, readClientKeyRing, toPublicJwk };
@@ -1,3 +1,3 @@
1
- import { n as createReoptPlansClient, t as ReoptPlansClient } from "../client-CSgUG6cr.js";
1
+ import { n as createReoptPlansClient, t as ReoptPlansClient } from "../client-B1Yh78Q2.js";
2
2
 
3
3
  export { ReoptPlansClient, createReoptPlansClient };
@@ -1,3 +1,3 @@
1
- import { n as createReoptPushClient, t as ReoptPushClient } from "../client-B6_Xb3wb.js";
1
+ import { n as createReoptPushClient, t as ReoptPushClient } from "../client-8-voCIn6.js";
2
2
 
3
3
  export { ReoptPushClient, createReoptPushClient };
@@ -1,4 +1,4 @@
1
- import { S as ReoptSDKError } from "./config-2_4Q71Vj.js";
1
+ import { S as ReoptSDKError } from "./config-C4uJ8ixE.js";
2
2
 
3
3
  //#region src/core/query.ts
4
4
  /**
@@ -32,4 +32,4 @@ function buildQuery(params) {
32
32
 
33
33
  //#endregion
34
34
  export { buildQuery as t };
35
- //# sourceMappingURL=query-CXZTvFbH.js.map
35
+ //# sourceMappingURL=query-okRw8nVs.js.map
@@ -1,9 +1,9 @@
1
1
  import { A as ListRecordsQuery, C as EavAttribute, D as EavRecord, E as EavEntity, F as UpdateRecordInput, I as UpsertRecordInput, L as UpsertRecordResult, S as DeleteWhereInput, _ as BulkUpdateItem, j as PaginatedResponse, x as CreateRecordInput } from "../config-BGT9h1OW.js";
2
- import { d as ImageGenerateOptions, f as ImageGenerateResult, g as StreamDoneData, l as CreditInfo, m as ModelInfo, o as CompletionOptions, r as AgentInfo, s as CompletionResult } from "../client-CRgkPwMT.js";
2
+ import { _ as StreamDoneData, f as ImageGenerateOptions, h as ModelInfo, o as CompletionOptions, p as ImageGenerateResult, r as AgentInfo, s as CompletionResult, u as CreditInfo } from "../client-Cm7LK9If.js";
3
3
  import { v as ReoptSDKError } from "../errors-D-Va8oeC.js";
4
4
  import { a as ListTagsQuery, c as PostGroup, d as Tag, i as ListPostsQuery, o as Post, r as ListPostGroupsQuery, s as PostDetail, t as CmsPaginatedResponse } from "../types-BXDcoJHG.js";
5
5
  import { a as FileListQuery, c as FolderInfo, d as UpdateFolderInput, f as UploadOptions, i as FileInfo, l as FolderListQuery, o as FileListResponse, r as CreateFolderInput, s as FileUsageInfo, u as UpdateFileInput } from "../client-wNzcgEJu.js";
6
- import { t as ReoptSDK } from "../index-Bxfokriz.js";
6
+ import { t as ReoptSDK } from "../index-Dd_2Eq1a.js";
7
7
  import { UseInfiniteQueryOptions, UseInfiniteQueryResult, UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
8
8
  //#region src/react/use-ai-stream.d.ts
9
9
  type UseAiStreamOptions = {
@@ -1,4 +1,4 @@
1
- import { i as REOPT_PLATFORM_URLS, n as PlatformApiError, o as createPlatformRequester, r as REOPT_PLATFORM_ID_URLS, s as resolvePlatformUrls } from "../client-BPkjuPIU.js";
1
+ import { i as REOPT_PLATFORM_URLS, n as PlatformApiError, o as createPlatformRequester, r as REOPT_PLATFORM_ID_URLS, s as resolvePlatformUrls } from "../client-CeRmh20T.js";
2
2
  import { z } from "zod";
3
3
 
4
4
  //#region src/social/schemas.ts
@@ -1,3 +1,3 @@
1
- import { n as createReoptTermsClient, t as ReoptTermsClient } from "../client-B1KTMiad.js";
1
+ import { n as createReoptTermsClient, t as ReoptTermsClient } from "../client-DrTi1wIz.js";
2
2
 
3
3
  export { ReoptTermsClient, createReoptTermsClient };
@@ -1,5 +1,5 @@
1
1
  import { a as SeedAllInput, c as SeedPostGroupInput, d as SeedTermsItem, l as SeedPostInput, n as DevServer, o as SeedData, t as DevSchema } from "../index-Dh8XMVFF.js";
2
- import { t as ReoptSDK } from "../index-Bxfokriz.js";
2
+ import { t as ReoptSDK } from "../index-Dd_2Eq1a.js";
3
3
  //#region src/testing/index.d.ts
4
4
  type TestSDKOptions = {
5
5
  /** EAV schema to seed entities and attributes */
@@ -1,3 +1,3 @@
1
- import { $ as platformWebhookUpsertInputSchema, A as platformEavSchemaOperationSchema, B as platformPipelineResourceSchema, C as platformBrandappResourceSchema, D as platformEavEntityResourceSchema, E as platformEavBrandappResourcesSchema, F as platformMeSchema, G as platformResourcesSchema, H as platformPipelineStageInputSchema, I as platformOAuthClientImportInputSchema, J as platformTaskStageInputSchema, K as platformResourcesV2Schema, L as platformOAuthClientResourceSchema, M as platformExternalIdSchema, N as platformLockAcquiredSchema, O as platformEavSchemaApplyInputSchema, P as platformLockReleasedSchema, Q as platformWebhookSchema, R as platformOAuthClientUpsertInputSchema, S as platformBrandUpsertInputSchema, T as platformCustomerUpsertInputSchema, U as platformPipelineUpsertInputSchema, V as platformPipelineSchema, W as platformResourceKeySchema, X as platformTaskUpsertInputSchema, Y as platformTaskStageSchema, Z as platformWebhookResourceSchema, _ as PLATFORM_TASK_PRIORITIES, a as createPlatformClient, b as platformBrandImportInputSchema, c as PLATFORM_ADMIN_SCOPE, d as PLATFORM_MANAGED_BY_VALUES, et as platformWorkTaskStageChangedEventSchema, f as PLATFORM_OAUTH_APPLICATION_TYPES, g as PLATFORM_TASK_OUTCOMES, h as PLATFORM_STAGE_COLORS, i as REOPT_PLATFORM_URLS, j as platformErrorSchema, k as platformEavSchemaApplyResultSchema, l as PLATFORM_BRANDAPP_STATUSES, m as PLATFORM_OAUTH_GRANT_TYPES, n as PlatformApiError, p as PLATFORM_OAUTH_CLIENT_PURPOSES, q as platformTaskSchema, r as REOPT_PLATFORM_ID_URLS, s as resolvePlatformUrls, t as DEFAULT_PLATFORM_SCOPES, tt as platformWriteMetaSchema, u as PLATFORM_DOMAIN_STATUSES, v as PLATFORM_TOKEN_ENDPOINT_AUTH_METHODS, w as platformBrandappUpsertInputSchema, x as platformBrandResourceSchema, y as PLATFORM_WEBHOOK_TRIGGERS, z as platformPipelineImportInputSchema } from "../client-BPkjuPIU.js";
1
+ import { $ as platformWebhookUpsertInputSchema, A as platformEavSchemaOperationSchema, B as platformPipelineResourceSchema, C as platformBrandappResourceSchema, D as platformEavEntityResourceSchema, E as platformEavBrandappResourcesSchema, F as platformMeSchema, G as platformResourcesSchema, H as platformPipelineStageInputSchema, I as platformOAuthClientImportInputSchema, J as platformTaskStageInputSchema, K as platformResourcesV2Schema, L as platformOAuthClientResourceSchema, M as platformExternalIdSchema, N as platformLockAcquiredSchema, O as platformEavSchemaApplyInputSchema, P as platformLockReleasedSchema, Q as platformWebhookSchema, R as platformOAuthClientUpsertInputSchema, S as platformBrandUpsertInputSchema, T as platformCustomerUpsertInputSchema, U as platformPipelineUpsertInputSchema, V as platformPipelineSchema, W as platformResourceKeySchema, X as platformTaskUpsertInputSchema, Y as platformTaskStageSchema, Z as platformWebhookResourceSchema, _ as PLATFORM_TASK_PRIORITIES, a as createPlatformClient, b as platformBrandImportInputSchema, c as PLATFORM_ADMIN_SCOPE, d as PLATFORM_MANAGED_BY_VALUES, et as platformWorkTaskStageChangedEventSchema, f as PLATFORM_OAUTH_APPLICATION_TYPES, g as PLATFORM_TASK_OUTCOMES, h as PLATFORM_STAGE_COLORS, i as REOPT_PLATFORM_URLS, j as platformErrorSchema, k as platformEavSchemaApplyResultSchema, l as PLATFORM_BRANDAPP_STATUSES, m as PLATFORM_OAUTH_GRANT_TYPES, n as PlatformApiError, p as PLATFORM_OAUTH_CLIENT_PURPOSES, q as platformTaskSchema, r as REOPT_PLATFORM_ID_URLS, s as resolvePlatformUrls, t as DEFAULT_PLATFORM_SCOPES, tt as platformWriteMetaSchema, u as PLATFORM_DOMAIN_STATUSES, v as PLATFORM_TOKEN_ENDPOINT_AUTH_METHODS, w as platformBrandappUpsertInputSchema, x as platformBrandResourceSchema, y as PLATFORM_WEBHOOK_TRIGGERS, z as platformPipelineImportInputSchema } from "../client-CeRmh20T.js";
2
2
 
3
3
  export { DEFAULT_PLATFORM_SCOPES, PLATFORM_ADMIN_SCOPE, PLATFORM_BRANDAPP_STATUSES, PLATFORM_DOMAIN_STATUSES, PLATFORM_MANAGED_BY_VALUES, PLATFORM_OAUTH_APPLICATION_TYPES, PLATFORM_OAUTH_CLIENT_PURPOSES, PLATFORM_OAUTH_GRANT_TYPES, PLATFORM_STAGE_COLORS, PLATFORM_TASK_OUTCOMES, PLATFORM_TASK_PRIORITIES, PLATFORM_TOKEN_ENDPOINT_AUTH_METHODS, PLATFORM_WEBHOOK_TRIGGERS, PlatformApiError, REOPT_PLATFORM_ID_URLS, REOPT_PLATFORM_URLS, createPlatformClient, platformBrandImportInputSchema, platformBrandResourceSchema, platformBrandUpsertInputSchema, platformBrandappResourceSchema, platformBrandappUpsertInputSchema, platformCustomerUpsertInputSchema, platformEavBrandappResourcesSchema, platformEavEntityResourceSchema, platformEavSchemaApplyInputSchema, platformEavSchemaApplyResultSchema, platformEavSchemaOperationSchema, platformErrorSchema, platformExternalIdSchema, platformLockAcquiredSchema, platformLockReleasedSchema, platformMeSchema, platformOAuthClientImportInputSchema, platformOAuthClientResourceSchema, platformOAuthClientUpsertInputSchema, platformPipelineImportInputSchema, platformPipelineResourceSchema, platformPipelineSchema, platformPipelineStageInputSchema, platformPipelineUpsertInputSchema, platformResourceKeySchema, platformResourcesSchema, platformResourcesV2Schema, platformTaskSchema, platformTaskStageInputSchema, platformTaskStageSchema, platformTaskUpsertInputSchema, platformWebhookResourceSchema, platformWebhookSchema, platformWebhookUpsertInputSchema, platformWorkTaskStageChangedEventSchema, platformWriteMetaSchema, resolvePlatformUrls };
@@ -101,7 +101,7 @@ import type { FetchOptions } from "@reopt-ai/brandapp-sdk";
101
101
  const result = await sdk.ai.complete({
102
102
  messages: ChatMessage[]; // [{ role, content }]
103
103
  model?: string; // Default: BrandApp config
104
- maxTokens?: number;
104
+ maxTokens?: number; // Default·max: BrandApp AI 설정의 최대 출력 토큰(기본 8192)
105
105
  temperature?: number;
106
106
  customerId?: string; // Usage tracking
107
107
  });
@@ -309,7 +309,8 @@ const result = streamText({ model: brandapp("model-id"), prompt: "..." });
309
309
 
310
310
  // Provider metadata includes BrandApp-specific data
311
311
  const { providerMetadata } = await generateText({ ... });
312
- providerMetadata?.brandapp?.creditCost;
312
+ providerMetadata?.brandapp?.creditCost; // 올림한 정수 표시값
313
+ providerMetadata?.brandapp?.creditCostMilli; // 실제 사용량(1/1000 크레딧)
313
314
  providerMetadata?.brandapp?.creditsRemaining;
314
315
 
315
316
  // Pass customerId via providerOptions
@@ -332,7 +333,12 @@ const { image } = await generateImage({
332
333
  도구는 **앱이 실행한다** — 서버는 도구 정의를 모델에 넘기고 모델이 고른 호출(`tool-call`)을 돌려줄 뿐
333
334
  실행하지 않는다. AI SDK의 도구 루프(`ToolLoopAgent`, `streamText` + `stopWhen`)가 실행과 다음 단계 요청을
334
335
  맡는다. 단계 하나가 HTTP 요청 하나라 사용량도 **단계마다** 정산되고, 각 단계의
335
- `providerMetadata.brandapp.creditCost`가 그 단계의 차감액이다.
336
+ `providerMetadata.brandapp.creditCostMilli`가 그 단계의 실제 사용량(1/1000 크레딧)이다.
337
+
338
+ > `creditCost`는 **올림한 정수 표시값**이다 — 0.03크레딧짜리 단계도 1로 보인다. 정산은 1/1000 단위로
339
+ > 하고, 1크레딧 미만은 잔액이 아니라 우수리에 쌓였다가 1000을 넘는 호출에서 떼어진다. 단계를 더해
340
+ > 한 턴의 비용을 구할 때는 `creditCostMilli`를 더한 뒤 한 번만 올림한다(`creditCost`를 더하면 단계 수만큼
341
+ > 과대 계상된다).
336
342
 
337
343
  ```typescript
338
344
  import { ToolLoopAgent, isStepCount, tool } from "ai";
@@ -350,9 +356,11 @@ const agent = new ToolLoopAgent({
350
356
  providerOptions: { brandapp: { reasoningEffort: "high" } },
351
357
  });
352
358
  const result = await agent.generate({ prompt: "서울 날씨 알려줘" });
353
- const credits = result.steps.map(
354
- (s) => s.providerMetadata?.brandapp?.creditCost,
359
+ const milli = result.steps.reduce(
360
+ (sum, s) => sum + Number(s.providerMetadata?.brandapp?.creditCostMilli ?? 0),
361
+ 0,
355
362
  );
363
+ const turnCredits = Math.ceil(milli / 1000);
356
364
  ```
357
365
 
358
366
  - **켜기** — 플랫폼 콘솔 → 브랜드앱 → AI 설정의 **"도구 호출·구조화 출력 허용"**(기본 꺼짐) + 워크스페이스
@@ -371,6 +379,8 @@ const credits = result.steps.map(
371
379
  `openai.reasoningEffort`에서 읽는다.
372
380
  - **사용량** — `usage.inputTokens.cacheRead/cacheWrite`, `usage.outputTokens.reasoning`이 채워진다. Anthropic
373
381
  모델이면 서버가 시스템 프롬프트·도구 정의·대화 끝에 캐시 지점을 자동으로 건다(할인은 `creditCost`에 반영).
382
+ - **경고** — 요청대로 실행되지 않은 것(모델이 무시한 `temperature`, 도구 강제 때문에 꺼진 thinking 등)은 AI SDK
383
+ 결과의 `warnings`로 온다. SDK가 걸러 낸 옵션(`topP`·`topK` 등)의 경고와 합쳐진다.
374
384
  - **한도** — 요청 본문 2MB, 메시지 400개, 도구 64개(정의 전체 20만 자).
375
385
 
376
386
  ### 지원 범위 (정직한 계약)
@@ -379,7 +389,7 @@ const credits = result.steps.map(
379
389
 
380
390
  - `generateText()`, `streamText()`, `ToolLoopAgent` — 텍스트·도구 호출·구조화 출력·추론 파트
381
391
  - `generateImage()` — 이미지 생성 (`brandapp.imageModel(...)`)
382
- - `providerMetadata.brandapp` — `creditCost` / `creditsRemaining` / `responseId`(단계마다)
392
+ - `providerMetadata.brandapp` — `creditCost`(올림 표시값) / `creditCostMilli`(실제 사용량) / `creditsRemaining` / `responseId`(단계마다)
383
393
  - `providerOptions.brandapp` — `customerId` / `reasoningEffort` / (이미지) `style` / `negativePrompt` / `aspectRatio`
384
394
  - `finishReason` — 서버가 보고하면 정확히 매핑(`tool-calls` 포함, 미보고 시 `stop`)
385
395
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@reopt-ai/brandapp-sdk",
3
- "version": "4.7.0-rc.7",
3
+ "version": "4.7.0-rc.8",
4
4
  "description": "Reopt Brandapp SDK — Better Auth adapter, OAuth login, and EAV client",
5
5
  "author": "Reopt",
6
6
  "license": "MIT",