@microsoft/agents-a365-runtime package

Service for handling agentic user authentication.

Default provider that returns environment-based configuration.

Multi-tenant considerations: This provider creates a single configuration instance at construction time, shared across all requests in a process. The default module-level providers (e.g., defaultRuntimeConfigurationProvider) are singletons.

For multi-tenant scenarios, two approaches are supported:

1. Dynamic override functions (recommended): Pass override functions that read from async context (e.g., OpenTelemetry baggage) at runtime. The same Configuration instance returns different values per request.

   const config = new ToolingConfiguration({
     mcpPlatformEndpoint: () => {
       const tenantConfig = context.active().getValue(TENANT_KEY);
       return tenantConfig?.endpoint ?? 'https://default.endpoint';
     }
   });
   

2. Per-tenant providers: Create separate provider instances for each tenant when different tenants need different override functions entirely.

Encapsulates an error from an operation.

Represents the result of an operation.

Base configuration class for Agent365 SDK. Other packages extend this to add their own settings.

Override functions are called on each property access, enabling dynamic resolution from async context (e.g., OpenTelemetry baggage) per-request.

Utility class providing helper methods for agent runtime operations.

Generic interface for providing configuration. Each package defines its own configuration type T.

Runtime configuration options - all optional functions. Functions are called on each property access, enabling dynamic resolution. Unset values fall back to environment variables.

Cluster categories for Power Platform API discovery. String enum provides both compile-time type safety and runtime validation.

Gets the cluster category from environment variables.

Example

// Before:
import { getClusterCategory } from '@microsoft/agents-a365-runtime';
const cluster = getClusterCategory();

// After:
import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime';
const cluster = defaultRuntimeConfigurationProvider.getConfiguration().clusterCategory;

Gets the MCP platform authentication scope.

Example

// Before:
import { getMcpPlatformAuthenticationScope } from '@microsoft/agents-a365-runtime';
const scope = getMcpPlatformAuthenticationScope();

// After:
import { defaultToolingConfigurationProvider } from '@microsoft/agents-a365-tooling';
const scope = defaultToolingConfigurationProvider.getConfiguration().mcpPlatformAuthenticationScope;

Returns the scope for authenticating to the observability service.

Example

// Before:
import { getObservabilityAuthenticationScope } from '@microsoft/agents-a365-runtime';
const scopes = getObservabilityAuthenticationScope();

// After:
import { defaultObservabilityConfigurationProvider } from '@microsoft/agents-a365-observability';
const scopes = [...defaultObservabilityConfigurationProvider.getConfiguration().observabilityAuthenticationScopes];

Returns true if the current environment is a development environment.

Example

// Before:
import { isDevelopmentEnvironment } from '@microsoft/agents-a365-runtime';
if (isDevelopmentEnvironment()) { ... }

// After:
import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime';
if (defaultRuntimeConfigurationProvider.getConfiguration().isDevelopmentEnvironment) { ... }

Production MCP platform authentication scope.

Default cluster category for production environments.

Production observability authentication scope.

Shared default provider for RuntimeConfiguration. Uses environment variables with no overrides - suitable for single-tenant deployments or when using dynamic override functions for multi-tenancy.