@executor-js/plugin-mcp 1.5.2 → 1.5.4

package/dist/sdk/types.d.ts

@@ -0,0 +1,110 @@
+import { Schema } from "effect";
+export declare const McpRemoteTransport: Schema.Literals<readonly ["streamable-http", "sse", "auto"]>;
+export type McpRemoteTransport = typeof McpRemoteTransport.Type;
+/** All transport types (used in the connector layer) */
+export declare const McpTransport: Schema.Literals<readonly ["streamable-http", "sse", "stdio", "auto"]>;
+export type McpTransport = typeof McpTransport.Type;
+export declare const McpAuthTemplate: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"none">;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"header">;
+    readonly headerName: Schema.String;
+    readonly prefix: Schema.optional<Schema.String>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"oauth2">;
+}>]>;
+export type McpAuthTemplate = typeof McpAuthTemplate.Type;
+export declare const McpRemoteIntegrationConfig: Schema.Struct<{
+    readonly transport: Schema.Literal<"remote">;
+    /** The MCP server endpoint URL */
+    readonly endpoint: Schema.String;
+    /** Transport preference for this remote server */
+    readonly remoteTransport: Schema.withConstructorDefault<Schema.optionalKey<Schema.Literals<readonly ["streamable-http", "sse", "auto"]>>>;
+    /** Static query params appended to the endpoint URL (non-credential) */
+    readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    /** Static headers sent on every request (non-credential) */
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    /** Auth template — how the connection's value is rendered onto requests */
+    readonly auth: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"none">;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"header">;
+        readonly headerName: Schema.String;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"oauth2">;
+    }>]>;
+}>;
+export type McpRemoteIntegrationConfig = typeof McpRemoteIntegrationConfig.Type;
+export declare const McpStdioIntegrationConfig: Schema.Struct<{
+    readonly transport: Schema.Literal<"stdio">;
+    /** The command to run */
+    readonly command: Schema.String;
+    /** Arguments to the command */
+    readonly args: Schema.optional<Schema.$Array<Schema.String>>;
+    /** Environment variables */
+    readonly env: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    /** Working directory */
+    readonly cwd: Schema.optional<Schema.String>;
+}>;
+export type McpStdioIntegrationConfig = typeof McpStdioIntegrationConfig.Type;
+export declare const McpIntegrationConfig: Schema.Union<readonly [Schema.Struct<{
+    readonly transport: Schema.Literal<"remote">;
+    /** The MCP server endpoint URL */
+    readonly endpoint: Schema.String;
+    /** Transport preference for this remote server */
+    readonly remoteTransport: Schema.withConstructorDefault<Schema.optionalKey<Schema.Literals<readonly ["streamable-http", "sse", "auto"]>>>;
+    /** Static query params appended to the endpoint URL (non-credential) */
+    readonly queryParams: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    /** Static headers sent on every request (non-credential) */
+    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    /** Auth template — how the connection's value is rendered onto requests */
+    readonly auth: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"none">;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"header">;
+        readonly headerName: Schema.String;
+        readonly prefix: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"oauth2">;
+    }>]>;
+}>, Schema.Struct<{
+    readonly transport: Schema.Literal<"stdio">;
+    /** The command to run */
+    readonly command: Schema.String;
+    /** Arguments to the command */
+    readonly args: Schema.optional<Schema.$Array<Schema.String>>;
+    /** Environment variables */
+    readonly env: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    /** Working directory */
+    readonly cwd: Schema.optional<Schema.String>;
+}>]>;
+export type McpIntegrationConfig = typeof McpIntegrationConfig.Type;
+/** Parse an opaque integration `config` blob into a typed MCP config, or null
+ *  if it isn't this plugin's shape. */
+export declare const parseMcpIntegrationConfig: (config: unknown) => McpIntegrationConfig | null;
+export declare const McpToolAnnotations: Schema.Struct<{
+    readonly title: Schema.optional<Schema.String>;
+    readonly readOnlyHint: Schema.optional<Schema.Boolean>;
+    readonly destructiveHint: Schema.optional<Schema.Boolean>;
+    readonly idempotentHint: Schema.optional<Schema.Boolean>;
+    readonly openWorldHint: Schema.optional<Schema.Boolean>;
+}>;
+export type McpToolAnnotations = typeof McpToolAnnotations.Type;
+export declare const McpToolBinding: Schema.Struct<{
+    /** Sanitized, address-safe tool name (the `<tool>` address segment). */
+    readonly toolId: Schema.String;
+    /** The real MCP tool name as advertised by the server. */
+    readonly toolName: Schema.String;
+    readonly description: Schema.NullOr<Schema.String>;
+    readonly inputSchema: Schema.optional<Schema.Unknown>;
+    readonly outputSchema: Schema.optional<Schema.Unknown>;
+    readonly annotations: Schema.optional<Schema.Struct<{
+        readonly title: Schema.optional<Schema.String>;
+        readonly readOnlyHint: Schema.optional<Schema.Boolean>;
+        readonly destructiveHint: Schema.optional<Schema.Boolean>;
+        readonly idempotentHint: Schema.optional<Schema.Boolean>;
+        readonly openWorldHint: Schema.optional<Schema.Boolean>;
+    }>>;
+}>;
+export type McpToolBinding = typeof McpToolBinding.Type;

package/dist/testing/index.d.ts

@@ -0,0 +1 @@
+export { McpTestServerError, McpTestServerLayer, makeAnnotationsMcpServer, makeEchoMcpServer, makeElicitationMcpServer, makeGreetingMcpServer, serveMcpServer, serveMcpServerWithOAuth, type McpTestRequest, type McpTestServer, type McpTestServerOptions, } from "./server";

package/dist/testing/server.d.ts

@@ -0,0 +1,76 @@
+import { Context, Effect, Layer, Scope } from "effect";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { OAuthTestServer } from "@executor-js/sdk/testing";
+export type McpTestServer = {
+    readonly url: string;
+    readonly endpoint: string;
+    /** Number of MCP sessions created (each connect = 1 session) */
+    readonly sessionCount: () => number;
+    readonly requests: Effect.Effect<readonly McpTestRequest[]>;
+    readonly clearRequests: Effect.Effect<void>;
+};
+export type McpTestRequest = {
+    readonly method: string;
+    readonly url: string;
+    readonly authorization: string | undefined;
+    readonly sessionId: string | undefined;
+};
+export type McpTestServerOptions = {
+    readonly path?: string;
+    readonly auth?: {
+        readonly validateAuthorization: (authorization: string | undefined) => Effect.Effect<boolean>;
+        readonly authorizationServerUrls?: readonly string[];
+        readonly scopes?: readonly string[];
+        readonly wwwAuthenticate?: string;
+    };
+};
+declare const McpTestServerError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "McpTestServerError";
+} & Readonly<A>;
+export declare class McpTestServerError extends McpTestServerError_base<{
+    readonly cause: unknown;
+}> {
+}
+export declare const serveMcpServer: (factory: () => McpServer, options?: McpTestServerOptions) => Effect.Effect<{
+    url: string;
+    endpoint: string;
+    sessionCount: () => number;
+    requests: Effect.Effect<readonly McpTestRequest[], never, never>;
+    clearRequests: Effect.Effect<void, never, never>;
+}, McpTestServerError, Scope.Scope>;
+export declare const serveMcpServerWithOAuth: (factory: () => McpServer, options?: Omit<McpTestServerOptions, "auth"> & {
+    readonly scopes?: readonly string[];
+    readonly wwwAuthenticate?: string;
+}) => Effect.Effect<{
+    url: string;
+    endpoint: string;
+    sessionCount: () => number;
+    requests: Effect.Effect<readonly McpTestRequest[], never, never>;
+    clearRequests: Effect.Effect<void, never, never>;
+}, McpTestServerError, Scope.Scope | OAuthTestServer>;
+declare const McpTestServerLayer_base: Context.ServiceClass<McpTestServerLayer, "@executor-js/plugin-mcp/testing/McpTestServer", McpTestServer>;
+export declare class McpTestServerLayer extends McpTestServerLayer_base {
+    static readonly layer: (factory: () => McpServer, options?: McpTestServerOptions) => Layer.Layer<McpTestServerLayer, McpTestServerError, Scope.Scope>;
+    static readonly layerWithOAuth: (factory: () => McpServer, options?: Omit<McpTestServerOptions, "auth"> & {
+        readonly scopes?: readonly string[];
+        readonly wwwAuthenticate?: string;
+    }) => Layer.Layer<McpTestServerLayer, McpTestServerError, Scope.Scope | OAuthTestServer>;
+}
+export declare const makeGreetingMcpServer: (options?: {
+    readonly name?: string;
+    readonly version?: string;
+    readonly toolName?: string;
+    readonly toolDescription?: string;
+    readonly text?: string;
+}) => McpServer;
+export declare const makeEchoMcpServer: (options?: {
+    readonly name?: string;
+    readonly version?: string;
+    readonly toolName?: string;
+    readonly toolDescription?: string;
+    readonly inputName?: "name" | "value" | "marker";
+    readonly text?: (value: string) => string;
+}) => McpServer;
+export declare const makeElicitationMcpServer: () => McpServer;
+export declare const makeAnnotationsMcpServer: () => McpServer;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@executor-js/plugin-mcp",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "homepage": "https://github.com/RhysSullivan/executor/tree/main/packages/plugins/mcp",
   "bugs": {
     "url": "https://github.com/RhysSullivan/executor/issues"
@@ -53,28 +53,28 @@
   },
   "dependencies": {
     "@cfworker/json-schema": "^4.1.1",
-    "@effect/platform-node": "catalog:",
-    "@executor-js/config": "1.5.2",
-    "@executor-js/sdk": "1.5.2",
+    "@effect/platform-node": "4.0.0-beta.59",
+    "@executor-js/config": "1.5.4",
+    "@executor-js/sdk": "1.5.4",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@effect/atom-react": "catalog:",
-    "@effect/vitest": "catalog:",
-    "@types/node": "catalog:",
-    "@types/react": "catalog:",
-    "bun-types": "catalog:",
-    "effect": "catalog:",
-    "react": "catalog:",
-    "tsup": "catalog:",
-    "vitest": "catalog:"
+    "@effect/atom-react": "4.0.0-beta.59",
+    "@effect/vitest": "4.0.0-beta.59",
+    "@types/node": "^24.3.1",
+    "@types/react": "^19.1.0",
+    "bun-types": "^1.2.22",
+    "effect": "4.0.0-beta.59",
+    "react": "^19.1.0",
+    "tsup": "^8.5.0",
+    "vitest": "^4.1.5"
   },
   "peerDependencies": {
-    "@effect/atom-react": "catalog:",
-    "@tanstack/react-router": "catalog:",
-    "effect": "catalog:",
-    "react": "catalog:"
+    "@effect/atom-react": "4.0.0-beta.59",
+    "@tanstack/react-router": "^1.168.10",
+    "effect": "4.0.0-beta.59",
+    "react": "^19.1.0"
   },
   "peerDependenciesMeta": {
     "react": {