@ai_mind/dsh-a2a 1.1.3 → 1.2.0

package/README.md

@@ -115,7 +115,7 @@
 面板分三部分：
 
 1. **概览**：实时 Agent Card、JSON-RPC / HTTP+JSON 地址（一键复制）、流式/推送/扩展卡片能力、鉴权状态、运行状态与可复制的 `curl` / 官方 JS 客户端示例。
-2. **配置表单**：直接编辑名称、描述、对外地址、挂载路径、流式/推送/扩展卡片、鉴权模式与令牌环境变量、访问令牌（写入后不再回显）、Agent 预设/模型/工作目录/沙箱/审批/并发/超时，以及请求体与任务保留限额。
+2. **配置表单**：直接编辑名称、描述、对外地址、挂载路径、流式/推送/扩展卡片、鉴权模式与令牌环境变量、访问令牌（写入后不再回显）、Agent 预设/模型/工作目录/沙箱/审批/并发/超时，以及请求体与任务保留限额。预设、模型提供方、模型和推理强度会从当前 Host 的 `agentPresets` / `llm` 服务动态列出选项；留空即使用部署默认，无法列出的自定义值仍可手动输入。
 3. **保存**：写入 profile 的 `cordis.patch.yml`（`a2a-server` 行），校验通过后插件自动重载；修改挂载路径后刷新页面即可。
 
 配置接口 `GET/PUT <mountPath>/panel/config` 始终位于 DSH Web 的 origin（独立端口模式下也不在 A2A 端口上），使用 **Harness Web 连接凭据**（不是 A2A token）鉴权：只有能打开 Settings 的已登录浏览器可以读写，远程 A2A 客户端即使知道路径也会收到 401。令牌字段是只写字段，GET 只返回“是否已配置”。
@@ -322,8 +322,11 @@ A2A 前面的 Nginx/Caddy 等反代需要保留原始 `Host` 和协议头：
 proxy_set_header Host $host;
 proxy_set_header X-Forwarded-Proto $scheme;
 proxy_set_header X-Forwarded-Host $host;
+proxy_set_header X-Forwarded-Port $server_port;
 ```
 
+自定义外部端口时，代理除了 `Host` 还要传 `X-Forwarded-Port`（或让 `Host` 直接包含端口），卡片才会带上正确端口。
+
 并设置：
 
 ```yaml

package/client.js

@@ -108,6 +108,9 @@ window.__ModuleLoader__.load({
       fieldAgentProvider: '模型提供方',
       fieldAgentModel: '模型',
       fieldAgentReasoningEffort: '推理强度',
+      optionDefault: '（使用默认）',
+      defaultModel: '默认模型（留空时）',
+      modelPairHint: '模型提供方和模型必须同时选择，或都留空使用默认。',
       fieldAgentSandboxMode: '沙箱模式',
       fieldAgentApprovalPolicy: '审批策略',
       fieldAgentMaxConcurrentTasks: '最大并发任务',
@@ -220,6 +223,9 @@ window.__ModuleLoader__.load({
       fieldAgentProvider: 'Model provider',
       fieldAgentModel: 'Model',
       fieldAgentReasoningEffort: 'Reasoning effort',
+      optionDefault: '(use default)',
+      defaultModel: 'Default model (when empty)',
+      modelPairHint: 'Choose both a provider and a model, or leave both empty for the default.',
       fieldAgentSandboxMode: 'Sandbox mode',
       fieldAgentApprovalPolicy: 'Approval policy',
       fieldAgentMaxConcurrentTasks: 'Max concurrent tasks',
@@ -369,6 +375,15 @@ window.__ModuleLoader__.load({
       return typeof label === 'string' && label !== key ? label : value
     }
 
+    function panelOptionsPath(panelPath, provider, model) {
+      const base = panelPath.replace(/\/config$/, '/options')
+      const params = new URLSearchParams()
+      if (provider) params.set('provider', provider)
+      if (model) params.set('model', model)
+      const query = params.toString()
+      return query ? `${base}?${query}` : base
+    }
+
     function draftFrom(panel) {
       const values = {}
       for (const field of panel && Array.isArray(panel.fields) ? panel.fields : []) values[field.path] = field.value
@@ -428,6 +443,37 @@ window.__ModuleLoader__.load({
         const [saveError, setSaveError] = React.useState(null)
         const [copied, setCopied] = React.useState(null)
         const [reloadKey, setReloadKey] = React.useState(0)
+        const [optionSets, setOptionSets] = React.useState({})
+        const optionsRequest = React.useRef(0)
+
+        const loadOptions = async (panelPath, provider, model, signal) => {
+          if (!panelPath) return
+          const requestId = ++optionsRequest.current
+          try {
+            const response = await fetch(panelOptionsPath(panelPath, provider, model), {
+              cache: 'no-store',
+              credentials: 'same-origin',
+              signal,
+            })
+            if (!response.ok) return
+            const data = await response.json()
+            if (requestId !== optionsRequest.current) return
+            setOptionSets(data)
+            if (provider && !model && Array.isArray(data.models) && data.models.length > 0) {
+              const preferred =
+                data.default && data.default.provider === provider && data.models.some((entry) => entry.value === data.default.model)
+                  ? data.default.model
+                  : data.models[0].value
+              setDraft((previous) => {
+                if (previous['agent.provider'] !== provider || previous['agent.model']) return previous
+                return { ...previous, 'agent.model': preferred, 'agent.reasoningEffort': '' }
+              })
+              void loadOptions(panelPath, provider, preferred)
+            }
+          } catch {
+            /* options are optional; the text inputs remain usable */
+          }
+        }
 
         React.useEffect(() => {
           const controller = new AbortController()
@@ -487,6 +533,10 @@ window.__ModuleLoader__.load({
               }
               setState({ status: 'ready', card, health, denied, error: null, panel, panelPath, panelError })
               setDraft(draftFrom(panel))
+              if (panel && panelPath) {
+                const fieldValue = (path) => panel.fields.find((field) => field.path === path)?.value
+                void loadOptions(panelPath, fieldValue('agent.provider'), fieldValue('agent.model'), controller.signal)
+              }
             } catch (error) {
               if (error && error.name === 'AbortError') return
               setState({ status: 'error', card: null, health: null, denied: false, error: String((error && error.message) || error), panel: null, panelPath: null, panelError: null })
@@ -573,11 +623,35 @@ window.__ModuleLoader__.load({
         const dirty = panel
           ? panel.fields.some((field) => !sameValue(field, draft[field.path])) || token !== '' || clearToken
           : false
+        const invalidModelPair = Boolean(draft['agent.provider']) !== Boolean(draft['agent.model'])
 
         const setField = (path, value) => {
-          setDraft((previous) => ({ ...previous, [path]: value }))
+          setDraft((previous) => {
+            const next = { ...previous, [path]: value }
+            if (path === 'agent.provider') {
+              next['agent.model'] = ''
+              next['agent.reasoningEffort'] = ''
+            } else if (path === 'agent.model') {
+              if (value === '') next['agent.provider'] = ''
+              else if (!previous['agent.provider']) {
+                next['agent.provider'] = optionSets.provider ?? optionSets.default?.provider ?? ''
+              }
+              next['agent.reasoningEffort'] = ''
+            }
+            return next
+          })
           setSaved(false)
           setSaveError(null)
+          if (path === 'agent.provider') {
+            void loadOptions(state.panelPath, value ?? '', '')
+          } else if (path === 'agent.model') {
+            if (value === '') {
+              void loadOptions(state.panelPath, '', '')
+            } else {
+              const provider = draft['agent.provider'] || optionSets.provider || optionSets.default?.provider || ''
+              void loadOptions(state.panelPath, provider, value)
+            }
+          }
         }
 
         const save = async () => {
@@ -618,6 +692,26 @@ window.__ModuleLoader__.load({
         const renderControl = (field) => {
           const value = draft[field.path]
           const onChange = (event) => setField(field.path, event.target.value)
+          const dynamicOptions = field.optionsKey ? optionSets[field.optionsKey] : undefined
+          if (field.optionsKey && Array.isArray(dynamicOptions) && dynamicOptions.length > 0) {
+            const current = value == null ? '' : String(value)
+            const options =
+              !current || dynamicOptions.some((option) => String(option.value) === current)
+                ? dynamicOptions
+                : [{ value: current, label: `${current} (current)` }, ...dynamicOptions]
+            return h(
+              'select',
+              { className: 'a2aui-select', value: current, onChange },
+              h('option', { value: '' }, t('optionDefault')),
+              options.map((option) =>
+                h(
+                  'option',
+                  { key: option.value, value: option.value },
+                  option.description ? `${option.label} — ${option.description}` : option.label,
+                ),
+              ),
+            )
+          }
           if (field.type === 'boolean') {
             return h(
               'label',
@@ -719,6 +813,14 @@ window.__ModuleLoader__.load({
                         h('div', null, renderControl(field)),
                       ),
                     ),
+                    group === 'agent' && optionSets.default
+                      ? h(
+                          'p',
+                          { className: 'a2aui-field-note' },
+                          `${t('defaultModel')}: ${optionSets.default.provider ?? '?'} / ${optionSets.default.model ?? '?'}` +
+                            (optionSets.default.reasoningEffort ? ` · ${optionSets.default.reasoningEffort}` : ''),
+                        )
+                      : null,
                   )
                   return group === 'auth' ? [node, secretBlock] : [node]
                 }),
@@ -727,11 +829,14 @@ window.__ModuleLoader__.load({
                   { className: 'a2aui-form-foot' },
                   h(
                     'button',
-                    { type: 'button', className: 'a2aui-btn a2aui-btnPrimary', disabled: !dirty || saving, onClick: save },
+                    { type: 'button', className: 'a2aui-btn a2aui-btnPrimary', disabled: !dirty || saving || invalidModelPair, onClick: save },
                     saving ? t('saving') : t('save'),
                   ),
                   h('button', { type: 'button', className: 'a2aui-btn', onClick: () => setReloadKey((value) => value + 1) }, t('reload')),
                   dirty ? h('span', { className: 'a2aui-status' }, t('dirty')) : null,
+                  invalidModelPair
+                    ? h('span', { className: 'a2aui-status', 'data-tone': 'warn' }, t('modelPairHint'))
+                    : null,
                   saved ? h('span', { className: 'a2aui-status', 'data-tone': 'ok' }, t('saved')) : null,
                   saveError ? h('span', { className: 'a2aui-status', 'data-tone': 'error' }, `${t('saveError')}: ${saveError}`) : null,
                   h('span', { className: 'a2aui-status' }, t('configHint')),

package/lib/panel.js

@@ -49,10 +49,10 @@ const FIELDS = [
   { path: 'auth.tokenEnv', type: 'string', group: 'auth', nullable: true, placeholder: 'A2A_AUTH_TOKEN' },
   { path: 'auth.allowRemoteUnauthenticated', type: 'boolean', group: 'auth' },
   { path: 'agent.cwd', type: 'string', group: 'agent', nullable: true, placeholder: '/srv/a2a-workspace' },
-  { path: 'agent.preset', type: 'string', group: 'agent', nullable: true },
-  { path: 'agent.provider', type: 'string', group: 'agent', nullable: true },
-  { path: 'agent.model', type: 'string', group: 'agent', nullable: true },
-  { path: 'agent.reasoningEffort', type: 'string', group: 'agent', nullable: true },
+  { path: 'agent.preset', type: 'string', group: 'agent', nullable: true, optionsKey: 'presets' },
+  { path: 'agent.provider', type: 'string', group: 'agent', nullable: true, optionsKey: 'providers' },
+  { path: 'agent.model', type: 'string', group: 'agent', nullable: true, optionsKey: 'models' },
+  { path: 'agent.reasoningEffort', type: 'string', group: 'agent', nullable: true, optionsKey: 'reasoning' },
   {
     path: 'agent.sandboxMode',
     type: 'enum',
@@ -175,6 +175,7 @@ function describe(config, entry, warnings) {
       ...(field.min === undefined ? {} : { min: field.min }),
       ...(field.max === undefined ? {} : { max: field.max }),
       ...(field.placeholder === undefined ? {} : { placeholder: field.placeholder }),
+      ...(field.optionsKey === undefined ? {} : { optionsKey: field.optionsKey }),
       value: value === undefined ? null : value,
     }
   })
@@ -202,6 +203,23 @@ function describe(config, entry, warnings) {
  * @param {() => object} [options.health] live health snapshot
  * @returns {import('express').Router}
  */
+/** First value of an express query parameter. */
+function firstQuery(value) {
+  if (Array.isArray(value)) return value[0]
+  return typeof value === 'string' ? value : undefined
+}
+
+/** Resolve an optional Host call without letting a slow model catalog block the panel. */
+function withTimeout(promise, fallback, ms) {
+  return Promise.race([
+    Promise.resolve(promise).catch(() => fallback),
+    new Promise((resolve) => {
+      const timer = setTimeout(() => resolve(fallback), ms)
+      timer.unref?.()
+    }),
+  ])
+}
+
 function safeHealth(health, logger) {
   try {
     return health()
@@ -287,7 +305,7 @@ export function createPanelRouter({ ctx, config, mountPath, logger, status, heal
     res.setHeader('Cache-Control', 'no-store')
     res.json({
       ok: true,
-      plugin: { name: PLUGIN_NAME, version: '1.1.3' },
+      plugin: { name: PLUGIN_NAME, version: '1.2.0' },
       mountPath,
       ...payload,
       ...(typeof status === 'function' ? { server: status() } : {}),
@@ -295,6 +313,88 @@ export function createPanelRouter({ ctx, config, mountPath, logger, status, heal
     })
   })
 
+  router.get('/options', async (req, res) => {
+    if (authorize(req, res)) return
+    const llm = ctx.get?.('llm')
+    const presetsService = ctx.get?.('agentPresets')
+    const defaults = ctx.get?.('agentDefaultModel')
+    let selection = null
+    try {
+      selection = defaults?.currentSelection?.() ?? null
+    } catch (error) {
+      logger.warn(`[a2a] cannot read the default model selection: ${errorMessage(error)}`)
+    }
+    const requestedProvider = firstQuery(req.query.provider)?.trim() || null
+    const requestedModel = firstQuery(req.query.model)?.trim() || null
+    const provider = requestedProvider ?? selection?.provider ?? null
+    const model = requestedModel ?? (provider === selection?.provider ? selection?.model : null) ?? null
+
+    let presets = []
+    try {
+      const listed = await withTimeout(presetsService?.list?.(), [], 3000)
+      presets = (listed ?? []).map((preset) => ({
+        value: preset.id,
+        label: preset.name ?? preset.id,
+        description: preset.broken ? `unavailable: ${preset.broken}` : (preset.description ?? null),
+      }))
+    } catch (error) {
+      logger.warn(`[a2a] cannot list agent presets: ${errorMessage(error)}`)
+    }
+
+    let providers = []
+    try {
+      providers = (llm?.listProviders?.() ?? []).map((entry) => ({
+        value: entry.id,
+        label: entry.name ?? entry.id,
+      }))
+    } catch (error) {
+      logger.warn(`[a2a] cannot list model providers: ${errorMessage(error)}`)
+    }
+
+    let models = []
+    if (provider !== null && typeof llm?.listModels === 'function') {
+      try {
+        const listed = await withTimeout(llm.listModels(provider), [], 4000)
+        models = (listed ?? []).map((entry) => ({
+          value: entry.id,
+          label: entry.name && entry.name !== entry.id ? `${entry.name} (${entry.id})` : entry.id,
+          description: entry.description ?? null,
+        }))
+      } catch (error) {
+        logger.warn(`[a2a] cannot list models for ${provider}: ${errorMessage(error)}`)
+      }
+    }
+
+    let reasoning = []
+    let reasoningDefault = null
+    if (provider !== null && model !== null && typeof llm?.resolveModelInfo === 'function') {
+      try {
+        const info = await withTimeout(llm.resolveModelInfo(provider, model), null, 4000)
+        reasoning = (info?.reasoning?.efforts ?? []).map((effort) => ({
+          value: effort.id,
+          label: effort.name ?? effort.id,
+          description: effort.description ?? null,
+        }))
+        reasoningDefault = info?.reasoning?.defaultEffort ?? null
+      } catch (error) {
+        logger.warn(`[a2a] cannot resolve reasoning options for ${provider}/${model}: ${errorMessage(error)}`)
+      }
+    }
+
+    res.setHeader('Cache-Control', 'no-store')
+    res.json({
+      ok: true,
+      presets,
+      providers,
+      models,
+      reasoning,
+      reasoningDefault,
+      default: selection,
+      provider,
+      model,
+    })
+  })
+
   router.put('/config', json, async (req, res) => {
     if (authorize(req, res)) return
     const configEditor = editor()
@@ -384,7 +484,7 @@ export function createPanelRouter({ ctx, config, mountPath, logger, status, heal
     logger.info('[a2a] configuration updated from the settings panel')
     res.json({
       ok: true,
-      plugin: { name: PLUGIN_NAME, version: '1.1.3' },
+      plugin: { name: PLUGIN_NAME, version: '1.2.0' },
       mountPath,
       ...describe(live, liveEntry, []),
       ...(typeof status === 'function' ? { server: status() } : {}),

package/lib/server.js

@@ -94,6 +94,13 @@ function baseFromHeaders(headers, config, fallbackProtocol = 'http') {
   try {
     const url = new URL(`${protocol}://${host}`)
     if (url.protocol !== 'http:' && url.protocol !== 'https:') return null
+    // A proxy may expose the service on a non-standard port while forwarding
+    // only the hostname; X-Forwarded-Port carries the client-facing port.
+    if (trusted && url.port === '') {
+      const forwardedPort = firstHeader(headers?.['x-forwarded-port'])
+      const port = Number(forwardedPort?.split(',')[0].trim())
+      if (Number.isInteger(port) && port >= 1 && port <= 65535) url.port = String(port)
+    }
     return trimTrailingSlash(url.origin)
   } catch {
     return null

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai_mind/dsh-a2a",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "Production A2A (Agent2Agent) v1.0 server for DeepSeek Harness agents: JSON-RPC + HTTP+JSON bindings, streaming, tasks, push notifications and signed Agent Cards.",
   "type": "module",
   "license": "MIT",