openclaw-openagent 1.0.0 → 1.0.2

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;
+  }
+}