nimwire/middleware

This page is generated from the module’s exported API and ## documentation comments.

Composable request middleware for tool handlers.

Types

McpToolNext

McpToolNext = proc (): Future[McpToolResult] {.closure.}

View source

McpToolMiddleware

McpToolMiddleware = proc (name: string; arguments: JsonNode;
                          context: McpContext; next: McpToolNext): Future[
    McpToolResult] {.closure.}

View source

McpToolAuthorization

McpToolAuthorization = proc (name: string; principal: McpPrincipal): bool {.
    closure.}

View source

McpToolPolicy

McpToolPolicy = proc (name: string; arguments: JsonNode; context: McpContext): bool {.
    closure.}

View source

McpToolValidation

McpToolValidation = proc (name: string; arguments: JsonNode; context: McpContext) {.
    closure.}

View source

McpToolTimingHook

McpToolTimingHook = proc (name: string; durationMs: float) {.closure.}

View source

McpToolRetryPredicate

McpToolRetryPredicate = proc (error: ref CatchableError): bool {.closure.}

View source

McpToolApprovalDecision

McpToolApprovalDecision = enum
  mcpApprovalAllow, mcpApprovalDeny

View source

McpToolApprovalPolicy

McpToolApprovalPolicy = proc (name: string; arguments: JsonNode;
                              context: McpContext): Future[
    McpToolApprovalDecision] {.closure.}

View source

McpSyncToolApprovalPolicy

McpSyncToolApprovalPolicy = proc (name: string; arguments: JsonNode;
                                  context: McpContext): McpToolApprovalDecision {.
    closure.}

View source

Procedures

mcpAuthMiddleware

proc mcpAuthMiddleware(authorize: McpToolAuthorization): McpToolMiddleware {.
    raises: [McpError], tags: [], forbids: [].}

Returns: McpToolMiddleware.

Arguments

Name	Type	Default
authorize	McpToolAuthorization

View source

mcpValidationMiddleware

proc mcpValidationMiddleware(validate: McpToolValidation): McpToolMiddleware {.
    raises: [McpError], tags: [], forbids: [].}

Returns: McpToolMiddleware.

Arguments

Name	Type	Default
validate	McpToolValidation

View source

mcpTimingMiddleware

proc mcpTimingMiddleware(timing: McpToolTimingHook): McpToolMiddleware {.
    raises: [McpError], tags: [], forbids: [].}

Returns: McpToolMiddleware.

Arguments

Name	Type	Default
timing	McpToolTimingHook

View source

defaultMcpRetry

proc defaultMcpRetry(error: ref CatchableError): bool {.raises: [], tags: [],
    forbids: [].}

Returns: bool.

Arguments

Name	Type	Default
error	ref CatchableError

View source

mcpRetryMiddleware

proc mcpRetryMiddleware(maxAttempts = 2; delayMs = 0;
                        retryOn: McpToolRetryPredicate = nil): McpToolMiddleware {.
    raises: [McpError], tags: [], forbids: [].}

Returns: McpToolMiddleware.

Arguments

Name	Type	Default
maxAttempts	inferred	2
delayMs	inferred	0
retryOn	McpToolRetryPredicate	nil

View source

mcpPolicyMiddleware

proc mcpPolicyMiddleware(policy: McpToolPolicy): McpToolMiddleware {.
    raises: [McpError], tags: [], forbids: [].}

Returns: McpToolMiddleware.

Arguments

Name	Type	Default
policy	McpToolPolicy

View source

mcpApprovalMiddleware (overload 1)

proc mcpApprovalMiddleware(policy: McpToolApprovalPolicy): McpToolMiddleware {.
    raises: [McpError], tags: [], forbids: [].}

Returns: McpToolMiddleware.

Arguments

Name	Type	Default
policy	McpToolApprovalPolicy

View source

mcpApprovalMiddleware (overload 2)

proc mcpApprovalMiddleware(policy: McpSyncToolApprovalPolicy): McpToolMiddleware {.
    raises: [McpError], tags: [], forbids: [].}

Returns: McpToolMiddleware.

Arguments

Name	Type	Default
policy	McpSyncToolApprovalPolicy

View source

runMcpToolMiddleware

proc runMcpToolMiddleware(middlewares: seq[McpToolMiddleware]; index: int;
                          name: string; arguments: JsonNode;
                          context: McpContext; terminal: McpToolNext): Future[
    McpToolResult] {.stackTrace: false, raises: [Exception, ValueError],
                     tags: [RootEffect], forbids: [].}

Returns: Future[McpToolResult].

Arguments

Name	Type	Default
middlewares	seq[McpToolMiddleware]
index	int
name	string
arguments	JsonNode
context	McpContext
terminal	McpToolNext

View source