@outfitter/mcp 0.4.2 → 0.5.0

package/dist/index.d.ts

@@ -1,953 +1,14 @@
-import { ActionRegistry, ActionSurface, AnyActionSpec } from "@outfitter/contracts";
-import { Handler, HandlerContext, Logger, OutfitterError, Result, TaggedErrorClass } from "@outfitter/contracts";
-import { z } from "zod";
-/**
-* @outfitter/mcp - Logging Bridge
-*
-* Maps Outfitter log levels to MCP log levels for
-* server-to-client log message notifications.
-*
-* @packageDocumentation
-*/
-/**
-* MCP log levels as defined in the MCP specification.
-* Ordered from least to most severe.
-*/
-type McpLogLevel = "debug" | "info" | "notice" | "warning" | "error" | "critical" | "alert" | "emergency";
-/**
-* Outfitter log levels.
-*/
-type OutfitterLogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
-/**
-* Map an Outfitter log level to the corresponding MCP log level.
-*/
-declare function mapLogLevelToMcp(level: OutfitterLogLevel): McpLogLevel;
-/**
-* Check whether a message at the given level should be emitted
-* based on the client-requested threshold.
-*/
-declare function shouldEmitLog(messageLevel: McpLogLevel, threshold: McpLogLevel): boolean;
-/**
-* Configuration options for creating an MCP server.
-*
-* @example
-* ```typescript
-* const options: McpServerOptions = {
-*   name: "my-mcp-server",
-*   version: "1.0.0",
-*   logger: createLogger({ name: "mcp" }),
-* };
-*
-* const server = createMcpServer(options);
-* ```
-*/
-interface McpServerOptions {
-	/**
-	* Default MCP log level for client-facing log forwarding.
-	*
-	* Precedence (highest wins):
-	* 1. `OUTFITTER_LOG_LEVEL` environment variable
-	* 2. This option
-	* 3. Environment profile (`OUTFITTER_ENV`)
-	* 4. `null` (no forwarding until client opts in)
-	*
-	* Set to `null` to explicitly disable forwarding regardless of environment.
-	* 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.
-*
-* Annotations help clients understand tool behavior without invoking them.
-* All fields are optional — only include hints that apply.
-*
-* @see https://spec.modelcontextprotocol.io/specification/2025-03-26/server/tools/#annotations
-*/
-interface ToolAnnotations {
-	/** 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.
-*
-* Use these as a starting point and spread-override individual hints:
-*
-* ```typescript
-* annotations: { ...TOOL_ANNOTATIONS.readOnly, openWorldHint: true }
-* ```
-*
-* For multi-action tools (e.g., a single tool with read and write actions),
-* use the most conservative union of hints — if any action is destructive,
-* mark the whole tool as destructive. Per-action annotations are an MCP spec
-* 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;
-	};
-};
-/**
-* Definition of an MCP tool that can be invoked by clients.
-*
-* Tools are the primary way clients interact with MCP servers.
-* Each tool has a name, description, input schema (for validation),
-* and a handler function that processes requests.
-*
-* @typeParam TInput - The validated input type (inferred from Zod schema)
-* @typeParam TOutput - The success output type
-* @typeParam TError - The error type (must extend OutfitterError)
-*
-* @example
-* ```typescript
-* const getUserTool: ToolDefinition<
-*   { userId: string },
-*   { name: string; email: string },
-*   NotFoundError
-* > = {
-*   name: "get-user",
-*   description: "Retrieve a user by ID",
-*   inputSchema: z.object({ userId: z.string().uuid() }),
-*   handler: async (input, ctx) => {
-*     ctx.logger.debug("Fetching user", { userId: input.userId });
-*     const user = await db.users.find(input.userId);
-*     if (!user) {
-*       return Result.err(new NotFoundError({
-*         message: `User ${input.userId} not found`,
-*         resourceType: "user",
-*         resourceId: input.userId,
-*       }));
-*     }
-*     return Result.ok({ name: user.name, email: user.email });
-*   },
-* };
-* ```
-*/
-interface ToolDefinition<
-	TInput,
-	TOutput,
-	TError extends OutfitterError = OutfitterError
-> {
-	/**
-	* Optional behavioral annotations for the tool.
-	* Helps clients understand tool behavior without invoking it.
-	*/
-	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;
-	/**
-	* Handler function that processes the tool invocation.
-	* Receives validated input and HandlerContext, returns Result.
-	*/
-	handler: Handler<TInput, TOutput, TError>;
-	/**
-	* Zod schema for validating and parsing input.
-	* The schema defines the expected input structure.
-	*/
-	inputSchema: z.ZodType<TInput>;
-	/**
-	* Unique tool name (kebab-case recommended).
-	* Used by clients to invoke the tool.
-	*/
-	name: string;
-}
-/**
-* Serialized tool information for MCP protocol.
-* This is the format sent to clients during tool listing.
-*/
-interface SerializedTool {
-	/** 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>;
-	/** Tool name */
-	name: string;
-}
-/**
-* Annotations for content items (resource content, prompt messages).
-*
-* Provides hints about content audience and priority.
-*
-* @see https://spec.modelcontextprotocol.io/specification/2025-03-26/server/utilities/annotations/
-*/
-interface ContentAnnotations {
-	/**
-	* Who the content is intended for.
-	* Can include "user", "assistant", or both.
-	*/
-	audience?: Array<"user" | "assistant">;
-	/**
-	* Priority level from 0.0 (least) to 1.0 (most important).
-	*/
-	priority?: number;
-}
-/**
-* Text content returned from a resource read.
-*/
-interface TextResourceContent {
-	/** 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 {
-	/** Optional content annotations */
-	annotations?: ContentAnnotations;
-	/** Base64-encoded binary content */
-	blob: string;
-	/** Optional MIME type */
-	mimeType?: string;
-	/** Resource URI */
-	uri: string;
-}
-/**
-* Content returned from reading a resource.
-*/
-type ResourceContent = TextResourceContent | BlobResourceContent;
-/**
-* Handler for reading a resource's content.
-*
-* @param uri - The resource URI being read
-* @param ctx - Handler context with logger and requestId
-* @returns Array of resource content items
-*/
-type ResourceReadHandler = (uri: string, ctx: HandlerContext) => Promise<Result<ResourceContent[], OutfitterError>>;
-/**
-* Definition of an MCP resource that can be read by clients.
-*
-* Resources represent data that clients can access, such as files,
-* database records, or API responses.
-*
-* @example
-* ```typescript
-* const configResource: ResourceDefinition = {
-*   uri: "file:///etc/app/config.json",
-*   name: "Application Config",
-*   description: "Main application configuration file",
-*   mimeType: "application/json",
-*   handler: async (uri, ctx) => {
-*     const content = await readFile(uri);
-*     return Result.ok([{ uri, text: content }]);
-*   },
-* };
-* ```
-*/
-interface ResourceDefinition {
-	/**
-	* 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;
-	/**
-	* Human-readable resource name.
-	* Displayed to users in resource listings.
-	*/
-	name: string;
-	/**
-	* Unique resource URI.
-	* Must be a valid URI (file://, https://, custom://, etc.).
-	*/
-	uri: string;
-}
-/**
-* Handler for reading a resource template's content.
-*
-* @param uri - The matched URI
-* @param variables - Extracted template variables
-* @param ctx - Handler context
-*/
-type ResourceTemplateReadHandler = (uri: string, variables: Record<string, string>, ctx: HandlerContext) => Promise<Result<ResourceContent[], OutfitterError>>;
-/**
-* Definition of an MCP resource template with URI pattern matching.
-*
-* Templates use RFC 6570 Level 1 URI templates (e.g., `{param}`)
-* to match and extract variables from URIs.
-*
-* @example
-* ```typescript
-* const userTemplate: ResourceTemplateDefinition = {
-*   uriTemplate: "db:///users/{userId}/profile",
-*   name: "User Profile",
-*   handler: async (uri, variables) => {
-*     const profile = await getProfile(variables.userId);
-*     return Result.ok([{ uri, text: JSON.stringify(profile) }]);
-*   },
-* };
-* ```
-*/
-interface ResourceTemplateDefinition {
-	/** 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 {
-	/** Whether there are more values */
-	hasMore?: boolean;
-	/** Total number of available values (for pagination) */
-	total?: number;
-	/** Completion values */
-	values: string[];
-}
-/**
-* Handler for generating completions.
-*/
-type CompletionHandler = (value: string) => Promise<CompletionResult>;
-/**
-* Reference to a prompt or resource for completion.
-*/
-type CompletionRef = {
-	type: "ref/prompt";
-	name: string;
-} | {
-	type: "ref/resource";
-	uri: string;
-};
-/**
-* Argument definition for a prompt.
-*/
-interface PromptArgument {
-	/** Optional completion handler for this argument */
-	complete?: CompletionHandler;
-	/** Human-readable description */
-	description?: string;
-	/** Argument name */
-	name: string;
-	/** Whether this argument is required */
-	required?: boolean;
-}
-/**
-* Content block within a prompt message.
-*/
-interface PromptMessageContent {
-	/** Optional content annotations */
-	annotations?: ContentAnnotations;
-	/** Text content */
-	text: string;
-	/** Content type */
-	type: "text";
-}
-/**
-* A message in a prompt response.
-*/
-interface PromptMessage {
-	/** Message content */
-	content: PromptMessageContent;
-	/** Message role */
-	role: "user" | "assistant";
-}
-/**
-* Result returned from getting a prompt.
-*/
-interface PromptResult {
-	/** Optional description override */
-	description?: string;
-	/** Prompt messages */
-	messages: PromptMessage[];
-}
-/**
-* Handler for generating prompt messages.
-*/
-type PromptHandler = (args: Record<string, string | undefined>) => Promise<Result<PromptResult, OutfitterError>>;
-/**
-* Definition of an MCP prompt.
-*
-* Prompts are reusable templates that generate messages for LLMs.
-*
-* @example
-* ```typescript
-* const reviewPrompt: PromptDefinition = {
-*   name: "code-review",
-*   description: "Review code changes",
-*   arguments: [
-*     { name: "language", description: "Programming language", required: true },
-*   ],
-*   handler: async (args) => Result.ok({
-*     messages: [{ role: "user", content: { type: "text", text: `Review this ${args.language} code` } }],
-*   }),
-* };
-* ```
-*/
-interface PromptDefinition {
-	/** 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;
-	code: number;
-	context?: Record<string, unknown>;
-}>;
-/**
-* MCP-specific error with JSON-RPC error code.
-*
-* Used when tool invocations fail or when there are protocol-level errors.
-* Follows the JSON-RPC 2.0 error object format.
-*
-* Standard error codes:
-* - `-32700`: Parse error
-* - `-32600`: Invalid request
-* - `-32601`: Method not found
-* - `-32602`: Invalid params
-* - `-32603`: Internal error
-* - `-32000` to `-32099`: Server errors (reserved)
-*
-* @example
-* ```typescript
-* const error = new McpError({
-*   message: "Tool not found: unknown-tool",
-*   code: -32601,
-*   context: { tool: "unknown-tool" },
-* });
-* ```
-*/
-declare class McpError extends McpErrorBase {
-	/** Error category for Outfitter error taxonomy compatibility */
-	readonly category: "internal";
-}
-/**
-* Options for invoking a tool.
-*/
-interface InvokeToolOptions {
-	/** 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.
-*
-* Provides methods for registering tools and resources, and for
-* starting/stopping the server.
-*
-* @example
-* ```typescript
-* const server = createMcpServer({
-*   name: "my-server",
-*   version: "1.0.0",
-* });
-*
-* server.registerTool(myTool);
-* server.registerResource(myResource);
-*
-* await server.start();
-* ```
-*/
-interface McpServer {
-	/**
-	* Bind the SDK server instance for notifications.
-	* Called internally by the transport layer.
-	* @param sdkServer - The MCP SDK Server instance
-	*/
-	bindSdkServer?(sdkServer: any): void;
-	/**
-	* Complete an argument value.
-	* @param ref - Reference to the prompt or resource template
-	* @param argumentName - Name of the argument to complete
-	* @param value - Current value to complete
-	* @returns Result with completion values or McpError
-	*/
-	complete(ref: CompletionRef, argumentName: string, value: string): Promise<Result<CompletionResult, InstanceType<typeof McpError>>>;
-	/**
-	* Get a specific prompt's messages.
-	* @param name - Prompt name
-	* @param args - Prompt arguments
-	* @returns Result with prompt result or McpError
-	*/
-	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)
-	*/
-	getPrompts(): Array<{
-		name: string;
-		description?: string;
-		arguments: PromptArgument[];
-	}>;
-	/**
-	* Get all registered resources.
-	* @returns Array of resource definitions
-	*/
-	getResources(): ResourceDefinition[];
-	/**
-	* Get all registered resource templates.
-	* @returns Array of resource template definitions
-	*/
-	getResourceTemplates(): ResourceTemplateDefinition[];
-	/**
-	* Get all registered tools.
-	* @returns Array of serialized tool information
-	*/
-	getTools(): SerializedTool[];
-	/**
-	* Invoke a tool by name.
-	* @param name - Tool name
-	* @param input - Tool input (will be validated)
-	* @param options - Optional invocation options
-	* @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;
-	/**
-	* Notify connected clients that the prompt list has changed.
-	*/
-	notifyPromptsChanged(): void;
-	/**
-	* Notify connected clients that the resource list has changed.
-	*/
-	notifyResourcesChanged(): void;
-	/**
-	* Notify connected clients that a specific resource has been updated.
-	* Only emits for subscribed URIs.
-	* @param uri - URI of the updated resource
-	*/
-	notifyResourceUpdated(uri: string): void;
-	/**
-	* Notify connected clients that the tool list has changed.
-	*/
-	notifyToolsChanged(): void;
-	/**
-	* Read a resource by URI.
-	* @param uri - Resource URI
-	* @returns Result with resource content or McpError
-	*/
-	readResource(uri: string): Promise<Result<ResourceContent[], InstanceType<typeof McpError>>>;
-	/**
-	* Register a prompt with the server.
-	* @param prompt - Prompt definition to register
-	*/
-	registerPrompt(prompt: PromptDefinition): void;
-	/**
-	* Register a resource with the server.
-	* @param resource - Resource definition to register
-	*/
-	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.
-	* No-op if no SDK server is bound or if the message is below the threshold.
-	*
-	* @param level - MCP log level for the message
-	* @param data - Log data (string, object, or any serializable value)
-	* @param loggerName - Optional logger name for client-side filtering
-	*/
-	sendLogMessage(level: McpLogLevel, data: unknown, loggerName?: string): void;
-	/**
-	* Set the client-requested log level.
-	* Only log messages at or above this level will be forwarded.
-	* @param level - MCP log level string
-	*/
-	setLogLevel?(level: string): void;
-	/**
-	* Start the MCP server.
-	* Begins listening for client connections.
-	*/
-	start(): Promise<void>;
-	/**
-	* Stop the MCP server.
-	* 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.
-*/
-interface ProgressReporter {
-	/**
-	* Report progress for the current operation.
-	* @param progress - Current progress value
-	* @param total - Optional total value (for percentage calculation)
-	* @param message - Optional human-readable status message
-	*/
-	report(progress: number, total?: number, message?: string): void;
-}
-/**
-* Extended handler context for MCP tools.
-* Includes MCP-specific information in addition to standard HandlerContext.
-*/
-interface McpHandlerContext extends HandlerContext {
-	/** 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.
-*
-* MCP tool definitions constrain `TError extends OutfitterError`. When your
-* handler returns domain-specific errors that extend `Error` but not
-* `OutfitterError`, use this function instead of an unsafe cast:
-*
-* ```typescript
-* import { adaptHandler } from "@outfitter/mcp";
-*
-* const tool = defineTool({
-*   name: "my-tool",
-*   inputSchema: z.object({ id: z.string() }),
-*   handler: adaptHandler(myDomainHandler),
-* });
-* ```
-*/
-declare function adaptHandler<
-	TInput,
-	TOutput,
-	TError extends Error
->(handler: (input: TInput, ctx: HandlerContext) => Promise<Result<TOutput, TError>>): Handler<TInput, TOutput, OutfitterError>;
-interface BuildMcpToolsOptions {
-	readonly includeSurfaces?: readonly ActionSurface[];
-}
-type ActionSource = ActionRegistry | readonly AnyActionSpec[];
-declare function buildMcpTools(source: ActionSource, options?: BuildMcpToolsOptions): ToolDefinition<unknown, unknown>[];
-import { HandlerContext as HandlerContext2, OutfitterError as OutfitterError2 } from "@outfitter/contracts";
-import { Result as Result3 } from "@outfitter/contracts";
-type DocsSection = "overview" | "tools" | "examples" | "schemas";
-interface DocsToolInput {
-	section?: DocsSection | undefined;
-}
-interface DocsToolEntry {
-	examples?: Array<{
-		input: Record<string, unknown>;
-		description?: string;
-	}>;
-	name: string;
-	summary?: string;
-}
-interface DocsToolResponse {
-	examples?: Array<{
-		name?: string;
-		description?: string;
-		input?: Record<string, unknown>;
-		output?: unknown;
-	}>;
-	overview?: string;
-	schemas?: Record<string, unknown>;
-	tools?: DocsToolEntry[];
-}
-interface DocsToolOptions {
-	/** Optional override for the docs tool description. */
-	description?: string;
-	/** Static docs payload (used when getDocs is not provided). */
-	docs?: DocsToolResponse;
-	/** Dynamic docs provider. */
-	getDocs?: (section?: DocsSection) => DocsToolResponse | Promise<DocsToolResponse>;
-}
-declare function defineDocsTool(options?: DocsToolOptions): ToolDefinition<DocsToolInput, DocsToolResponse>;
-type ConfigAction = "get" | "set" | "list";
-interface ConfigToolInput {
-	action: ConfigAction;
-	key?: string | undefined;
-	value?: unknown | undefined;
-}
-interface ConfigToolResponse {
-	action: ConfigAction;
-	config?: Record<string, unknown>;
-	found?: boolean;
-	key?: string;
-	value?: unknown;
-}
-interface ConfigStore {
-	get(key: string): {
-		value: unknown;
-		found: boolean;
-	} | Promise<{
-		value: unknown;
-		found: boolean;
-	}>;
-	list(): Record<string, unknown> | Promise<Record<string, unknown>>;
-	set(key: string, value: unknown): void | Promise<void>;
-}
-interface ConfigToolOptions {
-	/** Optional override for the config tool description. */
-	description?: string;
-	/** Initial config values when using the default in-memory store. */
-	initial?: Record<string, unknown>;
-	/** Custom config store implementation. */
-	store?: ConfigStore;
-}
-declare function defineConfigTool(options?: ConfigToolOptions): ToolDefinition<ConfigToolInput, ConfigToolResponse>;
-interface QueryToolInput {
-	cursor?: string | undefined;
-	filters?: Record<string, unknown> | undefined;
-	limit?: number | undefined;
-	q?: string | undefined;
-	query?: string | undefined;
-}
-interface QueryToolResponse<T = unknown> {
-	_meta?: Record<string, unknown>;
-	nextCursor?: string;
-	results: T[];
-}
-interface QueryToolOptions<T = unknown> {
-	/** Optional override for the query tool description. */
-	description?: string;
-	/** Custom query handler implementation. */
-	handler?: (input: NormalizedQueryInput, ctx: HandlerContext2) => Promise<Result3<QueryToolResponse<T>, OutfitterError2>>;
-}
-declare function defineQueryTool<T = unknown>(options?: QueryToolOptions<T>): ToolDefinition<QueryToolInput, QueryToolResponse<T>>;
-interface CoreToolsOptions {
-	config?: ConfigToolOptions;
-	docs?: DocsToolOptions;
-	query?: QueryToolOptions;
-}
-type NormalizedQueryInput = Required<Pick<QueryToolInput, "q">> & Omit<QueryToolInput, "q">;
-type CoreToolDefinition = ToolDefinition<DocsToolInput, DocsToolResponse> | ToolDefinition<ConfigToolInput, ConfigToolResponse> | ToolDefinition<QueryToolInput, QueryToolResponse>;
-declare function createCoreTools(options?: CoreToolsOptions): CoreToolDefinition[];
-import { JsonSchema, zodToJsonSchema } from "@outfitter/contracts/schema";
-import { OutfitterError as OutfitterError3 } from "@outfitter/contracts";
-/**
-* Create an MCP server instance.
-*
-* The server provides:
-* - Tool registration with Zod schema validation
-* - Resource registration
-* - Tool invocation with Result-based error handling
-* - Automatic error translation from OutfitterError to McpError
-*
-* @param options - Server configuration options
-* @returns Configured McpServer instance
-*
-* @example
-* ```typescript
-* const server = createMcpServer({
-*   name: "calculator",
-*   version: "1.0.0",
-*   logger: createLogger({ name: "mcp" }),
-* });
-*
-* server.registerTool(defineTool({
-*   name: "add",
-*   description: "Add two numbers",
-*   inputSchema: z.object({ a: z.number(), b: z.number() }),
-*   handler: async (input) => Result.ok({ sum: input.a + input.b }),
-* }));
-*
-* const result = await server.invokeTool("add", { a: 2, b: 3 });
-* if (result.isOk()) {
-*   console.log(result.value.sum); // 5
-* }
-* ```
-*/
-declare function createMcpServer(options: McpServerOptions): McpServer;
-/**
-* Define a typed tool.
-*
-* This is a helper function that provides better type inference
-* when creating tool definitions.
-*
-* @param definition - Tool definition object
-* @returns The same tool definition with inferred types
-*
-* @example
-* ```typescript
-* const echoTool = defineTool({
-*   name: "echo",
-*   description: "Echo the input message",
-*   inputSchema: z.object({ message: z.string() }),
-*   handler: async (input, ctx) => {
-*     ctx.logger.debug("Echoing message");
-*     return Result.ok({ echo: input.message });
-*   },
-* });
-* ```
-*/
-declare function defineTool<
-	TInput,
-	TOutput,
-	TError extends OutfitterError3 = OutfitterError3
->(definition: ToolDefinition<TInput, TOutput, TError>): ToolDefinition<TInput, TOutput, TError>;
-/**
-* Define a resource.
-*
-* This is a helper function for creating resource definitions
-* with consistent typing.
-*
-* @param definition - Resource definition object
-* @returns The same resource definition
-*
-* @example
-* ```typescript
-* const configResource = defineResource({
-*   uri: "file:///etc/app/config.json",
-*   name: "Application Config",
-*   description: "Main configuration file",
-*   mimeType: "application/json",
-* });
-* ```
-*/
-declare function defineResource(definition: ResourceDefinition): ResourceDefinition;
-/**
-* Define a resource template.
-*
-* Helper function for creating resource template definitions
-* with URI pattern matching.
-*
-* @param definition - Resource template definition object
-* @returns The same resource template definition
-*/
-declare function defineResourceTemplate(definition: ResourceTemplateDefinition): ResourceTemplateDefinition;
-/**
-* Define a prompt.
-*
-* Helper function for creating prompt definitions
-* with consistent typing.
-*
-* @param definition - Prompt definition object
-* @returns The same prompt definition
-*/
-declare function definePrompt(definition: PromptDefinition): PromptDefinition;
-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.
-*
-* If the value is already a valid McpToolResponse (has a `content` array),
-* it is returned as-is. Otherwise it is wrapped in a text content block.
-* Plain objects are also attached as `structuredContent` for SDK clients
-* that support structured output.
-*/
-declare function wrapToolResult(value: unknown): McpToolResponse;
-/**
-* Wrap an error into an MCP CallToolResult with `isError: true`.
-*
-* Serializes the error (preserving `_tag`, `message`, `code`, `context` if
-* present) and wraps it as a text content block.
-*/
-declare function wrapToolError(error: unknown): McpToolResponse;
-/**
-* Create an MCP SDK server from an Outfitter MCP server.
-*/
-declare function createSdkServer(server: McpServer): Server;
-/**
-* Connect an MCP server over stdio transport.
-*/
-declare function connectStdio(server: McpServer, transport?: StdioServerTransport): Promise<Server>;
-export { zodToJsonSchema, wrapToolResult, wrapToolError, shouldEmitLog, mapLogLevelToMcp, defineTool, defineResourceTemplate, defineResource, defineQueryTool, definePrompt, defineDocsTool, defineConfigTool, createSdkServer, createMcpServer, createCoreTools, connectStdio, buildMcpTools, adaptHandler, ToolDefinition, ToolAnnotations, TextResourceContent, TOOL_ANNOTATIONS, SerializedTool, ResourceTemplateReadHandler, ResourceTemplateDefinition, ResourceReadHandler, ResourceDefinition, ResourceContent, QueryToolResponse, QueryToolOptions, QueryToolInput, PromptResult, PromptMessageContent, PromptMessage, PromptHandler, PromptDefinition, PromptArgument, ProgressReporter, McpToolResponse, McpServerOptions, McpServer, McpLogLevel, McpHandlerContext, McpError, JsonSchema, InvokeToolOptions, DocsToolResponse, DocsToolOptions, DocsToolInput, DocsToolEntry, DocsSection, CoreToolsOptions, ContentAnnotations, ConfigToolResponse, ConfigToolOptions, ConfigToolInput, ConfigStore, ConfigAction, CompletionResult, CompletionRef, CompletionHandler, BuildMcpToolsOptions, BlobResourceContent };
+import { McpToolResponse, connectStdio, createSdkServer, wrapToolError, wrapToolResult } from "./shared/@outfitter/mcp-yf0w5cgh.js";
+import { McpNotificationSender, McpProgressNotification, createMcpProgressCallback } from "./shared/@outfitter/mcp-r27vbpc1.js";
+import { createMcpServer, definePrompt, defineResource, defineResourceTemplate, defineTool } from "./shared/@outfitter/mcp-3hxaatj9.js";
+import { BuildMcpToolsOptions, buildMcpTools } from "./shared/@outfitter/mcp-f67dnr72.js";
+import { ConfigAction, ConfigStore, ConfigToolInput, ConfigToolOptions, ConfigToolResponse, CoreToolsOptions, DocsSection, DocsToolEntry, DocsToolInput, DocsToolOptions, DocsToolResponse, QueryToolInput, QueryToolOptions, QueryToolResponse, createCoreTools, defineConfigTool, defineDocsTool, defineQueryTool } from "./shared/@outfitter/mcp-4s22693j.js";
+import "./shared/@outfitter/mcp-qmdmgxa1.js";
+import { InvokeToolOptions, McpError, McpHandlerContext, McpServer, McpServerOptions, ProgressReporter, adaptHandler } from "./shared/@outfitter/mcp-7btcghjj.js";
+import { SerializedTool, TOOL_ANNOTATIONS, ToolAnnotations, ToolDefinition } from "./shared/@outfitter/mcp-knc1gq0g.js";
+import { BlobResourceContent, ResourceContent, ResourceDefinition, ResourceReadHandler, ResourceTemplateDefinition, ResourceTemplateReadHandler, TextResourceContent, TypedResourceTemplateDefinition, TypedResourceTemplateReadHandler } from "./shared/@outfitter/mcp-9ry52yg3.js";
+import { CompletionHandler, CompletionRef, CompletionResult, PromptArgument, PromptDefinition, PromptHandler, PromptMessage, PromptMessageContent, PromptResult } from "./shared/@outfitter/mcp-dgwj3jna.js";
+import { ContentAnnotations } from "./shared/@outfitter/mcp-q5hr7227.js";
+import { McpLogLevel, mapLogLevelToMcp, shouldEmitLog } from "./shared/@outfitter/mcp-cqpyer9m.js";
+import { JsonSchema, zodToJsonSchema } from "./shared/@outfitter/mcp-83zvbna8.js";
+export { zodToJsonSchema, wrapToolResult, wrapToolError, shouldEmitLog, mapLogLevelToMcp, defineTool, defineResourceTemplate, defineResource, defineQueryTool, definePrompt, defineDocsTool, defineConfigTool, createSdkServer, createMcpServer, createMcpProgressCallback, createCoreTools, connectStdio, buildMcpTools, adaptHandler, TypedResourceTemplateReadHandler, TypedResourceTemplateDefinition, ToolDefinition, ToolAnnotations, TextResourceContent, TOOL_ANNOTATIONS, SerializedTool, ResourceTemplateReadHandler, ResourceTemplateDefinition, ResourceReadHandler, ResourceDefinition, ResourceContent, QueryToolResponse, QueryToolOptions, QueryToolInput, PromptResult, PromptMessageContent, PromptMessage, PromptHandler, PromptDefinition, PromptArgument, ProgressReporter, McpToolResponse, McpServerOptions, McpServer, McpProgressNotification, McpNotificationSender, McpLogLevel, McpHandlerContext, McpError, JsonSchema, InvokeToolOptions, DocsToolResponse, DocsToolOptions, DocsToolInput, DocsToolEntry, DocsSection, CoreToolsOptions, ContentAnnotations, ConfigToolResponse, ConfigToolOptions, ConfigToolInput, ConfigStore, ConfigAction, CompletionResult, CompletionRef, CompletionHandler, BuildMcpToolsOptions, BlobResourceContent };