@outfitter/mcp 0.4.3 → 0.5.0

package/README.md

@@ -237,6 +237,47 @@ server.registerResource(configResource);
 const contentResult = await server.readResource("file:///etc/app/config.json");
 ```
 
+### defineResourceTemplate(definition)
+
+Helper for defining MCP resource templates with URI pattern matching and optional Zod validation.
+
+```typescript
+import { defineResourceTemplate } from "@outfitter/mcp";
+import { z } from "zod";
+
+// Basic template with string variables
+const userTemplate = defineResourceTemplate({
+  uriTemplate: "db:///users/{userId}/profile",
+  name: "User Profile",
+  handler: async (uri, variables, ctx) => {
+    const profile = await getProfile(variables.userId);
+    return Result.ok([
+      { uri, text: JSON.stringify(profile), mimeType: "application/json" },
+    ]);
+  },
+});
+
+// Typed template with Zod validation and coercion
+const postTemplate = defineResourceTemplate({
+  uriTemplate: "db:///users/{userId}/posts/{postId}",
+  name: "User Post",
+  paramSchema: z.object({
+    userId: z.string().min(1),
+    postId: z.coerce.number().int().positive(),
+  }),
+  handler: async (uri, params, ctx) => {
+    // params is { userId: string; postId: number } — validated and coerced
+    const post = await getPost(params.userId, params.postId);
+    return Result.ok([{ uri, text: JSON.stringify(post) }]);
+  },
+});
+
+server.registerResourceTemplate(userTemplate);
+server.registerResourceTemplate(postTemplate);
+```
+
+Templates use RFC 6570 Level 1 URI templates (`{param}` placeholders). Typed templates validate extracted variables against a Zod schema before handler invocation.
+
 ### Server Methods
 
 ```typescript
@@ -278,6 +319,57 @@ interface McpHandlerContext extends HandlerContext {
 }
 ```
 
+## Streaming and Progress (`@outfitter/mcp/progress`)
+
+When an MCP client provides a `progressToken` in the tool call params, the server automatically creates a progress callback and injects it into the handler context as `ctx.progress`. Each call emits a `notifications/progress` notification.
+
+```typescript
+const tool = defineTool({
+  name: "index-files",
+  description: "Index workspace files",
+  inputSchema: z.object({ path: z.string() }),
+  handler: async (input, ctx) => {
+    const files = await listFiles(input.path);
+
+    for (let i = 0; i < files.length; i++) {
+      await indexFile(files[i]);
+      ctx.progress?.({ type: "progress", current: i + 1, total: files.length });
+    }
+
+    ctx.progress?.({
+      type: "step",
+      name: "complete",
+      status: "complete",
+      duration_ms: 150,
+    });
+
+    return Result.ok({ indexed: files.length });
+  },
+});
+```
+
+Use optional chaining (`ctx.progress?.()`) so the handler works whether or not the client requested progress tracking. Without a `progressToken`, `ctx.progress` is `undefined` and no notifications are sent.
+
+**Event mapping to MCP notifications:**
+
+| StreamEvent type | MCP `progress` | MCP `total` | MCP `message`             |
+| ---------------- | -------------- | ----------- | ------------------------- |
+| `start`          | `0`            | --          | `[start] {command}`       |
+| `step`           | `0`            | --          | `[step] {name}: {status}` |
+| `progress`       | `current`      | `total`     | `message` (if provided)   |
+
+The progress callback uses the same `StreamEvent` types from `@outfitter/contracts/stream` as the CLI NDJSON adapter, keeping handlers transport-agnostic.
+
+**Programmatic usage** (for custom transport layers):
+
+```typescript
+import { createMcpProgressCallback } from "@outfitter/mcp/progress";
+
+const progress = createMcpProgressCallback("tok-123", (notification) =>
+  sdkServer.notification(notification)
+);
+```
+
 ## Core Tools
 
 Pre-built tools for common MCP patterns. These are marked with `deferLoading: false` for immediate availability.

package/dist/actions.d.ts

@@ -1,4 +1,9 @@
-import { BuildMcpToolsOptions, buildMcpTools } from "./shared/@outfitter/mcp-d8vs6vry.js";
-import "./shared/@outfitter/mcp-gqjg15f5.js";
+import { BuildMcpToolsOptions, buildMcpTools } from "./shared/@outfitter/mcp-f67dnr72.js";
+import "./shared/@outfitter/mcp-qmdmgxa1.js";
+import "./shared/@outfitter/mcp-7btcghjj.js";
+import "./shared/@outfitter/mcp-knc1gq0g.js";
+import "./shared/@outfitter/mcp-9ry52yg3.js";
+import "./shared/@outfitter/mcp-dgwj3jna.js";
+import "./shared/@outfitter/mcp-q5hr7227.js";
 import "./shared/@outfitter/mcp-cqpyer9m.js";
 export { buildMcpTools, BuildMcpToolsOptions };

package/dist/actions.js

@@ -1,9 +1,12 @@
 // @bun
 import {
   defineTool
-} from "./shared/@outfitter/mcp-b502y16n.js";
+} from "./shared/@outfitter/mcp-yf1n85e9.js";
+import"./shared/@outfitter/mcp-n9vzcp37.js";
+import"./shared/@outfitter/mcp-zt2s3r38.js";
+import"./shared/@outfitter/mcp-q70dtfj6.js";
 import"./shared/@outfitter/mcp-fjtxsa0x.js";
-import"./shared/@outfitter/mcp-9m5hs2z0.js";
+import"./shared/@outfitter/mcp-s2vnhzav.js";
 import"./shared/@outfitter/mcp-hw5wz4gb.js";
 
 // packages/mcp/src/actions.ts
@@ -11,6 +14,25 @@ import { DEFAULT_REGISTRY_SURFACES } from "@outfitter/contracts";
 function isActionRegistry(source) {
   return "list" in source;
 }
+function buildAnnotations(mcp) {
+  if (!mcp)
+    return;
+  const annotations = {};
+  let hasAnnotation = false;
+  if (mcp.readOnly === true) {
+    annotations["readOnlyHint"] = true;
+    hasAnnotation = true;
+  }
+  if (mcp.idempotent === true) {
+    annotations["idempotentHint"] = true;
+    hasAnnotation = true;
+  }
+  if (mcp.destructive === true) {
+    annotations["destructiveHint"] = true;
+    hasAnnotation = true;
+  }
+  return hasAnnotation ? annotations : undefined;
+}
 function buildMcpTools(source, options = {}) {
   const actions = isActionRegistry(source) ? source.list() : source;
   const includeSurfaces = options.includeSurfaces ?? [
@@ -19,13 +41,17 @@ function buildMcpTools(source, options = {}) {
   return actions.filter((action) => {
     const surfaces = action.surfaces ?? DEFAULT_REGISTRY_SURFACES;
     return surfaces.some((surface) => includeSurfaces.includes(surface));
-  }).map((action) => defineTool({
-    name: action.mcp?.tool ?? action.id,
-    description: action.mcp?.description ?? action.description ?? action.id,
-    inputSchema: action.input,
-    handler: async (input, ctx) => action.handler(input, ctx),
-    ...action.mcp?.deferLoading !== undefined ? { deferLoading: action.mcp.deferLoading } : {}
-  }));
+  }).map((action) => {
+    const annotations = buildAnnotations(action.mcp);
+    return defineTool({
+      name: action.mcp?.tool ?? action.id,
+      description: action.mcp?.description ?? action.description ?? action.id,
+      inputSchema: action.input,
+      handler: async (input, ctx) => action.handler(input, ctx),
+      ...action.mcp?.deferLoading !== undefined ? { deferLoading: action.mcp.deferLoading } : {},
+      ...annotations ? { annotations } : {}
+    });
+  });
 }
 export {
   buildMcpTools

package/dist/core-tools.d.ts

@@ -1,4 +1,9 @@
-import { ConfigAction, ConfigStore, ConfigToolInput, ConfigToolOptions, ConfigToolResponse, CoreToolDefinition, CoreToolsOptions, DocsSection, DocsToolEntry, DocsToolInput, DocsToolOptions, DocsToolResponse, NormalizedQueryInput, QueryToolInput, QueryToolOptions, QueryToolResponse, createCoreTools, defineConfigTool, defineDocsTool, defineQueryTool } from "./shared/@outfitter/mcp-s6afm4ff.js";
-import "./shared/@outfitter/mcp-gqjg15f5.js";
+import { ConfigAction, ConfigStore, ConfigToolInput, ConfigToolOptions, ConfigToolResponse, CoreToolDefinition, CoreToolsOptions, DocsSection, DocsToolEntry, DocsToolInput, DocsToolOptions, DocsToolResponse, NormalizedQueryInput, QueryToolInput, QueryToolOptions, QueryToolResponse, createCoreTools, defineConfigTool, defineDocsTool, defineQueryTool } from "./shared/@outfitter/mcp-4s22693j.js";
+import "./shared/@outfitter/mcp-qmdmgxa1.js";
+import "./shared/@outfitter/mcp-7btcghjj.js";
+import "./shared/@outfitter/mcp-knc1gq0g.js";
+import "./shared/@outfitter/mcp-9ry52yg3.js";
+import "./shared/@outfitter/mcp-dgwj3jna.js";
+import "./shared/@outfitter/mcp-q5hr7227.js";
 import "./shared/@outfitter/mcp-cqpyer9m.js";
 export { defineQueryTool, defineDocsTool, defineConfigTool, createCoreTools, QueryToolResponse, QueryToolOptions, QueryToolInput, NormalizedQueryInput, DocsToolResponse, DocsToolOptions, DocsToolInput, DocsToolEntry, DocsSection, CoreToolsOptions, CoreToolDefinition, ConfigToolResponse, ConfigToolOptions, ConfigToolInput, ConfigStore, ConfigAction };

package/dist/index.d.ts

@@ -1,8 +1,14 @@
-import { McpToolResponse, connectStdio, createSdkServer, wrapToolError, wrapToolResult } from "./shared/@outfitter/mcp-7kcw2814.js";
-import { createMcpServer, definePrompt, defineResource, defineResourceTemplate, defineTool } from "./shared/@outfitter/mcp-knq080yt.js";
-import { BuildMcpToolsOptions, buildMcpTools } from "./shared/@outfitter/mcp-d8vs6vry.js";
-import { ConfigAction, ConfigStore, ConfigToolInput, ConfigToolOptions, ConfigToolResponse, CoreToolsOptions, DocsSection, DocsToolEntry, DocsToolInput, DocsToolOptions, DocsToolResponse, QueryToolInput, QueryToolOptions, QueryToolResponse, createCoreTools, defineConfigTool, defineDocsTool, defineQueryTool } from "./shared/@outfitter/mcp-s6afm4ff.js";
-import { BlobResourceContent, CompletionHandler, CompletionRef, CompletionResult, ContentAnnotations, InvokeToolOptions, McpError, McpHandlerContext, McpServer, McpServerOptions, ProgressReporter, PromptArgument, PromptDefinition, PromptHandler, PromptMessage, PromptMessageContent, PromptResult, ResourceContent, ResourceDefinition, ResourceReadHandler, ResourceTemplateDefinition, ResourceTemplateReadHandler, SerializedTool, TOOL_ANNOTATIONS, TextResourceContent, ToolAnnotations, ToolDefinition, adaptHandler } from "./shared/@outfitter/mcp-gqjg15f5.js";
+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, 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 };
+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 };

package/dist/index.js

@@ -1,6 +1,7 @@
 export { buildMcpTools } from "./actions.js";
 export { createCoreTools, defineConfigTool, defineDocsTool, defineQueryTool } from "./core-tools.js";
 export { mapLogLevelToMcp, shouldEmitLog } from "./logging.js";
+export { createMcpProgressCallback } from "./progress.js";
 export { zodToJsonSchema } from "./schema.js";
 export { createMcpServer, definePrompt, defineResource, defineResourceTemplate, defineTool } from "./server.js";
 export { connectStdio, createSdkServer, wrapToolError, wrapToolResult } from "./transport.js";

package/dist/internal/content-types.d.ts

@@ -0,0 +1,2 @@
+import { ContentAnnotations } from "../shared/@outfitter/mcp-q5hr7227.js";
+export { ContentAnnotations };

package/dist/internal/content-types.js

@@ -0,0 +1 @@
+// @bun

package/dist/internal/log-config.d.ts

@@ -0,0 +1,24 @@
+import { McpServerOptions } from "../shared/@outfitter/mcp-7btcghjj.js";
+import "../shared/@outfitter/mcp-knc1gq0g.js";
+import "../shared/@outfitter/mcp-9ry52yg3.js";
+import "../shared/@outfitter/mcp-dgwj3jna.js";
+import "../shared/@outfitter/mcp-q5hr7227.js";
+import { McpLogLevel } from "../shared/@outfitter/mcp-cqpyer9m.js";
+import { Sink } from "@outfitter/logging";
+/** Valid MCP log levels for env var and option validation. */
+declare const VALID_MCP_LOG_LEVELS: ReadonlySet<string>;
+/** Map from EnvironmentDefaults logLevel to McpLogLevel. */
+declare const DEFAULTS_TO_MCP: Readonly<Record<string, McpLogLevel>>;
+/** Create a stderr sink with plain-text formatting for fallback logging. */
+declare function createDefaultMcpSink(): Sink;
+/**
+* Resolve the default client log level from the precedence chain.
+*
+* Precedence (highest wins):
+* 1. `OUTFITTER_LOG_LEVEL` environment variable
+* 2. `options.defaultLogLevel` (validated against MCP levels)
+* 3. Environment profile (`OUTFITTER_ENV`)
+* 4. `null` (no forwarding)
+*/
+declare function resolveDefaultLogLevel(options: McpServerOptions): McpLogLevel | null;
+export { resolveDefaultLogLevel, createDefaultMcpSink, VALID_MCP_LOG_LEVELS, DEFAULTS_TO_MCP };

package/dist/internal/log-config.js

@@ -0,0 +1,13 @@
+// @bun
+import {
+  DEFAULTS_TO_MCP,
+  VALID_MCP_LOG_LEVELS,
+  createDefaultMcpSink,
+  resolveDefaultLogLevel
+} from "../shared/@outfitter/mcp-n9vzcp37.js";
+export {
+  resolveDefaultLogLevel,
+  createDefaultMcpSink,
+  VALID_MCP_LOG_LEVELS,
+  DEFAULTS_TO_MCP
+};

package/dist/internal/prompt-types.d.ts

@@ -0,0 +1,3 @@
+import { CompletionHandler, CompletionRef, CompletionResult, PromptArgument, PromptDefinition, PromptHandler, PromptMessage, PromptMessageContent, PromptResult } from "../shared/@outfitter/mcp-dgwj3jna.js";
+import "../shared/@outfitter/mcp-q5hr7227.js";
+export { PromptResult, PromptMessageContent, PromptMessage, PromptHandler, PromptDefinition, PromptArgument, CompletionResult, CompletionRef, CompletionHandler };

package/dist/internal/prompt-types.js

@@ -0,0 +1 @@
+// @bun

package/dist/internal/resource-types.d.ts

@@ -0,0 +1,4 @@
+import { BlobResourceContent, ResourceContent, ResourceDefinition, ResourceReadHandler, ResourceTemplateDefinition, ResourceTemplateReadHandler, TextResourceContent, TypedResourceTemplateDefinition, TypedResourceTemplateReadHandler } from "../shared/@outfitter/mcp-9ry52yg3.js";
+import "../shared/@outfitter/mcp-dgwj3jna.js";
+import { ContentAnnotations } from "../shared/@outfitter/mcp-q5hr7227.js";
+export { TypedResourceTemplateReadHandler, TypedResourceTemplateDefinition, TextResourceContent, ResourceTemplateReadHandler, ResourceTemplateDefinition, ResourceReadHandler, ResourceDefinition, ResourceContent, ContentAnnotations, BlobResourceContent };

package/dist/internal/resource-types.js

@@ -0,0 +1 @@
+// @bun

package/dist/internal/server-types.d.ts

@@ -0,0 +1,7 @@
+import { InvokeToolOptions, McpError, McpHandlerContext, McpServer, McpServerOptions, ProgressReporter, Result, TaggedError, adaptHandler } from "../shared/@outfitter/mcp-7btcghjj.js";
+import "../shared/@outfitter/mcp-knc1gq0g.js";
+import "../shared/@outfitter/mcp-9ry52yg3.js";
+import "../shared/@outfitter/mcp-dgwj3jna.js";
+import "../shared/@outfitter/mcp-q5hr7227.js";
+import "../shared/@outfitter/mcp-cqpyer9m.js";
+export { adaptHandler, TaggedError, Result, ProgressReporter, McpServerOptions, McpServer, McpHandlerContext, McpError, InvokeToolOptions };

package/dist/internal/server-types.js

@@ -0,0 +1,20 @@
+// @bun
+// packages/mcp/src/internal/server-types.ts
+import {
+  TaggedError as TaggedErrorImpl
+} from "@outfitter/contracts";
+import { TaggedError } from "@outfitter/contracts";
+var TaggedError2 = TaggedErrorImpl;
+var McpErrorBase = TaggedError2("McpError")();
+
+class McpError extends McpErrorBase {
+  category = "internal";
+}
+function adaptHandler(handler) {
+  return handler;
+}
+export {
+  adaptHandler,
+  TaggedError,
+  McpError
+};

package/dist/internal/tool-types.d.ts

@@ -0,0 +1,2 @@
+import { SerializedTool, TOOL_ANNOTATIONS, ToolAnnotations, ToolDefinition } from "../shared/@outfitter/mcp-knc1gq0g.js";
+export { ToolDefinition, ToolAnnotations, TOOL_ANNOTATIONS, SerializedTool };

package/dist/{shared/@outfitter/mcp-9m5hs2z0.js → internal/tool-types.js}

@@ -1,10 +1,5 @@
 // @bun
-// packages/mcp/src/types.ts
-import {
-  TaggedError as TaggedErrorImpl
-} from "@outfitter/contracts";
-import { TaggedError } from "@outfitter/contracts";
-var TaggedError2 = TaggedErrorImpl;
+// packages/mcp/src/internal/tool-types.ts
 var TOOL_ANNOTATIONS = {
   readOnly: {
     readOnlyHint: true,
@@ -37,13 +32,6 @@ var TOOL_ANNOTATIONS = {
     openWorldHint: true
   }
 };
-var McpErrorBase = TaggedError2("McpError")();
-
-class McpError extends McpErrorBase {
-  category = "internal";
-}
-function adaptHandler(handler) {
-  return handler;
-}
-
-export { TOOL_ANNOTATIONS, McpError, adaptHandler, TaggedError };
+export {
+  TOOL_ANNOTATIONS
+};

package/dist/internal/uri-template.d.ts

@@ -0,0 +1,8 @@
+/**
+* Match a URI against a RFC 6570 Level 1 URI template.
+*
+* Extracts named variables from `{param}` segments.
+* Returns null if the URI doesn't match the template.
+*/
+declare function matchUriTemplate(template: string, uri: string): Record<string, string> | null;
+export { matchUriTemplate };

package/dist/internal/uri-template.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  matchUriTemplate
+} from "../shared/@outfitter/mcp-zt2s3r38.js";
+export {
+  matchUriTemplate
+};

package/dist/progress.d.ts

@@ -0,0 +1,2 @@
+import { McpNotificationSender, McpProgressNotification, createMcpProgressCallback } from "./shared/@outfitter/mcp-r27vbpc1.js";
+export { createMcpProgressCallback, McpProgressNotification, McpNotificationSender };

package/dist/progress.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  createMcpProgressCallback
+} from "./shared/@outfitter/mcp-q70dtfj6.js";
+export {
+  createMcpProgressCallback
+};

package/dist/server.d.ts

@@ -1,4 +1,9 @@
-import { createMcpServer, definePrompt, defineResource, defineResourceTemplate, defineTool } from "./shared/@outfitter/mcp-knq080yt.js";
-import "./shared/@outfitter/mcp-gqjg15f5.js";
+import { createMcpServer, definePrompt, defineResource, defineResourceTemplate, defineTool } from "./shared/@outfitter/mcp-3hxaatj9.js";
+import "./shared/@outfitter/mcp-qmdmgxa1.js";
+import "./shared/@outfitter/mcp-7btcghjj.js";
+import "./shared/@outfitter/mcp-knc1gq0g.js";
+import "./shared/@outfitter/mcp-9ry52yg3.js";
+import "./shared/@outfitter/mcp-dgwj3jna.js";
+import "./shared/@outfitter/mcp-q5hr7227.js";
 import "./shared/@outfitter/mcp-cqpyer9m.js";
 export { defineTool, defineResourceTemplate, defineResource, definePrompt, createMcpServer };

package/dist/server.js

@@ -5,9 +5,12 @@ import {
   defineResource,
   defineResourceTemplate,
   defineTool
-} from "./shared/@outfitter/mcp-b502y16n.js";
+} from "./shared/@outfitter/mcp-yf1n85e9.js";
+import"./shared/@outfitter/mcp-n9vzcp37.js";
+import"./shared/@outfitter/mcp-zt2s3r38.js";
+import"./shared/@outfitter/mcp-q70dtfj6.js";
 import"./shared/@outfitter/mcp-fjtxsa0x.js";
-import"./shared/@outfitter/mcp-9m5hs2z0.js";
+import"./shared/@outfitter/mcp-s2vnhzav.js";
 import"./shared/@outfitter/mcp-hw5wz4gb.js";
 export {
   defineTool,

package/dist/shared/@outfitter/{mcp-knq080yt.d.ts → mcp-3hxaatj9.d.ts}

@@ -1,4 +1,7 @@
-import { McpServer, McpServerOptions, PromptDefinition, ResourceDefinition, ResourceTemplateDefinition, ToolDefinition } from "./mcp-gqjg15f5.js";
+import { McpServer, McpServerOptions } from "./mcp-7btcghjj.js";
+import { ToolDefinition } from "./mcp-knc1gq0g.js";
+import { ResourceDefinition, ResourceTemplateDefinition, TypedResourceTemplateDefinition } from "./mcp-9ry52yg3.js";
+import { PromptDefinition } from "./mcp-dgwj3jna.js";
 import { OutfitterError } from "@outfitter/contracts";
 /**
 * Create an MCP server instance.
@@ -82,14 +85,42 @@ declare function defineTool<
 */
 declare function defineResource(definition: ResourceDefinition): ResourceDefinition;
 /**
-* Define a resource template.
+* Define a resource template with optional Zod schema validation.
 *
-* Helper function for creating resource template definitions
-* with URI pattern matching.
+* When `paramSchema` is provided, URI template variables are validated
+* and coerced before handler invocation — parallel to how `defineTool()`
+* validates input via `inputSchema`. Invalid parameters produce an
+* McpError with code -32602 (Invalid params) and the handler is never called.
 *
-* @param definition - Resource template definition object
-* @returns The same resource template definition
+* @param definition - Resource template definition with optional `paramSchema`
+* @returns A `ResourceTemplateDefinition` compatible with `registerResourceTemplate()`
+*
+* @example
+* ```typescript
+* // With Zod schema validation (recommended for typed params)
+* const userTemplate = defineResourceTemplate({
+*   uriTemplate: "db:///users/{userId}/posts/{postId}",
+*   name: "User Post",
+*   paramSchema: z.object({
+*     userId: z.string().min(1),
+*     postId: z.coerce.number().int().positive(),
+*   }),
+*   handler: async (uri, params, ctx) => {
+*     // params is typed as { userId: string; postId: number }
+*     return Result.ok([{ uri, text: JSON.stringify(params) }]);
+*   },
+* });
+*
+* // Without schema (backward compatible)
+* const simpleTemplate = defineResourceTemplate({
+*   uriTemplate: "db:///items/{itemId}",
+*   name: "Item",
+*   handler: async (uri, variables) =>
+*     Result.ok([{ uri, text: variables.itemId }]),
+* });
+* ```
 */
+declare function defineResourceTemplate<TParams>(definition: TypedResourceTemplateDefinition<TParams>): ResourceTemplateDefinition;
 declare function defineResourceTemplate(definition: ResourceTemplateDefinition): ResourceTemplateDefinition;
 /**
 * Define a prompt.

package/dist/shared/@outfitter/{mcp-s6afm4ff.d.ts → mcp-4s22693j.d.ts}

@@ -1,4 +1,4 @@
-import { ToolDefinition } from "./mcp-gqjg15f5.js";
+import { ToolDefinition } from "./mcp-knc1gq0g.js";
 import { HandlerContext, OutfitterError } from "@outfitter/contracts";
 import { Result } from "@outfitter/contracts";
 type DocsSection = "overview" | "tools" | "examples" | "schemas";