@skopon-cool/form-sdk 0.2.2 → 0.2.4

package/dist/submit/buildAnswerAgentBody.d.ts

@@ -0,0 +1,23 @@
+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>;
+/** 提交前校验 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

@@ -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;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

@@ -0,0 +1,13 @@
+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 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

@@ -0,0 +1 @@
+{"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.2",
+  "version": "0.2.4",
   "description": "Skopon form rendering SDK (A2UI + form_definition) with submit helpers",
   "type": "module",
   "sideEffects": [

package/src/client/authStorage.test.ts

@@ -3,7 +3,10 @@
  */
 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,
 } from './authStorage'
 
@@ -59,3 +62,31 @@ 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 default mock url when field is missing', () => {
+    sessionStorage.setItem(DEFAULT_AUTH_STORAGE_KEY, JSON.stringify({ token: 'tok' }))
+    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

@@ -9,6 +9,9 @@ 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',
@@ -21,19 +24,51 @@ 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 DEFAULT_ANSWER_AGENT_CALLBACK_URL
+
+  const raw = storage.getItem(storageKey)
+  if (!raw) return DEFAULT_ANSWER_AGENT_CALLBACK_URL
+
+  const parsed = readSessionJson(raw)
+  if (!parsed) return DEFAULT_ANSWER_AGENT_CALLBACK_URL
+
+  const url = parsed[field]
+  const trimmed = typeof url === 'string' ? url.trim() : ''
+  return trimmed || DEFAULT_ANSWER_AGENT_CALLBACK_URL
 }
 
 /** 从宿主登录缓存读取 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,11 @@ import {
   parsePayloadBlocksJson,
   payloadHasInputBlocks,
 } from '../submit/intersectPayloadBlocksWithForm'
-import { copyTextToClipboard, submitFormJson } from '../submit/submitFormJson'
+import { submitFormJson } from '../submit/submitFormJson'
+import {
+  formatAnswerAgentSubmitMessage,
+  submitAnswerAgent,
+} from '../submit/submitAnswerAgent'
 import { validateFormSubmitValues } from '../submit/validateFormSubmit'
 import type { CaseSearchFn } from '../catalog/caseSearchContext'
 import type { ResumeSearchFn } from '../catalog/resumeSearchContext'
@@ -38,6 +45,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 +60,7 @@ export default function AskUserFormCard({
   formUniqueId,
   callbackUrl,
   submitMode = 'curl',
+  answerAgentContext,
   fetchFormDetail,
   onNotify,
   resumeSearch = null,
@@ -68,6 +77,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 +187,7 @@ export default function AskUserFormCard({
         <CurlSubmitBlock
           payload={payload}
           callbackUrl={callbackUrl}
-          copyMode="submitFields"
+          answerAgentContext={resolvedAnswerAgentContext}
           unpublishedFormId={formDisabled && resolvedFormUniqueId ? resolvedFormUniqueId : undefined}
           onNotify={onNotify}
         />
@@ -188,7 +205,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 +213,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 +223,19 @@ 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 到剪贴板')
+      const notify = formatAnswerAgentSubmitMessage(result)
+      onNotifyRef.current?.(notify.type, notify.message)
     } 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,18 @@
-import { useMemo } from 'react'
+import { useEffect, useMemo, useRef, 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 {
+  formatAnswerAgentSubmitMessage,
+  submitAnswerAgent,
+} from '../submit/submitAnswerAgent'
 
 export type CurlSubmitBlockCopyMode = 'display' | 'submitFields'
 
@@ -16,43 +24,74 @@ export interface CurlSubmitBlockProps {
   incompleteFormId?: string | null
   /** display：复制与显示一致；submitFields：复制向 callback 提交返回字段的 curl */
   copyMode?: CurlSubmitBlockCopyMode
+  answerAgentContext?: AskUserAnswerAgentContext
   onNotify?: (type: 'success' | 'error', message: string) => void
 }
 
+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 mountedRef = useRef(true)
+
+  useEffect(() => {
+    mountedRef.current = true
+    return () => {
+      mountedRef.current = 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 (!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 {
+      if (mountedRef.current) 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 +108,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,25 @@ 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 {
+  resolveAnswerAgentCallbackUrl,
   resolveSkoponAuthHeaders,
   resolveClientHeaders,
   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

@@ -0,0 +1,98 @@
+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,
+  }
+}
+
+/** 提交前校验 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: {},
+    }),
+  )
+}