@skopon-cool/form-sdk 0.5.2 → 0.6.1

package/src/client/authStorage.test.ts

@@ -1,14 +1,16 @@
 /**
  * @vitest-environment happy-dom
  */
-import { afterEach, describe, expect, it } from 'vitest'
+import { afterEach, describe, expect, it, vi } from 'vitest'
 import {
   DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD,
   DEFAULT_AUTH_REALTIME_WS_URL_FIELD,
+  DEFAULT_AUTH_SKOPON_API_BASE_URL_FIELD,
   DEFAULT_ANSWER_AGENT_CALLBACK_URL,
   DEFAULT_AUTH_STORAGE_KEY,
   resolveAnswerAgentCallbackUrl,
   resolveRealtimeWsUrl,
+  resolveSkoponApiBaseUrl,
   resolveSkoponAuthHeaders,
   resolveSubmitAuthHeaders,
 } from './authStorage'
@@ -17,6 +19,7 @@ describe('resolveSkoponAuthHeaders', () => {
   afterEach(() => {
     sessionStorage.clear()
     localStorage.clear()
+    vi.unstubAllGlobals()
   })
 
   it('reads Bearer token from sessionStorage auth_user by default', () => {
@@ -66,6 +69,69 @@ describe('resolveSkoponAuthHeaders', () => {
   })
 })
 
+describe('resolveSkoponApiBaseUrl', () => {
+  afterEach(() => {
+    if (typeof sessionStorage !== 'undefined') sessionStorage.clear()
+    if (typeof localStorage !== 'undefined') localStorage.clear()
+    vi.unstubAllGlobals()
+  })
+
+  it('reads and normalizes skopon_api_base_url from auth_user', () => {
+    sessionStorage.setItem(
+      DEFAULT_AUTH_STORAGE_KEY,
+      JSON.stringify({
+        [DEFAULT_AUTH_SKOPON_API_BASE_URL_FIELD]:
+          ' https://admin-test.hibot.lol/api/skopon/api/v1/ ',
+      }),
+    )
+    expect(resolveSkoponApiBaseUrl()).toBe(
+      'https://admin-test.hibot.lol/api/skopon/api/v1',
+    )
+  })
+
+  it('falls back to the current origin when session or field is missing', () => {
+    expect(resolveSkoponApiBaseUrl()).toBe(`${window.location.origin}/api/v1`)
+    sessionStorage.setItem(DEFAULT_AUTH_STORAGE_KEY, JSON.stringify({ token: 'tok' }))
+    expect(resolveSkoponApiBaseUrl()).toBe(`${window.location.origin}/api/v1`)
+  })
+
+  it('falls back to a relative API path outside the browser', () => {
+    vi.stubGlobal('window', undefined)
+    expect(resolveSkoponApiBaseUrl()).toBe('/api/v1')
+  })
+
+  it('falls back when browser storage is inaccessible', () => {
+    const origin = window.location.origin
+    vi.stubGlobal('window', {
+      location: { origin },
+      sessionStorage: {
+        getItem() {
+          throw new Error('blocked')
+        },
+      },
+    })
+    expect(resolveSkoponApiBaseUrl()).toBe(`${origin}/api/v1`)
+  })
+
+  it.each([
+    '/api/v1',
+    'ftp://example.com/api/v1',
+    'https://user:pass@example.com/api/v1',
+    'https://example.com/api/v1?tenant=1',
+    'https://example.com/api/v1#upload',
+  ])('rejects invalid configured base URL: %s', (configured) => {
+    sessionStorage.setItem(
+      DEFAULT_AUTH_STORAGE_KEY,
+      JSON.stringify({
+        [DEFAULT_AUTH_SKOPON_API_BASE_URL_FIELD]: configured,
+      }),
+    )
+    expect(() => resolveSkoponApiBaseUrl()).toThrow(
+      'skopon_api_base_url 格式无效，无法上传文件',
+    )
+  })
+})
+
 describe('resolveSubmitAuthHeaders', () => {
   afterEach(() => {
     sessionStorage.clear()

package/src/client/authStorage.ts

@@ -11,8 +11,10 @@ export const DEFAULT_AUTH_STORAGE_KEY = 'auth_user'
 export const DEFAULT_AUTH_TOKEN_FIELD = 'token'
 export const DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD = 'answer_agent_callback_url'
 export const DEFAULT_AUTH_REALTIME_WS_URL_FIELD = 'realtime_ws_url'
+export const DEFAULT_AUTH_SKOPON_API_BASE_URL_FIELD = 'skopon_api_base_url'
 /** 与 skopon-admin 登录写入的 mock answer-agent 路径一致 */
 export const DEFAULT_ANSWER_AGENT_CALLBACK_URL = '/api/v1/mock/ask_user_answer_mock'
+export const DEFAULT_SKOPON_API_BASE_PATH = '/api/v1'
 
 function readStorage(
   kind: 'sessionStorage' | 'localStorage',
@@ -35,6 +37,71 @@ function readSessionJson(raw: string): Record<string, unknown> | null {
   }
 }
 
+function defaultSkoponApiBaseUrl(): string {
+  if (typeof window === 'undefined') return DEFAULT_SKOPON_API_BASE_PATH
+  try {
+    const origin = window.location.origin
+    const parsed = new URL(origin)
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+      return DEFAULT_SKOPON_API_BASE_PATH
+    }
+    return `${parsed.origin}${DEFAULT_SKOPON_API_BASE_PATH}`
+  } catch {
+    return DEFAULT_SKOPON_API_BASE_PATH
+  }
+}
+
+/**
+ * 从宿主登录缓存读取 Skopon API 根地址。
+ * 缺失时回退当前 Origin 的 /api/v1；非空配置必须是无凭据、Query、Hash 的绝对 HTTP(S) URL。
+ */
+export function resolveSkoponApiBaseUrl(
+  options: SkoponAuthStorageOptions & {
+    skoponApiBaseUrlField?: string
+  } = {},
+): string {
+  const storageKind = options.storage ?? 'sessionStorage'
+  const storageKey = options.storageKey ?? DEFAULT_AUTH_STORAGE_KEY
+  const field =
+    options.skoponApiBaseUrlField ?? DEFAULT_AUTH_SKOPON_API_BASE_URL_FIELD
+
+  const storage = readStorage(storageKind)
+  let raw: string | null = null
+  try {
+    raw = storage?.getItem(storageKey) ?? null
+  } catch {
+    return defaultSkoponApiBaseUrl()
+  }
+  const parsedSession = raw ? readSessionJson(raw) : null
+  const configured = parsedSession?.[field]
+  if (configured === undefined || configured === null) {
+    return defaultSkoponApiBaseUrl()
+  }
+  if (typeof configured !== 'string') {
+    throw new Error('skopon_api_base_url 格式无效，无法上传文件')
+  }
+
+  const trimmed = configured.trim()
+  if (!trimmed) return defaultSkoponApiBaseUrl()
+
+  try {
+    const parsed = new URL(trimmed)
+    if (
+      (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') ||
+      parsed.username ||
+      parsed.password ||
+      parsed.search ||
+      parsed.hash
+    ) {
+      throw new Error('invalid Skopon API base URL')
+    }
+    const pathname = parsed.pathname.replace(/\/+$/, '')
+    return `${parsed.origin}${pathname}`
+  } catch {
+    throw new Error('skopon_api_base_url 格式无效，无法上传文件')
+  }
+}
+
 function readTokenFromSessionJson(
   raw: string,
   tokenField: string,

package/src/client/uploadClient.test.ts

@@ -0,0 +1,143 @@
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import {
+  CDN_UPLOAD_PATH,
+  CDN_UPLOAD_TIMEOUT_MS,
+  UploadCancelledError,
+  uploadFileToCdn,
+} from './uploadClient'
+
+function response(body: unknown, init: Partial<Response> = {}): Response {
+  return {
+    ok: init.ok ?? true,
+    status: init.status ?? 200,
+    json: async () => body,
+  } as Response
+}
+
+describe('uploadFileToCdn', () => {
+  afterEach(() => {
+    vi.useRealTimers()
+    vi.unstubAllGlobals()
+    sessionStorage.clear()
+  })
+
+  it('uploads multipart data to the fixed endpoint with session Bearer auth', async () => {
+    sessionStorage.setItem(
+      'auth_user',
+      JSON.stringify({
+        token: 'token-1',
+        skopon_api_base_url: 'https://admin-test.hibot.lol/api/skopon/api/v1/',
+      }),
+    )
+    const fetchMock = vi.fn(async () =>
+      response({
+        success: true,
+        data: { url: ' https://cdn.example.com/a.pdf ', file_name: 'a.pdf' },
+      }),
+    )
+    vi.stubGlobal('fetch', fetchMock)
+    const file = new File(['pdf'], 'a.pdf', { type: 'application/pdf' })
+
+    await expect(uploadFileToCdn(file)).resolves.toMatchObject({
+      url: 'https://cdn.example.com/a.pdf',
+      file_name: 'a.pdf',
+    })
+    expect(fetchMock).toHaveBeenCalledTimes(1)
+    const [url, init] = fetchMock.mock.calls[0] as unknown as [string, RequestInit]
+    expect(url).toBe(
+      `https://admin-test.hibot.lol/api/skopon/api/v1${CDN_UPLOAD_PATH}`,
+    )
+    expect(init.method).toBe('POST')
+    expect(init.headers).toEqual({ Authorization: 'Bearer token-1' })
+    expect((init.headers as Record<string, string>)['Content-Type']).toBeUndefined()
+    expect(init.body).toBeInstanceOf(FormData)
+    expect((init.body as FormData).get('file')).toBe(file)
+    expect((init.body as FormData).get('purpose')).toBeNull()
+  })
+
+  it('falls back to the current origin API base when session config is missing', async () => {
+    const fetchMock = vi.fn(async () =>
+      response({ success: true, data: { url: 'https://cdn.example.com/a.txt' } }),
+    )
+    vi.stubGlobal('fetch', fetchMock)
+
+    await uploadFileToCdn(new File(['x'], 'x.txt'))
+
+    expect(fetchMock).toHaveBeenCalledWith(
+      `${window.location.origin}/api/v1${CDN_UPLOAD_PATH}`,
+      expect.objectContaining({ method: 'POST' }),
+    )
+  })
+
+  it('rejects an invalid configured base URL without sending a request', async () => {
+    sessionStorage.setItem(
+      'auth_user',
+      JSON.stringify({
+        token: 'token-1',
+        skopon_api_base_url: '/api/v1',
+      }),
+    )
+    const fetchMock = vi.fn()
+    vi.stubGlobal('fetch', fetchMock)
+
+    await expect(uploadFileToCdn(new File(['x'], 'x.txt'))).rejects.toThrow(
+      'skopon_api_base_url 格式无效，无法上传文件',
+    )
+    expect(fetchMock).not.toHaveBeenCalled()
+  })
+
+  it.each([
+    [{ success: false, message: '七牛上传失败', data: {} }, '七牛上传失败'],
+    [{ success: true, data: { url: '   ' } }, '响应缺少文件地址'],
+  ])('rejects invalid API responses', async (body, message) => {
+    vi.stubGlobal('fetch', vi.fn(async () => response(body)))
+    await expect(uploadFileToCdn(new File(['x'], 'x.txt'))).rejects.toThrow(message)
+  })
+
+  it('rejects non-JSON and non-success HTTP responses', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi.fn(async () => ({
+        ok: false,
+        status: 502,
+        json: async () => {
+          throw new SyntaxError('bad json')
+        },
+      } as Response)),
+    )
+    await expect(uploadFileToCdn(new File(['x'], 'x.txt'))).rejects.toThrow('响应非 JSON (502)')
+  })
+
+  it('turns a caller abort into UploadCancelledError', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi.fn((_url: string, init?: RequestInit) =>
+        new Promise<Response>((_resolve, reject) => {
+          init?.signal?.addEventListener('abort', () => reject(new DOMException('aborted', 'AbortError')))
+        }),
+      ),
+    )
+    const controller = new AbortController()
+    const pending = uploadFileToCdn(new File(['x'], 'x.txt'), { signal: controller.signal })
+    const assertion = expect(pending).rejects.toBeInstanceOf(UploadCancelledError)
+    controller.abort()
+    await assertion
+  })
+
+  it('aborts and reports a timeout after 120 seconds', async () => {
+    vi.useFakeTimers()
+    vi.stubGlobal(
+      'fetch',
+      vi.fn((_url: string, init?: RequestInit) =>
+        new Promise<Response>((_resolve, reject) => {
+          init?.signal?.addEventListener('abort', () => reject(new DOMException('aborted', 'AbortError')))
+        }),
+      ),
+    )
+    const pending = uploadFileToCdn(new File(['x'], 'x.txt'))
+    const assertion = expect(pending).rejects.toThrow('上传超时，请稍后重试')
+    await vi.advanceTimersByTimeAsync(CDN_UPLOAD_TIMEOUT_MS)
+    await assertion
+  })
+})

package/src/client/uploadClient.ts

@@ -0,0 +1,72 @@
+import { parseEnvelope } from './apiEnvelope'
+import {
+  resolveSkoponApiBaseUrl,
+  resolveSkoponAuthHeaders,
+} from './authStorage'
+
+export const CDN_UPLOAD_PATH = '/univ/upload/cdn'
+export const CDN_UPLOAD_TIMEOUT_MS = 120_000
+
+export interface CdnUploadResult {
+  url: string
+  file_name?: string
+  mime_type?: string | null
+  size?: number
+}
+
+export class UploadCancelledError extends Error {
+  constructor(message = '上传已取消') {
+    super(message)
+    this.name = 'UploadCancelledError'
+  }
+}
+
+export function isUploadCancelledError(error: unknown): error is UploadCancelledError {
+  return error instanceof UploadCancelledError
+}
+
+/** SDK 固定 CDN 上传通道：使用宿主默认 session token 调用后端七牛代理。 */
+export async function uploadFileToCdn(
+  file: File,
+  options: { signal?: AbortSignal } = {},
+): Promise<CdnUploadResult> {
+  const uploadUrl = `${resolveSkoponApiBaseUrl()}${CDN_UPLOAD_PATH}`
+  const controller = new AbortController()
+  let timedOut = false
+
+  const abortFromCaller = () => controller.abort()
+  if (options.signal?.aborted) {
+    controller.abort()
+  } else {
+    options.signal?.addEventListener('abort', abortFromCaller, { once: true })
+  }
+
+  const timer = setTimeout(() => {
+    timedOut = true
+    controller.abort()
+  }, CDN_UPLOAD_TIMEOUT_MS)
+
+  try {
+    const formData = new FormData()
+    formData.append('file', file)
+    const response = await fetch(uploadUrl, {
+      method: 'POST',
+      headers: resolveSkoponAuthHeaders(),
+      body: formData,
+      signal: controller.signal,
+    })
+    const result = await parseEnvelope<CdnUploadResult>(response)
+    const url = typeof result.url === 'string' ? result.url.trim() : ''
+    if (!url) throw new Error('上传成功但响应缺少文件地址')
+    return { ...result, url }
+  } catch (error) {
+    if (controller.signal.aborted) {
+      if (timedOut) throw new Error('上传超时，请稍后重试')
+      throw new UploadCancelledError()
+    }
+    throw error
+  } finally {
+    clearTimeout(timer)
+    options.signal?.removeEventListener('abort', abortFromCaller)
+  }
+}

package/src/components/AskUserFormCard.tsx

@@ -103,6 +103,7 @@ function AskUserFormCardBody({
   const [formDisabled, setFormDisabled] = useState(false)
   const [loading, setLoading] = useState(true)
   const [submitting, setSubmitting] = useState(false)
+  const [uploading, setUploading] = useState(false)
   const rendererRef = useRef<SkoponFormRendererRef>(null)
   const cardRootRef = useRef<HTMLDivElement>(null)
   const mountedRef = useRef(true)
@@ -322,6 +323,10 @@ function AskUserFormCardBody({
 
   const handleSubmit = useCallback(async () => {
     if (submitting) return
+    if (uploading) {
+      onNotifyRef.current?.('error', '文件正在上传，请稍候')
+      return
+    }
     setSubmitting(true)
     try {
       const cardValues = rendererRef.current?.getValues(fieldNames) ?? {}
@@ -397,6 +402,7 @@ function AskUserFormCardBody({
     }
   }, [
     submitting,
+    uploading,
     fieldNames,
     renderBlocks,
     surfaceTitle,
@@ -486,6 +492,7 @@ function AskUserFormCardBody({
         wrapProvider={false}
         resumeSearch={resumeSearch}
         caseSearch={caseSearch}
+        onUploadingChange={setUploading}
       />
 
       <div className="ask-user-form-actions">
@@ -500,7 +507,7 @@ function AskUserFormCardBody({
             type="primary"
             size="small"
             loading={submitting}
-            disabled={submitting}
+            disabled={submitting || uploading}
             onClick={() => void handleSubmit()}
           >
             提交

package/src/components/AskUserFormCard.upload.test.tsx

@@ -0,0 +1,91 @@
+// @vitest-environment happy-dom
+import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest'
+
+const uploadMock = vi.hoisted(() => vi.fn())
+
+vi.mock('@a2ui/web_core/v0_9/basic_catalog', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('@a2ui/web_core/v0_9/basic_catalog')>()
+  return { ...actual, injectBasicCatalogStyles: vi.fn() }
+})
+
+vi.mock('@a2ui/react/styles', () => ({
+  injectStyles: vi.fn(),
+  removeStyles: vi.fn(),
+}))
+
+vi.mock('../client/uploadClient', () => ({
+  uploadFileToCdn: uploadMock,
+  isUploadCancelledError: () => false,
+}))
+
+import { createElement } from 'react'
+import { act, cleanup, fireEvent, render, waitFor } from '@testing-library/react'
+import AskUserFormCard from './AskUserFormCard'
+import { normalizeFormDefinition } from '../adapter/formSchema'
+
+beforeAll(() => {
+  class ResizeObserverMock {
+    observe() {}
+    unobserve() {}
+    disconnect() {}
+  }
+  vi.stubGlobal('ResizeObserver', ResizeObserverMock)
+})
+
+beforeEach(() => {
+  uploadMock.mockReset()
+  sessionStorage.clear()
+})
+afterEach(cleanup)
+
+describe('AskUserFormCard file upload guard', () => {
+  it('disables submit until every file upload settles', async () => {
+    let resolveUpload!: (value: { url: string }) => void
+    uploadMock.mockReturnValue(
+      new Promise<{ url: string }>((resolve) => {
+        resolveUpload = resolve
+      }),
+    )
+    const fileBlock = {
+      id: 'file',
+      type: 'file' as const,
+      name: 'attachments',
+      label: '附件',
+      fileMinCount: 0,
+      fileMaxCount: 1,
+    }
+    const formDefinition = normalizeFormDefinition({
+      title: '',
+      description: '',
+      blocks: [fileBlock],
+      jsonSchema: {},
+    })
+    const view = render(
+      createElement(AskUserFormCard, {
+        payload: { title: '', description: '', blocks: [fileBlock] },
+        formUniqueId: 'form-upload',
+        callbackUrl: '/callback',
+        submitMode: 'post',
+        fetchFormDetail: async () => ({
+          formUniqueId: 'form-upload',
+          disabled: false,
+          formDefinition,
+        }),
+      }),
+    )
+
+    const input = await waitFor(() => {
+      const node = view.container.querySelector('input[type="file"]') as HTMLInputElement
+      expect(node).toBeTruthy()
+      return node
+    })
+    const submit = view.getByRole('button', { name: /提\s*交/ }) as HTMLButtonElement
+    expect(submit.disabled).toBe(false)
+
+    fireEvent.change(input, { target: { files: [new File(['x'], 'a.pdf')] } })
+    await waitFor(() => expect(submit.disabled).toBe(true))
+
+    await act(async () => resolveUpload({ url: 'https://cdn.example.com/a.pdf' }))
+    await waitFor(() => expect(submit.disabled).toBe(false))
+  })
+})

package/src/components/SkoponA2uiStreamRenderer.tsx

@@ -5,6 +5,7 @@ import { A2uiSurface, type ReactComponentImplementation } from '@a2ui/react/v0_9
 import { injectStyles } from '@a2ui/react/styles'
 import { buildSkoponCatalog } from '../catalog/a2uiCustomCatalog'
 import { A2uiPreviewModeProvider } from '../catalog/a2uiPreviewContext'
+import { FileUploadStatusProvider } from '../catalog/fileUploadStatusContext'
 import { CaseSearchProvider, type CaseSearchFn } from '../catalog/caseSearchContext'
 import { ResumeSearchProvider, type ResumeSearchFn } from '../catalog/resumeSearchContext'
 import SkoponFormProvider from './SkoponFormProvider'
@@ -182,17 +183,19 @@ export default function SkoponA2uiStreamRenderer({
 
   return (
     <SkoponFormProvider>
-      <ResumeSearchProvider resumeSearch={resumeSearch}>
-      <CaseSearchProvider caseSearch={caseSearch}>
-        <A2uiPreviewModeProvider interactive={interactive}>
-          <div className="a2ui-surface a2ui-container">
-            {surfaces.map((surface) => (
-              <A2uiSurface key={surface.id} surface={surface} />
-            ))}
-          </div>
-        </A2uiPreviewModeProvider>
-      </CaseSearchProvider>
-    </ResumeSearchProvider>
+      <FileUploadStatusProvider>
+        <ResumeSearchProvider resumeSearch={resumeSearch}>
+          <CaseSearchProvider caseSearch={caseSearch}>
+            <A2uiPreviewModeProvider interactive={interactive}>
+              <div className="a2ui-surface a2ui-container">
+                {surfaces.map((surface) => (
+                  <A2uiSurface key={surface.id} surface={surface} />
+                ))}
+              </div>
+            </A2uiPreviewModeProvider>
+          </CaseSearchProvider>
+        </ResumeSearchProvider>
+      </FileUploadStatusProvider>
     </SkoponFormProvider>
   )
 }

package/src/components/SkoponFormRenderer.tsx

@@ -15,6 +15,7 @@ import { extractSurfaceValues } from '../adapter/extractSurfaceValues'
 import { isA2uiSurfaceEmpty, surfaceDocToMessages } from '../adapter/a2uiAdapter'
 import { SKOPON_CATALOG_ID, buildSkoponCatalog } from '../catalog/a2uiCustomCatalog'
 import { A2uiPreviewModeProvider } from '../catalog/a2uiPreviewContext'
+import { FileUploadStatusProvider } from '../catalog/fileUploadStatusContext'
 import { CaseSearchProvider, type CaseSearchFn } from '../catalog/caseSearchContext'
 import { ResumeSearchProvider, type ResumeSearchFn } from '../catalog/resumeSearchContext'
 import SkoponFormProvider from './SkoponFormProvider'
@@ -35,6 +36,8 @@ export interface SkoponFormRendererProps {
   resumeSearch?: ResumeSearchFn | null
   /** 案例单选组件：注入搜索函数 */
   caseSearch?: CaseSearchFn | null
+  /** 任意文件上传任务的聚合状态 */
+  onUploadingChange?: (uploading: boolean) => void
   /** 外层已包裹 SkoponFormProvider 时可设为 false，避免重复 ConfigProvider */
   wrapProvider?: boolean
 }
@@ -49,6 +52,7 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
       fieldNames = [],
       resumeSearch = null,
       caseSearch = null,
+      onUploadingChange,
       wrapProvider = true,
     },
     ref,
@@ -122,27 +126,31 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
 
     if (surfaces.length === 0) {
       const empty = (
-        <ResumeSearchProvider resumeSearch={resumeSearch}>
-          <CaseSearchProvider caseSearch={caseSearch}>
-            <A2uiPreviewModeProvider interactive={interactive}>{emptyHint}</A2uiPreviewModeProvider>
-          </CaseSearchProvider>
-        </ResumeSearchProvider>
+        <FileUploadStatusProvider onUploadingChange={onUploadingChange}>
+          <ResumeSearchProvider resumeSearch={resumeSearch}>
+            <CaseSearchProvider caseSearch={caseSearch}>
+              <A2uiPreviewModeProvider interactive={interactive}>{emptyHint}</A2uiPreviewModeProvider>
+            </CaseSearchProvider>
+          </ResumeSearchProvider>
+        </FileUploadStatusProvider>
       )
       return wrapProvider ? <SkoponFormProvider>{empty}</SkoponFormProvider> : empty
     }
 
     const content = (
-      <ResumeSearchProvider resumeSearch={resumeSearch}>
-        <CaseSearchProvider caseSearch={caseSearch}>
-          <A2uiPreviewModeProvider interactive={interactive}>
-            <div className="a2ui-surface a2ui-container">
-              {surfaces.map((surface) => (
-                <A2uiSurface key={surface.id} surface={surface} />
-              ))}
-            </div>
-          </A2uiPreviewModeProvider>
-        </CaseSearchProvider>
-      </ResumeSearchProvider>
+      <FileUploadStatusProvider onUploadingChange={onUploadingChange}>
+        <ResumeSearchProvider resumeSearch={resumeSearch}>
+          <CaseSearchProvider caseSearch={caseSearch}>
+            <A2uiPreviewModeProvider interactive={interactive}>
+              <div className="a2ui-surface a2ui-container">
+                {surfaces.map((surface) => (
+                  <A2uiSurface key={surface.id} surface={surface} />
+                ))}
+              </div>
+            </A2uiPreviewModeProvider>
+          </CaseSearchProvider>
+        </ResumeSearchProvider>
+      </FileUploadStatusProvider>
     )
 
     return wrapProvider ? <SkoponFormProvider>{content}</SkoponFormProvider> : content

package/src/index.ts

@@ -106,6 +106,7 @@ export {
 export {
   resolveAnswerAgentCallbackUrl,
   resolveRealtimeWsUrl,
+  resolveSkoponApiBaseUrl,
   resolveSkoponAuthHeaders,
   resolveSubmitAuthHeaders,
   resolveClientHeaders,
@@ -113,7 +114,9 @@ export {
   DEFAULT_AUTH_TOKEN_FIELD,
   DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD,
   DEFAULT_AUTH_REALTIME_WS_URL_FIELD,
+  DEFAULT_AUTH_SKOPON_API_BASE_URL_FIELD,
   DEFAULT_ANSWER_AGENT_CALLBACK_URL,
+  DEFAULT_SKOPON_API_BASE_PATH,
   type SkoponAuthStorageOptions,
   type ClientHeadersOptions,
 } from './client/authStorage'