@outfitter/mcp 0.4.1 → 0.4.3

package/dist/logging.d.ts

@@ -1,2 +1,2 @@
-import { McpLogLevel, mapLogLevelToMcp, shouldEmitLog } from "./shared/@outfitter/mcp-cqpyer9m";
+import { McpLogLevel, mapLogLevelToMcp, shouldEmitLog } from "./shared/@outfitter/mcp-cqpyer9m.js";
 export { shouldEmitLog, mapLogLevelToMcp, McpLogLevel };

package/dist/schema.d.ts

@@ -1,2 +1,2 @@
-import { JsonSchema, zodToJsonSchema } from "./shared/@outfitter/mcp-83zvbna8";
+import { JsonSchema, zodToJsonSchema } from "./shared/@outfitter/mcp-83zvbna8.js";
 export { zodToJsonSchema, JsonSchema };

package/dist/schema.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   zodToJsonSchema
-} from "./shared/@outfitter/mcp-zy7b487d.js";
+} from "./shared/@outfitter/mcp-hw5wz4gb.js";
 export {
   zodToJsonSchema
 };

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { createMcpServer, definePrompt, defineResource, defineResourceTemplate, defineTool } from "./shared/@outfitter/mcp-2vqyt1fj";
-import "./shared/@outfitter/mcp-h2twz77x";
-import "./shared/@outfitter/mcp-cqpyer9m";
+import { createMcpServer, definePrompt, defineResource, defineResourceTemplate, defineTool } from "./shared/@outfitter/mcp-knq080yt.js";
+import "./shared/@outfitter/mcp-gqjg15f5.js";
+import "./shared/@outfitter/mcp-cqpyer9m.js";
 export { defineTool, defineResourceTemplate, defineResource, definePrompt, createMcpServer };

package/dist/server.js

@@ -5,10 +5,10 @@ import {
   defineResource,
   defineResourceTemplate,
   defineTool
-} from "./shared/@outfitter/mcp-nmp5wf0w.js";
+} from "./shared/@outfitter/mcp-b502y16n.js";
 import"./shared/@outfitter/mcp-fjtxsa0x.js";
 import"./shared/@outfitter/mcp-9m5hs2z0.js";
-import"./shared/@outfitter/mcp-zy7b487d.js";
+import"./shared/@outfitter/mcp-hw5wz4gb.js";
 export {
   defineTool,
   defineResourceTemplate,

package/dist/shared/@outfitter/{mcp-jk0ka9hw.d.ts → mcp-7kcw2814.d.ts}

@@ -1,7 +1,7 @@
-import { McpServer } from "./mcp-h2twz77x";
-import { Server } from "@modelcontextprotocol/sdk/server/index";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { McpServer } from "./mcp-gqjg15f5.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 type McpToolResponse = CallToolResult;
 /**
 * Wrap a handler success value into an MCP CallToolResult.

package/dist/shared/@outfitter/{mcp-nmp5wf0w.js → mcp-b502y16n.js}

@@ -7,7 +7,7 @@ import {
 } from "./mcp-9m5hs2z0.js";
 import {
   zodToJsonSchema
-} from "./mcp-zy7b487d.js";
+} from "./mcp-hw5wz4gb.js";
 
 // packages/mcp/src/server.ts
 import { getEnvironment, getEnvironmentDefaults } from "@outfitter/config";

package/dist/shared/@outfitter/{mcp-a0cgfsnw.d.ts → mcp-d8vs6vry.d.ts}

@@ -1,4 +1,4 @@
-import { ToolDefinition } from "./mcp-h2twz77x";
+import { ToolDefinition } from "./mcp-gqjg15f5.js";
 import { ActionRegistry, ActionSurface, AnyActionSpec } from "@outfitter/contracts";
 interface BuildMcpToolsOptions {
 	readonly includeSurfaces?: readonly ActionSurface[];

package/dist/shared/@outfitter/{mcp-h2twz77x.d.ts → mcp-gqjg15f5.d.ts}

@@ -1,4 +1,4 @@
-import { McpLogLevel } from "./mcp-cqpyer9m";
+import { McpLogLevel } from "./mcp-cqpyer9m.js";
 import { Handler, HandlerContext, Logger, OutfitterError, Result, TaggedErrorClass } from "@outfitter/contracts";
 import { z } from "zod";
 import { Result as Result2 } from "@outfitter/contracts";
@@ -18,21 +18,6 @@ import { TaggedError } from "@outfitter/contracts";
 * ```
 */
 interface McpServerOptions {
-	/**
-	* Server name, used in MCP protocol handshake.
-	* Should be a short, descriptive identifier.
-	*/
-	name: string;
-	/**
-	* Server version (semver format recommended).
-	* Sent to clients during initialization.
-	*/
-	version: string;
-	/**
-	* Optional logger instance for server logging.
-	* If not provided, the server uses the Outfitter logger factory defaults.
-	*/
-	logger?: Logger;
 	/**
 	* Default MCP log level for client-facing log forwarding.
 	*
@@ -46,6 +31,21 @@ interface McpServerOptions {
 	* The MCP client can always override via `logging/setLevel`.
 	*/
 	defaultLogLevel?: McpLogLevel | null;
+	/**
+	* Optional logger instance for server logging.
+	* If not provided, the server uses the Outfitter logger factory defaults.
+	*/
+	logger?: Logger;
+	/**
+	* Server name, used in MCP protocol handshake.
+	* Should be a short, descriptive identifier.
+	*/
+	name: string;
+	/**
+	* Server version (semver format recommended).
+	* Sent to clients during initialization.
+	*/
+	version: string;
 }
 /**
 * Behavioral hints for MCP tools.
@@ -56,14 +56,14 @@ interface McpServerOptions {
 * @see https://spec.modelcontextprotocol.io/specification/2025-03-26/server/tools/#annotations
 */
 interface ToolAnnotations {
-	/** When true, the tool does not modify any state. */
-	readOnlyHint?: boolean;
 	/** When true, the tool may perform destructive operations (e.g., deleting data). */
 	destructiveHint?: boolean;
 	/** When true, calling the tool multiple times with the same input has the same effect. */
 	idempotentHint?: boolean;
 	/** When true, the tool may interact with external systems beyond the server. */
 	openWorldHint?: boolean;
+	/** When true, the tool does not modify any state. */
+	readOnlyHint?: boolean;
 }
 /**
 * Common annotation presets for MCP tools.
@@ -80,41 +80,11 @@ interface ToolAnnotations {
 * limitation; presets + spread cover most edge cases.
 */
 declare const TOOL_ANNOTATIONS: {
-	/** Read-only, safe to call repeatedly. */
-	readonly readOnly: {
-		readonly readOnlyHint: true;
-		readonly destructiveHint: false;
-		readonly idempotentHint: true;
-		readonly openWorldHint: false;
-	};
-	/** Creates or updates state, not destructive. */
-	readonly write: {
-		readonly readOnlyHint: false;
-		readonly destructiveHint: false;
-		readonly idempotentHint: false;
-		readonly openWorldHint: false;
-	};
-	/** Idempotent write (PUT-like). */
-	readonly writeIdempotent: {
-		readonly readOnlyHint: false;
-		readonly destructiveHint: false;
-		readonly idempotentHint: true;
-		readonly openWorldHint: false;
-	};
-	/** Deletes or permanently modifies data. */
-	readonly destructive: {
-		readonly readOnlyHint: false;
-		readonly destructiveHint: true;
-		readonly idempotentHint: true;
-		readonly openWorldHint: false;
-	};
-	/** Interacts with external systems (APIs, network). */
-	readonly openWorld: {
-		readonly readOnlyHint: false;
-		readonly destructiveHint: false;
-		readonly idempotentHint: false;
-		readonly openWorldHint: true;
-	};
+	readonly destructive: ToolAnnotations;
+	readonly openWorld: ToolAnnotations;
+	readonly readOnly: ToolAnnotations;
+	readonly write: ToolAnnotations;
+	readonly writeIdempotent: ToolAnnotations;
 };
 /**
 * Definition of an MCP tool that can be invoked by clients.
@@ -158,51 +128,51 @@ interface ToolDefinition<
 	TError extends OutfitterError = OutfitterError
 > {
 	/**
-	* Unique tool name (kebab-case recommended).
-	* Used by clients to invoke the tool.
+	* Optional behavioral annotations for the tool.
+	* Helps clients understand tool behavior without invoking it.
 	*/
-	name: string;
+	annotations?: ToolAnnotations;
+	/**
+	* Whether the tool should be deferred for tool search.
+	* Defaults to true for domain tools; core tools set this to false.
+	*/
+	deferLoading?: boolean;
 	/**
 	* Human-readable description of what the tool does.
 	* Shown to clients and used by LLMs to understand tool capabilities.
 	*/
 	description: string;
 	/**
-	* Whether the tool should be deferred for tool search.
-	* Defaults to true for domain tools; core tools set this to false.
+	* Handler function that processes the tool invocation.
+	* Receives validated input and HandlerContext, returns Result.
 	*/
-	deferLoading?: boolean;
+	handler: Handler<TInput, TOutput, TError>;
 	/**
 	* Zod schema for validating and parsing input.
 	* The schema defines the expected input structure.
 	*/
 	inputSchema: z.ZodType<TInput>;
 	/**
-	* Optional behavioral annotations for the tool.
-	* Helps clients understand tool behavior without invoking it.
-	*/
-	annotations?: ToolAnnotations;
-	/**
-	* Handler function that processes the tool invocation.
-	* Receives validated input and HandlerContext, returns Result.
+	* Unique tool name (kebab-case recommended).
+	* Used by clients to invoke the tool.
 	*/
-	handler: Handler<TInput, TOutput, TError>;
+	name: string;
 }
 /**
 * Serialized tool information for MCP protocol.
 * This is the format sent to clients during tool listing.
 */
 interface SerializedTool {
-	/** Tool name */
-	name: string;
+	/** Behavioral annotations for the tool */
+	annotations?: ToolAnnotations;
+	/** MCP tool-search hint: whether tool is deferred */
+	defer_loading?: boolean;
 	/** Tool description */
 	description: string;
 	/** JSON Schema representation of the input schema */
 	inputSchema: Record<string, unknown>;
-	/** MCP tool-search hint: whether tool is deferred */
-	defer_loading?: boolean;
-	/** Behavioral annotations for the tool */
-	annotations?: ToolAnnotations;
+	/** Tool name */
+	name: string;
 }
 /**
 * Annotations for content items (resource content, prompt messages).
@@ -226,27 +196,27 @@ interface ContentAnnotations {
 * Text content returned from a resource read.
 */
 interface TextResourceContent {
-	/** Resource URI */
-	uri: string;
-	/** Text content */
-	text: string;
-	/** Optional MIME type */
-	mimeType?: string;
 	/** Optional content annotations */
 	annotations?: ContentAnnotations;
+	/** Optional MIME type */
+	mimeType?: string;
+	/** Text content */
+	text: string;
+	/** Resource URI */
+	uri: string;
 }
 /**
 * Binary (base64-encoded) content returned from a resource read.
 */
 interface BlobResourceContent {
-	/** Resource URI */
-	uri: string;
+	/** Optional content annotations */
+	annotations?: ContentAnnotations;
 	/** Base64-encoded binary content */
 	blob: string;
 	/** Optional MIME type */
 	mimeType?: string;
-	/** Optional content annotations */
-	annotations?: ContentAnnotations;
+	/** Resource URI */
+	uri: string;
 }
 /**
 * Content returned from reading a resource.
@@ -281,31 +251,31 @@ type ResourceReadHandler = (uri: string, ctx: HandlerContext) => Promise<Result<
 * ```
 */
 interface ResourceDefinition {
-	/**
-	* Unique resource URI.
-	* Must be a valid URI (file://, https://, custom://, etc.).
-	*/
-	uri: string;
-	/**
-	* Human-readable resource name.
-	* Displayed to users in resource listings.
-	*/
-	name: string;
 	/**
 	* Optional description of the resource.
 	* Provides additional context about the resource contents.
 	*/
 	description?: string;
 	/**
+	* Optional handler for reading the resource content.
+	* If not provided, the resource is metadata-only.
+	*/
+	handler?: ResourceReadHandler;
+	/**
 	* Optional MIME type of the resource content.
 	* Helps clients understand how to process the resource.
 	*/
 	mimeType?: string;
 	/**
-	* Optional handler for reading the resource content.
-	* If not provided, the resource is metadata-only.
+	* Human-readable resource name.
+	* Displayed to users in resource listings.
 	*/
-	handler?: ResourceReadHandler;
+	name: string;
+	/**
+	* Unique resource URI.
+	* Must be a valid URI (file://, https://, custom://, etc.).
+	*/
+	uri: string;
 }
 /**
 * Handler for reading a resource template's content.
@@ -334,29 +304,29 @@ type ResourceTemplateReadHandler = (uri: string, variables: Record<string, strin
 * ```
 */
 interface ResourceTemplateDefinition {
-	/** URI template with `{param}` placeholders (RFC 6570 Level 1). */
-	uriTemplate: string;
-	/** Human-readable name for the template. */
-	name: string;
-	/** Optional description. */
-	description?: string;
-	/** Optional MIME type. */
-	mimeType?: string;
 	/** Optional completion handlers keyed by parameter name. */
 	complete?: Record<string, CompletionHandler>;
+	/** Optional description. */
+	description?: string;
 	/** Handler for reading matched resources. */
 	handler: ResourceTemplateReadHandler;
+	/** Optional MIME type. */
+	mimeType?: string;
+	/** Human-readable name for the template. */
+	name: string;
+	/** URI template with `{param}` placeholders (RFC 6570 Level 1). */
+	uriTemplate: string;
 }
 /**
 * Result of a completion request.
 */
 interface CompletionResult {
-	/** Completion values */
-	values: string[];
-	/** Total number of available values (for pagination) */
-	total?: number;
 	/** Whether there are more values */
 	hasMore?: boolean;
+	/** Total number of available values (for pagination) */
+	total?: number;
+	/** Completion values */
+	values: string[];
 }
 /**
 * Handler for generating completions.
@@ -376,43 +346,43 @@ type CompletionRef = {
 * Argument definition for a prompt.
 */
 interface PromptArgument {
-	/** Argument name */
-	name: string;
+	/** Optional completion handler for this argument */
+	complete?: CompletionHandler;
 	/** Human-readable description */
 	description?: string;
+	/** Argument name */
+	name: string;
 	/** Whether this argument is required */
 	required?: boolean;
-	/** Optional completion handler for this argument */
-	complete?: CompletionHandler;
 }
 /**
 * Content block within a prompt message.
 */
 interface PromptMessageContent {
-	/** Content type */
-	type: "text";
-	/** Text content */
-	text: string;
 	/** Optional content annotations */
 	annotations?: ContentAnnotations;
+	/** Text content */
+	text: string;
+	/** Content type */
+	type: "text";
 }
 /**
 * A message in a prompt response.
 */
 interface PromptMessage {
-	/** Message role */
-	role: "user" | "assistant";
 	/** Message content */
 	content: PromptMessageContent;
+	/** Message role */
+	role: "user" | "assistant";
 }
 /**
 * Result returned from getting a prompt.
 */
 interface PromptResult {
-	/** Prompt messages */
-	messages: PromptMessage[];
 	/** Optional description override */
 	description?: string;
+	/** Prompt messages */
+	messages: PromptMessage[];
 }
 /**
 * Handler for generating prompt messages.
@@ -438,14 +408,14 @@ type PromptHandler = (args: Record<string, string | undefined>) => Promise<Resul
 * ```
 */
 interface PromptDefinition {
-	/** Unique prompt name */
-	name: string;
-	/** Human-readable description */
-	description?: string;
 	/** Prompt arguments */
 	arguments: PromptArgument[];
+	/** Human-readable description */
+	description?: string;
 	/** Handler to generate messages */
 	handler: PromptHandler;
+	/** Unique prompt name */
+	name: string;
 }
 declare const McpErrorBase: TaggedErrorClass<"McpError", {
 	message: string;
@@ -483,12 +453,12 @@ declare class McpError extends McpErrorBase {
 * Options for invoking a tool.
 */
 interface InvokeToolOptions {
-	/** Abort signal for cancellation */
-	signal?: AbortSignal;
-	/** Custom request ID (auto-generated if not provided) */
-	requestId?: string;
 	/** Progress token from client for tracking progress */
 	progressToken?: string | number;
+	/** Custom request ID (auto-generated if not provided) */
+	requestId?: string;
+	/** Abort signal for cancellation */
+	signal?: AbortSignal;
 }
 /**
 * MCP Server instance.
@@ -510,44 +480,12 @@ interface InvokeToolOptions {
 * ```
 */
 interface McpServer {
-	/** Server name */
-	readonly name: string;
-	/** Server version */
-	readonly version: string;
-	/**
-	* Register a tool with the server.
-	* @param tool - Tool definition to register
-	*/
-	registerTool<
-		TInput,
-		TOutput,
-		TError extends OutfitterError
-	>(tool: ToolDefinition<TInput, TOutput, TError>): void;
-	/**
-	* Register a resource with the server.
-	* @param resource - Resource definition to register
-	*/
-	registerResource(resource: ResourceDefinition): void;
-	/**
-	* Get all registered tools.
-	* @returns Array of serialized tool information
-	*/
-	getTools(): SerializedTool[];
-	/**
-	* Register a resource template with the server.
-	* @param template - Resource template definition to register
-	*/
-	registerResourceTemplate(template: ResourceTemplateDefinition): void;
-	/**
-	* Get all registered resources.
-	* @returns Array of resource definitions
-	*/
-	getResources(): ResourceDefinition[];
 	/**
-	* Get all registered resource templates.
-	* @returns Array of resource template definitions
+	* Bind the SDK server instance for notifications.
+	* Called internally by the transport layer.
+	* @param sdkServer - The MCP SDK Server instance
 	*/
-	getResourceTemplates(): ResourceTemplateDefinition[];
+	bindSdkServer?(sdkServer: any): void;
 	/**
 	* Complete an argument value.
 	* @param ref - Reference to the prompt or resource template
@@ -557,10 +495,12 @@ interface McpServer {
 	*/
 	complete(ref: CompletionRef, argumentName: string, value: string): Promise<Result<CompletionResult, InstanceType<typeof McpError>>>;
 	/**
-	* Register a prompt with the server.
-	* @param prompt - Prompt definition to register
+	* Get a specific prompt's messages.
+	* @param name - Prompt name
+	* @param args - Prompt arguments
+	* @returns Result with prompt result or McpError
 	*/
-	registerPrompt(prompt: PromptDefinition): void;
+	getPrompt(name: string, args: Record<string, string | undefined>): Promise<Result<PromptResult, InstanceType<typeof McpError>>>;
 	/**
 	* Get all registered prompts.
 	* @returns Array of prompt definitions (without handlers)
@@ -571,18 +511,20 @@ interface McpServer {
 		arguments: PromptArgument[];
 	}>;
 	/**
-	* Get a specific prompt's messages.
-	* @param name - Prompt name
-	* @param args - Prompt arguments
-	* @returns Result with prompt result or McpError
+	* Get all registered resources.
+	* @returns Array of resource definitions
 	*/
-	getPrompt(name: string, args: Record<string, string | undefined>): Promise<Result<PromptResult, InstanceType<typeof McpError>>>;
+	getResources(): ResourceDefinition[];
 	/**
-	* Read a resource by URI.
-	* @param uri - Resource URI
-	* @returns Result with resource content or McpError
+	* Get all registered resource templates.
+	* @returns Array of resource template definitions
 	*/
-	readResource(uri: string): Promise<Result<ResourceContent[], InstanceType<typeof McpError>>>;
+	getResourceTemplates(): ResourceTemplateDefinition[];
+	/**
+	* Get all registered tools.
+	* @returns Array of serialized tool information
+	*/
+	getTools(): SerializedTool[];
 	/**
 	* Invoke a tool by name.
 	* @param name - Tool name
@@ -591,16 +533,16 @@ interface McpServer {
 	* @returns Result with tool output or McpError
 	*/
 	invokeTool<T = unknown>(name: string, input: unknown, options?: InvokeToolOptions): Promise<Result<T, InstanceType<typeof McpError>>>;
+	/** Server name */
+	readonly name: string;
 	/**
-	* Subscribe to updates for a resource URI.
-	* @param uri - Resource URI to subscribe to
+	* Notify connected clients that the prompt list has changed.
 	*/
-	subscribe(uri: string): void;
+	notifyPromptsChanged(): void;
 	/**
-	* Unsubscribe from updates for a resource URI.
-	* @param uri - Resource URI to unsubscribe from
+	* Notify connected clients that the resource list has changed.
 	*/
-	unsubscribe(uri: string): void;
+	notifyResourcesChanged(): void;
 	/**
 	* Notify connected clients that a specific resource has been updated.
 	* Only emits for subscribed URIs.
@@ -612,19 +554,35 @@ interface McpServer {
 	*/
 	notifyToolsChanged(): void;
 	/**
-	* Notify connected clients that the resource list has changed.
+	* Read a resource by URI.
+	* @param uri - Resource URI
+	* @returns Result with resource content or McpError
 	*/
-	notifyResourcesChanged(): void;
+	readResource(uri: string): Promise<Result<ResourceContent[], InstanceType<typeof McpError>>>;
 	/**
-	* Notify connected clients that the prompt list has changed.
+	* Register a prompt with the server.
+	* @param prompt - Prompt definition to register
 	*/
-	notifyPromptsChanged(): void;
+	registerPrompt(prompt: PromptDefinition): void;
 	/**
-	* Set the client-requested log level.
-	* Only log messages at or above this level will be forwarded.
-	* @param level - MCP log level string
+	* Register a resource with the server.
+	* @param resource - Resource definition to register
 	*/
-	setLogLevel?(level: string): void;
+	registerResource(resource: ResourceDefinition): void;
+	/**
+	* Register a resource template with the server.
+	* @param template - Resource template definition to register
+	*/
+	registerResourceTemplate(template: ResourceTemplateDefinition): void;
+	/**
+	* Register a tool with the server.
+	* @param tool - Tool definition to register
+	*/
+	registerTool<
+		TInput,
+		TOutput,
+		TError extends OutfitterError
+	>(tool: ToolDefinition<TInput, TOutput, TError>): void;
 	/**
 	* Send a log message to connected clients.
 	* Filters by the client-requested log level threshold.
@@ -636,11 +594,11 @@ interface McpServer {
 	*/
 	sendLogMessage(level: McpLogLevel, data: unknown, loggerName?: string): void;
 	/**
-	* Bind the SDK server instance for notifications.
-	* Called internally by the transport layer.
-	* @param sdkServer - The MCP SDK Server instance
+	* Set the client-requested log level.
+	* Only log messages at or above this level will be forwarded.
+	* @param level - MCP log level string
 	*/
-	bindSdkServer?(sdkServer: any): void;
+	setLogLevel?(level: string): void;
 	/**
 	* Start the MCP server.
 	* Begins listening for client connections.
@@ -651,6 +609,18 @@ interface McpServer {
 	* Closes all connections and cleans up resources.
 	*/
 	stop(): Promise<void>;
+	/**
+	* Subscribe to updates for a resource URI.
+	* @param uri - Resource URI to subscribe to
+	*/
+	subscribe(uri: string): void;
+	/**
+	* Unsubscribe from updates for a resource URI.
+	* @param uri - Resource URI to unsubscribe from
+	*/
+	unsubscribe(uri: string): void;
+	/** Server version */
+	readonly version: string;
 }
 /**
 * Reporter for sending progress updates to clients.
@@ -669,10 +639,10 @@ interface ProgressReporter {
 * Includes MCP-specific information in addition to standard HandlerContext.
 */
 interface McpHandlerContext extends HandlerContext {
-	/** The name of the tool being invoked */
-	toolName?: string;
 	/** Progress reporter, present when client provides a progressToken */
 	progress?: ProgressReporter;
+	/** The name of the tool being invoked */
+	toolName?: string;
 }
 /**
 * Adapt a handler with a domain error type for use with MCP tools.

package/dist/shared/@outfitter/mcp-hw5wz4gb.js

@@ -0,0 +1 @@
+export { zodToJsonSchema } from "@outfitter/contracts/schema";