/**
 * RemoteAgent transport 协议。
 *
 * 关键点（中文）
 * - RemoteSession 只依赖这里定义的最小会话传输能力。
 * - HTTP / RPC transport 只负责协议适配，不持有 session 编排逻辑。
 */
import type { AgentCreateSessionInput, AgentListSessionsInput, AgentArchiveSessionInput, AgentArchiveSessionsInput, AgentArchiveSessionResult, AgentArchiveSessionsResult, AgentCleanArchiveResult, AgentSessionForkInput, AgentSessionInfo, AgentSessionSetOptions, AgentSessionStatus, AgentSessionSummaryPage, AgentSessionSystemSnapshot, RemoteSessionSetInput } from "../types/agent/SessionTypes.js";
import type { RemoteAgentPluginActionInput, RemoteAgentPluginActionResult } from "../types/agent/RemoteAgentPluginAction.js";
import type { SessionMutation } from "../types/session/SessionMutation.js";
import type { RespondSessionInteractionInput, SessionInteractionResult, SessionPendingInteraction } from "../types/session/SessionInteraction.js";
import type { AgentSessionPromptInput } from "../types/sdk/AgentSessionPrompt.js";
import type { AgentSessionStopResult } from "../types/sdk/AgentSessionStop.js";
import type { ListSessionMessagesInput, SessionMessagePage } from "../types/session/SessionMessage.js";
/**
 * Transport 持有的事件订阅句柄。
 */
export type TransportSubscription = {
    /** 关闭当前订阅。 */
    close(): Promise<void>;
};
/**
 * 单个远程 session 所需的 transport 能力。
 */
export type RemoteSessionTransport = {
    /** 读取 session 信息。 */
    get_info(session_id: string): Promise<AgentSessionInfo>;
    /** 发送 prompt。 */
    prompt(session_id: string, input: AgentSessionPromptInput): Promise<{
        id: string;
    }>;
    /** 停止当前 session turn，并取消未吸收队列。 */
    stop(session_id: string): Promise<AgentSessionStopResult>;
    /** 把一次显式历史压缩加入远程 Session 的有序输入队列。 */
    compact(session_id: string): Promise<{
        id: string;
    }>;
    /** 订阅 session 事件。 */
    subscribe(params: {
        session_id: string;
        on_ready: () => void;
        on_event: (mutation: SessionMutation) => void;
        /** 底层事件连接结束后的通知；主动关闭不触发。 */
        on_close: (error?: unknown) => void;
    }): Promise<TransportSubscription>;
    /** 读取 Session Message。 */
    messages(session_id: string, input?: ListSessionMessagesInput): Promise<SessionMessagePage>;
    /** 读取 system snapshot。 */
    system(session_id: string): Promise<AgentSessionSystemSnapshot>;
    /** 分叉 session。 */
    fork(session_id: string, input?: AgentSessionForkInput | string): Promise<AgentSessionInfo>;
    /** 列出指定 Session 正在等待用户响应的 Interaction。 */
    interactions(session_id: string): Promise<SessionPendingInteraction[]>;
    /** 读取指定 Session 的运行与安全状态。 */
    status(session_id: string): Promise<AgentSessionStatus>;
    /** 更新指定 Session 的可序列化动态配置。 */
    set(session_id: string, input: RemoteSessionSetInput, options?: AgentSessionSetOptions): Promise<void>;
    /** 提交指定 Session 的 Interaction 用户响应。 */
    respond(session_id: string, input: RespondSessionInteractionInput): Promise<SessionInteractionResult>;
};
/**
 * RemoteAgent 顶层 transport 能力。
 */
export type RemoteAgentTransport = RemoteSessionTransport & {
    /** 新建 session。 */
    create_session(input?: AgentCreateSessionInput): Promise<AgentSessionInfo>;
    /** 列出 sessions。 */
    list_sessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
    /** 归档 session。 */
    archive_session(input: AgentArchiveSessionInput): Promise<AgentArchiveSessionResult>;
    /** 列出已归档 sessions。 */
    archive_sessions(input?: AgentArchiveSessionsInput): Promise<AgentArchiveSessionsResult>;
    /** 清空归档 sessions。 */
    clean_archive(): Promise<AgentCleanArchiveResult>;
    /** 执行远程 Agent runtime 内的 plugin action。 */
    run_plugin_action(input: RemoteAgentPluginActionInput): Promise<RemoteAgentPluginActionResult>;
    /** 关闭 transport 持有的长期连接。 */
    close?(): Promise<void>;
};
//# sourceMappingURL=RemoteTransport.d.ts.map