@skopon-cool/form-sdk 0.2.2 → 0.2.3

package/dist/submit/buildAnswerAgentBody.d.ts

@@ -0,0 +1,19 @@
+import type { FormSchema } from '../types/index';
+import { type PayloadBlocksDefinition } from './intersectPayloadBlocksWithForm';
+export interface AskUserAnswerAgentContext {
+    missionId?: number | string | null;
+    tenantId?: number | null;
+    tenantUserId?: string | null;
+    requestId?: string | null;
+    askUserQueryDescription?: string | null;
+    callbackUrl?: string | null;
+}
+export interface BuildAnswerAgentBodyOptions {
+    context: AskUserAnswerAgentContext;
+    payload: unknown;
+    form?: PayloadBlocksDefinition | FormSchema | null;
+    answer: Record<string, unknown>;
+}
+/** 组装 answer-agent 外包消息体（与 mock AskUserAnswerMockVo 对齐）。 */
+export declare function buildAnswerAgentBody({ context, payload, form, answer, }: BuildAnswerAgentBodyOptions): Record<string, unknown>;
+//# sourceMappingURL=buildAnswerAgentBody.d.ts.map

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

@@ -0,0 +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"}

package/dist/submit/submitAnswerAgent.d.ts

@@ -0,0 +1,9 @@
+import { type SkoponAuthStorageOptions } from '../client/authStorage';
+import { type SubmitFormJsonOptions, type SubmitFormJsonResult } from './submitFormJson';
+export interface SubmitAnswerAgentOptions extends SubmitFormJsonOptions {
+    authStorage?: SkoponAuthStorageOptions;
+    /** 显式覆盖 auth_user 中的 answer_agent_callback_url */
+    answerAgentCallbackUrl?: string | null;
+}
+export declare function submitAnswerAgent(body: Record<string, unknown>, options?: SubmitAnswerAgentOptions): Promise<SubmitFormJsonResult>;
+//# sourceMappingURL=submitAnswerAgent.d.ts.map

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

@@ -0,0 +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"}

package/package.json

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

package/src/client/authStorage.test.ts

@@ -3,7 +3,9 @@
  */
 import { afterEach, describe, expect, it } from 'vitest'
 import {
+  DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD,
   DEFAULT_AUTH_STORAGE_KEY,
+  resolveAnswerAgentCallbackUrl,
   resolveSkoponAuthHeaders,
 } from './authStorage'
 
@@ -59,3 +61,27 @@ describe('resolveSkoponAuthHeaders', () => {
     })
   })
 })
+
+describe('resolveAnswerAgentCallbackUrl', () => {
+  afterEach(() => {
+    sessionStorage.clear()
+    localStorage.clear()
+  })
+
+  it('reads answer_agent_callback_url from sessionStorage auth_user', () => {
+    sessionStorage.setItem(
+      DEFAULT_AUTH_STORAGE_KEY,
+      JSON.stringify({
+        token: 'tok',
+        [DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD]:
+          '/api/v1/mock/ask_user_answer_mock',
+      }),
+    )
+    expect(resolveAnswerAgentCallbackUrl()).toBe('/api/v1/mock/ask_user_answer_mock')
+  })
+
+  it('returns empty string when field is missing', () => {
+    sessionStorage.setItem(DEFAULT_AUTH_STORAGE_KEY, JSON.stringify({ token: 'tok' }))
+    expect(resolveAnswerAgentCallbackUrl()).toBe('')
+  })
+})

package/src/client/authStorage.ts

@@ -9,6 +9,7 @@ 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'
 
 function readStorage(
   kind: 'sessionStorage' | 'localStorage',
@@ -21,19 +22,50 @@ function readStorage(
   }
 }
 
+function readSessionJson(raw: string): Record<string, unknown> | null {
+  try {
+    const parsed = JSON.parse(raw) as unknown
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) return null
+    return parsed as Record<string, unknown>
+  } catch {
+    return null
+  }
+}
+
 function readTokenFromSessionJson(
   raw: string,
   tokenField: string,
 ): string {
-  try {
-    const parsed = JSON.parse(raw) as Record<string, unknown>
-    const token = parsed[tokenField]
-    return typeof token === 'string'
-      ? token.trim().replace(/^bearer\s+/i, '').trim()
-      : ''
-  } catch {
-    return ''
-  }
+  const parsed = readSessionJson(raw)
+  if (!parsed) return ''
+  const token = parsed[tokenField]
+  return typeof token === 'string'
+    ? token.trim().replace(/^bearer\s+/i, '').trim()
+    : ''
+}
+
+/** 从宿主登录缓存读取 answer_agent_callback_url（无则返回空串）。 */
+export function resolveAnswerAgentCallbackUrl(
+  options: SkoponAuthStorageOptions & {
+    answerAgentCallbackUrlField?: string
+  } = {},
+): string {
+  const storageKind = options.storage ?? 'sessionStorage'
+  const storageKey = options.storageKey ?? DEFAULT_AUTH_STORAGE_KEY
+  const field =
+    options.answerAgentCallbackUrlField ?? DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD
+
+  const storage = readStorage(storageKind)
+  if (!storage) return ''
+
+  const raw = storage.getItem(storageKey)
+  if (!raw) return ''
+
+  const parsed = readSessionJson(raw)
+  if (!parsed) return ''
+
+  const url = parsed[field]
+  return typeof url === 'string' ? url.trim() : ''
 }
 
 /** 从宿主登录缓存读取 Bearer token，返回 Authorization 头（无 token 时返回空对象）。 */

package/src/components/AskUserFormCard.tsx

@@ -2,7 +2,10 @@ import { useEffect, useMemo, useRef, useState } from 'react'
 import { Button, Spin, Tag, Tooltip } from 'antd'
 import type { FormDetailResult, FormSchema, SubmitMode } from '../types/index'
 import { buildAskUserSurface } from '../adapter/resolveSurface'
-import { buildAskUserCurlStatement } from '../submit/buildCurlStatement'
+import {
+  buildAnswerAgentBody,
+  type AskUserAnswerAgentContext,
+} from '../submit/buildAnswerAgentBody'
 import {
   extractExtraBlockValues,
   getPayloadInputFieldNames,
@@ -11,7 +14,8 @@ import {
   parsePayloadBlocksJson,
   payloadHasInputBlocks,
 } from '../submit/intersectPayloadBlocksWithForm'
-import { copyTextToClipboard, submitFormJson } from '../submit/submitFormJson'
+import { submitFormJson } from '../submit/submitFormJson'
+import { submitAnswerAgent } from '../submit/submitAnswerAgent'
 import { validateFormSubmitValues } from '../submit/validateFormSubmit'
 import type { CaseSearchFn } from '../catalog/caseSearchContext'
 import type { ResumeSearchFn } from '../catalog/resumeSearchContext'
@@ -38,6 +42,7 @@ export interface AskUserFormCardProps {
   formUniqueId?: string | null
   callbackUrl?: string | null
   submitMode?: SubmitMode
+  answerAgentContext?: AskUserAnswerAgentContext
   /** 需 useCallback 稳定引用，避免重复拉取 */
   fetchFormDetail: (ref: { formUniqueId: string }) => Promise<FormDetailResult>
   onNotify?: (type: 'success' | 'error', message: string) => void
@@ -52,6 +57,7 @@ export default function AskUserFormCard({
   formUniqueId,
   callbackUrl,
   submitMode = 'curl',
+  answerAgentContext,
   fetchFormDetail,
   onNotify,
   resumeSearch = null,
@@ -68,6 +74,14 @@ export default function AskUserFormCard({
 
   const resolvedFormUniqueId = formUniqueId?.trim() ?? ''
 
+  const resolvedAnswerAgentContext = useMemo(
+    (): AskUserAnswerAgentContext => ({
+      ...answerAgentContext,
+      callbackUrl: answerAgentContext?.callbackUrl ?? callbackUrl ?? null,
+    }),
+    [answerAgentContext, callbackUrl],
+  )
+
   useEffect(() => {
     mountedRef.current = true
     return () => {
@@ -170,7 +184,7 @@ export default function AskUserFormCard({
         <CurlSubmitBlock
           payload={payload}
           callbackUrl={callbackUrl}
-          copyMode="submitFields"
+          answerAgentContext={resolvedAnswerAgentContext}
           unpublishedFormId={formDisabled && resolvedFormUniqueId ? resolvedFormUniqueId : undefined}
           onNotify={onNotify}
         />
@@ -188,7 +202,7 @@ export default function AskUserFormCard({
         onNotifyRef.current?.('error', validationError.message)
         return
       }
-      const submitBody = { ...cardValues, ...extraValues }
+      const answer = { ...cardValues, ...extraValues }
 
       if (submitMode === 'post') {
         const url = (callbackUrl ?? '').trim()
@@ -196,7 +210,7 @@ export default function AskUserFormCard({
           onNotifyRef.current?.('error', 'callback_url 为空，无法提交')
           return
         }
-        const result = await submitFormJson(url, submitBody)
+        const result = await submitFormJson(url, answer)
         if (!mountedRef.current) return
         if (result.ok) {
           onNotifyRef.current?.('success', '提交成功')
@@ -206,14 +220,22 @@ export default function AskUserFormCard({
         return
       }
 
-      await copyTextToClipboard(
-        buildAskUserCurlStatement({ cardValues, extraValues, callbackUrl }),
-      )
+      const body = buildAnswerAgentBody({
+        context: resolvedAnswerAgentContext,
+        payload,
+        form: formDef ?? payloadDef,
+        answer,
+      })
+      const result = await submitAnswerAgent(body)
       if (!mountedRef.current) return
-      onNotifyRef.current?.('success', '已复制 curl 到剪贴板')
+      if (result.ok) {
+        onNotifyRef.current?.('success', '提交成功')
+      } else {
+        onNotifyRef.current?.('error', formatSubmitErrorMessage(result.status, result.body))
+      }
     } catch (error) {
       if (!mountedRef.current) return
-      const detail = error instanceof Error ? error.message : '复制失败'
+      const detail = error instanceof Error ? error.message : '提交失败'
       onNotifyRef.current?.('error', detail)
     } finally {
       if (mountedRef.current) setSubmitting(false)
@@ -242,7 +264,13 @@ export default function AskUserFormCard({
       />
 
       <div className="ask-user-form-actions">
-        <Tooltip title={submitMode === 'curl' ? '点击复制 curl' : '提交 JSON 到 callback_url'}>
+        <Tooltip
+          title={
+            submitMode === 'post'
+              ? '提交 JSON 到 callback_url'
+              : '提交到 answer_agent_callback_url'
+          }
+        >
           <Button
             type="primary"
             size="small"

package/src/components/CurlSubmitBlock.tsx

@@ -1,10 +1,15 @@
-import { useMemo } from 'react'
+import { useMemo, useState } from 'react'
 import { Button, Tag, Tooltip, Typography } from 'antd'
+import { buildCurlStatement } from '../submit/buildCurlStatement'
 import {
-  buildAskUserSubmitCurlFromPayload,
-  buildCurlStatement,
-} from '../submit/buildCurlStatement'
-import { copyTextToClipboard } from '../submit/submitFormJson'
+  buildAnswerAgentBody,
+  type AskUserAnswerAgentContext,
+} from '../submit/buildAnswerAgentBody'
+import {
+  extractExtraBlockValues,
+  parsePayloadBlocksJson,
+} from '../submit/intersectPayloadBlocksWithForm'
+import { submitAnswerAgent } from '../submit/submitAnswerAgent'
 
 export type CurlSubmitBlockCopyMode = 'display' | 'submitFields'
 
@@ -16,43 +21,80 @@ export interface CurlSubmitBlockProps {
   incompleteFormId?: string | null
   /** display：复制与显示一致；submitFields：复制向 callback 提交返回字段的 curl */
   copyMode?: CurlSubmitBlockCopyMode
+  answerAgentContext?: AskUserAnswerAgentContext
   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)
+  if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
+    return payload as Record<string, unknown>
+  }
+  return {}
+}
+
 export default function CurlSubmitBlock({
   payload,
   callbackUrl,
   title,
   unpublishedFormId,
   incompleteFormId,
-  copyMode = 'display',
+  answerAgentContext,
   onNotify,
 }: CurlSubmitBlockProps) {
+  const [submitting, setSubmitting] = useState(false)
+
   const displayCurl = useMemo(
     () => buildCurlStatement(payload, callbackUrl),
     [payload, callbackUrl],
   )
-  const copyCurl = useMemo(() => {
-    if (copyMode === 'submitFields') {
-      return buildAskUserSubmitCurlFromPayload(payload, callbackUrl)
-    }
-    return displayCurl
-  }, [copyMode, payload, callbackUrl, displayCurl])
 
-  async function handleCopy() {
+  const resolvedContext = useMemo(
+    (): AskUserAnswerAgentContext => ({
+      ...answerAgentContext,
+      callbackUrl: answerAgentContext?.callbackUrl ?? callbackUrl ?? null,
+    }),
+    [answerAgentContext, callbackUrl],
+  )
+
+  async function handleSubmit() {
+    if (submitting) return
+    setSubmitting(true)
     try {
-      await copyTextToClipboard(copyCurl)
-      onNotify?.('success', '已复制到剪贴板')
-    } catch {
-      onNotify?.('error', '复制失败')
+      const answer = resolveAnswerFromPayload(payload)
+      const body = buildAnswerAgentBody({
+        context: resolvedContext,
+        payload,
+        answer,
+      })
+      const result = await submitAnswerAgent(body)
+      if (result.ok) {
+        onNotify?.('success', '提交成功')
+      } else {
+        onNotify?.('error', formatSubmitErrorMessage(result.status, result.body))
+      }
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : '提交失败'
+      onNotify?.('error', detail)
+    } finally {
+      setSubmitting(false)
     }
   }
 
-  const copyTooltip =
-    copyMode === 'submitFields'
-      ? '复制提交字段 curl（向 callback 回传）'
-      : '复制 curl'
-
   return (
     <div className="ask-user-curl-card">
       <div className="ask-user-curl-card-header">
@@ -69,9 +111,15 @@ export default function CurlSubmitBlock({
             </Tooltip>
           ) : null}
         </div>
-        <Tooltip title={copyTooltip}>
-          <Button size="small" type="text" onClick={() => void handleCopy()}>
-            复制
+        <Tooltip title="提交到 answer_agent_callback_url">
+          <Button
+            size="small"
+            type="text"
+            loading={submitting}
+            disabled={submitting}
+            onClick={() => void handleSubmit()}
+          >
+            提交
           </Button>
         </Tooltip>
       </div>

package/src/index.ts

@@ -66,10 +66,21 @@ export {
 
 export { createFormClient, type FormClient, type FormClientOptions } from './client/formClient'
 export {
+  buildAnswerAgentBody,
+  type AskUserAnswerAgentContext,
+  type BuildAnswerAgentBodyOptions,
+} from './submit/buildAnswerAgentBody'
+export {
+  submitAnswerAgent,
+  type SubmitAnswerAgentOptions,
+} from './submit/submitAnswerAgent'
+export {
+  resolveAnswerAgentCallbackUrl,
   resolveSkoponAuthHeaders,
   resolveClientHeaders,
   DEFAULT_AUTH_STORAGE_KEY,
   DEFAULT_AUTH_TOKEN_FIELD,
+  DEFAULT_AUTH_ANSWER_AGENT_CALLBACK_URL_FIELD,
   type SkoponAuthStorageOptions,
   type ClientHeadersOptions,
 } from './client/authStorage'

package/src/submit/buildAnswerAgentBody.ts

@@ -0,0 +1,61 @@
+import type { FormSchema } from '../types/index'
+import {
+  parsePayloadBlocksJson,
+  type PayloadBlocksDefinition,
+} from './intersectPayloadBlocksWithForm'
+
+export interface AskUserAnswerAgentContext {
+  missionId?: number | string | null
+  tenantId?: number | null
+  tenantUserId?: string | null
+  requestId?: string | null
+  askUserQueryDescription?: string | null
+  callbackUrl?: string | null
+}
+
+function toBlocksJsonShape(
+  source: PayloadBlocksDefinition | FormSchema | unknown,
+): unknown {
+  if (!source || typeof source !== 'object' || Array.isArray(source)) {
+    return source ?? null
+  }
+  const obj = source as Record<string, unknown>
+  if (!Array.isArray(obj.blocks)) {
+    return source
+  }
+  return {
+    title: typeof obj.title === 'string' ? obj.title : '',
+    description: typeof obj.description === 'string' ? obj.description : '',
+    blocks: obj.blocks,
+  }
+}
+
+export interface BuildAnswerAgentBodyOptions {
+  context: AskUserAnswerAgentContext
+  payload: unknown
+  form?: PayloadBlocksDefinition | FormSchema | null
+  answer: Record<string, unknown>
+}
+
+/** 组装 answer-agent 外包消息体（与 mock AskUserAnswerMockVo 对齐）。 */
+export function buildAnswerAgentBody({
+  context,
+  payload,
+  form,
+  answer,
+}: BuildAnswerAgentBodyOptions): Record<string, unknown> {
+  const question = parsePayloadBlocksJson(payload) ?? payload
+  const formBody = form ? toBlocksJsonShape(form) : question
+
+  return {
+    mission_id: context.missionId ?? null,
+    tenant_id: context.tenantId ?? null,
+    tenant_user_id: context.tenantUserId ?? null,
+    request_id: context.requestId ?? null,
+    ask_user_query_description: context.askUserQueryDescription ?? null,
+    callback_url: (context.callbackUrl ?? '').trim() || null,
+    form: formBody,
+    question,
+    answer,
+  }
+}

package/src/submit/submit.test.ts

@@ -8,6 +8,7 @@ import {
   buildAskUserSubmitCurlFromPayload,
   buildCurlStatement,
 } from '../submit/buildCurlStatement'
+import { buildAnswerAgentBody } from '../submit/buildAnswerAgentBody'
 import {
   extractExtraBlockValues,
   getPayloadInputFieldNames,
@@ -16,6 +17,7 @@ import {
   parsePayloadBlocksJson,
   payloadHasInputBlocks,
 } from '../submit/intersectPayloadBlocksWithForm'
+import { submitAnswerAgent } from '../submit/submitAnswerAgent'
 import { submitFormJson } from '../submit/submitFormJson'
 import { validateFormSubmitValues } from '../submit/validateFormSubmit'
 import type { FormSchema } from '../types/index'
@@ -261,6 +263,79 @@ describe('payload fallback helpers', () => {
   })
 })
 
+describe('buildAnswerAgentBody', () => {
+  it('maps context and payload into answer-agent body', () => {
+    const payload = {
+      title: '需求描述',
+      blocks: [
+        { id: 'b1', type: 'textarea', name: 'field_b6ba0dbb', label: '需求描述' },
+      ],
+    }
+    const body = buildAnswerAgentBody({
+      context: {
+        missionId: 12,
+        tenantId: 1001,
+        tenantUserId: 'user-1',
+        requestId: 'req-1',
+        askUserQueryDescription: '请确认',
+        callbackUrl: 'https://example.com/cb',
+      },
+      payload,
+      answer: { field_b6ba0dbb: 'hello' },
+    })
+    expect(body.mission_id).toBe(12)
+    expect(body.tenant_id).toBe(1001)
+    expect(body.tenant_user_id).toBe('user-1')
+    expect(body.request_id).toBe('req-1')
+    expect(body.ask_user_query_description).toBe('请确认')
+    expect(body.callback_url).toBe('https://example.com/cb')
+    expect(body.answer).toEqual({ field_b6ba0dbb: 'hello' })
+    expect(body.question).toMatchObject({ title: '需求描述' })
+    expect(body.form).toMatchObject({ title: '需求描述' })
+    expect((body.question as { blocks: Array<{ name: string }> }).blocks[0]?.name).toBe(
+      'field_b6ba0dbb',
+    )
+  })
+})
+
+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 }),
+    })) as unknown as typeof fetch
+
+    const result = await submitAnswerAgent(
+      { answer: { a: 1 } },
+      {
+        answerAgentCallbackUrl: '/api/v1/mock/ask_user_answer_mock',
+        headers: { Authorization: 'Bearer tok' },
+        fetch: fetchMock,
+      },
+    )
+    expect(result.ok).toBe(true)
+    expect(fetchMock).toHaveBeenCalledWith(
+      '/api/v1/mock/ask_user_answer_mock',
+      expect.objectContaining({
+        method: 'POST',
+        headers: expect.objectContaining({
+          Authorization: 'Bearer tok',
+          'Content-Type': 'application/json',
+        }),
+        body: JSON.stringify({ answer: { a: 1 } }),
+      }),
+    )
+  })
+
+  it('throws when answer agent callback url is missing', async () => {
+    await expect(submitAnswerAgent({ answer: {} })).rejects.toThrow(
+      'answer_agent_callback_url 未配置，无法提交',
+    )
+  })
+})
+
 describe('submitFormJson', () => {
   it('POSTs JSON payload', async () => {
     const fetchMock = vi.fn(async () => ({

package/src/submit/submitAnswerAgent.ts

@@ -0,0 +1,39 @@
+import {
+  resolveAnswerAgentCallbackUrl,
+  resolveSkoponAuthHeaders,
+  type SkoponAuthStorageOptions,
+} from '../client/authStorage'
+import {
+  submitFormJson,
+  type SubmitFormJsonOptions,
+  type SubmitFormJsonResult,
+} from './submitFormJson'
+
+export interface SubmitAnswerAgentOptions extends SubmitFormJsonOptions {
+  authStorage?: SkoponAuthStorageOptions
+  /** 显式覆盖 auth_user 中的 answer_agent_callback_url */
+  answerAgentCallbackUrl?: string | null
+}
+
+export async function submitAnswerAgent(
+  body: Record<string, unknown>,
+  options?: SubmitAnswerAgentOptions,
+): Promise<SubmitFormJsonResult> {
+  const url = (
+    options?.answerAgentCallbackUrl ??
+    resolveAnswerAgentCallbackUrl(options?.authStorage)
+  ).trim()
+  if (!url) {
+    throw new Error('answer_agent_callback_url 未配置，无法提交')
+  }
+
+  const storageHeaders = resolveSkoponAuthHeaders(options?.authStorage)
+
+  return submitFormJson(url, body, {
+    ...options,
+    headers: {
+      ...storageHeaders,
+      ...(options?.headers ?? {}),
+    },
+  })
+}