McpTaskStoreBuilder

Definition

Assembly: CloudNimble.McpEssentials.Core.dll Namespace: CloudNimble.McpEssentials.Core.Tasks Inheritance: System.Object

Syntax

CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder

Summary

Selects an IMcpTaskStorePlus provider for WithTasksPlus and OData WithTasks. Core ships McpTaskStoreOptions}). Provider packages add UseEntityFramework, UseRedis, and so on.

Constructors

.ctor

Initializes a new instance of the McpTaskStoreBuilder class.

Syntax

public McpTaskStoreBuilder(Microsoft.Extensions.DependencyInjection.IServiceCollection services)

Parameters

Name	Type	Description
`services`	`Microsoft.Extensions.DependencyInjection.IServiceCollection`	The application service collection.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when services is `null`.

.ctor Inherited

Inherited from object

Syntax

public Object()

Properties

CapturedServices

Gets the built IServiceProvider after MCP options compose, or null until the first request.

Syntax

public System.IServiceProvider CapturedServices { get; }

Property Value

Type: System.IServiceProvider?

Services

Gets the application service collection.

Syntax

public Microsoft.Extensions.DependencyInjection.IServiceCollection Services { get; }

Property Value

Type: Microsoft.Extensions.DependencyInjection.IServiceCollection

Store

Gets the store selected by the last Use* call.

Syntax

public CloudNimble.McpEssentials.Core.Tasks.IMcpTaskStorePlus Store { get; private set; }

Property Value

Type: CloudNimble.McpEssentials.Core.Tasks.IMcpTaskStorePlus?

Methods

Equals Inherited Virtual

Inherited from object

Syntax

public virtual bool Equals(object obj)

Parameters

Name	Type	Description
`obj`	`object?`	-

Returns

Type: bool

Equals Inherited

Inherited from object

Syntax

public static bool Equals(object objA, object objB)

Parameters

Name	Type	Description
`objA`	`object?`	-
`objB`	`object?`	-

Returns

Type: bool

GetHashCode Inherited Virtual

Inherited from object

Syntax

public virtual int GetHashCode()

Returns

Type: int

GetType Inherited

Inherited from object

Syntax

public System.Type GetType()

Returns

Type: System.Type

MemberwiseClone Inherited

Inherited from object

Syntax

protected internal object MemberwiseClone()

Returns

Type: object

ReferenceEquals Inherited

Inherited from object

Syntax

public static bool ReferenceEquals(object objA, object objB)

Parameters

Name	Type	Description
`objA`	`object?`	-
`objB`	`object?`	-

Returns

Type: bool

ToString Inherited Virtual

Inherited from object

Syntax

public virtual string ToString()

Returns

Type: string?

UseEntityFramework Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_EntityFrameworkCore_McpTaskStoreBuilderExtensions

Uses EFCoreMcpTaskStore1` with a constant owner.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseEntityFramework<TContext>(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, string userId, System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions> configure = null) where TContext : Microsoft.EntityFrameworkCore.DbContext

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`userId`	`string`	The owner stamped on every task this process creates.
`configure`	`System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Type Parameters

TContext - The host DbContext that maps McpTaskEntity.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder is `null`.
`ArgumentException`	Thrown when userId is `null` or whitespace.

UseEntityFramework Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_EntityFrameworkCore_McpTaskStoreBuilderExtensions

Uses EFCoreMcpTaskStore1` with an owner callback.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseEntityFramework<TContext>(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, System.Func<string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions> configure = null) where TContext : Microsoft.EntityFrameworkCore.DbContext

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`getCurrentUserId`	`System.Func<string?>`	Returns the current user identifier, or `null` when unauthenticated.
`configure`	`System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Type Parameters

TContext - The host DbContext that maps McpTaskEntity.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getCurrentUserId is `null`.

UseEntityFramework Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_EntityFrameworkCore_McpTaskStoreBuilderExtensions

Uses EFCoreMcpTaskStore1`, resolving the owner from a principal.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseEntityFramework<TContext>(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, System.Func<System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions> configure = null) where TContext : Microsoft.EntityFrameworkCore.DbContext

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`getPrincipal`	`System.Func<System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request.
`configure`	`System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Type Parameters

TContext - The host DbContext that maps McpTaskEntity.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

UseEntityFramework Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_EntityFrameworkCore_McpTaskStoreBuilderExtensions

Uses EFCoreMcpTaskStore1`, resolving the owner from the built provider.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseEntityFramework<TContext>(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions> configure = null) where TContext : Microsoft.EntityFrameworkCore.DbContext

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`getPrincipal`	`System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request. ASP.NET Core hosts pass
`sp => sp.GetRequiredService<IHttpContextAccessor>().HttpContext?.User`.
`configure`	`System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Type Parameters

TContext - The host DbContext that maps McpTaskEntity.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

UseEntityFramework Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_EntityFrameworkCore_McpTaskStoreBuilderExtensions

Uses EFCoreMcpTaskStore1` with an owner id from the built provider.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseEntityFramework<TContext>(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, System.Func<System.IServiceProvider, string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions> configure = null) where TContext : Microsoft.EntityFrameworkCore.DbContext

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`getCurrentUserId`	`System.Func<System.IServiceProvider, string?>`	Returns the current user identifier from the built provider.
`configure`	`System.Action<CloudNimble.McpEssentials.EntityFrameworkCore.Tasks.EFCoreMcpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Type Parameters

TContext - The host DbContext that maps McpTaskEntity.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getCurrentUserId is `null`.

UseInMemory

Uses InMemoryMcpTaskStorePlus with a constant owner.

Syntax

public CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseInMemory(string userId, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`userId`	`string`	The owner stamped on every task this process creates.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder This builder.

Exceptions

Exception	Description
`ArgumentException`	Thrown when userId is `null` or whitespace.

UseInMemory

Uses InMemoryMcpTaskStorePlus with an owner callback.

Syntax

public CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseInMemory(System.Func<string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`getCurrentUserId`	`System.Func<string?>`	Returns the current user identifier, or `null` when unauthenticated.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder This builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when getCurrentUserId is `null`.

UseInMemory

Uses InMemoryMcpTaskStorePlus, resolving the owner from a principal.

Syntax

public CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseInMemory(System.Func<System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`getPrincipal`	`System.Func<System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder This builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when getPrincipal is `null`.

UseInMemory

Uses InMemoryMcpTaskStorePlus, resolving the owner from the built IServiceProvider. ASP.NET Core hosts pass sp => sp.GetRequiredService<IHttpContextAccessor>().HttpContext?.User.

Syntax

public CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseInMemory(System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`getPrincipal`	`System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder This builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when getPrincipal is `null`.

UseInMemory

Uses InMemoryMcpTaskStorePlus with an owner id resolved from the built IServiceProvider.

Syntax

public CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseInMemory(System.Func<System.IServiceProvider, string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`getCurrentUserId`	`System.Func<System.IServiceProvider, string?>`	Returns the current user identifier, or `null` when unauthenticated.
`configure`	`System.Action<CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreOptions>?`	Optional store options (TTL, poll interval).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder This builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when getCurrentUserId is `null`.

UseRedis Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Redis_McpTaskStoreBuilderExtensions

Uses RedisMcpTaskStore with a constant owner.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseRedis(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, string userId, System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`userId`	`string`	The owner stamped on every task this process creates.
`configure`	`System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions>?`	Optional store options (TTL, key prefix, replica wait).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder is `null`.
`ArgumentException`	Thrown when userId is `null` or whitespace.

UseRedis Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Redis_McpTaskStoreBuilderExtensions

Uses RedisMcpTaskStore with an owner callback.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseRedis(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, System.Func<string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`getCurrentUserId`	`System.Func<string?>`	Returns the current user identifier, or `null` when unauthenticated.
`configure`	`System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions>?`	Optional store options (TTL, key prefix, replica wait).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getCurrentUserId is `null`.

UseRedis Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Redis_McpTaskStoreBuilderExtensions

Uses RedisMcpTaskStore, resolving the owner from a principal.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseRedis(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, System.Func<System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`getPrincipal`	`System.Func<System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request.
`configure`	`System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions>?`	Optional store options (TTL, key prefix, replica wait).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

UseRedis Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Redis_McpTaskStoreBuilderExtensions

Uses RedisMcpTaskStore, resolving the owner from the built provider.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseRedis(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal> getPrincipal, System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`getPrincipal`	`System.Func<System.IServiceProvider, System.Security.Claims.ClaimsPrincipal?>`	Returns the principal for the current request. ASP.NET Core hosts pass
`sp => sp.GetRequiredService<IHttpContextAccessor>().HttpContext?.User`.
`configure`	`System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions>?`	Optional store options (TTL, key prefix, replica wait).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getPrincipal is `null`.

UseRedis Extension

Extension method from Microsoft.Extensions.DependencyInjection.McpEssentials_Redis_McpTaskStoreBuilderExtensions

Uses RedisMcpTaskStore with an owner id from the built provider. Resolves IConnectionMultiplexer from DI.

Syntax

public static CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseRedis(CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder builder, System.Func<System.IServiceProvider, string> getCurrentUserId, System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions> configure = null)

Parameters

Name	Type	Description
`builder`	`CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder`	The task-store builder.
`getCurrentUserId`	`System.Func<System.IServiceProvider, string?>`	Returns the current user identifier from the built provider.
`configure`	`System.Action<CloudNimble.McpEssentials.Redis.Tasks.RedisMcpTaskStoreOptions>?`	Optional store options (TTL, key prefix, replica wait).

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder The builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when builder or getCurrentUserId is `null`.

UseStore

Registers store as the selected provider. Durable packages call this from their Use* extensions.

Syntax

public CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder UseStore(CloudNimble.McpEssentials.Core.Tasks.IMcpTaskStorePlus store, bool captureProvider = true)

Parameters

Name	Type	Description
`store`	`CloudNimble.McpEssentials.Core.Tasks.IMcpTaskStorePlus`	The plus store.
`captureProvider`	`bool`	When `true`, captures IServiceProvider on first options
compose so owner factories can resolve scoped services.

Returns

Type: CloudNimble.McpEssentials.Core.Tasks.McpTaskStoreBuilder This builder.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when store is `null`.

​Definition

​Syntax

​Summary

​Constructors

​ .ctor

​Syntax

​Parameters

​Exceptions

​ .ctor Inherited

​Syntax

​Properties

​ CapturedServices

​Syntax

​Property Value

​ Services

​Syntax

​Property Value

​ Store

​Syntax

​Property Value

​Methods

​ Equals Inherited Virtual

​Syntax

​Parameters

​Returns

​ Equals Inherited

​Syntax

​Parameters

​Returns

​ GetHashCode Inherited Virtual

​Syntax

​Returns

​ GetType Inherited

​Syntax

​Returns

​ MemberwiseClone Inherited

​Syntax

​Returns

​ ReferenceEquals Inherited

​Syntax

​Parameters

​Returns

​ ToString Inherited Virtual

​Syntax

​Returns

​ UseEntityFramework Extension

​Syntax

​Parameters

​Returns

​Type Parameters

​Exceptions

​ UseEntityFramework Extension

​Syntax

​Parameters

​Returns

​Type Parameters

​Exceptions

​ UseEntityFramework Extension

​Syntax

​Parameters

​Returns

​Type Parameters

​Exceptions

​ UseEntityFramework Extension

​Syntax

​Parameters

​Returns

​Type Parameters

​Exceptions

​ UseEntityFramework Extension

​Syntax

​Parameters

​Returns

​Type Parameters

​Exceptions

​ UseInMemory

​Syntax

​Parameters

​Returns

​Exceptions

Definition

Syntax

Summary

Constructors

.ctor

Syntax

Parameters

Exceptions

.ctor Inherited

Syntax

Properties

CapturedServices

Syntax

Property Value

Services

Syntax

Property Value

Store

Syntax

Property Value

Methods

Equals Inherited Virtual

Syntax

Parameters

Returns

Equals Inherited

Syntax

Parameters

Returns

GetHashCode Inherited Virtual

Syntax

Returns

GetType Inherited

Syntax

Returns

MemberwiseClone Inherited

Syntax

Returns

ReferenceEquals Inherited

Syntax

Parameters

Returns

ToString Inherited Virtual

Syntax

Returns

UseEntityFramework Extension

Syntax

Parameters

Returns

Type Parameters

Exceptions

UseEntityFramework Extension

Syntax

Parameters

Returns

Type Parameters

Exceptions

UseEntityFramework Extension

Syntax

Parameters

Returns

Type Parameters

Exceptions

UseEntityFramework Extension

Syntax

Parameters

Returns

Type Parameters

Exceptions

UseEntityFramework Extension

Syntax

Parameters

Returns

Type Parameters

Exceptions

UseInMemory

Syntax

Parameters

Returns

Exceptions