@linkshell/host 0.4.69 → 0.4.70

package/dist/wire/src/rpc-mcp.d.ts

@@ -0,0 +1,199 @@
+import { z } from "zod";
+/** A tool Codex offers as an app of the thread (what its "插件和 MCP" menu lists). */
+export declare const mcpAppSchema: z.ZodObject<{
+    server: z.ZodString;
+    tool: z.ZodString;
+    /** The plugin's or connector's name where there is one, else the tool's. */
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    /** Always `ui://…`. */
+    resourceUri: z.ZodString;
+    /** Where Codex offers it (`openai/ui.entrypoints[].type`): always includes "thread". */
+    entrypoints: z.ZodArray<z.ZodString, "many">;
+    /** Who may call the tool (`ui.visibility`: "model", "app"); absent: both. */
+    visibility: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    displayMode: z.ZodOptional<z.ZodEnum<["inline", "fullscreen"]>>;
+    /** The Codex connector (server `codex_apps`): `mcp.call` needs it there. */
+    connector: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    server: string;
+    tool: string;
+    resourceUri: string;
+    entrypoints: string[];
+    description?: string | undefined;
+    displayMode?: "inline" | "fullscreen" | undefined;
+    connector?: string | undefined;
+    visibility?: string[] | undefined;
+}, {
+    title: string;
+    server: string;
+    tool: string;
+    resourceUri: string;
+    entrypoints: string[];
+    description?: string | undefined;
+    displayMode?: "inline" | "fullscreen" | undefined;
+    connector?: string | undefined;
+    visibility?: string[] | undefined;
+}>;
+export type McpApp = z.infer<typeof mcpAppSchema>;
+export declare const mcpMethods: {
+    /** The apps the session's Codex can open in the thread. */
+    readonly "mcp.apps": {
+        readonly params: z.ZodObject<{
+            sessionId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+        }, {
+            sessionId: string;
+        }>;
+        readonly result: z.ZodObject<{
+            apps: z.ZodArray<z.ZodObject<{
+                server: z.ZodString;
+                tool: z.ZodString;
+                /** The plugin's or connector's name where there is one, else the tool's. */
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                /** Always `ui://…`. */
+                resourceUri: z.ZodString;
+                /** Where Codex offers it (`openai/ui.entrypoints[].type`): always includes "thread". */
+                entrypoints: z.ZodArray<z.ZodString, "many">;
+                /** Who may call the tool (`ui.visibility`: "model", "app"); absent: both. */
+                visibility: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                displayMode: z.ZodOptional<z.ZodEnum<["inline", "fullscreen"]>>;
+                /** The Codex connector (server `codex_apps`): `mcp.call` needs it there. */
+                connector: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                server: string;
+                tool: string;
+                resourceUri: string;
+                entrypoints: string[];
+                description?: string | undefined;
+                displayMode?: "inline" | "fullscreen" | undefined;
+                connector?: string | undefined;
+                visibility?: string[] | undefined;
+            }, {
+                title: string;
+                server: string;
+                tool: string;
+                resourceUri: string;
+                entrypoints: string[];
+                description?: string | undefined;
+                displayMode?: "inline" | "fullscreen" | undefined;
+                connector?: string | undefined;
+                visibility?: string[] | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            apps: {
+                title: string;
+                server: string;
+                tool: string;
+                resourceUri: string;
+                entrypoints: string[];
+                description?: string | undefined;
+                displayMode?: "inline" | "fullscreen" | undefined;
+                connector?: string | undefined;
+                visibility?: string[] | undefined;
+            }[];
+        }, {
+            apps: {
+                title: string;
+                server: string;
+                tool: string;
+                resourceUri: string;
+                entrypoints: string[];
+                description?: string | undefined;
+                displayMode?: "inline" | "fullscreen" | undefined;
+                connector?: string | undefined;
+                visibility?: string[] | undefined;
+            }[];
+        }>;
+    };
+    /**
+     * A page's HTML (its first content), as the MCP server gives it. Only `ui://`
+     * URIs (`invalid_params` otherwise); one over 4 MB is refused (`too_large`).
+     * `meta` is the content's `_meta`: CSP domains, display modes, border.
+     */
+    readonly "mcp.resource": {
+        readonly params: z.ZodObject<{
+            sessionId: z.ZodString;
+            server: z.ZodString;
+            uri: z.ZodString;
+            /** The page's connector (`detail.app.connector`, `McpApp.connector`), for server `codex_apps`. */
+            connector: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            uri: string;
+            server: string;
+            sessionId: string;
+            connector?: string | undefined;
+        }, {
+            uri: string;
+            server: string;
+            sessionId: string;
+            connector?: string | undefined;
+        }>;
+        readonly result: z.ZodObject<{
+            mimeType: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            blob: z.ZodOptional<z.ZodString>;
+            meta: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            text?: string | undefined;
+            mimeType?: string | undefined;
+            blob?: string | undefined;
+            meta?: unknown;
+        }, {
+            text?: string | undefined;
+            mimeType?: string | undefined;
+            blob?: string | undefined;
+            meta?: unknown;
+        }>;
+    };
+    /**
+     * A page calls one of its server's tools, in the session's thread. Refused
+     * (`forbidden`) for a server without a page, a tool the page may not call
+     * (`ui.visibility` without "app", `openai/fileParams`), or, on `codex_apps`, a
+     * tool of another connector than `connector` (required there:
+     * `invalid_params` without it); `not_found` for a tool the server doesn't
+     * have. Codex's own failure is `agent_error`; a tool that ran and failed is
+     * `isError` in the result.
+     */
+    readonly "mcp.call": {
+        readonly params: z.ZodObject<{
+            sessionId: z.ZodString;
+            server: z.ZodString;
+            tool: z.ZodString;
+            arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            connector: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            server: string;
+            tool: string;
+            sessionId: string;
+            connector?: string | undefined;
+            arguments?: Record<string, unknown> | undefined;
+        }, {
+            server: string;
+            tool: string;
+            sessionId: string;
+            connector?: string | undefined;
+            arguments?: Record<string, unknown> | undefined;
+        }>;
+        readonly result: z.ZodObject<{
+            content: z.ZodArray<z.ZodUnknown, "many">;
+            structuredContent: z.ZodOptional<z.ZodUnknown>;
+            isError: z.ZodOptional<z.ZodBoolean>;
+            meta: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            content: unknown[];
+            meta?: unknown;
+            structuredContent?: unknown;
+            isError?: boolean | undefined;
+        }, {
+            content: unknown[];
+            meta?: unknown;
+            structuredContent?: unknown;
+            isError?: boolean | undefined;
+        }>;
+    };
+};

package/dist/wire/src/rpc-mcp.js

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { mcpAppDisplayModeSchema } from "./updates.js";
+// MCP Apps: an MCP tool can declare a page of its own (a `ui://` HTML
+// resource) that the client shows in a sandboxed frame, and that page can call
+// its server's tools back. Codex sessions only: Codex is the agent that tells
+// the host which tools have pages and lets a client read and call them. Other
+// agents' sessions are refused with `not_supported`; a Codex that isn't
+// running with `agent_unavailable`. Hosts older than these methods answer
+// "method not found".
+/** A tool Codex offers as an app of the thread (what its "插件和 MCP" menu lists). */
+export const mcpAppSchema = z.object({
+    server: z.string(),
+    tool: z.string(),
+    /** The plugin's or connector's name where there is one, else the tool's. */
+    title: z.string(),
+    description: z.string().optional(),
+    /** Always `ui://…`. */
+    resourceUri: z.string(),
+    /** Where Codex offers it (`openai/ui.entrypoints[].type`): always includes "thread". */
+    entrypoints: z.array(z.string()),
+    /** Who may call the tool (`ui.visibility`: "model", "app"); absent: both. */
+    visibility: z.array(z.string()).optional(),
+    displayMode: mcpAppDisplayModeSchema.optional(),
+    /** The Codex connector (server `codex_apps`): `mcp.call` needs it there. */
+    connector: z.string().optional(),
+});
+export const mcpMethods = {
+    /** The apps the session's Codex can open in the thread. */
+    "mcp.apps": {
+        params: z.object({ sessionId: z.string().min(1) }),
+        result: z.object({ apps: z.array(mcpAppSchema) }),
+    },
+    /**
+     * A page's HTML (its first content), as the MCP server gives it. Only `ui://`
+     * URIs (`invalid_params` otherwise); one over 4 MB is refused (`too_large`).
+     * `meta` is the content's `_meta`: CSP domains, display modes, border.
+     */
+    "mcp.resource": {
+        params: z.object({
+            sessionId: z.string().min(1),
+            server: z.string().min(1),
+            uri: z.string().min(1),
+            /** The page's connector (`detail.app.connector`, `McpApp.connector`), for server `codex_apps`. */
+            connector: z.string().optional(),
+        }),
+        result: z.object({
+            mimeType: z.string().optional(),
+            text: z.string().optional(),
+            blob: z.string().optional(),
+            meta: z.unknown().optional(),
+        }),
+    },
+    /**
+     * A page calls one of its server's tools, in the session's thread. Refused
+     * (`forbidden`) for a server without a page, a tool the page may not call
+     * (`ui.visibility` without "app", `openai/fileParams`), or, on `codex_apps`, a
+     * tool of another connector than `connector` (required there:
+     * `invalid_params` without it); `not_found` for a tool the server doesn't
+     * have. Codex's own failure is `agent_error`; a tool that ran and failed is
+     * `isError` in the result.
+     */
+    "mcp.call": {
+        params: z.object({
+            sessionId: z.string().min(1),
+            server: z.string().min(1),
+            tool: z.string().min(1),
+            arguments: z.record(z.unknown()).optional(),
+            connector: z.string().optional(),
+        }),
+        result: z.object({
+            content: z.array(z.unknown()),
+            structuredContent: z.unknown().optional(),
+            isError: z.boolean().optional(),
+            meta: z.unknown().optional(),
+        }),
+    },
+};
+//# sourceMappingURL=rpc-mcp.js.map

package/dist/wire/src/rpc-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-mcp.js","sourceRoot":"","sources":["../../../../wire/src/rpc-mcp.ts"],"names":[],"mappings":"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"}