@skopon-cool/form-sdk 0.2.3 → 0.2.4

package/dist/submit/buildAnswerAgentBody.d.ts

@@ -16,4 +16,8 @@ export interface BuildAnswerAgentBodyOptions {
 }
 /** 组装 answer-agent 外包消息体（与 mock AskUserAnswerMockVo 对齐）。 */
 export declare function buildAnswerAgentBody({ context, payload, form, answer, }: BuildAnswerAgentBodyOptions): Record<string, unknown>;
+/** 提交前校验 mock answer-agent 必填字段，返回错误文案或 null。 */
+export declare function validateAnswerAgentBody(body: Record<string, unknown>): string | null;
+/** 提交前校验上下文必填字段，返回错误文案或 null。 */
+export declare function validateAnswerAgentContext(context: AskUserAnswerAgentContext): string | null;
 //# sourceMappingURL=buildAnswerAgentBody.d.ts.map

package/dist/submit/buildAnswerAgentBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildAnswerAgentBody.d.ts","sourceRoot":"","sources":["../../src/submit/buildAnswerAgentBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAA;AAEzC,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAmBD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,yBAAyB,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,uBAAuB,GAAG,UAAU,GAAG,IAAI,CAAA;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,OAAO,EACP,IAAI,EACJ,MAAM,GACP,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAevD"}
+{"version":3,"file":"buildAnswerAgentBody.d.ts","sourceRoot":"","sources":["../../src/submit/buildAnswerAgentBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAA;AAEzC,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAmBD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,yBAAyB,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,uBAAuB,GAAG,UAAU,GAAG,IAAI,CAAA;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,OAAO,EACP,IAAI,EACJ,MAAM,GACP,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAevD;AAED,iDAAiD;AACjD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAqBpF;AAED,iCAAiC;AACjC,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,yBAAyB,GACjC,MAAM,GAAG,IAAI,CAQf"}

package/dist/submit/submitAnswerAgent.d.ts

@@ -5,5 +5,9 @@ export interface SubmitAnswerAgentOptions extends SubmitFormJsonOptions {
     /** 显式覆盖 auth_user 中的 answer_agent_callback_url */
     answerAgentCallbackUrl?: string | null;
 }
+export declare function formatAnswerAgentSubmitMessage(result: SubmitFormJsonResult): {
+    type: 'success' | 'error';
+    message: string;
+};
 export declare function submitAnswerAgent(body: Record<string, unknown>, options?: SubmitAnswerAgentOptions): Promise<SubmitFormJsonResult>;
 //# sourceMappingURL=submitAnswerAgent.d.ts.map

package/dist/submit/submitAnswerAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submitAnswerAgent.d.ts","sourceRoot":"","sources":["../../src/submit/submitAnswerAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,WAAW,CAAC,EAAE,wBAAwB,CAAA;IACtC,kDAAkD;IAClD,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvC;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAkB/B"}
+{"version":3,"file":"submitAnswerAgent.d.ts","sourceRoot":"","sources":["../../src/submit/submitAnswerAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,WAAW,CAAC,EAAE,wBAAwB,CAAA;IACtC,kDAAkD;IAClD,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvC;AAqCD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,oBAAoB,GAC3B;IAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAchD;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CA4B/B"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Skopon form rendering SDK (A2UI + form_definition) with submit helpers",
   "type": "module",
   "sideEffects": [

package/src/client/authStorage.test.ts

@@ -4,6 +4,7 @@
 import { afterEach, describe, expect, it } from 'vitest'
 import {
   DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD,
+  DEFAULT_ANSWER_AGENT_CALLBACK_URL,
   DEFAULT_AUTH_STORAGE_KEY,
   resolveAnswerAgentCallbackUrl,
   resolveSkoponAuthHeaders,
@@ -80,8 +81,12 @@ describe('resolveAnswerAgentCallbackUrl', () => {
     expect(resolveAnswerAgentCallbackUrl()).toBe('/api/v1/mock/ask_user_answer_mock')
   })
 
-  it('returns empty string when field is missing', () => {
+  it('returns default mock url when field is missing', () => {
     sessionStorage.setItem(DEFAULT_AUTH_STORAGE_KEY, JSON.stringify({ token: 'tok' }))
-    expect(resolveAnswerAgentCallbackUrl()).toBe('')
+    expect(resolveAnswerAgentCallbackUrl()).toBe(DEFAULT_ANSWER_AGENT_CALLBACK_URL)
+  })
+
+  it('returns default mock url when session is missing', () => {
+    expect(resolveAnswerAgentCallbackUrl()).toBe(DEFAULT_ANSWER_AGENT_CALLBACK_URL)
   })
 })

package/src/client/authStorage.ts

@@ -10,6 +10,8 @@ export interface SkoponAuthStorageOptions {
 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'
+/** 与 skopon-admin 登录写入的 mock answer-agent 路径一致 */
+export const DEFAULT_ANSWER_AGENT_CALLBACK_URL = '/api/v1/mock/ask_user_answer_mock'
 
 function readStorage(
   kind: 'sessionStorage' | 'localStorage',
@@ -56,16 +58,17 @@ export function resolveAnswerAgentCallbackUrl(
     options.answerAgentCallbackUrlField ?? DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD
 
   const storage = readStorage(storageKind)
-  if (!storage) return ''
+  if (!storage) return DEFAULT_ANSWER_AGENT_CALLBACK_URL
 
   const raw = storage.getItem(storageKey)
-  if (!raw) return ''
+  if (!raw) return DEFAULT_ANSWER_AGENT_CALLBACK_URL
 
   const parsed = readSessionJson(raw)
-  if (!parsed) return ''
+  if (!parsed) return DEFAULT_ANSWER_AGENT_CALLBACK_URL
 
   const url = parsed[field]
-  return typeof url === 'string' ? url.trim() : ''
+  const trimmed = typeof url === 'string' ? url.trim() : ''
+  return trimmed || DEFAULT_ANSWER_AGENT_CALLBACK_URL
 }
 
 /** 从宿主登录缓存读取 Bearer token，返回 Authorization 头（无 token 时返回空对象）。 */

package/src/components/AskUserFormCard.tsx

@@ -15,7 +15,10 @@ import {
   payloadHasInputBlocks,
 } from '../submit/intersectPayloadBlocksWithForm'
 import { submitFormJson } from '../submit/submitFormJson'
-import { submitAnswerAgent } from '../submit/submitAnswerAgent'
+import {
+  formatAnswerAgentSubmitMessage,
+  submitAnswerAgent,
+} from '../submit/submitAnswerAgent'
 import { validateFormSubmitValues } from '../submit/validateFormSubmit'
 import type { CaseSearchFn } from '../catalog/caseSearchContext'
 import type { ResumeSearchFn } from '../catalog/resumeSearchContext'
@@ -228,11 +231,8 @@ export default function AskUserFormCard({
       })
       const result = await submitAnswerAgent(body)
       if (!mountedRef.current) return
-      if (result.ok) {
-        onNotifyRef.current?.('success', '提交成功')
-      } else {
-        onNotifyRef.current?.('error', formatSubmitErrorMessage(result.status, result.body))
-      }
+      const notify = formatAnswerAgentSubmitMessage(result)
+      onNotifyRef.current?.(notify.type, notify.message)
     } catch (error) {
       if (!mountedRef.current) return
       const detail = error instanceof Error ? error.message : '提交失败'

package/src/components/CurlSubmitBlock.tsx

@@ -1,4 +1,4 @@
-import { useMemo, useState } from 'react'
+import { useEffect, useMemo, useRef, useState } from 'react'
 import { Button, Tag, Tooltip, Typography } from 'antd'
 import { buildCurlStatement } from '../submit/buildCurlStatement'
 import {
@@ -9,7 +9,10 @@ import {
   extractExtraBlockValues,
   parsePayloadBlocksJson,
 } from '../submit/intersectPayloadBlocksWithForm'
-import { submitAnswerAgent } from '../submit/submitAnswerAgent'
+import {
+  formatAnswerAgentSubmitMessage,
+  submitAnswerAgent,
+} from '../submit/submitAnswerAgent'
 
 export type CurlSubmitBlockCopyMode = 'display' | 'submitFields'
 
@@ -25,19 +28,6 @@ export interface CurlSubmitBlockProps {
   onNotify?: (type: 'success' | 'error', message: string) => void
 }
 
-function formatSubmitErrorMessage(status: number, body: unknown): string {
-  if (body && typeof body === 'object' && body !== null && 'message' in body) {
-    const msg = (body as { message: unknown }).message
-    if (typeof msg === 'string' && msg.trim()) {
-      return `提交失败 (${status}): ${msg.trim()}`
-    }
-  }
-  if (typeof body === 'string' && body.trim()) {
-    return `提交失败 (${status}): ${body.trim()}`
-  }
-  return `提交失败 (${status})`
-}
-
 function resolveAnswerFromPayload(payload: unknown): Record<string, unknown> {
   const def = parsePayloadBlocksJson(payload)
   if (def) return extractExtraBlockValues(def.blocks)
@@ -57,6 +47,14 @@ export default function CurlSubmitBlock({
   onNotify,
 }: CurlSubmitBlockProps) {
   const [submitting, setSubmitting] = useState(false)
+  const mountedRef = useRef(true)
+
+  useEffect(() => {
+    mountedRef.current = true
+    return () => {
+      mountedRef.current = false
+    }
+  }, [])
 
   const displayCurl = useMemo(
     () => buildCurlStatement(payload, callbackUrl),
@@ -82,16 +80,15 @@ export default function CurlSubmitBlock({
         answer,
       })
       const result = await submitAnswerAgent(body)
-      if (result.ok) {
-        onNotify?.('success', '提交成功')
-      } else {
-        onNotify?.('error', formatSubmitErrorMessage(result.status, result.body))
-      }
+      if (!mountedRef.current) return
+      const notify = formatAnswerAgentSubmitMessage(result)
+      onNotify?.(notify.type, notify.message)
     } catch (error) {
+      if (!mountedRef.current) return
       const detail = error instanceof Error ? error.message : '提交失败'
       onNotify?.('error', detail)
     } finally {
-      setSubmitting(false)
+      if (mountedRef.current) setSubmitting(false)
     }
   }
 

package/src/index.ts

@@ -67,11 +67,14 @@ export {
 export { createFormClient, type FormClient, type FormClientOptions } from './client/formClient'
 export {
   buildAnswerAgentBody,
+  validateAnswerAgentBody,
+  validateAnswerAgentContext,
   type AskUserAnswerAgentContext,
   type BuildAnswerAgentBodyOptions,
 } from './submit/buildAnswerAgentBody'
 export {
   submitAnswerAgent,
+  formatAnswerAgentSubmitMessage,
   type SubmitAnswerAgentOptions,
 } from './submit/submitAnswerAgent'
 export {
@@ -81,6 +84,7 @@ export {
   DEFAULT_AUTH_STORAGE_KEY,
   DEFAULT_AUTH_TOKEN_FIELD,
   DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD,
+  DEFAULT_ANSWER_AGENT_CALLBACK_URL,
   type SkoponAuthStorageOptions,
   type ClientHeadersOptions,
 } from './client/authStorage'

package/src/submit/buildAnswerAgentBody.ts

@@ -59,3 +59,40 @@ export function buildAnswerAgentBody({
     answer,
   }
 }
+
+/** 提交前校验 mock answer-agent 必填字段，返回错误文案或 null。 */
+export function validateAnswerAgentBody(body: Record<string, unknown>): string | null {
+  const callbackUrl = body.callback_url
+  if (typeof callbackUrl !== 'string' || !callbackUrl.trim()) {
+    return 'callback_url 为空，无法提交'
+  }
+  if (body.tenant_id == null) {
+    return 'tenant_id 缺失，无法提交'
+  }
+  const tenantUserId = body.tenant_user_id
+  if (typeof tenantUserId !== 'string' || !tenantUserId.trim()) {
+    return 'tenant_user_id 缺失，无法提交'
+  }
+  const requestId = body.request_id
+  if (typeof requestId !== 'string' || !requestId.trim()) {
+    return 'request_id 缺失，无法提交'
+  }
+  const missionId = body.mission_id
+  if (missionId == null || missionId === '') {
+    return 'mission_id 缺失，无法提交'
+  }
+  return null
+}
+
+/** 提交前校验上下文必填字段，返回错误文案或 null。 */
+export function validateAnswerAgentContext(
+  context: AskUserAnswerAgentContext,
+): string | null {
+  return validateAnswerAgentBody(
+    buildAnswerAgentBody({
+      context,
+      payload: {},
+      answer: {},
+    }),
+  )
+}

package/src/submit/submit.test.ts

@@ -8,7 +8,7 @@ import {
   buildAskUserSubmitCurlFromPayload,
   buildCurlStatement,
 } from '../submit/buildCurlStatement'
-import { buildAnswerAgentBody } from '../submit/buildAnswerAgentBody'
+import { buildAnswerAgentBody, validateAnswerAgentBody } from '../submit/buildAnswerAgentBody'
 import {
   extractExtraBlockValues,
   getPayloadInputFieldNames,
@@ -17,7 +17,10 @@ import {
   parsePayloadBlocksJson,
   payloadHasInputBlocks,
 } from '../submit/intersectPayloadBlocksWithForm'
-import { submitAnswerAgent } from '../submit/submitAnswerAgent'
+import {
+  formatAnswerAgentSubmitMessage,
+  submitAnswerAgent,
+} from '../submit/submitAnswerAgent'
 import { submitFormJson } from '../submit/submitFormJson'
 import { validateFormSubmitValues } from '../submit/validateFormSubmit'
 import type { FormSchema } from '../types/index'
@@ -298,17 +301,58 @@ describe('buildAnswerAgentBody', () => {
   })
 })
 
+describe('validateAnswerAgentBody', () => {
+  it('rejects missing request_id', () => {
+    const body = buildAnswerAgentBody({
+      context: {
+        missionId: 1,
+        tenantId: 1001,
+        tenantUserId: 'u1',
+        callbackUrl: 'https://example.com/cb',
+      },
+      payload: {},
+      answer: {},
+    })
+    expect(validateAnswerAgentBody(body)).toBe('request_id 缺失，无法提交')
+  })
+
+  it('accepts mission_id 0', () => {
+    const body = buildAnswerAgentBody({
+      context: {
+        missionId: 0,
+        tenantId: 1001,
+        tenantUserId: 'u1',
+        requestId: 'req-1',
+        callbackUrl: 'https://example.com/cb',
+      },
+      payload: {},
+      answer: {},
+    })
+    expect(validateAnswerAgentBody(body)).toBeNull()
+  })
+})
+
 describe('submitAnswerAgent', () => {
   it('POSTs to explicit answer agent callback url with auth headers', async () => {
     const fetchMock = vi.fn(async () => ({
       ok: true,
       status: 200,
       headers: { get: () => 'application/json' },
-      json: async () => ({ callback_ok: true }),
+      json: async () => ({
+        success: true,
+        data: { callback_ok: true },
+      }),
     })) as unknown as typeof fetch
 
     const result = await submitAnswerAgent(
-      { answer: { a: 1 } },
+      {
+        mission_id: 1,
+        tenant_id: 1001,
+        tenant_user_id: 'u1',
+        request_id: 'req-1',
+        callback_url: 'https://example.com/cb',
+        answer: { a: 1 },
+      },
       {
         answerAgentCallbackUrl: '/api/v1/mock/ask_user_answer_mock',
         headers: { Authorization: 'Bearer tok' },
@@ -324,14 +368,45 @@ describe('submitAnswerAgent', () => {
           Authorization: 'Bearer tok',
           'Content-Type': 'application/json',
         }),
-        body: JSON.stringify({ answer: { a: 1 } }),
       }),
     )
   })
 
-  it('throws when answer agent callback url is missing', async () => {
+  it('marks result not ok when callback_ok is false', async () => {
+    const fetchMock = vi.fn(async () => ({
+      ok: true,
+      status: 200,
+      headers: { get: () => 'application/json' },
+      json: async () => ({
+        success: true,
+        data: { callback_ok: false, error: 'connection refused' },
+      }),
+    })) as unknown as typeof fetch
+
+    const result = await submitAnswerAgent(
+      {
+        mission_id: 1,
+        tenant_id: 1001,
+        tenant_user_id: 'u1',
+        request_id: 'req-1',
+        callback_url: 'https://example.com/cb',
+        answer: {},
+      },
+      {
+        answerAgentCallbackUrl: '/api/v1/mock/ask_user_answer_mock',
+        fetch: fetchMock,
+      },
+    )
+    expect(result.ok).toBe(false)
+    expect(formatAnswerAgentSubmitMessage(result)).toEqual({
+      type: 'error',
+      message: '提交失败：connection refused',
+    })
+  })
+
+  it('throws when required body fields are missing', async () => {
     await expect(submitAnswerAgent({ answer: {} })).rejects.toThrow(
-      'answer_agent_callback_url 未配置，无法提交',
+      'callback_url 为空，无法提交',
     )
   })
 })

package/src/submit/submitAnswerAgent.ts

@@ -1,8 +1,10 @@
 import {
+  DEFAULT_ANSWER_AGENT_CALLBACK_URL,
   resolveAnswerAgentCallbackUrl,
   resolveSkoponAuthHeaders,
   type SkoponAuthStorageOptions,
 } from '../client/authStorage'
+import { validateAnswerAgentBody } from './buildAnswerAgentBody'
 import {
   submitFormJson,
   type SubmitFormJsonOptions,
@@ -15,25 +17,88 @@ export interface SubmitAnswerAgentOptions extends SubmitFormJsonOptions {
   answerAgentCallbackUrl?: string | null
 }
 
+interface AnswerAgentResponseData {
+  callback_ok?: boolean
+  callback_status?: number
+  error?: string | null
+}
+
+function extractAnswerAgentData(body: unknown): AnswerAgentResponseData | null {
+  if (!body || typeof body !== 'object' || Array.isArray(body)) return null
+  const envelope = body as Record<string, unknown>
+  const data = envelope.data
+  if (!data || typeof data !== 'object' || Array.isArray(data)) return null
+  return data as AnswerAgentResponseData
+}
+
+function formatHttpErrorMessage(status: number, body: unknown): string {
+  if (body && typeof body === 'object' && body !== null && 'message' in body) {
+    const msg = (body as { message: unknown }).message
+    if (typeof msg === 'string' && msg.trim()) {
+      return `提交失败 (${status}): ${msg.trim()}`
+    }
+  }
+  if (typeof body === 'string' && body.trim()) {
+    return `提交失败 (${status}): ${body.trim()}`
+  }
+  return `提交失败 (${status})`
+}
+
+function formatCallbackFailureMessage(data: AnswerAgentResponseData): string {
+  const detail =
+    typeof data.error === 'string' && data.error.trim()
+      ? data.error.trim()
+      : `回调 HTTP ${data.callback_status ?? '失败'}`
+  return `提交失败：${detail}`
+}
+
+export function formatAnswerAgentSubmitMessage(
+  result: SubmitFormJsonResult,
+): { type: 'success' | 'error'; message: string } {
+  const data = extractAnswerAgentData(result.body)
+  if (data?.callback_ok === false) {
+    return { type: 'error', message: formatCallbackFailureMessage(data) }
+  }
+
+  if (!result.ok) {
+    return {
+      type: 'error',
+      message: formatHttpErrorMessage(result.status, result.body),
+    }
+  }
+
+  return { type: 'success', message: '提交成功' }
+}
+
 export async function submitAnswerAgent(
   body: Record<string, unknown>,
   options?: SubmitAnswerAgentOptions,
 ): Promise<SubmitFormJsonResult> {
+  const validationError = validateAnswerAgentBody(body)
+  if (validationError) {
+    throw new Error(validationError)
+  }
+
   const url = (
-    options?.answerAgentCallbackUrl ??
-    resolveAnswerAgentCallbackUrl(options?.authStorage)
+    options?.answerAgentCallbackUrl?.trim() ||
+    resolveAnswerAgentCallbackUrl(options?.authStorage) ||
+    DEFAULT_ANSWER_AGENT_CALLBACK_URL
   ).trim()
-  if (!url) {
-    throw new Error('answer_agent_callback_url 未配置，无法提交')
-  }
 
   const storageHeaders = resolveSkoponAuthHeaders(options?.authStorage)
 
-  return submitFormJson(url, body, {
+  const result = await submitFormJson(url, body, {
     ...options,
     headers: {
       ...storageHeaders,
       ...(options?.headers ?? {}),
     },
   })
+
+  const data = extractAnswerAgentData(result.body)
+  if (result.ok && data?.callback_ok === false) {
+    return { ok: false, status: result.status, body: result.body }
+  }
+
+  return result
 }