mcp-server-framework 1.0.0

package/build/mcp/types/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/mcp/types/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uDAAuD,CAAC;AAM9F;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAMrH;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,uFAAuF;IACvF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEhC,sFAAsF;IACtF,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IAEnC,uFAAuF;IACvF,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAElC,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IACxE,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IAEvC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACnF;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,QAAQ,IAAI,aAAa,CAAC,cAAc,CAAC,CAAC;CAC3C;AAMD;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C;;;;OAIG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,WAAW,0BAA0B,CACzC,MAAM,SAAS,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAC9C,SAAQ,sBAAsB;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,OAAO,CAClB,KAAK,CAAC;QACJ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CACH,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,IACzE,wBAAwB,GACxB,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAMvC;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,QAAQ,IAAI,wBAAwB,CAEnG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,EAC/E,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,GACnC,QAAQ,IAAI,0BAA0B,CAAC,MAAM,CAAC,CAEhD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,YAAY,IAAI,aAAa,CAAC,wBAAwB,CAAC,CAAC;IACxD,iCAAiC;IACjC,YAAY,IAAI,aAAa,CAAC,0BAA0B,CAAC,CAAC;IAC1D,gEAAgE;IAChE,YAAY,IAAI,OAAO,CAAC;CACzB;AAMD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;IAC9E,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,UAAU,IAAI,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC9C,wCAAwC;IACxC,UAAU,IAAI,OAAO,CAAC;CACvB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,IAAI,EAAE,MAAM,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;CAChE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IACvE,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IAEzC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAElF,gCAAgC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAMD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IACzE;;;;;;;;;OASG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7F;;;;;;;;;OASG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1F;;;;;;;;;OASG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAClG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,kBAAkB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IAC5E,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAEnC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAE9C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,YAAY,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACnD"}

package/build/mcp/types/definition.js

@@ -0,0 +1,29 @@
+/**
+ * MCP Definition Types
+ *
+ * Unified type definitions for MCP tools, resources, and prompts.
+ * These are the canonical types used throughout the framework.
+ *
+ * DESIGN PRINCIPLES:
+ * - User-friendly naming (no I-prefix, 'input' instead of 'schema')
+ * - Single source of truth for each concept
+ * - Compatible with MCP SDK types
+ *
+ * @module mcp/types/definition
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Resource Type Guards
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Type guard for static resources.
+ */
+export function isStaticResource(resource) {
+    return "uri" in resource && !("uriTemplate" in resource);
+}
+/**
+ * Type guard for resource templates.
+ */
+export function isResourceTemplate(resource) {
+    return "uriTemplate" in resource;
+}
+//# sourceMappingURL=definition.js.map

package/build/mcp/types/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/mcp/types/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA2VH,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA4B;IAC3D,OAAO,KAAK,IAAI,QAAQ,IAAI,CAAC,CAAC,aAAa,IAAI,QAAQ,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAoC;IAEpC,OAAO,aAAa,IAAI,QAAQ,CAAC;AACnC,CAAC"}

package/build/mcp/types/handler.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Handler Types
+ *
+ * Types for MCP protocol handler configuration.
+ * Provides callback types for customizing handler behavior.
+ *
+ * @module mcp/types/handler
+ */
+/**
+ * Custom ping handler callback.
+ *
+ * Called when a ping request is received from an MCP client.
+ * Use for health checks, metrics, heartbeat tracking, or custom logic.
+ *
+ * The return value is ignored - ping always returns an empty object
+ * per MCP specification. If the handler throws, the ping still succeeds
+ * (errors are logged but not propagated to the client).
+ *
+ * @example
+ * ```typescript
+ * const options: ServerOptions = {
+ *   // ...
+ *   handlers: {
+ *     onPing: async () => {
+ *       metrics.increment('mcp.ping.received');
+ *       await healthChecker.recordHeartbeat();
+ *     },
+ *   },
+ * };
+ * ```
+ */
+export type PingHandler = () => void | Promise<void>;
+/**
+ * Protocol handler configuration.
+ *
+ * Allows customizing behavior when MCP protocol events occur.
+ * All handlers are optional - the framework provides default behavior.
+ *
+ * Note: Cancellation is handled automatically by the framework.
+ * There is no hook for cancellation as it must always abort requests.
+ *
+ * @example
+ * ```typescript
+ * const handlers: HandlersConfig = {
+ *   onPing: () => metrics.increment('mcp.ping'),
+ * };
+ * ```
+ */
+export interface HandlersConfig {
+    /**
+     * Called when a ping request is received.
+     *
+     * Use for health checks, metrics, or heartbeat tracking.
+     * Return value is ignored (ping always returns empty object).
+     */
+    onPing?: PingHandler;
+}
+//# sourceMappingURL=handler.d.ts.map

package/build/mcp/types/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/mcp/types/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAMrD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/build/mcp/types/handler.js

@@ -0,0 +1,10 @@
+/**
+ * Handler Types
+ *
+ * Types for MCP protocol handler configuration.
+ * Provides callback types for customizing handler behavior.
+ *
+ * @module mcp/types/handler
+ */
+export {};
+//# sourceMappingURL=handler.js.map

package/build/mcp/types/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/mcp/types/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/build/mcp/types/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP Types Module
+ *
+ * Central export point for all MCP-related type definitions.
+ * This is the SINGLE SOURCE OF TRUTH for MCP types in the framework.
+ *
+ * ## Type Categories
+ *
+ * - **Definition Types** — Tool, Resource, Prompt definitions and providers
+ * - **Handler Types** — Protocol handler interfaces and configs
+ * - **Response Types** — Response helper options and content types
+ * - **Context Types** — Tool execution context and progress reporting
+ *
+ * @module mcp/types
+ */
+export type { CompletionResult, CompletionCallback, ToolAnnotations, ToolDefinition, ToolProvider, BaseResourceDefinition, ResourceStaticDefinition, ResourceTemplateDefinition, ResourceDefinition, TextResourceContent, BlobResourceContent, ResourceContent, ResourceProvider, PromptRole, PromptMessage, PromptDefinition, PromptProvider, AppResourceDefinition, AppDefinition, TaskSupport, TaskToolHandler, TaskToolDefinition, TaskToolProvider, } from "./definition.js";
+export { isStaticResource, isResourceTemplate } from "./definition.js";
+export type { ProgressData, ProgressReporter, ToolContext, TaskCreateContext, TaskOperationContext, SendNotificationFn, ProgressToken, } from "./context.js";
+export type { PingHandler, HandlersConfig } from "./handler.js";
+export type { ContentAudience, ContentAnnotations, ResponseOptions, TextResponseOptions, JsonResponseOptions, ErrorResponseOptions, ImageMimeType, ImageResponseOptions, AudioMimeType, AudioResponseOptions, ToolResponse, } from "./response.js";
+//# sourceMappingURL=index.d.ts.map

package/build/mcp/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,YAAY,EAEV,gBAAgB,EAChB,kBAAkB,EAElB,eAAe,EACf,cAAc,EACd,YAAY,EAEZ,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAEhB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EAEd,qBAAqB,EACrB,aAAa,EAEb,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAMvE,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAC;AAMtB,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMhE,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,YAAY,GACb,MAAM,eAAe,CAAC"}

package/build/mcp/types/index.js

@@ -0,0 +1,18 @@
+/**
+ * MCP Types Module
+ *
+ * Central export point for all MCP-related type definitions.
+ * This is the SINGLE SOURCE OF TRUTH for MCP types in the framework.
+ *
+ * ## Type Categories
+ *
+ * - **Definition Types** — Tool, Resource, Prompt definitions and providers
+ * - **Handler Types** — Protocol handler interfaces and configs
+ * - **Response Types** — Response helper options and content types
+ * - **Context Types** — Tool execution context and progress reporting
+ *
+ * @module mcp/types
+ */
+// Type Guards
+export { isStaticResource, isResourceTemplate } from "./definition.js";
+//# sourceMappingURL=index.js.map

package/build/mcp/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsCH,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/build/mcp/types/response.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Response Types
+ *
+ * Types for response helper functions used in tool handlers.
+ * Provides a type-safe API for creating MCP tool responses.
+ *
+ * @module mcp/types/response
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Audience for content annotations.
+ */
+export type ContentAudience = "user" | "assistant";
+/**
+ * Annotations that can be attached to content.
+ */
+export interface ContentAnnotations {
+    /** Target audience for this content */
+    readonly audience?: ContentAudience[];
+    /** Priority of this content (higher = more important) */
+    readonly priority?: number;
+    /** ISO 8601 timestamp of last modification */
+    readonly lastModified?: string;
+}
+/**
+ * Base options for response helpers.
+ */
+export interface ResponseOptions {
+    /** Annotations to attach to the content */
+    readonly annotations?: ContentAnnotations;
+    /** Custom metadata */
+    readonly _meta?: Record<string, unknown>;
+}
+/**
+ * Options for text responses.
+ */
+export interface TextResponseOptions extends ResponseOptions {
+}
+/**
+ * Options for JSON responses.
+ */
+export interface JsonResponseOptions extends ResponseOptions {
+    /** Number of spaces for indentation (default: 2, use 0 for compact) */
+    readonly indent?: number;
+}
+/**
+ * Options for error responses.
+ */
+export interface ErrorResponseOptions extends ResponseOptions {
+}
+/**
+ * Supported image MIME types.
+ */
+export type ImageMimeType = "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "image/svg+xml";
+/**
+ * Options for image responses.
+ */
+export interface ImageResponseOptions extends ResponseOptions {
+    /** MIME type of the image (default: 'image/png') */
+    readonly mimeType?: ImageMimeType;
+}
+/**
+ * Supported audio MIME types.
+ */
+export type AudioMimeType = "audio/wav" | "audio/mp3" | "audio/mpeg" | "audio/ogg" | "audio/webm";
+/**
+ * Options for audio responses.
+ */
+export interface AudioResponseOptions extends ResponseOptions {
+    /** MIME type of the audio (default: 'audio/wav') */
+    readonly mimeType?: AudioMimeType;
+}
+/**
+ * Tool response type - alias for CallToolResult.
+ *
+ * This is the return type for all response helpers.
+ */
+export type ToolResponse = CallToolResult;
+//# sourceMappingURL=response.d.ts.map

package/build/mcp/types/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/mcp/types/response.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMzE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IACtC,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,sBAAsB;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;CAE3D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;CAE5D;AAMD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,CAAC;AAEtG;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;CACnC;AAMD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC"}

package/build/mcp/types/response.js

@@ -0,0 +1,10 @@
+/**
+ * Response Types
+ *
+ * Types for response helper functions used in tool handlers.
+ * Provides a type-safe API for creating MCP tool responses.
+ *
+ * @module mcp/types/response
+ */
+export {};
+//# sourceMappingURL=response.js.map

package/build/mcp/types/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../src/mcp/types/response.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/build/server/auth/auth-context.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Auth Context Types
+ *
+ * Authentication and authorization context for MCP sessions.
+ * Aligned with the SDK's `AuthInfo` type from `@modelcontextprotocol/sdk`.
+ *
+ * The SDK provides `AuthInfo` (token, clientId, scopes, expiresAt) through
+ * `RequestHandlerExtra.authInfo` in tool handlers. This module wraps it with
+ * framework-level auth metadata prepared for future permission systems.
+ *
+ * @module server/auth/auth-context
+ */
+import type { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
+export type { AuthInfo };
+/**
+ * Authentication context for a session.
+ *
+ * Wraps the SDK's `AuthInfo` (from OAuth/Bearer middleware) and adds
+ * framework-level auth metadata for future user/permission systems.
+ *
+ * When no auth middleware is configured, sessions use `ANONYMOUS_AUTH`.
+ */
+export interface AuthContext {
+    /** Whether the session is authenticated */
+    readonly isAuthenticated: boolean;
+    /** SDK auth info from transport (populated by OAuth middleware via `req.auth`) */
+    readonly sdkAuthInfo?: AuthInfo;
+    /** Resolved user identity (future: mapped from sdkAuthInfo.clientId or custom resolver) */
+    readonly userId?: string;
+    /** Framework permission scopes (future: role-based or mapped from sdkAuthInfo.scopes) */
+    readonly permissions?: readonly string[];
+    /** When authentication was validated */
+    readonly authenticatedAt?: Date;
+    /** Consumer-provided extra data (populated via `onAuthenticated` hook) */
+    readonly extra?: Record<string, unknown> | undefined;
+}
+/**
+ * Anonymous auth context (default for unauthenticated sessions).
+ */
+export declare const ANONYMOUS_AUTH: AuthContext;
+/**
+ * Creates an authenticated auth context from SDK AuthInfo.
+ *
+ * @public Available for consumers implementing custom auth strategies.
+ * Part of the auth extension point.
+ *
+ * @param sdkAuthInfo - SDK auth info from transport middleware
+ * @param userId - Optional resolved user identity
+ * @param permissions - Optional framework-level permissions
+ */
+export declare function createAuthContext(sdkAuthInfo: AuthInfo, userId?: string, permissions?: string[], extra?: Record<string, unknown>): AuthContext;
+//# sourceMappingURL=auth-context.d.ts.map

package/build/server/auth/auth-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-context.d.ts","sourceRoot":"","sources":["../../../src/server/auth/auth-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAG/E,YAAY,EAAE,QAAQ,EAAE,CAAC;AAMzB;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC;IAEhC,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,yFAAyF;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzC,wCAAwC;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC;IAEhC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACtD;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAE3B,CAAC;AAMH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,QAAQ,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,WAAW,CASb"}

package/build/server/auth/auth-context.js

@@ -0,0 +1,45 @@
+/**
+ * Auth Context Types
+ *
+ * Authentication and authorization context for MCP sessions.
+ * Aligned with the SDK's `AuthInfo` type from `@modelcontextprotocol/sdk`.
+ *
+ * The SDK provides `AuthInfo` (token, clientId, scopes, expiresAt) through
+ * `RequestHandlerExtra.authInfo` in tool handlers. This module wraps it with
+ * framework-level auth metadata prepared for future permission systems.
+ *
+ * @module server/auth/auth-context
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Anonymous auth context (default for unauthenticated sessions).
+ */
+export const ANONYMOUS_AUTH = Object.freeze({
+    isAuthenticated: false,
+});
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Creates an authenticated auth context from SDK AuthInfo.
+ *
+ * @public Available for consumers implementing custom auth strategies.
+ * Part of the auth extension point.
+ *
+ * @param sdkAuthInfo - SDK auth info from transport middleware
+ * @param userId - Optional resolved user identity
+ * @param permissions - Optional framework-level permissions
+ */
+export function createAuthContext(sdkAuthInfo, userId, permissions, extra) {
+    return Object.freeze({
+        isAuthenticated: true,
+        sdkAuthInfo,
+        userId: userId ?? sdkAuthInfo.clientId,
+        permissions: permissions ? Object.freeze([...permissions]) : Object.freeze([...sdkAuthInfo.scopes]),
+        authenticatedAt: new Date(),
+        extra: extra ? Object.freeze({ ...extra }) : undefined,
+    });
+}
+//# sourceMappingURL=auth-context.js.map

package/build/server/auth/auth-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-context.js","sourceRoot":"","sources":["../../../src/server/auth/auth-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuCH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgB,MAAM,CAAC,MAAM,CAAC;IACvD,eAAe,EAAE,KAAK;CACvB,CAAC,CAAC;AAEH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAqB,EACrB,MAAe,EACf,WAAsB,EACtB,KAA+B;IAE/B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,eAAe,EAAE,IAAI;QACrB,WAAW;QACX,MAAM,EAAE,MAAM,IAAI,WAAW,CAAC,QAAQ;QACtC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACnG,eAAe,EAAE,IAAI,IAAI,EAAE;QAC3B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;KACvD,CAAC,CAAC;AACL,CAAC"}

package/build/server/auth/guards.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Auth Guards
+ *
+ * Guard functions for tool handlers to enforce authentication and
+ * authorization requirements. Two flavors:
+ *
+ * - **Throwing guards** (`require*`): Throw typed errors, use for mandatory checks.
+ * - **Safe checks** (`has*`): Return booleans, use for conditional logic.
+ *
+ * @module server/auth/guards
+ *
+ * @example
+ * ```typescript
+ * import { requireAuth, requireScope, hasScope } from 'mcp-server-framework';
+ *
+ * const myTool = defineTool({
+ *   name: 'deploy',
+ *   input: z.object({ target: z.string() }),
+ *   handler: async ({ context }) => {
+ *     // Throwing guard — stops execution if not authenticated
+ *     requireAuth(context.auth);
+ *
+ *     // Throwing guard — stops if scope missing
+ *     requireScope(context.auth, 'deploy:write');
+ *
+ *     // Safe check — conditional logic
+ *     if (hasScope(context.auth, 'deploy:admin')) {
+ *       // admin-only path
+ *     }
+ *
+ *     return text('deployed');
+ *   },
+ * });
+ * ```
+ */
+import type { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
+/**
+ * Require that the request is authenticated.
+ *
+ * @throws {@link AuthenticationError} if `authInfo` is `undefined`
+ */
+export declare function requireAuth(authInfo: AuthInfo | undefined): asserts authInfo is AuthInfo;
+/**
+ * Require a specific scope on the authenticated token.
+ *
+ * @throws {@link AuthenticationError} if not authenticated
+ * @throws {@link AuthorizationError} if scope is missing
+ */
+export declare function requireScope(authInfo: AuthInfo | undefined, scope: string): void;
+/**
+ * Require all specified scopes on the authenticated token.
+ *
+ * @throws {@link AuthenticationError} if not authenticated
+ * @throws {@link AuthorizationError} if any scope is missing
+ */
+export declare function requireScopes(authInfo: AuthInfo | undefined, scopes: string[]): void;
+/**
+ * Check if the token has a specific scope.
+ * Returns `false` if not authenticated.
+ */
+export declare function hasScope(authInfo: AuthInfo | undefined, scope: string): boolean;
+/**
+ * Check if the token has all specified scopes.
+ * Returns `false` if not authenticated.
+ */
+export declare function hasAllScopes(authInfo: AuthInfo | undefined, scopes: string[]): boolean;
+/**
+ * Check if the token has at least one of the specified scopes.
+ * Returns `false` if not authenticated.
+ */
+export declare function hasAnyScope(authInfo: AuthInfo | undefined, scopes: string[]): boolean;
+//# sourceMappingURL=guards.d.ts.map

package/build/server/auth/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../src/server/auth/guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAO/E;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAIxF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKhF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAMpF;AAMD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAGtF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAGrF"}

package/build/server/auth/guards.js

@@ -0,0 +1,103 @@
+/**
+ * Auth Guards
+ *
+ * Guard functions for tool handlers to enforce authentication and
+ * authorization requirements. Two flavors:
+ *
+ * - **Throwing guards** (`require*`): Throw typed errors, use for mandatory checks.
+ * - **Safe checks** (`has*`): Return booleans, use for conditional logic.
+ *
+ * @module server/auth/guards
+ *
+ * @example
+ * ```typescript
+ * import { requireAuth, requireScope, hasScope } from 'mcp-server-framework';
+ *
+ * const myTool = defineTool({
+ *   name: 'deploy',
+ *   input: z.object({ target: z.string() }),
+ *   handler: async ({ context }) => {
+ *     // Throwing guard — stops execution if not authenticated
+ *     requireAuth(context.auth);
+ *
+ *     // Throwing guard — stops if scope missing
+ *     requireScope(context.auth, 'deploy:write');
+ *
+ *     // Safe check — conditional logic
+ *     if (hasScope(context.auth, 'deploy:admin')) {
+ *       // admin-only path
+ *     }
+ *
+ *     return text('deployed');
+ *   },
+ * });
+ * ```
+ */
+import { AuthenticationError, AuthorizationError } from "../../errors/categories/auth.js";
+// ============================================================================
+// Throwing Guards
+// ============================================================================
+/**
+ * Require that the request is authenticated.
+ *
+ * @throws {@link AuthenticationError} if `authInfo` is `undefined`
+ */
+export function requireAuth(authInfo) {
+    if (!authInfo) {
+        throw AuthenticationError.missingToken();
+    }
+}
+/**
+ * Require a specific scope on the authenticated token.
+ *
+ * @throws {@link AuthenticationError} if not authenticated
+ * @throws {@link AuthorizationError} if scope is missing
+ */
+export function requireScope(authInfo, scope) {
+    requireAuth(authInfo);
+    if (!authInfo.scopes.includes(scope)) {
+        throw AuthorizationError.insufficientScope([scope], authInfo.scopes);
+    }
+}
+/**
+ * Require all specified scopes on the authenticated token.
+ *
+ * @throws {@link AuthenticationError} if not authenticated
+ * @throws {@link AuthorizationError} if any scope is missing
+ */
+export function requireScopes(authInfo, scopes) {
+    requireAuth(authInfo);
+    const missing = scopes.filter((s) => !authInfo.scopes.includes(s));
+    if (missing.length > 0) {
+        throw AuthorizationError.insufficientScope(scopes, authInfo.scopes);
+    }
+}
+// ============================================================================
+// Safe Checks (Boolean)
+// ============================================================================
+/**
+ * Check if the token has a specific scope.
+ * Returns `false` if not authenticated.
+ */
+export function hasScope(authInfo, scope) {
+    return authInfo?.scopes.includes(scope) === true;
+}
+/**
+ * Check if the token has all specified scopes.
+ * Returns `false` if not authenticated.
+ */
+export function hasAllScopes(authInfo, scopes) {
+    if (!authInfo)
+        return false;
+    return scopes.every((s) => authInfo.scopes.includes(s));
+}
+/**
+ * Check if the token has at least one of the specified scopes.
+ * Returns `false` if not authenticated.
+ */
+export function hasAnyScope(authInfo, scopes) {
+    if (!authInfo)
+        return false;
+    return scopes.some((s) => authInfo.scopes.includes(s));
+}
+//# sourceMappingURL=guards.js.map

package/build/server/auth/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../src/server/auth/guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1F,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,QAA8B;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,mBAAmB,CAAC,YAAY,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAA8B,EAAE,KAAa;IACxE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAA8B,EAAE,MAAgB;IAC5E,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,kBAAkB,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,QAA8B,EAAE,KAAa;IACpE,OAAO,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAA8B,EAAE,MAAgB;IAC3E,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAA8B,EAAE,MAAgB;IAC1E,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/build/server/auth/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Auth Module
+ *
+ * Authentication and authorization for MCP sessions.
+ * Provides OAuth 2.1 integration per MCP specification, token verification,
+ * auth context for sessions, and guard functions for tool handlers.
+ *
+ * @module server/auth
+ */
+export type { AuthInfo, AuthContext } from "./auth-context.js";
+export { ANONYMOUS_AUTH, createAuthContext } from "./auth-context.js";
+export type { OAuthServerProvider, TokenVerifier, AuthProvider, AuthenticatedExtra, AuthOptions } from "./types.js";
+export { isFullOAuthProvider } from "./types.js";
+export { requireAuth, requireScope, requireScopes, hasScope, hasAllScopes, hasAnyScope } from "./guards.js";
+export { createUpstreamOAuthProvider } from "./upstream-provider.js";
+export type { UpstreamOAuthOptions, UpstreamOAuthProviderResult, UpstreamEndpoints } from "./upstream-provider.js";
+export { createOidcProvider } from "./oidc-provider.js";
+export type { OidcProviderOptions } from "./oidc-provider.js";
+export { fetchOidcDiscovery, getOidcDiscovery, clearOidcDiscoveryCache } from "./oidc-discovery.js";
+export type { OidcDiscoveryDocument } from "./oidc-discovery.js";
+//# sourceMappingURL=index.d.ts.map

package/build/server/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG5G,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGnH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACpG,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/build/server/auth/index.js

@@ -0,0 +1,20 @@
+/**
+ * Auth Module
+ *
+ * Authentication and authorization for MCP sessions.
+ * Provides OAuth 2.1 integration per MCP specification, token verification,
+ * auth context for sessions, and guard functions for tool handlers.
+ *
+ * @module server/auth
+ */
+export { ANONYMOUS_AUTH, createAuthContext } from "./auth-context.js";
+export { isFullOAuthProvider } from "./types.js";
+// Auth Guards
+export { requireAuth, requireScope, requireScopes, hasScope, hasAllScopes, hasAnyScope } from "./guards.js";
+// Upstream OAuth Provider (generic server-side callback pattern)
+export { createUpstreamOAuthProvider } from "./upstream-provider.js";
+// OIDC Provider (auto-discovery for OIDC-compliant providers)
+export { createOidcProvider } from "./oidc-provider.js";
+// OIDC Discovery (for advanced use cases)
+export { fetchOidcDiscovery, getOidcDiscovery, clearOidcDiscoveryCache } from "./oidc-discovery.js";
+//# sourceMappingURL=index.js.map

package/build/server/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAItE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,cAAc;AACd,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5G,iEAAiE;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE,8DAA8D;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,0CAA0C;AAC1C,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}