openclaw-openagent 1.0.1 → 1.0.2

package/src/plugin-ui/ui-extension-loader/registry-regex.ts

@@ -583,7 +583,7 @@ const toolcallidPropagate: UIExtension = {
 };
 
 
-// ── Extension 6: remote-agent-message-short-circuit（正则定位，双策略A+B）─
+// ── Extension 6: remote-agent-message-short-circuit（三策略 A/B/C）───────
 
 const remoteAgentMessageShortCircuit: UIExtension = {
   id: 'remote-agent-message-short-circuit',
@@ -597,16 +597,16 @@ const remoteAgentMessageShortCircuit: UIExtension = {
     if (hasMarker(content, this.id)) { return true; }
     if (!backupFile(bundlePath)) return false;
 
-    // 找 showToolCalls 赋值
+    // 找 showToolCalls 赋值 → 提取 toolCardsVar / hasToolCardsVar
     const assignRe = /(\w+)=\w+\.showToolCalls[^;]*\(\w+(?:,\w+)?\)\s*:\s*\[\]\s*,\s*(\w+)\s*=\s*\1\.length\s*>\s*0/;
     const assignMatch = content.match(assignRe);
     if (!assignMatch) {
-      logger.warn('[ui-ext:regex] remote-agent-msg: showToolCalls pattern not found');
+      logger.warn('[ui-ext:regex] remote-agent-msg: showToolCalls assignment not found');
       return false;
     }
 
-    const toolCardsVar = assignMatch[1];
-    const hasToolCardsVar = assignMatch[2];
+    const toolCardsVar = assignMatch[1]!;
+    const hasToolCardsVar = assignMatch[2]!;
     const marker = makeMarker(this.id);
 
     // 策略A (v3.23~v4.10): if(!markdown&&hasToolCards&&isToolResult)
@@ -614,8 +614,8 @@ const remoteAgentMessageShortCircuit: UIExtension = {
     const ifMatchA = content.match(ifReA);
 
     if (ifMatchA) {
-      const markdownVar = ifMatchA[1];
-      const isToolResultVar = ifMatchA[2];
+      const markdownVar = ifMatchA[1]!;
+      const isToolResultVar = ifMatchA[2]!;
       const patched = `if(${marker}(!${markdownVar}||window.__openagentOwnsToolCards&&window.__openagentOwnsToolCards(${toolCardsVar}))&&${hasToolCardsVar}&&${isToolResultVar})`;
       content = content.substring(0, ifMatchA.index!) + patched + content.substring(ifMatchA.index! + ifMatchA[0].length);
       writeFileSync(bundlePath, content, 'utf-8');
@@ -623,15 +623,30 @@ const remoteAgentMessageShortCircuit: UIExtension = {
       return true;
     }
 
-    // 策略B (v4.11+): compound = hasToolCards && (showToolCalls ?? !0)
+    // 策略C (2026.4.x): if(!VAR.showToolCalls&&...toolresult...)continue
+    // 直接匹配 continue 跳过语句，注入 openagentOwnsToolCards 条件
+    const continueRe = /if\(!(\w+)\.showToolCalls&&(\w+)\.role\.toLowerCase\(\)===`toolresult`\)continue/;
+    const continueMatch = content.match(continueRe);
+
+    if (continueMatch) {
+      const scVar = continueMatch[1]!;
+      const roleVar = continueMatch[2]!;
+      const patched = `if(!${scVar}.showToolCalls&&!window.__openagentOwnsToolCards?.(${toolCardsVar})&&${roleVar}.role.toLowerCase()===\`toolresult\`)continue`;
+      content = content.substring(0, continueMatch.index!) + marker + patched + content.substring(continueMatch.index! + continueMatch[0].length);
+      writeFileSync(bundlePath, content, 'utf-8');
+      logger.info(`[ui-ext:regex] remote-agent-msg: patched (strategy C, sc=${scVar})`);
+      return true;
+    }
+
+    // 策略B (v4.11~v4.1x fallback): compound = hasToolCards && (showToolCalls ?? !0)
     const compoundRe = new RegExp(`(\\w+)=${hasToolCardsVar}&&\\(\\w+\\.showToolCalls\\?\\?!0\\)`);
     const compoundMatch = content.match(compoundRe);
     if (!compoundMatch) {
-      logger.warn('[ui-ext:regex] remote-agent-msg: both strategies failed');
+      logger.warn('[ui-ext:regex] remote-agent-msg: all strategies (A/C/B) failed');
       return false;
     }
 
-    const compoundVar = compoundMatch[1];
+    const compoundVar = compoundMatch[1]!;
     const ifReB = new RegExp(`if\\(!(\\w+)&&!${compoundVar}&&`);
     const ifMatchB = content.match(ifReB);
     if (!ifMatchB) {
@@ -639,7 +654,7 @@ const remoteAgentMessageShortCircuit: UIExtension = {
       return false;
     }
 
-    const markdownVarB = ifMatchB[1];
+    const markdownVarB = ifMatchB[1]!;
     const patchedCond = `if(${marker}(!${markdownVarB}||window.__openagentOwnsToolCards&&window.__openagentOwnsToolCards(${toolCardsVar}))&&!${compoundVar}&&`;
     content = content.substring(0, ifMatchB.index!) + patchedCond + content.substring(ifMatchB.index! + ifMatchB[0].length);
     writeFileSync(bundlePath, content, 'utf-8');
@@ -668,14 +683,16 @@ const mentionHooks: UIExtension = {
     if (!backupFile(bundlePath)) return false;
 
     // 注入点 A: handleKeyDown
-    const keydownRe = /;return\}if\(([a-zA-Z_$][a-zA-Z0-9_$]*)\.key===`Enter`&&!\1\.shiftKey\)\{if\(\1\.isComposing/;
+    // 匹配 return;if(key===Enter&&!shiftKey){if(isComposing 结构
+    // 兼容 2026.4.x: return;if (无 }) 和旧版 ;return}if (有 })
+    const keydownRe = /;return\}?if\(([a-zA-Z_$][a-zA-Z0-9_$]*)\.key===`Enter`&&!\1\.shiftKey\)\{if\(\1\.isComposing/;
     const keydownMatch = content.match(keydownRe);
     if (!keydownMatch) {
       logger.warn('[ui-ext:regex] mention-hooks: keydown anchor not found');
       return false;
     }
     const eventParam = keydownMatch[1];
-    const keydownInsertIdx = content.indexOf(keydownMatch[0]) + ';return}'.length;
+    const keydownInsertIdx = content.indexOf(keydownMatch[0]) + keydownMatch[0].indexOf('if(');
     const markerA = makeMarker(this.id);
     const hookA = `${markerA}if(window.__clMention?.onKeyDown(${eventParam}))return;`;
     content = content.substring(0, keydownInsertIdx) + hookA + content.substring(keydownInsertIdx);

package/src/runtime/account.ts

@@ -39,7 +39,6 @@ import { createTransport } from '../transport/factory.js';
 import type {
   AgentTransport,
   AgentStatusResult,
-  ClaimResult,
   OasnTransport,
   TransportCredentials,
 } from '../transport/types.js';
@@ -310,28 +309,6 @@ export class AccountRuntime {
     this._statusPollTimer = null;
   }
 
-  async claimOwnerEmail(ownerEmail: string): Promise<ClaimResult> {
-    if (this._transportType !== 'oasn') {
-      throw new Error('Agent claim is only available in OASN mode');
-    }
-    await this.ensureConnected();
-    const transport = this.transport;
-    if (!transport || transport.transportType !== 'oasn') {
-      throw new Error('OASN transport not ready');
-    }
-    const oasnTransport = transport as OasnTransport;
-    const result = await oasnTransport.claimAgent({
-      agent_id: this._config?.agentId,
-      owner_email: ownerEmail,
-    });
-    this._claimStatus = 'claim_pending';
-    this._claimExpiresAt = result.expires_at;
-    this._saveOasnAccountConfig({ status: 'claim_pending' });
-    this._scheduleOasnStatusPolling(oasnTransport);
-    logger.info(`[runtime] OASN claim started: agent_id=${result.agent_id} owner=${result.owner_email_masked} expires_at=${result.expires_at}`);
-    return result;
-  }
-
   assertOasnInvocationAllowed(): void {
     if (this._transportType === 'oasn' && this._claimStatus !== 'claimed') {
       throw new Error(`OASN ClientAgent is not claimed yet (status=${this._claimStatus}). Complete claim before calling remote agents.`);

package/src/transport/oasn/oasn-files.ts

@@ -155,11 +155,11 @@ export class OasnFiles {
     );
 
     return {
-      fileRef: resp.file_ref,
-      displayName: resp.display_name,
-      mimeType: resp.mime_type,
-      sizeBytes: resp.size_bytes,
-      expiresAt: this._parseExpiresAt(resp.expires_at),
+      fileRef: resp.fileRef ?? resp.file_ref ?? '',
+      displayName: resp.displayName ?? resp.display_name ?? 'unknown',
+      mimeType: resp.mimeType ?? resp.mime_type ?? 'application/octet-stream',
+      sizeBytes: resp.sizeBytes ?? resp.size_bytes ?? 0,
+      expiresAt: this._parseExpiresAt(resp.expiresAt ?? resp.expires_at ?? ''),
     };
   }
 

package/src/transport/oasn/oasn-invocation.ts

@@ -38,6 +38,7 @@ import {
   type TaskRequest,
   type TaskResult,
   type TransportError,
+  type WebuiContinuationRef,
 } from '../types.js';
 import type { OasnHttpClient } from './oasn-http.js';
 import {
@@ -48,6 +49,7 @@ import {
   type CreateInvocationResponse,
   type GetInvocationResponse,
   type InvocationStatus,
+  type VisibleResultResponse,
 } from './oasn-types.js';
 
 /** Invocation 持久化钩子（接 StateStore.pending_invocations，§11.1） */
@@ -378,31 +380,71 @@ export class OasnInvocation {
   /**
    * 把终态 Invocation 响应转换为 TaskResult。
    *
-   *   - succeeded → status:'complete' + content=summary + artifacts
+   *   - succeeded → status:'complete' + content=summary + artifacts + webuiContinuation
    *   - 其它终态 → status:'error' + content=user_error.message
+   *
+   * content 的归一路径：
+   *   inlineResult.summary > visible_result.inline_result_summary > ''
+   *
+   * webui_continuation 仅在 succeeded 时抽取（失败场景后端不保证存在）。
    */
   private _toTaskResult(invocationId: string, final: GetInvocationResponse): TaskResult {
+    const webuiContinuation = this._toWebuiContinuation(final);
+
     if (final.status === 'succeeded') {
       const inlineResult = final.inlineResult ?? final.inline_result;
+      const visible = final.visibleResult ?? final.visible_result;
+      const summary = inlineResult?.summary
+        ?? visible?.inlineResultSummary
+        ?? visible?.inline_result_summary
+        ?? '';
       return {
         requestId: invocationId,
         status: 'complete',
-        content: inlineResult?.summary ?? '',
+        content: summary,
         artifacts: (final.artifacts ?? []).map(this._toArtifactRef),
+        webuiContinuation,
       };
     }
 
     // 失败/超时/取消 —— 文本统一用 user_error.message 兜底
     const userError = final.userError ?? final.user_error;
     const inlineResult = final.inlineResult ?? final.inline_result;
+    const visible = final.visibleResult ?? final.visible_result;
     const message = userError?.message
       ?? inlineResult?.summary
+      ?? visible?.inlineResultSummary
+      ?? visible?.inline_result_summary
       ?? `Invocation ended with status=${final.status}`;
     return {
       requestId: invocationId,
       status: 'error',
       content: message,
       artifacts: (final.artifacts ?? []).map(this._toArtifactRef),
+      webuiContinuation,
+    };
+  }
+
+  /**
+   * 从终态响应里抽取 WebUI continuation（camelCase / snake_case 双归一）。
+   * 缺必要字段（id / launch_url）时返回 undefined，调用方按 falsy 处理即可。
+   */
+  private _toWebuiContinuation(final: GetInvocationResponse): WebuiContinuationRef | undefined {
+    const visible: VisibleResultResponse | undefined =
+      final.visibleResult ?? final.visible_result;
+    const raw = visible?.webuiContinuation ?? visible?.webui_continuation;
+    if (!raw) return undefined;
+
+    const id = raw.continuationId ?? raw.continuation_id;
+    const launchUrl = raw.launchUrl ?? raw.launch_url;
+    if (!id || !launchUrl) return undefined;
+
+    return {
+      id,
+      launchUrl,
+      displayName: raw.displayName ?? raw.display_name ?? 'Open WebUI',
+      visibleState: raw.visibleState ?? raw.visible_state ?? 'available',
+      sessionId: raw.sessionId ?? raw.session_id,
     };
   }
 

package/src/transport/oasn/oasn-normalize.ts

@@ -3,8 +3,6 @@ import type {
   AgentStatusResult,
   CategoryNode,
   CategoryTree,
-  ClaimResult,
-  RegisterResult,
   SearchResult,
 } from '../types.js';
 import type {
@@ -12,8 +10,6 @@ import type {
   AgentStatusResponse,
   CategoryNodeResponse,
   CategoryTreeResponse,
-  ClaimAgentResponse,
-  RegisterAgentResponse,
   SearchResponse,
 } from './oasn-types.js';
 
@@ -96,28 +92,6 @@ export function normalizeAgentCard(resp: AgentCardResponse | unknown): AgentCard
   };
 }
 
-export function normalizeRegisterResult(resp: RegisterAgentResponse | unknown): RegisterResult {
-  const record = asRecord(resp);
-  return {
-    agent_id: pickString(record, 'agentId', 'agent_id'),
-    agent_type: (pickString(record, 'agentType', 'agent_type') || 'client') as 'client',
-    api_key: pickString(record, 'apiKey', 'api_key'),
-    claim_url: pickString(record, 'claimUrl', 'claim_url'),
-    status: (pickString(record, 'status') || 'unclaimed') as 'unclaimed',
-    agent_card: normalizeAgentCard(pickRecord(record, 'agentCard', 'agent_card')),
-  };
-}
-
-export function normalizeClaimResult(resp: ClaimAgentResponse | unknown): ClaimResult {
-  const record = asRecord(resp);
-  return {
-    agent_id: pickString(record, 'agentId', 'agent_id'),
-    status: (pickString(record, 'status') || 'claim_email_sent') as 'claim_email_sent',
-    owner_email_masked: pickString(record, 'ownerEmailMasked', 'owner_email_masked'),
-    expires_at: pickString(record, 'expiresAt', 'expires_at'),
-  };
-}
-
 export function normalizeAgentStatus(resp: AgentStatusResponse | unknown): AgentStatusResult {
   const record = asRecord(resp);
   return {

package/src/transport/oasn/oasn-register.ts

@@ -1,101 +1,28 @@
 /**
- * OASN Agent 注册与认领
+ * OASN Agent 状态查询
  *
  * 设计依据：
- *   - docs/specs/2026-06-16-oasn-api-module-mapping.md §2.1 / §2.2
+ *   - docs/specs/2026-06-16-oasn-api-module-mapping.md §2.3
  *
- * 调用时机：
- *   - registerAgent：插件首次安装、本地无 agent_id/api_key 时
- *   - claimAgent：用户主动触发认领（带 owner_email）
- *
- * 关键约束：
- *   - register 返回的 api_key **是明文且仅此一次**。调用方必须立即持久化（最好走 keychain，§11.6）
- *   - 当前后端 RegisterAgentCommand 只定义 platform；install_id/device_hint 需先扩展后端契约
+ * 注意：register 和 claim 已迁移到 CLI（openclaw-plugin-openagent-cli），
+ * 本模块仅保留 getStatus（GET /api/agents/{agent_id}）。
  */
 
 import { logger } from '../../util/logger.js';
-import type { AgentStatusResult, ClaimParams, ClaimResult, RegisterResult } from '../types.js';
+import type { AgentStatusResult } from '../types.js';
 import type { OasnHttpClient } from './oasn-http.js';
 import {
   OASN_ENDPOINTS,
-  type ClaimAgentRequest,
-  type ClaimAgentResponse,
   type AgentStatusResponse,
-  type RegisterAgentRequest,
-  type RegisterAgentResponse,
 } from './oasn-types.js';
-import {
-  normalizeAgentStatus,
-  normalizeClaimResult,
-  normalizeRegisterResult,
-} from './oasn-normalize.js';
+import { normalizeAgentStatus } from './oasn-normalize.js';
 
 /**
- * OASN Agent 注册模块。
- *
- * 注意 register 和 claim 是 OASN-only 能力，TIM transport 不暴露这两个方法。
- * AccountRuntime 在 transport-type === 'oasn' 时才能调用。
+ * OASN Agent 状态查询模块。
  */
-export class OasnRegister {
+export class OasnAgentStatus {
   constructor(private readonly _http: OasnHttpClient) {}
 
-  /**
-   * 注册新 Agent（首次安装流程）。
-   *
-   * @param platform OpenClaw 上固定为 "openclaw"
-   * @returns 含一次性明文 api_key 的注册响应。调用方必须立即持久化。
-   */
-  async register(
-    platform: string,
-    _params?: { installId?: string; deviceHint?: string },
-  ): Promise<RegisterResult> {
-    const body: RegisterAgentRequest = { platform };
-
-    logger.info(`[transport/oasn/register] register platform=${platform}`);
-
-    // skipRetry=true：register 是不幂等的写入，重试可能创建多个 agent
-    const resp = await this._http.post<RegisterAgentResponse>(
-      OASN_ENDPOINTS.REGISTER,
-      body,
-      { skipRetry: true },
-    );
-
-    const result = normalizeRegisterResult(resp);
-    logger.info(`[transport/oasn/register] registered agent_id=${result.agent_id} status=${result.status}`);
-    return result;
-  }
-
-  /**
-   * 触发认领邮件发送。
-   * 认证方式由 OasnHttpClient 注入的 Bearer 决定：
-   *   - 带 api_key：传入 { agent_id, owner_email }
-   *   - 不带 api_key（首次进入）：传入 { claim_token, owner_email }
-   */
-  async claim(params: ClaimParams): Promise<ClaimResult> {
-    if (!params.agent_id && !params.claim_token) {
-      throw new Error('OasnRegister.claim: must provide either agent_id or claim_token');
-    }
-    if (!params.owner_email) {
-      throw new Error('OasnRegister.claim: owner_email required');
-    }
-
-    const body: ClaimAgentRequest = {
-      ownerEmail: params.owner_email,
-    };
-    if (params.agent_id) body.agentId = params.agent_id;
-    if (params.claim_token) body.claimToken = params.claim_token;
-
-    logger.info(`[transport/oasn/register] claim email=${params.owner_email.replace(/(.).+(@.+)/, '$1***$2')}`);
-
-    const resp = await this._http.post<ClaimAgentResponse>(
-      OASN_ENDPOINTS.CLAIM,
-      body,
-      { skipRetry: true },
-    );
-
-    return normalizeClaimResult(resp);
-  }
-
   async getStatus(agentId: string): Promise<AgentStatusResult> {
     const resp = await this._http.get<AgentStatusResponse>(
       OASN_ENDPOINTS.AGENT_STATUS(agentId),

package/src/transport/oasn/oasn-transport.ts

@@ -7,7 +7,7 @@
  *
  * 子模块组装：
  *   - OasnHttpClient    HTTP 基础（Bearer 注入 / 重试 / 401 拦截）
- *   - OasnRegister      register / claim
+ *   - OasnAgentStatus    agent status query (GET /api/agents/{agent_id})
  *   - OasnAgentCard     get / update / getCurrentOwner
  *   - OasnDiscovery     search / categories
  *   - OasnInvocation    sendTask / waitForTaskResult（核心路径）
@@ -37,14 +37,11 @@ import {
   type AgentCardPatch,
   type AgentStatusResult,
   type CategoryTree,
-  type ClaimParams,
-  type ClaimResult,
   type CoreTransportEvent,
   type DownloadArtifactResult,
   type OasnTransport,
   type OwnerInfo,
   type ProgressCallback,
-  type RegisterResult,
   type SearchQuery,
   type SearchResult,
   type TaskHandle,
@@ -64,7 +61,7 @@ import {
   type CreateInvocationOptions,
   type PendingInvocationStore,
 } from './oasn-invocation.js';
-import { OasnRegister } from './oasn-register.js';
+import { OasnAgentStatus } from './oasn-register.js';
 
 // ───────────────────────────────────────────────────────────────
 // 构造选项
@@ -102,7 +99,7 @@ export class OasnTransportImpl extends EventEmitter implements OasnTransport {
   private _accessHttp: OasnHttpClient;
   private _agentCard: OasnAgentCard;
   private _discovery: OasnDiscovery;
-  private _register: OasnRegister;
+  private _agentStatus: OasnAgentStatus;
   private _invocation: OasnInvocation;
   private _files: OasnFiles;
 
@@ -131,7 +128,7 @@ export class OasnTransportImpl extends EventEmitter implements OasnTransport {
     // ── 子模块（共享 HTTP 实例） ──────────────────────────────────
     this._agentCard = new OasnAgentCard(this._http);
     this._discovery = new OasnDiscovery(this._http);
-    this._register = new OasnRegister(this._http);
+    this._agentStatus = new OasnAgentStatus(this._http);
     this._invocation = new OasnInvocation(this._accessHttp, options.pendingStore);
     this._files = new OasnFiles(this._accessHttp);
   }
@@ -165,7 +162,7 @@ export class OasnTransportImpl extends EventEmitter implements OasnTransport {
 
     if (this._agentId) {
       try {
-        const status = await this._register.getStatus(this._agentId);
+        const status = await this._agentStatus.getStatus(this._agentId);
         this._claimStatus = status.status;
         logger.info(
           `[transport/oasn] ready agent_id=${this._agentId} `
@@ -264,33 +261,13 @@ export class OasnTransportImpl extends EventEmitter implements OasnTransport {
   }
 
   // ═══════════════════════════════════════════════════════════════
-  // RegistrationTransport（OASN-only）
+  // AgentCard / Status（OASN-only）
   // ═══════════════════════════════════════════════════════════════
-
-  /**
-   * 注册新 Agent。
-   *
-   * 注意：register 不要求 ready() —— 首次安装时还没有 api_key。
-   * 但 register 成功后，调用方需立即把 api_key 持久化 + 调 ready() 进入可工作状态。
-   */
-  async registerAgent(
-    platform: string,
-    params?: { installId?: string; deviceHint?: string },
-  ): Promise<RegisterResult> {
-    const result = await this._register.register(platform, params);
-    // 回填 agentId（后续 ready() 探活会用到）
-    this._agentId = result.agent_id;
-    return result;
-  }
-
-  async claimAgent(params: ClaimParams): Promise<ClaimResult> {
-    const result = await this._register.claim(params);
-    this._claimStatus = 'claim_pending';
-    return result;
-  }
+  //
+  // registerAgent / claimAgent 已迁移到 CLI，此处仅保留状态查询。
 
   async getAgentStatus(agentId: string): Promise<AgentStatusResult> {
-    const result = await this._register.getStatus(agentId);
+    const result = await this._agentStatus.getStatus(agentId);
     this._claimStatus = result.status;
     return result;
   }

package/src/transport/oasn/oasn-types.ts

@@ -258,6 +258,40 @@ export interface ArtifactResponse {
   content_url?: string;
 }
 
+/**
+ * OASN WebUI continuation —— 标准 run 完成后，声明了 webui 能力的 ServiceAgent
+ * 会在用户视图里暴露一个可继续打开 WebUI 的入口。
+ *
+ * 后端同时兼容 camelCase / snake_case，插件两侧都需要做 fallback 归一。
+ * launch_url 通常是相对路径（如 /webui/continuations/{continuation_id}），
+ * 由上层按 OASN Access base URL 解析为绝对地址。
+ */
+export interface WebuiContinuationResponse {
+  continuationId?: string;
+  continuation_id?: string;
+  type?: string;
+  displayName?: string;
+  display_name?: string;
+  visibleState?: string;
+  visible_state?: string;
+  sessionId?: string;
+  session_id?: string;
+  launchUrl?: string;
+  launch_url?: string;
+}
+
+/**
+ * 用户视图结果 —— 后端在 sanitizeInvocationView() 后追加的结构。
+ * 除已声明字段外，保留 index signature 以容纳后续新增字段。
+ */
+export interface VisibleResultResponse {
+  inlineResultSummary?: string;
+  inline_result_summary?: string;
+  webuiContinuation?: WebuiContinuationResponse;
+  webui_continuation?: WebuiContinuationResponse;
+  [key: string]: unknown;
+}
+
 export interface GetInvocationResponse {
   invocationId?: string;
   invocation_id?: string;
@@ -273,6 +307,10 @@ export interface GetInvocationResponse {
     summary: string;
     [key: string]: unknown;
   };
+  /** 用户视图 —— 含 inline_result_summary 与 webui_continuation（camelCase） */
+  visibleResult?: VisibleResultResponse;
+  /** 用户视图 —— 含 inline_result_summary 与 webui_continuation（snake_case） */
+  visible_result?: VisibleResultResponse;
   artifacts?: ArtifactResponse[];
   /** 终态时为 null */
   nextPollAfterMs?: number | null;
@@ -291,13 +329,22 @@ export interface GetInvocationResponse {
 // ═══════════════════════════════════════════════════════════════
 
 export interface UploadFileResponse {
-  file_ref: string;
-  display_name: string;
-  mime_type: string;
-  size_bytes: number;
+  // snake_case (旧，向后兼容)
+  file_ref?: string;
+  display_name?: string;
+  mime_type?: string;
+  size_bytes?: number;
   /** ISO 8601 字符串 */
-  expires_at: string;
-  created_at: string;
+  expires_at?: string;
+  created_at?: string;
+  // camelCase (access 层实际返回，见 access-upload-download-api.md §2.2)
+  fileRef?: string;
+  displayName?: string;
+  mimeType?: string;
+  sizeBytes?: number;
+  /** ISO 8601 字符串 */
+  expiresAt?: string | null;
+  createdAt?: string;
 }
 
 // Artifact 下载返回二进制，没有 JSON 结构 —— 详见 oasn-files.ts