openclaw-openagent 1.0.1 → 1.0.3

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

package/src/transport/types.ts

@@ -105,18 +105,45 @@ export interface ArtifactRef {
   contentUrl: string;
 }
 
+/**
+ * WebUI continuation 引用 —— 远程 ServiceAgent 在标准 run 完成后暴露的 WebUI 入口。
+ *
+ * 不是 Artifact（不是可下载的二进制产物），也不是文件；只是一段可被用户点击打开
+ * 继续与 WebUI 交互的入口。launchUrl 可能是相对路径，由上层按 access base URL 解析。
+ *
+ * 仅 OASN 路径会填充此结构；TIM 路径不会出现。
+ */
+export interface WebuiContinuationRef {
+  /** continuation_id（如 wcont_xxx） */
+  id: string;
+  /** 按钮/链接展示文案（后端默认 "Open WebUI"） */
+  displayName: string;
+  /** 可见状态（available / pending / expired ...） */
+  visibleState: string;
+  /**
+   * WebUI shell 入口地址。
+   *   - 通常是相对路径：/webui/continuations/{continuation_id}
+   *   - 需要 Owner 登录态，直接打开无 token 会得到 WEBUI_AUTH_REQUIRED
+   */
+  launchUrl: string;
+  /** 关联 session（可用于续传） */
+  sessionId?: string;
+}
+
 /** 任务结果 */
 export interface TaskResult {
   requestId: string;
   status: 'complete' | 'error';
   /**
    * 文本结果。
-   *   - OASN: inline_result.summary
+   *   - OASN: inline_result.summary（fallback: visible_result.inline_result_summary）
    *   - TIM:  C2C `openagent_task_result.content`
    */
   content: string;
   /** 产物列表。可能为空 */
   artifacts?: ArtifactRef[];
+  /** WebUI 继续入口。仅 OASN 路径在声明了 webui 能力的 ServiceAgent 完成后返回 */
+  webuiContinuation?: WebuiContinuationRef;
 }
 
 /**
@@ -227,35 +254,11 @@ export interface SearchResult {
 }
 
 // ═══════════════════════════════════════════════════════════════
-// 注册 / 认领 / Owner（OASN-only）
+// Agent 状态 / Owner（OASN-only）
 // ═══════════════════════════════════════════════════════════════
-
-/** `POST /api/agents/register` 响应 */
-export interface RegisterResult {
-  agent_id: string;
-  agent_type: 'client';
-  /** 一次性明文 api_key —— 持久化后必须立即从内存清理 */
-  api_key: string;
-  claim_url: string;
-  status: 'unclaimed';
-  agent_card: AgentCard;
-}
-
-/** `POST /api/agents/claim` 请求 */
-export interface ClaimParams {
-  agent_id?: string;
-  /** 来自 claim_url 末段（与 agent_id+api_key 二选一） */
-  claim_token?: string;
-  owner_email: string;
-}
-
-export interface ClaimResult {
-  agent_id: string;
-  status: 'claim_email_sent';
-  owner_email_masked: string;
-  /** 邮件验证链接过期时间（ISO 8601 字符串） */
-  expires_at: string;
-}
+//
+// register / claim 已迁移到 CLI，插件侧仅保留状态查询。RegisterResult、
+// ClaimParams、ClaimResult 类型已移除。
 
 /** `GET /api/agents/{agent_id}` 响应 */
 export interface AgentStatusResult {
@@ -449,14 +452,8 @@ export interface DiscoveryTransport {
   getCategories?(params?: { agentType?: string }): Promise<CategoryTree>;
 }
 
-/** Agent 注册与管理 —— OASN-only */
+/** Agent 状态与管理 —— OASN-only。register/claim 已迁移到 CLI */
 export interface RegistrationTransport {
-  /** `POST /api/agents/register`。install_id 由 §11.7 防孤儿机制提供 */
-  registerAgent(
-    platform: string,
-    params?: { installId?: string; deviceHint?: string },
-  ): Promise<RegisterResult>;
-  claimAgent(params: ClaimParams): Promise<ClaimResult>;
   getAgentStatus(agentId: string): Promise<AgentStatusResult>;
   updateAgentCard(agentId: string, patch: AgentCardPatch): Promise<AgentCard>;
   getCurrentOwner?(): Promise<OwnerInfo | null>;

package/src/util/url-resolver.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared URL resolution helper.
+ *
+ * Resolves a possibly-relative URL against an optional base URL.
+ * Used by remote-agent-tool (WebUI continuation) and download-file-tool (artifact download).
+ */
+
+export function resolveOasnAccessUrl(accessApiBase: string | undefined, url: string): string {
+  if (!url) return url;
+  if (/^https?:\/\//i.test(url)) return url;
+  if (!accessApiBase) return url;
+  try {
+    return new URL(url, accessApiBase).toString();
+  } catch {
+    return url;
+  }
+}