openclaw-openagent 1.0.1 → 1.0.3

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

@@ -0,0 +1,114 @@
+/**
+ * OasnTransport —— 装配 OASN 子模块为统一的 AgentTransport
+ *
+ * 设计依据：
+ *   - docs/specs/2026-06-16-oasn-transport-abstraction-design.md §2.4
+ *   - docs/specs/2026-06-16-oasn-api-module-mapping.md §3.1
+ *
+ * 子模块组装：
+ *   - OasnHttpClient    HTTP 基础（Bearer 注入 / 重试 / 401 拦截）
+ *   - OasnAgentStatus    agent status query (GET /api/agents/{agent_id})
+ *   - OasnAgentCard     get / update / getCurrentOwner
+ *   - OasnDiscovery     search / categories
+ *   - OasnInvocation    sendTask / waitForTaskResult（核心路径）
+ *   - OasnFiles         upload / download + LRU
+ *
+ * 与 CoreTransport 契约的映射：
+ *   - id           = options.accountId
+ *   - transportType= 'oasn'
+ *   - ready()      = 用 credentials.token 设置 Bearer，调 GET /api/agent-cards/{agent_id} 探活
+ *                    （404 也算成功 —— 未认领的 agent 仍能用 api_key，只是公开查询返 404）
+ *   - dispose()    = 释放 HTTP（无长连接）+ 清空 token
+ *   - isReady      = ready() 成功且 token 非空
+ *   - 'credential_expired' 事件 = §11.5 401 撤销路径
+ *
+ * 与 TimTransport 的差异：
+ *   - 不持有 WebSocket / 长连接 → dispose 几乎是 no-op
+ *   - 不实现 IMChannelTransport（onTaskReceived / sendGroupMessage 等）
+ *   - register/claim/updateAgentCard/uploadFile/downloadArtifact 是 OASN-only 能力
+ */
+import { EventEmitter } from 'node:events';
+import { type AgentCard, type AgentCardPatch, type AgentStatusResult, type CategoryTree, type CoreTransportEvent, type DownloadArtifactResult, type OasnTransport, type OwnerInfo, type ProgressCallback, type SearchQuery, type SearchResult, type TaskHandle, type TaskRequest, type TaskResult, type TransportCredentials, type UploadFileParams, type UploadFileResult } from '../types.js';
+import { type PendingInvocationStore } from './oasn-invocation.js';
+export interface OasnTransportInitOptions {
+    /** 实例 id（多账户场景区分用） */
+    accountId: string;
+    /** OASN API base URL，例 `https://api.oasn.ai` */
+    apiBase: string;
+    /** Optional Access-layer API base URL for invocation/file/artifact endpoints. */
+    accessApiBase?: string;
+    /**
+     * 当前 agent_id（用于 ready() 探活 + register 后回填）。
+     * 可在 ready() 之前为空（未注册场景），但 sendTask 之类操作会失败。
+     */
+    agentId?: string;
+    /** §11.1 持久化钩子（接 StateStore.pending_invocations）；可选 */
+    pendingStore?: PendingInvocationStore;
+    /** 单次 HTTP 超时（默认 30s） */
+    defaultTimeoutMs?: number;
+    /** retryable 错误自动重试次数（默认 3） */
+    maxRetries?: number;
+}
+export declare class OasnTransportImpl extends EventEmitter implements OasnTransport {
+    readonly transportType: "oasn";
+    readonly id: string;
+    private _http;
+    private _accessHttp;
+    private _agentCard;
+    private _discovery;
+    private _agentStatus;
+    private _invocation;
+    private _files;
+    private _agentId;
+    private _isReady;
+    private _claimStatus;
+    constructor(options: OasnTransportInitOptions);
+    /**
+     * 校验 api_key 有效性 + 进入可工作状态。
+     *
+     * 验证策略：
+     *   1. 设置 Bearer = credentials.token
+     *   2. 若 agentId 已知 → 调 GET /api/agent-cards/{agent_id}
+     *      - status 接口返回 claimed 才允许后续 Invocation
+     *      - 401 → onCredentialRevoked 回调，抛 TransportError
+     *
+     * 注：credentials.identity 在 OASN 场景下应等于 agent_id。
+     */
+    ready(credentials: TransportCredentials): Promise<void>;
+    dispose(): Promise<void>;
+    get isReady(): boolean;
+    on(event: CoreTransportEvent, handler: (...args: any[]) => void): this;
+    off(event: CoreTransportEvent, handler: (...args: any[]) => void): this;
+    /**
+     * 发起远程 Agent 调用 → POST /api/invocations。
+     *
+     * §11.1：若 task.requestId 视作 toolCallId 传入，OasnInvocation 会去 pendingStore
+     * 查同名记录，命中则复用 idempotency_key，避免重复创建 Invocation。
+     */
+    sendTask(targetAgentId: string, task: TaskRequest): Promise<TaskHandle>;
+    /** 等待结果（轮询 / 未来可升级到 SSE） */
+    waitForTaskResult(handle: TaskHandle, options: {
+        timeoutMs: number;
+        signal?: AbortSignal;
+        onProgress?: ProgressCallback;
+    }): Promise<TaskResult>;
+    searchAgents(query: SearchQuery): Promise<SearchResult>;
+    getAgent(agentId: string): Promise<AgentCard | null>;
+    getCategories(params?: {
+        agentType?: string;
+    }): Promise<CategoryTree>;
+    getAgentStatus(agentId: string): Promise<AgentStatusResult>;
+    updateAgentCard(agentId: string, patch: AgentCardPatch): Promise<AgentCard>;
+    getCurrentOwner(): Promise<OwnerInfo | null>;
+    uploadFile(file: UploadFileParams): Promise<UploadFileResult>;
+    downloadArtifact(artifactId: string): Promise<DownloadArtifactResult>;
+    /**
+     * HTTP 层捕获 401 时调用：
+     *   1. 清掉本地 Bearer
+     *   2. 标记 not ready
+     *   3. 发 'credential_expired' 事件，AccountRuntime 接收后清凭证 + 引导 register
+     *
+     * 注意：不直接清 OpenClaw config —— config 持久层的清理由 AccountRuntime 决定。
+     */
+    private _onCredentialRevoked;
+}

package/dist/src/transport/oasn/oasn-transport.js

@@ -0,0 +1,230 @@
+/**
+ * OasnTransport —— 装配 OASN 子模块为统一的 AgentTransport
+ *
+ * 设计依据：
+ *   - docs/specs/2026-06-16-oasn-transport-abstraction-design.md §2.4
+ *   - docs/specs/2026-06-16-oasn-api-module-mapping.md §3.1
+ *
+ * 子模块组装：
+ *   - OasnHttpClient    HTTP 基础（Bearer 注入 / 重试 / 401 拦截）
+ *   - OasnAgentStatus    agent status query (GET /api/agents/{agent_id})
+ *   - OasnAgentCard     get / update / getCurrentOwner
+ *   - OasnDiscovery     search / categories
+ *   - OasnInvocation    sendTask / waitForTaskResult（核心路径）
+ *   - OasnFiles         upload / download + LRU
+ *
+ * 与 CoreTransport 契约的映射：
+ *   - id           = options.accountId
+ *   - transportType= 'oasn'
+ *   - ready()      = 用 credentials.token 设置 Bearer，调 GET /api/agent-cards/{agent_id} 探活
+ *                    （404 也算成功 —— 未认领的 agent 仍能用 api_key，只是公开查询返 404）
+ *   - dispose()    = 释放 HTTP（无长连接）+ 清空 token
+ *   - isReady      = ready() 成功且 token 非空
+ *   - 'credential_expired' 事件 = §11.5 401 撤销路径
+ *
+ * 与 TimTransport 的差异：
+ *   - 不持有 WebSocket / 长连接 → dispose 几乎是 no-op
+ *   - 不实现 IMChannelTransport（onTaskReceived / sendGroupMessage 等）
+ *   - register/claim/updateAgentCard/uploadFile/downloadArtifact 是 OASN-only 能力
+ */
+import { EventEmitter } from 'node:events';
+import { logger } from '../../util/logger.js';
+import { makeTransportError, } from '../types.js';
+import { OasnAgentCard } from './oasn-agent-card.js';
+import { OasnDiscovery } from './oasn-discovery.js';
+import { OasnFiles } from './oasn-files.js';
+import { OasnHttpClient } from './oasn-http.js';
+import { OasnInvocation, } from './oasn-invocation.js';
+import { OasnAgentStatus } from './oasn-register.js';
+// ───────────────────────────────────────────────────────────────
+// 实现类
+// ───────────────────────────────────────────────────────────────
+export class OasnTransportImpl extends EventEmitter {
+    transportType = 'oasn';
+    id;
+    _http;
+    _accessHttp;
+    _agentCard;
+    _discovery;
+    _agentStatus;
+    _invocation;
+    _files;
+    _agentId;
+    _isReady = false;
+    _claimStatus = 'unknown';
+    constructor(options) {
+        super();
+        this.id = options.accountId;
+        this._agentId = options.agentId;
+        // ── HTTP 层（含 401 撤销回调） ────────────────────────────────
+        const httpConfig = {
+            apiBase: options.apiBase,
+            defaultTimeoutMs: options.defaultTimeoutMs,
+            maxRetries: options.maxRetries,
+            onCredentialRevoked: () => this._onCredentialRevoked(),
+        };
+        this._http = new OasnHttpClient(httpConfig);
+        this._accessHttp = new OasnHttpClient({
+            ...httpConfig,
+            apiBase: options.accessApiBase || options.apiBase,
+        });
+        // ── 子模块（共享 HTTP 实例） ──────────────────────────────────
+        this._agentCard = new OasnAgentCard(this._http);
+        this._discovery = new OasnDiscovery(this._http);
+        this._agentStatus = new OasnAgentStatus(this._http);
+        this._invocation = new OasnInvocation(this._accessHttp, options.pendingStore);
+        this._files = new OasnFiles(this._accessHttp);
+    }
+    // ═══════════════════════════════════════════════════════════════
+    // CoreTransport
+    // ═══════════════════════════════════════════════════════════════
+    /**
+     * 校验 api_key 有效性 + 进入可工作状态。
+     *
+     * 验证策略：
+     *   1. 设置 Bearer = credentials.token
+     *   2. 若 agentId 已知 → 调 GET /api/agent-cards/{agent_id}
+     *      - status 接口返回 claimed 才允许后续 Invocation
+     *      - 401 → onCredentialRevoked 回调，抛 TransportError
+     *
+     * 注：credentials.identity 在 OASN 场景下应等于 agent_id。
+     */
+    async ready(credentials) {
+        if (!credentials.token) {
+            throw makeTransportError('MISSING_CREDENTIAL', 'OASN ready: token (api_key) is required');
+        }
+        this._http.setToken(credentials.token);
+        this._accessHttp.setToken(credentials.token);
+        // 若构造时未传 agentId，则从 credentials.identity 读取
+        if (!this._agentId && credentials.identity) {
+            this._agentId = credentials.identity;
+        }
+        if (this._agentId) {
+            try {
+                const status = await this._agentStatus.getStatus(this._agentId);
+                this._claimStatus = status.status;
+                logger.info(`[transport/oasn] ready agent_id=${this._agentId} `
+                    + `claim_status=${status.status}`);
+            }
+            catch (err) {
+                const te = err;
+                // 401 已经在 HTTP 层触发了 onCredentialRevoked，再次显式抛
+                if (te.code === 'HTTP_401' || te.code === 'UNAUTHENTICATED') {
+                    this._isReady = false;
+                    throw te;
+                }
+                // 其他错误（网络/服务端 5xx 等）：不阻止 ready，但保持 unknown，sendTask 会阻断
+                logger.warn(`[transport/oasn] ready probe failed code=${te.code} msg=${te.message}, continuing anyway`);
+            }
+        }
+        else {
+            logger.info('[transport/oasn] ready called without agent_id; skipping probe (register flow expected)');
+        }
+        this._isReady = true;
+    }
+    async dispose() {
+        // OASN 无长连接 —— 清 token 即可
+        this._http.setToken(undefined);
+        this._accessHttp.setToken(undefined);
+        this._isReady = false;
+        logger.info(`[transport/oasn] disposed account=${this.id}`);
+    }
+    get isReady() {
+        return this._isReady;
+    }
+    // EventEmitter 已经实现 on/off，此处仅做类型对齐（接口签名要求）
+    on(event, handler) {
+        return super.on(event, handler);
+    }
+    off(event, handler) {
+        return super.off(event, handler);
+    }
+    // ═══════════════════════════════════════════════════════════════
+    // TaskTransport（T2 核心路径）
+    // ═══════════════════════════════════════════════════════════════
+    /**
+     * 发起远程 Agent 调用 → POST /api/invocations。
+     *
+     * §11.1：若 task.requestId 视作 toolCallId 传入，OasnInvocation 会去 pendingStore
+     * 查同名记录，命中则复用 idempotency_key，避免重复创建 Invocation。
+     */
+    async sendTask(targetAgentId, task) {
+        if (!this._isReady) {
+            throw makeTransportError('NOT_READY', 'OASN transport not ready; call ready() first');
+        }
+        if (this._claimStatus !== 'claimed') {
+            throw makeTransportError('REGISTRATION_NOT_ACTIVATED', 'OASN ClientAgent must be claimed before creating invocations', { retryable: false });
+        }
+        // 把 task.requestId 映射为 toolCallId（若存在）
+        const opts = {};
+        if (task.requestId)
+            opts.toolCallId = task.requestId;
+        if (task.timeoutMs !== undefined)
+            opts.timeoutMs = task.timeoutMs;
+        return this._invocation.sendTask(targetAgentId, task, opts);
+    }
+    /** 等待结果（轮询 / 未来可升级到 SSE） */
+    waitForTaskResult(handle, options) {
+        return this._invocation.waitForTaskResult(handle, options);
+    }
+    // ═══════════════════════════════════════════════════════════════
+    // DiscoveryTransport
+    // ═══════════════════════════════════════════════════════════════
+    searchAgents(query) {
+        return this._discovery.search(query);
+    }
+    getAgent(agentId) {
+        return this._agentCard.get(agentId);
+    }
+    getCategories(params) {
+        return this._discovery.getCategories(params);
+    }
+    // ═══════════════════════════════════════════════════════════════
+    // AgentCard / Status（OASN-only）
+    // ═══════════════════════════════════════════════════════════════
+    //
+    // registerAgent / claimAgent 已迁移到 CLI，此处仅保留状态查询。
+    async getAgentStatus(agentId) {
+        const result = await this._agentStatus.getStatus(agentId);
+        this._claimStatus = result.status;
+        return result;
+    }
+    updateAgentCard(agentId, patch) {
+        return this._agentCard.update(agentId, patch);
+    }
+    getCurrentOwner() {
+        return this._agentCard.getCurrentOwner();
+    }
+    // ═══════════════════════════════════════════════════════════════
+    // FileTransport（OASN-only）
+    // ═══════════════════════════════════════════════════════════════
+    uploadFile(file) {
+        // 默认走 LRU 路径，避免重复上传同一份内容
+        return this._files.ensureFileRef(file);
+    }
+    downloadArtifact(artifactId) {
+        return this._files.downloadArtifact(artifactId);
+    }
+    // ═══════════════════════════════════════════════════════════════
+    // §11.5 401 撤销恢复路径
+    // ═══════════════════════════════════════════════════════════════
+    /**
+     * HTTP 层捕获 401 时调用：
+     *   1. 清掉本地 Bearer
+     *   2. 标记 not ready
+     *   3. 发 'credential_expired' 事件，AccountRuntime 接收后清凭证 + 引导 register
+     *
+     * 注意：不直接清 OpenClaw config —— config 持久层的清理由 AccountRuntime 决定。
+     */
+    _onCredentialRevoked() {
+        if (!this._isReady)
+            return; // 防止 ready 探活阶段重复触发
+        logger.error('[transport/oasn] api_key revoked (401 UNAUTHENTICATED) - emitting credential_expired');
+        this._http.setToken(undefined);
+        this._isReady = false;
+        this.emit('credential_expired', {
+            transportType: 'oasn',
+            accountId: this.id,
+        });
+    }
+}

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

@@ -0,0 +1,331 @@
+/**
+ * OASN API 请求/响应类型定义
+ *
+ * 设计依据：
+ *   - docs/specs/2026-06-16-oasn-api-module-mapping.md
+ *   - oasn-01-onboarding/apis.md（agent / claim / auth / agent-card / discovery）
+ *   - oasn-02-access-layer/apis.md（invocation / file / artifact）
+ *
+ * 这些类型仅在 OASN transport 内部使用，对外暴露的通用类型在 src/transport/types.ts。
+ * onboarding controller 的 Java record 当前使用 camelCase 请求/响应字段；
+ * transport 层兼容历史 snake_case 响应，并对外归一到 src/transport/types.ts 的稳定模型。
+ */
+/**
+ * OASN 统一错误响应格式（所有 4xx/5xx 接口返回此结构）。
+ * 详见 api-module-mapping.md §五 通用错误处理。
+ */
+export interface OasnErrorBody {
+    error: {
+        /** 错误码：UNAUTHENTICATED / FORBIDDEN / TARGET_UNAVAILABLE / ... */
+        code: string;
+        /** 人类可读消息 */
+        message: string;
+        /** 客户端是否可重试（服务端裁决） */
+        retryable: boolean;
+        /** 附加上下文（端点定义具体字段） */
+        details?: Record<string, unknown>;
+        /** 排障追踪 id */
+        request_id?: string;
+    };
+}
+export interface RegisterAgentRequest {
+    /** 当前固定为 "openclaw"（也可能是 "codex" / "claude_code" / "hermes"） */
+    platform: string;
+}
+export interface RegisterAgentResponse {
+    agentId?: string;
+    agent_id?: string;
+    agentType?: 'client';
+    agent_type?: 'client';
+    /** 一次性明文 api_key，仅此响应返回；服务端只存 hash */
+    apiKey?: string;
+    api_key?: string;
+    claimUrl?: string;
+    claim_url?: string;
+    status: 'unclaimed';
+    agentCard?: AgentCardResponse;
+    agent_card?: AgentCardResponse;
+}
+export interface AgentStatusResponse {
+    agentId?: string;
+    agent_id?: string;
+    status: 'unclaimed' | 'claim_pending' | 'claimed';
+    access_token?: string;
+    accessToken?: string;
+}
+export interface AgentCardResponse {
+    agentId?: string;
+    agent_id?: string;
+    agentType?: 'client' | 'service';
+    agent_type?: 'client' | 'service';
+    agentStatus?: string;
+    agent_status?: string;
+    claimStatus?: string;
+    claim_status?: string;
+    name: string;
+    description: string | null;
+    MOM: string | null;
+    tags: Array<{
+        tagId?: string;
+        tag_id?: string;
+        name: string;
+    }>;
+    category: string[];
+    avatarRef?: string | null;
+    avatar_ref?: string | null;
+    avatarUrl?: string | null;
+    avatar_url?: string | null;
+    visibility?: 'public' | 'private';
+    publicMetadata?: Record<string, unknown> | null;
+    public_metadata?: Record<string, unknown> | null;
+    updatedAt?: string;
+    updated_at?: string;
+}
+export interface ClaimAgentRequest {
+    agentId?: string;
+    claimToken?: string;
+    ownerEmail: string;
+}
+export interface ClaimAgentResponse {
+    agentId?: string;
+    agent_id?: string;
+    status: 'claim_email_sent';
+    ownerEmailMasked?: string;
+    owner_email_masked?: string;
+    expiresAt?: string;
+    expires_at?: string;
+}
+export interface UpdateAgentCardRequest {
+    name?: string | null;
+    description?: string | null;
+    MOM?: string | null;
+    tags?: string[] | null;
+    category?: string[] | null;
+    avatarRef?: string | null;
+    visibility?: 'public' | 'private';
+    publicMetadata?: Record<string, unknown> | null;
+}
+export interface CategoryNodeResponse {
+    categoryId?: string;
+    category_id?: string;
+    name: string;
+    children?: CategoryNodeResponse[];
+}
+export interface CategoryTreeResponse {
+    categories: CategoryNodeResponse[];
+    updatedAt?: string;
+    updated_at?: string;
+}
+/** 三种搜索端点的请求结构 */
+export interface SearchByQueryRequest {
+    query: string;
+    agentTypes?: string[];
+    sort?: string[];
+    pageSize?: number;
+    pageNum?: number;
+}
+export interface SearchByCategoryRequest {
+    category: string[];
+    agentTypes?: string[];
+    sort?: string[];
+    pageSize?: number;
+    pageNum?: number;
+}
+export interface SearchByTagsRequest {
+    tags: string[];
+    agentTypes?: string[];
+    sort?: string[];
+    pageSize?: number;
+    pageNum?: number;
+}
+export interface SearchResponse {
+    searchId?: string;
+    search_id?: string;
+    agentCards?: AgentCardResponse[];
+    agent_cards?: AgentCardResponse[];
+    pageNum?: number;
+    page_num?: number;
+    pageSize?: number;
+    page_size?: number;
+    hasNext?: boolean;
+    has_next?: boolean;
+}
+export interface CreateInvocationRequest {
+    /** 客户端生成的幂等 key（详见 §11.1） */
+    idempotency_key: string;
+    service_agent_id: string;
+    /** 显式输入意图，至少包含 task 字段 */
+    input: {
+        task: string;
+    } & Record<string, unknown>;
+    session_id?: string;
+    input_file_refs?: string[];
+    input_artifact_refs?: string[];
+    /** 期望超时（服务端裁决最终 effective_timeout_ms） */
+    timeout_ms?: number;
+    /** 客户端分组标识（可选） */
+    client_request_group_id?: string;
+}
+export interface CreateInvocationResponse {
+    invocationId?: string;
+    invocation_id?: string;
+    sessionId?: string;
+    session_id?: string;
+    status: 'accepted' | 'queued';
+    serviceAgentId?: string;
+    service_agent_id?: string;
+    effectiveTimeoutMs?: number;
+    effective_timeout_ms?: number;
+    nextPollAfterMs?: number;
+    next_poll_after_ms?: number;
+    /** 是否幂等重放（同一 idempotency_key 多次请求返回 true） */
+    idempotentReplay?: boolean;
+    idempotent_replay?: boolean;
+    createdAt?: string;
+    created_at?: string;
+}
+/** Invocation 状态枚举 */
+export type InvocationStatus = 'accepted' | 'queued' | 'running' | 'succeeded' | 'failed' | 'timed_out' | 'cancelled';
+/** 是否进入终态（停止轮询） */
+export declare function isInvocationTerminal(status: InvocationStatus): boolean;
+export interface InvocationProgress {
+    lifecycleState?: string;
+    lifecycle_state?: string;
+    activityCategory?: string;
+    activity_category?: string;
+    progressPercent?: number;
+    progress_percent?: number;
+    elapsedMs?: number;
+    elapsed_ms?: number;
+    /** 可对外展示的安全状态描述（已脱敏） */
+    safeStatusMessage?: string;
+    safe_status_message?: string;
+}
+export interface ArtifactResponse {
+    artifactId?: string;
+    artifact_id?: string;
+    displayName?: string;
+    display_name?: string;
+    mimeType?: string;
+    mime_type?: string;
+    sizeBytes?: number;
+    size_bytes?: number;
+    contentAvailable?: boolean;
+    content_available?: boolean;
+    contentUrl?: string;
+    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;
+    sessionId?: string;
+    session_id?: string;
+    status: InvocationStatus;
+    progress?: InvocationProgress;
+    inlineResult?: {
+        summary: string;
+        [key: string]: unknown;
+    };
+    inline_result?: {
+        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;
+    next_poll_after_ms?: number | null;
+    warnings?: string[];
+    userError?: {
+        code: string;
+        message: string;
+    };
+    user_error?: {
+        code: string;
+        message: string;
+    };
+    createdAt?: string;
+    created_at?: string;
+    updatedAt?: string;
+    updated_at?: string;
+}
+export interface UploadFileResponse {
+    file_ref?: string;
+    display_name?: string;
+    mime_type?: string;
+    size_bytes?: number;
+    /** ISO 8601 字符串 */
+    expires_at?: string;
+    created_at?: string;
+    fileRef?: string;
+    displayName?: string;
+    mimeType?: string;
+    sizeBytes?: number;
+    /** ISO 8601 字符串 */
+    expiresAt?: string | null;
+    createdAt?: string;
+}
+export interface OwnerInfoResponse {
+    ownerId?: string;
+    owner_id?: string;
+    ownerType?: string;
+    owner_type?: string;
+    displayName?: string;
+    display_name?: string;
+    emailMasked?: string;
+    email_masked?: string;
+    emailVerifiedAt?: string;
+    email_verified_at?: string;
+    status: string;
+}
+/** OASN HTTP 端点路径（相对于 api_base） */
+export declare const OASN_ENDPOINTS: {
+    readonly REGISTER: "/api/agents/register";
+    readonly CLAIM: "/api/agents/claim";
+    readonly AGENT_STATUS: (agentId: string) => string;
+    readonly AGENT_CARD: (agentId: string) => string;
+    readonly CATEGORIES: "/api/agent-card-categories";
+    readonly SEARCH_BY_QUERY: "/api/agent-cards/search/by-query";
+    readonly SEARCH_BY_CATEGORY: "/api/agent-cards/search/by-category";
+    readonly SEARCH_BY_TAGS: "/api/agent-cards/search/by-tags";
+    readonly INVOCATIONS: "/api/invocations";
+    readonly INVOCATION: (id: string) => string;
+    readonly FILES: "/api/files";
+    readonly ARTIFACT_CONTENT: (id: string) => string;
+    readonly USERS_ME: "/api/users/me";
+};