@agent-phonon/protocol 0.2.0

package/dist/schemas/discovery.d.ts

@@ -0,0 +1,892 @@
+import { z } from "zod";
+/**
+ * Agent / 模型发现（design §5 / D14）。
+ *
+ * 发现 = 内部扫描机制（非协议）+ 对外暴露接口（属协议）。本文件只定义
+ * **对外接口**的数据形状：服务端借此感知「这台设备上哪些 agent 可用、
+ * 各自哪些模型可用」。
+ */
+/** 单个模型的可用性描述。 */
+export declare const ModelInfo: z.ZodObject<{
+    /** 模型 id，session.create 的 `model` 入参取自这里。 */
+    id: z.ZodString;
+    /** 展示名（可选）。 */
+    displayName: z.ZodOptional<z.ZodString>;
+    /** 上下文窗口（token，若已知）。注意：以 phonon 实测/配置为准，不盲信后端返回。 */
+    contextWindow: z.ZodOptional<z.ZodNumber>;
+    /** 该模型当前是否可用（如鉴权过期会变 false）。 */
+    available: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    available: boolean;
+    displayName?: string | undefined;
+    contextWindow?: number | undefined;
+}, {
+    id: string;
+    displayName?: string | undefined;
+    contextWindow?: number | undefined;
+    available?: boolean | undefined;
+}>;
+export type ModelInfo = z.infer<typeof ModelInfo>;
+/** 单个 agent 的发现条目。 */
+export declare const AgentDescriptor: z.ZodObject<{
+    agentId: z.ZodBranded<z.ZodString, "AgentId">;
+    /** 展示名，如 "Claude Code" / "OpenClaw"。 */
+    displayName: z.ZodString;
+    /** 适配器内部名，如 "openclaw" / "claude-code"。 */
+    adapter: z.ZodString;
+    /** 整体是否可用（已安装 + 可执行 + 凭证就绪）。 */
+    available: z.ZodBoolean;
+    /** 不可用时的原因（如 "not_installed" / "not_logged_in" / "no_credentials"）。 */
+    unavailableReason: z.ZodOptional<z.ZodString>;
+    /** agent 自身版本（若可探测）。 */
+    version: z.ZodOptional<z.ZodString>;
+    /** 可用模型列表。 */
+    models: z.ZodArray<z.ZodObject<{
+        /** 模型 id，session.create 的 `model` 入参取自这里。 */
+        id: z.ZodString;
+        /** 展示名（可选）。 */
+        displayName: z.ZodOptional<z.ZodString>;
+        /** 上下文窗口（token，若已知）。注意：以 phonon 实测/配置为准，不盲信后端返回。 */
+        contextWindow: z.ZodOptional<z.ZodNumber>;
+        /** 该模型当前是否可用（如鉴权过期会变 false）。 */
+        available: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        available: boolean;
+        displayName?: string | undefined;
+        contextWindow?: number | undefined;
+    }, {
+        id: string;
+        displayName?: string | undefined;
+        contextWindow?: number | undefined;
+        available?: boolean | undefined;
+    }>, "many">;
+    /** 能力声明（随 discovery 暴露，见 §7）。 */
+    capabilities: z.ZodObject<{
+        nativeSession: z.ZodBoolean;
+        nativeCompression: z.ZodBoolean;
+        contextInjection: z.ZodBoolean;
+        proactiveOutput: z.ZodBoolean;
+        modelSwitch: z.ZodBoolean;
+        interrupt: z.ZodBoolean;
+        injectMidTurn: z.ZodBoolean;
+        skillManagement: z.ZodBoolean;
+        hooks: z.ZodArray<z.ZodEnum<["pre_tool", "post_tool", "pre_command", "pre_file_write", "pre_network", "session_start", "session_end", "notification"]>, "many">;
+        streaming: z.ZodBoolean;
+        limits: z.ZodOptional<z.ZodObject<{
+            maxConcurrentSessions: z.ZodOptional<z.ZodNumber>;
+            maxContextTokens: z.ZodOptional<z.ZodNumber>;
+            maxMessageBytes: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxConcurrentSessions?: number | undefined;
+            maxContextTokens?: number | undefined;
+            maxMessageBytes?: number | undefined;
+        }, {
+            maxConcurrentSessions?: number | undefined;
+            maxContextTokens?: number | undefined;
+            maxMessageBytes?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        nativeSession: boolean;
+        nativeCompression: boolean;
+        contextInjection: boolean;
+        proactiveOutput: boolean;
+        modelSwitch: boolean;
+        interrupt: boolean;
+        injectMidTurn: boolean;
+        skillManagement: boolean;
+        hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+        streaming: boolean;
+        limits?: {
+            maxConcurrentSessions?: number | undefined;
+            maxContextTokens?: number | undefined;
+            maxMessageBytes?: number | undefined;
+        } | undefined;
+    }, {
+        nativeSession: boolean;
+        nativeCompression: boolean;
+        contextInjection: boolean;
+        proactiveOutput: boolean;
+        modelSwitch: boolean;
+        interrupt: boolean;
+        injectMidTurn: boolean;
+        skillManagement: boolean;
+        hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+        streaming: boolean;
+        limits?: {
+            maxConcurrentSessions?: number | undefined;
+            maxContextTokens?: number | undefined;
+            maxMessageBytes?: number | undefined;
+        } | undefined;
+    }>;
+    /** 最近一次扫描时间。 */
+    scannedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    agentId: string & z.BRAND<"AgentId">;
+    displayName: string;
+    available: boolean;
+    adapter: string;
+    models: {
+        id: string;
+        available: boolean;
+        displayName?: string | undefined;
+        contextWindow?: number | undefined;
+    }[];
+    capabilities: {
+        nativeSession: boolean;
+        nativeCompression: boolean;
+        contextInjection: boolean;
+        proactiveOutput: boolean;
+        modelSwitch: boolean;
+        interrupt: boolean;
+        injectMidTurn: boolean;
+        skillManagement: boolean;
+        hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+        streaming: boolean;
+        limits?: {
+            maxConcurrentSessions?: number | undefined;
+            maxContextTokens?: number | undefined;
+            maxMessageBytes?: number | undefined;
+        } | undefined;
+    };
+    unavailableReason?: string | undefined;
+    version?: string | undefined;
+    scannedAt?: string | undefined;
+}, {
+    agentId: string;
+    displayName: string;
+    available: boolean;
+    adapter: string;
+    models: {
+        id: string;
+        displayName?: string | undefined;
+        contextWindow?: number | undefined;
+        available?: boolean | undefined;
+    }[];
+    capabilities: {
+        nativeSession: boolean;
+        nativeCompression: boolean;
+        contextInjection: boolean;
+        proactiveOutput: boolean;
+        modelSwitch: boolean;
+        interrupt: boolean;
+        injectMidTurn: boolean;
+        skillManagement: boolean;
+        hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+        streaming: boolean;
+        limits?: {
+            maxConcurrentSessions?: number | undefined;
+            maxContextTokens?: number | undefined;
+            maxMessageBytes?: number | undefined;
+        } | undefined;
+    };
+    unavailableReason?: string | undefined;
+    version?: string | undefined;
+    scannedAt?: string | undefined;
+}>;
+export type AgentDescriptor = z.infer<typeof AgentDescriptor>;
+export declare const DiscoveryListParams: z.ZodObject<{
+    /** 可选：只看可用的。 */
+    availableOnly: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    availableOnly?: boolean | undefined;
+}, {
+    availableOnly?: boolean | undefined;
+}>;
+export type DiscoveryListParams = z.infer<typeof DiscoveryListParams>;
+export declare const DiscoveryListResult: z.ZodObject<{
+    agents: z.ZodArray<z.ZodObject<{
+        agentId: z.ZodBranded<z.ZodString, "AgentId">;
+        /** 展示名，如 "Claude Code" / "OpenClaw"。 */
+        displayName: z.ZodString;
+        /** 适配器内部名，如 "openclaw" / "claude-code"。 */
+        adapter: z.ZodString;
+        /** 整体是否可用（已安装 + 可执行 + 凭证就绪）。 */
+        available: z.ZodBoolean;
+        /** 不可用时的原因（如 "not_installed" / "not_logged_in" / "no_credentials"）。 */
+        unavailableReason: z.ZodOptional<z.ZodString>;
+        /** agent 自身版本（若可探测）。 */
+        version: z.ZodOptional<z.ZodString>;
+        /** 可用模型列表。 */
+        models: z.ZodArray<z.ZodObject<{
+            /** 模型 id，session.create 的 `model` 入参取自这里。 */
+            id: z.ZodString;
+            /** 展示名（可选）。 */
+            displayName: z.ZodOptional<z.ZodString>;
+            /** 上下文窗口（token，若已知）。注意：以 phonon 实测/配置为准，不盲信后端返回。 */
+            contextWindow: z.ZodOptional<z.ZodNumber>;
+            /** 该模型当前是否可用（如鉴权过期会变 false）。 */
+            available: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            available: boolean;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+        }, {
+            id: string;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+            available?: boolean | undefined;
+        }>, "many">;
+        /** 能力声明（随 discovery 暴露，见 §7）。 */
+        capabilities: z.ZodObject<{
+            nativeSession: z.ZodBoolean;
+            nativeCompression: z.ZodBoolean;
+            contextInjection: z.ZodBoolean;
+            proactiveOutput: z.ZodBoolean;
+            modelSwitch: z.ZodBoolean;
+            interrupt: z.ZodBoolean;
+            injectMidTurn: z.ZodBoolean;
+            skillManagement: z.ZodBoolean;
+            hooks: z.ZodArray<z.ZodEnum<["pre_tool", "post_tool", "pre_command", "pre_file_write", "pre_network", "session_start", "session_end", "notification"]>, "many">;
+            streaming: z.ZodBoolean;
+            limits: z.ZodOptional<z.ZodObject<{
+                maxConcurrentSessions: z.ZodOptional<z.ZodNumber>;
+                maxContextTokens: z.ZodOptional<z.ZodNumber>;
+                maxMessageBytes: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            }, {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        }, {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        }>;
+        /** 最近一次扫描时间。 */
+        scannedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agentId: string & z.BRAND<"AgentId">;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            available: boolean;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    }, {
+        agentId: string;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+            available?: boolean | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    agents: {
+        agentId: string & z.BRAND<"AgentId">;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            available: boolean;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    }[];
+}, {
+    agents: {
+        agentId: string;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+            available?: boolean | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    }[];
+}>;
+export type DiscoveryListResult = z.infer<typeof DiscoveryListResult>;
+export declare const DiscoveryGetParams: z.ZodObject<{
+    agentId: z.ZodBranded<z.ZodString, "AgentId">;
+}, "strip", z.ZodTypeAny, {
+    agentId: string & z.BRAND<"AgentId">;
+}, {
+    agentId: string;
+}>;
+export type DiscoveryGetParams = z.infer<typeof DiscoveryGetParams>;
+export declare const DiscoveryGetResult: z.ZodObject<{
+    agent: z.ZodObject<{
+        agentId: z.ZodBranded<z.ZodString, "AgentId">;
+        /** 展示名，如 "Claude Code" / "OpenClaw"。 */
+        displayName: z.ZodString;
+        /** 适配器内部名，如 "openclaw" / "claude-code"。 */
+        adapter: z.ZodString;
+        /** 整体是否可用（已安装 + 可执行 + 凭证就绪）。 */
+        available: z.ZodBoolean;
+        /** 不可用时的原因（如 "not_installed" / "not_logged_in" / "no_credentials"）。 */
+        unavailableReason: z.ZodOptional<z.ZodString>;
+        /** agent 自身版本（若可探测）。 */
+        version: z.ZodOptional<z.ZodString>;
+        /** 可用模型列表。 */
+        models: z.ZodArray<z.ZodObject<{
+            /** 模型 id，session.create 的 `model` 入参取自这里。 */
+            id: z.ZodString;
+            /** 展示名（可选）。 */
+            displayName: z.ZodOptional<z.ZodString>;
+            /** 上下文窗口（token，若已知）。注意：以 phonon 实测/配置为准，不盲信后端返回。 */
+            contextWindow: z.ZodOptional<z.ZodNumber>;
+            /** 该模型当前是否可用（如鉴权过期会变 false）。 */
+            available: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            available: boolean;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+        }, {
+            id: string;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+            available?: boolean | undefined;
+        }>, "many">;
+        /** 能力声明（随 discovery 暴露，见 §7）。 */
+        capabilities: z.ZodObject<{
+            nativeSession: z.ZodBoolean;
+            nativeCompression: z.ZodBoolean;
+            contextInjection: z.ZodBoolean;
+            proactiveOutput: z.ZodBoolean;
+            modelSwitch: z.ZodBoolean;
+            interrupt: z.ZodBoolean;
+            injectMidTurn: z.ZodBoolean;
+            skillManagement: z.ZodBoolean;
+            hooks: z.ZodArray<z.ZodEnum<["pre_tool", "post_tool", "pre_command", "pre_file_write", "pre_network", "session_start", "session_end", "notification"]>, "many">;
+            streaming: z.ZodBoolean;
+            limits: z.ZodOptional<z.ZodObject<{
+                maxConcurrentSessions: z.ZodOptional<z.ZodNumber>;
+                maxContextTokens: z.ZodOptional<z.ZodNumber>;
+                maxMessageBytes: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            }, {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        }, {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        }>;
+        /** 最近一次扫描时间。 */
+        scannedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agentId: string & z.BRAND<"AgentId">;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            available: boolean;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    }, {
+        agentId: string;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+            available?: boolean | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    agent: {
+        agentId: string & z.BRAND<"AgentId">;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            available: boolean;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    };
+}, {
+    agent: {
+        agentId: string;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+            available?: boolean | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    };
+}>;
+export type DiscoveryGetResult = z.infer<typeof DiscoveryGetResult>;
+export declare const DiscoveryChangedParams: z.ZodObject<{
+    /** 变更类型：agent 上/下线、模型增减、能力变化。 */
+    kind: z.ZodEnum<["agent_added", "agent_removed", "agent_updated", "models_changed"]>;
+    agentId: z.ZodBranded<z.ZodString, "AgentId">;
+    /** 变更后的完整快照（可选，便于服务端直接更新缓存）。 */
+    snapshot: z.ZodOptional<z.ZodObject<{
+        agentId: z.ZodBranded<z.ZodString, "AgentId">;
+        /** 展示名，如 "Claude Code" / "OpenClaw"。 */
+        displayName: z.ZodString;
+        /** 适配器内部名，如 "openclaw" / "claude-code"。 */
+        adapter: z.ZodString;
+        /** 整体是否可用（已安装 + 可执行 + 凭证就绪）。 */
+        available: z.ZodBoolean;
+        /** 不可用时的原因（如 "not_installed" / "not_logged_in" / "no_credentials"）。 */
+        unavailableReason: z.ZodOptional<z.ZodString>;
+        /** agent 自身版本（若可探测）。 */
+        version: z.ZodOptional<z.ZodString>;
+        /** 可用模型列表。 */
+        models: z.ZodArray<z.ZodObject<{
+            /** 模型 id，session.create 的 `model` 入参取自这里。 */
+            id: z.ZodString;
+            /** 展示名（可选）。 */
+            displayName: z.ZodOptional<z.ZodString>;
+            /** 上下文窗口（token，若已知）。注意：以 phonon 实测/配置为准，不盲信后端返回。 */
+            contextWindow: z.ZodOptional<z.ZodNumber>;
+            /** 该模型当前是否可用（如鉴权过期会变 false）。 */
+            available: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            available: boolean;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+        }, {
+            id: string;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+            available?: boolean | undefined;
+        }>, "many">;
+        /** 能力声明（随 discovery 暴露，见 §7）。 */
+        capabilities: z.ZodObject<{
+            nativeSession: z.ZodBoolean;
+            nativeCompression: z.ZodBoolean;
+            contextInjection: z.ZodBoolean;
+            proactiveOutput: z.ZodBoolean;
+            modelSwitch: z.ZodBoolean;
+            interrupt: z.ZodBoolean;
+            injectMidTurn: z.ZodBoolean;
+            skillManagement: z.ZodBoolean;
+            hooks: z.ZodArray<z.ZodEnum<["pre_tool", "post_tool", "pre_command", "pre_file_write", "pre_network", "session_start", "session_end", "notification"]>, "many">;
+            streaming: z.ZodBoolean;
+            limits: z.ZodOptional<z.ZodObject<{
+                maxConcurrentSessions: z.ZodOptional<z.ZodNumber>;
+                maxContextTokens: z.ZodOptional<z.ZodNumber>;
+                maxMessageBytes: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            }, {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        }, {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        }>;
+        /** 最近一次扫描时间。 */
+        scannedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agentId: string & z.BRAND<"AgentId">;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            available: boolean;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    }, {
+        agentId: string;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+            available?: boolean | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    }>>;
+    at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    agentId: string & z.BRAND<"AgentId">;
+    kind: "agent_added" | "agent_removed" | "agent_updated" | "models_changed";
+    snapshot?: {
+        agentId: string & z.BRAND<"AgentId">;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            available: boolean;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    } | undefined;
+}, {
+    at: string;
+    agentId: string;
+    kind: "agent_added" | "agent_removed" | "agent_updated" | "models_changed";
+    snapshot?: {
+        agentId: string;
+        displayName: string;
+        available: boolean;
+        adapter: string;
+        models: {
+            id: string;
+            displayName?: string | undefined;
+            contextWindow?: number | undefined;
+            available?: boolean | undefined;
+        }[];
+        capabilities: {
+            nativeSession: boolean;
+            nativeCompression: boolean;
+            contextInjection: boolean;
+            proactiveOutput: boolean;
+            modelSwitch: boolean;
+            interrupt: boolean;
+            injectMidTurn: boolean;
+            skillManagement: boolean;
+            hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+            streaming: boolean;
+            limits?: {
+                maxConcurrentSessions?: number | undefined;
+                maxContextTokens?: number | undefined;
+                maxMessageBytes?: number | undefined;
+            } | undefined;
+        };
+        unavailableReason?: string | undefined;
+        version?: string | undefined;
+        scannedAt?: string | undefined;
+    } | undefined;
+}>;
+export type DiscoveryChangedParams = z.infer<typeof DiscoveryChangedParams>;
+//# sourceMappingURL=discovery.d.ts.map