@leaflow/sdk 0.200.2 → 0.202.0

package/dist/proto/leaflow/fleet/tool/v1/tool_pb.d.ts

@@ -0,0 +1,683 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Status } from "../../../../google/rpc/status_pb.js";
+import type { SignedAuthorization } from "../../control/v1/control_pb.js";
+import type { CapturedWindow } from "../../virtualdesktop/capture/v1/capture_pb.js";
+import type { Point, Rectangle, Size } from "../../virtualdesktop/display/v1/display_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file leaflow/fleet/tool/v1/tool.proto.
+ */
+export declare const file_leaflow_fleet_tool_v1_tool: GenFile;
+/**
+ * 工具的真实来源和原始名字，不是模型可能使用的别名。
+ *
+ * @generated from message leaflow.fleet.tool.v1.ToolRef
+ */
+export type ToolRef = Message<"leaflow.fleet.tool.v1.ToolRef"> & {
+    /**
+     * @generated from oneof leaflow.fleet.tool.v1.ToolRef.source
+     */
+    source: {
+        /**
+         * Agent 内置目录中的稳定名字，如 computer.get_desktop_state。
+         *
+         * @generated from field: string builtin = 1;
+         */
+        value: string;
+        case: "builtin";
+    } | {
+        /**
+         * 账号配置的 MCP server 及其 tools/list 原始工具名。
+         *
+         * @generated from field: leaflow.fleet.tool.v1.McpToolRef mcp = 2;
+         */
+        value: McpToolRef;
+        case: "mcp";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ToolRef.
+ * Use `create(ToolRefSchema)` to create a new message.
+ */
+export declare const ToolRefSchema: GenMessage<ToolRef>;
+/**
+ * MCP 的名字只选择本会话所属账号的 server，不能选择其他账号。
+ *
+ * @generated from message leaflow.fleet.tool.v1.McpToolRef
+ */
+export type McpToolRef = Message<"leaflow.fleet.tool.v1.McpToolRef"> & {
+    /**
+     * @generated from field: string server = 1;
+     */
+    server: string;
+    /**
+     * @generated from field: string name = 2;
+     */
+    name: string;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.McpToolRef.
+ * Use `create(McpToolRefSchema)` to create a new message.
+ */
+export declare const McpToolRefSchema: GenMessage<McpToolRef>;
+/**
+ * 工具的描述。外部来源的描述、schema 和 metadata 都是不可信内容，不授予权限。
+ *
+ * @generated from message leaflow.fleet.tool.v1.ToolDescriptor
+ */
+export type ToolDescriptor = Message<"leaflow.fleet.tool.v1.ToolDescriptor"> & {
+    /**
+     * @generated from field: leaflow.fleet.tool.v1.ToolRef tool = 1;
+     */
+    tool?: ToolRef | undefined;
+    /**
+     * 建议的展示名字。模型有自己的长度和字符限制时，客户端可建立别名，但调用时
+     * 必须还原完整 ToolRef，不能通过解析或截断名字猜来源。
+     *
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * @generated from field: string title = 3;
+     */
+    title: string;
+    /**
+     * @generated from field: string description = 4;
+     */
+    description: string;
+    /**
+     * JSON Schema object，使用 JSON 文本保留 schema 的值和扩展字段。
+     *
+     * @generated from field: string input_schema_json = 5;
+     */
+    inputSchemaJson: string;
+    /**
+     * 未声明输出 schema 时为空。
+     *
+     * @generated from field: string output_schema_json = 6;
+     */
+    outputSchemaJson: string;
+    /**
+     * 可选 JSON object，如外部工具的 annotations；仅供显示与提示，不作为授权。
+     *
+     * @generated from field: string metadata_json = 7;
+     */
+    metadataJson: string;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ToolDescriptor.
+ * Use `create(ToolDescriptorSchema)` to create a new message.
+ */
+export declare const ToolDescriptorSchema: GenMessage<ToolDescriptor>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.ListToolsRequest
+ */
+export type ListToolsRequest = Message<"leaflow.fleet.tool.v1.ListToolsRequest"> & {
+    /**
+     * @generated from field: string query = 1;
+     */
+    query: string;
+    /**
+     * @generated from field: leaflow.fleet.tool.v1.ToolSourceKind source = 2;
+     */
+    source: ToolSourceKind;
+    /**
+     * MCP 来源时可指定单个 server；空表示所有获准的 server。
+     *
+     * @generated from field: string mcp_server = 3;
+     */
+    mcpServer: string;
+    /**
+     * @generated from field: uint32 page_size = 4;
+     */
+    pageSize: number;
+    /**
+     * @generated from field: string page_token = 5;
+     */
+    pageToken: string;
+    /**
+     * Fleet 经会话 control 转发时必填且 Authorization.control_only 为 true；
+     * 不是由工具参数提供的身份。直连参与者从其通道取得非 control_only 授权，
+     * 不允许借工具请求把两种承载互相升级或伪装。
+     *
+     * @generated from field: leaflow.fleet.control.v1.SignedAuthorization authorization = 6;
+     */
+    authorization?: SignedAuthorization | undefined;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ListToolsRequest.
+ * Use `create(ListToolsRequestSchema)` to create a new message.
+ */
+export declare const ListToolsRequestSchema: GenMessage<ListToolsRequest>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.ListToolsResponse
+ */
+export type ListToolsResponse = Message<"leaflow.fleet.tool.v1.ListToolsResponse"> & {
+    /**
+     * @generated from field: repeated leaflow.fleet.tool.v1.ToolDescriptor tools = 1;
+     */
+    tools: ToolDescriptor[];
+    /**
+     * @generated from field: string next_page_token = 2;
+     */
+    nextPageToken: string;
+    /**
+     * @generated from field: repeated leaflow.fleet.tool.v1.UnavailableToolSource unavailable_sources = 3;
+     */
+    unavailableSources: UnavailableToolSource[];
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ListToolsResponse.
+ * Use `create(ListToolsResponseSchema)` to create a new message.
+ */
+export declare const ListToolsResponseSchema: GenMessage<ListToolsResponse>;
+/**
+ * 来源不可用，不包含该来源的凭据、工具参数或结果。
+ *
+ * @generated from message leaflow.fleet.tool.v1.UnavailableToolSource
+ */
+export type UnavailableToolSource = Message<"leaflow.fleet.tool.v1.UnavailableToolSource"> & {
+    /**
+     * @generated from field: leaflow.fleet.tool.v1.ToolSourceKind source = 1;
+     */
+    source: ToolSourceKind;
+    /**
+     * 内置来源时为空。
+     *
+     * @generated from field: string mcp_server = 2;
+     */
+    mcpServer: string;
+    /**
+     * @generated from field: google.rpc.Status status = 3;
+     */
+    status?: Status | undefined;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.UnavailableToolSource.
+ * Use `create(UnavailableToolSourceSchema)` to create a new message.
+ */
+export declare const UnavailableToolSourceSchema: GenMessage<UnavailableToolSource>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.CallToolRequest
+ */
+export type CallToolRequest = Message<"leaflow.fleet.tool.v1.CallToolRequest"> & {
+    /**
+     * @generated from field: leaflow.fleet.tool.v1.ToolRef tool = 1;
+     */
+    tool?: ToolRef | undefined;
+    /**
+     * @generated from field: string arguments_json = 2;
+     */
+    argumentsJson: string;
+    /**
+     * 同 ListToolsRequest.authorization，每次调用都检查当前有效授权。
+     *
+     * @generated from field: leaflow.fleet.control.v1.SignedAuthorization authorization = 3;
+     */
+    authorization?: SignedAuthorization | undefined;
+    /**
+     * 用于实时操作位置事件的关联，不是结果缓存或重放的幂等键。由 Fleet 选择的
+     * 1–64 个 ASCII 字母、数字或 -，调用方不得因此自动重试有副作用的动作。
+     *
+     * @generated from field: string operation_id = 4;
+     */
+    operationId: string;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.CallToolRequest.
+ * Use `create(CallToolRequestSchema)` to create a new message.
+ */
+export declare const CallToolRequestSchema: GenMessage<CallToolRequest>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.CallToolResponse
+ */
+export type CallToolResponse = Message<"leaflow.fleet.tool.v1.CallToolResponse"> & {
+    /**
+     * 保留顺序，同一结果可以同时含文字、图片和其他结构化内容。
+     *
+     * @generated from field: repeated leaflow.fleet.tool.v1.ToolContent content = 1;
+     */
+    content: ToolContent[];
+    /**
+     * 可选 JSON object。MCP 来源保留 structuredContent；内置工具遵循其输出 schema。
+     *
+     * @generated from field: string structured_content_json = 2;
+     */
+    structuredContentJson: string;
+    /**
+     * @generated from field: bool is_error = 3;
+     */
+    isError: boolean;
+    /**
+     * 结果的额外 JSON object，例如 MCP _meta；不重复 content、structuredContent、
+     * isError 或图片 data。仅保留扩展信息，不授予权限。
+     *
+     * @generated from field: string metadata_json = 4;
+     */
+    metadataJson: string;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.CallToolResponse.
+ * Use `create(CallToolResponseSchema)` to create a new message.
+ */
+export declare const CallToolResponseSchema: GenMessage<CallToolResponse>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.ToolContent
+ */
+export type ToolContent = Message<"leaflow.fleet.tool.v1.ToolContent"> & {
+    /**
+     * @generated from oneof leaflow.fleet.tool.v1.ToolContent.content
+     */
+    content: {
+        /**
+         * @generated from field: string text = 1;
+         */
+        value: string;
+        case: "text";
+    } | {
+        /**
+         * @generated from field: leaflow.fleet.tool.v1.ToolImage image = 2;
+         */
+        value: ToolImage;
+        case: "image";
+    } | {
+        /**
+         * 无专用表示的外部内容块，保留原 JSON object 及其 type；不是图片的文本替代，
+         * 不能执行其中的代码或自动下载其中的 URL。
+         *
+         * @generated from field: string json = 3;
+         */
+        value: string;
+        case: "json";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * 内容块的额外 JSON object，例如 annotations/_meta；不重复正文和图片数据，
+     * 不能被用于伪装来源、提升权限或自动访问外部资源。
+     *
+     * @generated from field: string metadata_json = 4;
+     */
+    metadataJson: string;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ToolContent.
+ * Use `create(ToolContentSchema)` to create a new message.
+ */
+export declare const ToolContentSchema: GenMessage<ToolContent>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.ToolImage
+ */
+export type ToolImage = Message<"leaflow.fleet.tool.v1.ToolImage"> & {
+    /**
+     * PNG、JPEG 或 WebP 的编码图片，不是 JSON 中的 base64 字符串。
+     *
+     * @generated from field: bytes data = 1;
+     */
+    data: Uint8Array;
+    /**
+     * @generated from field: string mime_type = 2;
+     */
+    mimeType: string;
+    /**
+     * 编码图片的实际像素尺寸，必须与图片头一致。
+     *
+     * @generated from field: leaflow.fleet.virtualdesktop.display.v1.Size size = 3;
+     */
+    size?: Size | undefined;
+    /**
+     * 内置截图附带其坐标上下文；外部图片没有可靠的本机会话坐标时不设置。
+     *
+     * @generated from field: leaflow.fleet.tool.v1.ScreenshotContext screenshot = 4;
+     */
+    screenshot?: ScreenshotContext | undefined;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ToolImage.
+ * Use `create(ToolImageSchema)` to create a new message.
+ */
+export declare const ToolImageSchema: GenMessage<ToolImage>;
+/**
+ * 图片像素与其所观察窗口的关联。图片缩放不改变这里的原始几何。
+ *
+ * @generated from message leaflow.fleet.tool.v1.ScreenshotContext
+ */
+export type ScreenshotContext = Message<"leaflow.fleet.tool.v1.ScreenshotContext"> & {
+    /**
+     * 会话签发的非空、不透明、自包含映射引用，仅在原调用者和原图形上下文代际内
+     * 有效，不是授权凭据。实现验证完整性、生命周期和当前窗口状态，不依赖数据库、
+     * 图片缓存或保存旧映射。过期或失效返回 STALE_CAPTURE，不改用最新截图默默执行。
+     *
+     * @generated from field: string reference = 1;
+     */
+    reference: string;
+    /**
+     * 0 表示整个画布；否则为 CaptureScreenshot 的目标窗口。
+     *
+     * @generated from field: uint64 window_id = 2;
+     */
+    windowId: bigint;
+    /**
+     * 原始截图区域：整个画布时为画布坐标，单窗口时相对该目标窗口。图片中的点先
+     * 按 ToolImage.size 缩放回此区域，再结合 windows 还原目标窗口局部坐标。
+     *
+     * @generated from field: leaflow.fleet.virtualdesktop.display.v1.Rectangle area = 3;
+     */
+    area?: Rectangle | undefined;
+    /**
+     * 同 CaptureScreenshotResponse.windows，含每个窗口的几何和 resize_counter。
+     *
+     * @generated from field: repeated leaflow.fleet.virtualdesktop.capture.v1.CapturedWindow windows = 4;
+     */
+    windows: CapturedWindow[];
+    /**
+     * @generated from field: google.protobuf.Timestamp captured_at = 5;
+     */
+    capturedAt?: Timestamp | undefined;
+    /**
+     * 观察到的 change revision，不自动等同于输入接口的窗口尺寸代际检查。
+     *
+     * @generated from field: uint64 revision = 6;
+     */
+    revision: bigint;
+    /**
+     * @generated from field: bool quiet = 7;
+     */
+    quiet: boolean;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ScreenshotContext.
+ * Use `create(ScreenshotContextSchema)` to create a new message.
+ */
+export declare const ScreenshotContextSchema: GenMessage<ScreenshotContext>;
+/**
+ * 参与者 authorization.policies 中的工具策略。内置工具继续使用各原有能力的策略，
+ * 本策略不越过 read_only、lease、模态或窗口检查。
+ *
+ * @generated from message leaflow.fleet.tool.v1.ToolPolicy
+ */
+export type ToolPolicy = Message<"leaflow.fleet.tool.v1.ToolPolicy"> & {
+    /**
+     * 明确允许账号的外部 MCP 工具；没有策略或 false 时不允许。仍不能越过
+     * read_only 或账号归属，工具自报的只读提示也不能放宽授权。
+     *
+     * @generated from field: bool allow_mcp = 1;
+     */
+    allowMcp: boolean;
+    /**
+     * 可选的 server 精确名字限制；allow_mcp 为 true 且列表为空时允许该账号当前
+     * 配置的所有 server，因此新配置的工具可以实时出现，不需要缓存目录或改授权。
+     * 非空时只允许列出的名字，不支持通配符。
+     *
+     * @generated from field: repeated string mcp_servers = 2;
+     */
+    mcpServers: string[];
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ToolPolicy.
+ * Use `create(ToolPolicySchema)` to create a new message.
+ */
+export declare const ToolPolicySchema: GenMessage<ToolPolicy>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.ReportToolActivityRequest
+ */
+export type ReportToolActivityRequest = Message<"leaflow.fleet.tool.v1.ReportToolActivityRequest"> & {
+    /**
+     * 至多 64 条、整个请求至多 32 KiB。高频位置可以合并；不伪造缺失的完成事件。
+     *
+     * @generated from field: repeated leaflow.fleet.tool.v1.ToolActivity events = 1;
+     */
+    events: ToolActivity[];
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ReportToolActivityRequest.
+ * Use `create(ReportToolActivityRequestSchema)` to create a new message.
+ */
+export declare const ReportToolActivityRequestSchema: GenMessage<ReportToolActivityRequest>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.ReportToolActivityResponse
+ */
+export type ReportToolActivityResponse = Message<"leaflow.fleet.tool.v1.ReportToolActivityResponse"> & {};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ReportToolActivityResponse.
+ * Use `create(ReportToolActivityResponseSchema)` to create a new message.
+ */
+export declare const ReportToolActivityResponseSchema: GenMessage<ReportToolActivityResponse>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.ToolActivity
+ */
+export type ToolActivity = Message<"leaflow.fleet.tool.v1.ToolActivity"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: uint64 participant_id = 2;
+     */
+    participantId: bigint;
+    /**
+     * @generated from field: string operation_id = 3;
+     */
+    operationId: string;
+    /**
+     * 操作报告器的本次进程实例，重启后改变；sequence 只在同一实例中比较。
+     *
+     * @generated from field: string instance_id = 4;
+     */
+    instanceId: string;
+    /**
+     * @generated from field: uint64 sequence = 5;
+     */
+    sequence: bigint;
+    /**
+     * @generated from field: google.protobuf.Timestamp observed_at = 6;
+     */
+    observedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: leaflow.fleet.tool.v1.ToolActivityPhase phase = 7;
+     */
+    phase: ToolActivityPhase;
+    /**
+     * 固定操作名，如 computer.click，不是输入内容或用户命令。
+     *
+     * @generated from field: string action = 8;
+     */
+    action: string;
+    /**
+     * @generated from field: leaflow.fleet.tool.v1.ToolActivityTarget target = 9;
+     */
+    target?: ToolActivityTarget | undefined;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ToolActivity.
+ * Use `create(ToolActivitySchema)` to create a new message.
+ */
+export declare const ToolActivitySchema: GenMessage<ToolActivity>;
+/**
+ * @generated from message leaflow.fleet.tool.v1.ToolActivityTarget
+ */
+export type ToolActivityTarget = Message<"leaflow.fleet.tool.v1.ToolActivityTarget"> & {
+    /**
+     * 0 时 position 为画布坐标；否则为该窗口客户区局部坐标。不是客户端 CSS、
+     * 物理屏幕或缩小截图坐标。没有位置的键盘操作可以仅指明 window_id。
+     *
+     * @generated from field: uint64 window_id = 1;
+     */
+    windowId: bigint;
+    /**
+     * @generated from field: leaflow.fleet.virtualdesktop.display.v1.Point position = 2;
+     */
+    position?: Point | undefined;
+    /**
+     * @generated from field: uint64 resize_counter = 3;
+     */
+    resizeCounter: bigint;
+    /**
+     * @generated from field: uint64 shape_counter = 4;
+     */
+    shapeCounter: bigint;
+};
+/**
+ * Describes the message leaflow.fleet.tool.v1.ToolActivityTarget.
+ * Use `create(ToolActivityTargetSchema)` to create a new message.
+ */
+export declare const ToolActivityTargetSchema: GenMessage<ToolActivityTarget>;
+/**
+ * 发现时选择的来源；未选择表示所有获准的来源。
+ *
+ * @generated from enum leaflow.fleet.tool.v1.ToolSourceKind
+ */
+export declare enum ToolSourceKind {
+    /**
+     * @generated from enum value: TOOL_SOURCE_KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: TOOL_SOURCE_KIND_BUILTIN = 1;
+     */
+    BUILTIN = 1,
+    /**
+     * @generated from enum value: TOOL_SOURCE_KIND_MCP = 2;
+     */
+    MCP = 2
+}
+/**
+ * Describes the enum leaflow.fleet.tool.v1.ToolSourceKind.
+ */
+export declare const ToolSourceKindSchema: GenEnum<ToolSourceKind>;
+/**
+ * @generated from enum leaflow.fleet.tool.v1.ToolActivityPhase
+ */
+export declare enum ToolActivityPhase {
+    /**
+     * @generated from enum value: TOOL_ACTIVITY_PHASE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * 权限与目标检查已通过，准备执行；不是应用已经收到动作的证明。
+     *
+     * @generated from enum value: TOOL_ACTIVITY_PHASE_TARGETED = 1;
+     */
+    TARGETED = 1,
+    /**
+     * 原生输入接口已接受对应操作，不等同于应用内容或 GPU 已呈现。
+     *
+     * @generated from enum value: TOOL_ACTIVITY_PHASE_APPLIED = 2;
+     */
+    APPLIED = 2,
+    /**
+     * @generated from enum value: TOOL_ACTIVITY_PHASE_FINISHED = 3;
+     */
+    FINISHED = 3,
+    /**
+     * @generated from enum value: TOOL_ACTIVITY_PHASE_CANCELLED = 4;
+     */
+    CANCELLED = 4,
+    /**
+     * @generated from enum value: TOOL_ACTIVITY_PHASE_FAILED = 5;
+     */
+    FAILED = 5
+}
+/**
+ * Describes the enum leaflow.fleet.tool.v1.ToolActivityPhase.
+ */
+export declare const ToolActivityPhaseSchema: GenEnum<ToolActivityPhase>;
+/**
+ * 会话中的工具：Agent 内置能力，以及账号配置的 MCP server 提供的外部工具。
+ * MCP 是外部工具的一种协议，不是内置工具的执行方式。工具身份由 Agent 的来源
+ * 注册决定，不能由外部工具的名字、描述或 annotations 声称。
+ *
+ * ToolService 是会话服务。Fleet 可以经该会话的 control 连接转发工具调用、结果
+ * 和图片，调用方不必另建 WebRTC；这条工具链路分段加密，Fleet 进程可见其内容。
+ * 该例外不改变桌面直播与既有参与者数据通道的端到端加密语义。实现也可以在已授权
+ * 参与者的数据连接提供同名可靠 bulk 服务通道，但不能把直连作为工具调用的前提。
+ *
+ * 只有显式 ListTools 才实时从内置实现和获准的 MCP server 发现工具。Agent/Fleet
+ * 不建工具数据库，不缓存目录或调用结果；调用方可持有上一轮发现的工具描述用于
+ * 后续调用，按需再次发现。CallTool 不要求先 ListTools，不为检查存在性另发发现
+ * 请求；已不存在的工具直接返回 NOT_FOUND / TOOL_NOT_FOUND。
+ * 协议连接、进程和正在执行的调用仍需要各自的生命周期管理；这些运行状态不是
+ * 工具目录缓存。列表分页标识必须能对实时列表校验，不依赖保存旧目录。
+ *
+ * 内置虚拟桌面工具使用 computer.* 名字，不以 CUA 或 MCP server 名字暴露。
+ * 只有虚拟桌面能力实际可用时才列出；不可用时直接按名字调用也返回 TOOL_NOT_FOUND，
+ * 不能用旧目录绕过当前能力检查。无需用户先打开桌面，账号的轻量图形上下文由系统准备。
+ *
+ * 内置工具复用各能力原有的权限与操作仲裁：只读参与者可以观察，不能执行写操作；
+ * 输入操作仍检查 lease、目标窗口、模态限制及窗口尺寸代际。经 control 转发时，
+ * authorization 必须先按 control.v1 校验平台签名、issuer、machine/session、期限、
+ * 身份与策略，建立真实的会话调用者；不要求其有 WebRTC Connection，也不伪造一个。
+ * 直连时从通道取得真实调用者；若同时给 authorization，它必须与通道身份一致。
+ * 工具 arguments 不能自报身份或改换账号/会话。调用取消、授权到期或调用者离开时，
+ * 正在执行的调用被取消；已执行的副作用不自动重放。
+ *
+ * 外部 MCP 工具可以执行任意账号代码，不能根据工具自报的 readOnlyHint 认定安全。
+ * 仅会话所属账号的非只读参与者，在授权中明确带有允许该 server 的 ToolPolicy 时
+ * 可以启动、发现和调用该 server。本机 provider 通道仍须检查账号权限；不能把
+ * 当前 machine McpService 的转发路径当作本服务的端到端实现。
+ *
+ * 工具结果是多模态内容，不要求 MCP 传输。图片以编码后的 bytes 传送；调用方在
+ * 模型适配边界转换为模型要求的 image content。不得为此默认上传公开 URL，或把
+ * 图片和工具调用内容写入日志。
+ *
+ * @generated from service leaflow.fleet.tool.v1.ToolService
+ */
+export declare const ToolService: GenService<{
+    /**
+     * 列出本参与者可发现的工具。不能使用的来源在 unavailable_sources 中报告，
+     * 不阻止其他来源返回。内置工具可在没有配置任何 MCP server 时独立发现。
+     *
+     * query 的每个词忽略大小写匹配工具名、标题或描述。page_size 未设置时由 Agent
+     * 选择，最多 100。每个响应还受通道消息预算限制，可能少于 page_size。
+     * page_token 只属于本参与者和相同查询；列表已改变时返回 FAILED_PRECONDITION，
+     * reason TOOL_LIST_CHANGED，调用方从第一页重新列出，不重放任何 CallTool。
+     *
+     * @generated from rpc leaflow.fleet.tool.v1.ToolService.ListTools
+     */
+    listTools: {
+        methodKind: "unary";
+        input: typeof ListToolsRequestSchema;
+        output: typeof ListToolsResponseSchema;
+    };
+    /**
+     * 调用一个明确来源的工具。arguments_json 是一个 JSON object，最多 256 KiB。
+     * schema 用于发现；内置实现还须独立验证参数，外部 MCP 使用 MCP tools/call。
+     *
+     * 每次调用都重新检查调用者授权与来源是否仍可用。权限拒绝、无效参数和不存在的
+     * 工具通过 RPC status 返回；工具执行得到的业务失败通过 is_error 返回。失败不
+     * 表示此前副作用必然没有发生，调用方不得因此盲目重试。
+     *
+     * 结果必须完整落在对端的消息上限内。无法容纳时返回 RESOURCE_EXHAUSTED，reason
+     * TOOL_RESULT_TOO_LARGE，不截断图片、伪造成功或改成未经授权的外部下载地址。
+     *
+     * @generated from rpc leaflow.fleet.tool.v1.ToolService.CallTool
+     */
+    callTool: {
+        methodKind: "unary";
+        input: typeof CallToolRequestSchema;
+        output: typeof CallToolResponseSchema;
+    };
+}>;
+/**
+ * Agent 报告工具操作的显示提示，Fleet 实时转给获准观察本会话的前端，不建事件
+ * 数据库、不缓存工具结果。只含操作类别、位置及阶段，不含输入文字、按键内容、
+ * 剪贴板、图片或工具 arguments。事件丢失不影响动作执行，也不能触发动作重放。
+ * 本服务由 Fleet 在会话的 control 连接提供；报告中的 session_id 必须等于该连接。
+ *
+ * @generated from service leaflow.fleet.tool.v1.ToolActivityService
+ */
+export declare const ToolActivityService: GenService<{
+    /**
+     * @generated from rpc leaflow.fleet.tool.v1.ToolActivityService.ReportToolActivity
+     */
+    reportToolActivity: {
+        methodKind: "unary";
+        input: typeof ReportToolActivityRequestSchema;
+        output: typeof ReportToolActivityResponseSchema;
+    };
+}>;