@breadstone/archipel-mcp 0.0.54 → 0.0.56

package/data/packages/platform-feature-flags/index.md

@@ -1,103 +0,0 @@
----
-title: platform-feature-flags
-description: Provider-agnostic feature flag infrastructure for NestJS with support for Azure App Configuration and Vercel Edge Config.
-order: 3
-tags: [feature-flags, azure, vercel, edge-config, configuration]
-package: '@breadstone/archipel-platform-feature-flags'
----
-
-# platform-feature-flags
-
-Provider-agnostic feature flag infrastructure for NestJS with support for Azure App Configuration and Vercel Edge Config.
-
-**Package:** `@breadstone/archipel-platform-feature-flags`
-
-<InstallTabs />
-
-## Provider Subpaths
-
-Import only the providers you need:
-
-| Provider                | Subpath                                              | SDK                                                                   |
-| ----------------------- | ---------------------------------------------------- | --------------------------------------------------------------------- |
-| Azure App Configuration | `@breadstone/archipel-platform-feature-flags/azure`  | `@azure/app-configuration-provider` + `@microsoft/feature-management` |
-| Vercel Edge Config      | `@breadstone/archipel-platform-feature-flags/vercel` | `@vercel/edge-config`                                                 |
-
-## Quick Start
-
-```typescript
-import { Module } from '@nestjs/common';
-import { FeatureFlagsModule } from '@breadstone/archipel-platform-feature-flags';
-import { AzureFeatureFlagsClient, AZURE_FEATURE_FLAGS_CONFIG_ENTRIES } from '@breadstone/archipel-platform-feature-flags/azure';
-
-@Module({
-  imports: [
-    FeatureFlagsModule.register({
-      client: AzureFeatureFlagsClient,
-      configEntries: AZURE_FEATURE_FLAGS_CONFIG_ENTRIES,
-    }),
-  ],
-})
-export class AppModule {}
-```
-
-## Environment Variables
-
-### Azure App Configuration
-
-| Variable                                | Required | Description                                      |
-| --------------------------------------- | -------- | ------------------------------------------------ |
-| `AZURE_APP_CONFIGURATION_CONNECTION_STRING` | Yes      | Connection string for Azure App Configuration    |
-| `AZURE_FEATURE_FLAGS_LABEL`             | No       | Label filter for feature flags (e.g., `prod`)    |
-
-### Vercel Edge Config
-
-| Variable                | Required | Description                          |
-| ----------------------- | -------- | ------------------------------------ |
-| `EDGE_CONFIG`           | Yes      | Vercel Edge Config connection string |
-
----
-
-## Checking Feature Flags
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import { FeatureFlagsService } from '@breadstone/archipel-platform-feature-flags';
-
-@Injectable()
-export class MyService {
-  public constructor(private readonly _featureFlags: FeatureFlagsService) {}
-
-  public async doSomething(): Promise<void> {
-    const isEnabled = await this._featureFlags.isEnabled('my-feature');
-
-    if (isEnabled) {
-      // Feature is enabled
-    }
-  }
-}
-```
-
----
-
-## Architecture
-
-```mermaid
-flowchart TB
-  subgraph FeatureFlagsModule
-    Service[FeatureFlagsService]
-    Port[FeatureFlagsClientPort]
-  end
-
-  subgraph Providers
-    Azure[AzureFeatureFlagsClient]
-    Vercel[VercelFeatureFlagsClient]
-  end
-
-  Service --> Port
-  Port -.-> Azure
-  Port -.-> Vercel
-
-  Azure --> AzureSDK[@azure/app-configuration-provider]
-  Vercel --> VercelSDK[@vercel/edge-config]
-```

package/data/packages/platform-health/index.md

@@ -1,141 +0,0 @@
----
-title: platform-health
-description: Health check orchestration with indicator-based architecture built on @nestjs/terminus.
-order: 4
-tags: [health, terminus, indicators, monitoring]
-package: '@breadstone/archipel-platform-health'
----
-
-# platform-health
-
-Health check orchestration for NestJS applications built on `@nestjs/terminus`. Register custom health indicators and expose aggregated health status via a single orchestrator. Extracted from `platform-core` to provide a focused, independently versionable health module.
-
-**Package:** `@breadstone/archipel-platform-health`
-
-<InstallTabs />
-
-## Installation
-
-```typescript
-import {
-  HealthModule,
-  HealthOrchestrator,
-  IHealthIndicator,
-  IHealthCheckResult,
-  HEALTH_INDICATORS,
-} from '@breadstone/archipel-platform-health';
-```
-
----
-
-## Module Registration
-
-Register the module with one or more health indicators:
-
-```typescript
-import { Module } from '@nestjs/common';
-import { HealthModule } from '@breadstone/archipel-platform-health';
-import { DatabaseHealthIndicator } from './health/DatabaseHealthIndicator';
-import { RedisHealthIndicator } from './health/RedisHealthIndicator';
-
-@Module({
-  imports: [
-    HealthModule.withIndicators([DatabaseHealthIndicator, RedisHealthIndicator]),
-  ],
-})
-export class AppModule {}
-```
-
-## Implementing a Health Indicator
-
-Each indicator implements the `IHealthIndicator` interface:
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import type { IHealthIndicator, IHealthCheckResult } from '@breadstone/archipel-platform-health';
-
-@Injectable()
-export class DatabaseHealthIndicator implements IHealthIndicator {
-  public readonly name = 'database';
-
-  public async isHealthy(): Promise<IHealthCheckResult> {
-    try {
-      await this._prisma.$queryRaw`SELECT 1`;
-      return { status: 'up' };
-    } catch (error) {
-      return { status: 'down', details: { error: (error as Error).message } };
-    }
-  }
-}
-```
-
-## Using the Orchestrator
-
-The `HealthOrchestrator` runs all registered indicators and returns aggregated results:
-
-```typescript
-import { Controller, Get } from '@nestjs/common';
-import { HealthOrchestrator } from '@breadstone/archipel-platform-health';
-
-@Controller('health')
-export class HealthController {
-  constructor(private readonly _healthOrchestrator: HealthOrchestrator) {}
-
-  @Get()
-  public async check(): Promise<unknown> {
-    return this._healthOrchestrator.check();
-  }
-}
-```
-
----
-
-## Built-in Consumers
-
-All Archipel platform libraries provide health indicators via their `/health` subpath export. Register them with `HealthModule.withIndicators()`:
-
-| Library                  | Indicator                      | Key              | Check                                                     |
-| ------------------------ | ------------------------------ | ---------------- | --------------------------------------------------------- |
-| `platform-database`      | `DatabaseHealthIndicator`      | `database`       | Prisma `SELECT 1` ping                                    |
-| `platform-blob-storage`  | `BlobHealthIndicator`          | `blob`           | HTTP ping to blob URL (or disabled if unconfigured)       |
-| `platform-mailing`       | `MailHealthIndicator`          | `mail`           | Validates mail host, user, and port config                |
-| `platform-caching`       | `CachingHealthIndicator`       | `caching`        | Always `up`                                               |
-| `platform-queue`         | `QueueHealthIndicator`         | `queue`          | Always `up`                                               |
-| `platform-payments`      | `PaymentHealthIndicator`       | `payment`        | `up` if `PaymentClientPort` injected, else `disabled`     |
-| `platform-esigning`      | `EsigningHealthIndicator`      | `esigning`       | `up` if `EsigningClientPort` injected, else `disabled`    |
-| `platform-intelligence`  | `IntelligenceHealthIndicator`  | `intelligence`   | Resolves text configuration and reports realtime providers plus active sessions; `disabled` when neither service is present |
-| `platform-analytics`     | `AnalyticsHealthIndicator`     | `analytics`      | `up` if `AnalyticsClientPort` injected, else `disabled`   |
-| `platform-telemetry`     | `TelemetryHealthIndicator`     | `telemetry`      | `up` if `OtelSdkHolder` injected, else `disabled`         |
-| `platform-authentication`| `AuthenticationHealthIndicator`| `authentication` | Always `up`                                               |
-| `platform-mcp`           | `McpHealthIndicator`           | `mcp`            | `up` if `McpRegistryService` injected, else `disabled`    |
-
-See the [Health Indicators guide](../../guides/health-indicators) for full setup instructions.
-
----
-
-## Interfaces
-
-| Interface              | Description                                                       |
-| ---------------------- | ----------------------------------------------------------------- |
-| `IHealthIndicator`    | Contract for health check implementations (`name` + `isHealthy`) |
-| `IHealthCheckResult`  | Result object with `status` (`'up'` or `'down'`) and optional `details` |
-
----
-
-## Tokens
-
-| Token               | Description                                              |
-| -------------------- | -------------------------------------------------------- |
-| `HEALTH_INDICATORS` | Multi-provider token for registering health indicators    |
-
----
-
-## Resource Bounds
-
-The `HealthOrchestrator` enforces a maximum of **100** registered indicators. If the limit is exceeded, the indicator is skipped and a warning is logged.
-
----
-
-## API Reference
-
-The auto-generated API reference is published when API docs are generated for this package.

package/data/packages/platform-intelligence/api/Class.IntelligenceMediaGenerator.md

@@ -1,118 +0,0 @@
----
-title: 'Class: IntelligenceMediaGenerator'
-generated: true
-editUrl: false
----
-# Class: IntelligenceMediaGenerator
-
-Defined in: [IntelligenceMediaGenerator.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L24)
-
-Executes AI SDK media generation and understanding operations.
-
-## Constructors
-
-### Constructor
-
-```ts
-new IntelligenceMediaGenerator(): IntelligenceMediaGenerator;
-```
-
-#### Returns
-
-`IntelligenceMediaGenerator`
-
-## Methods
-
-### generateImage()
-
-```ts
-generateImage(options): Promise<GenerateImageResult>;
-```
-
-Defined in: [IntelligenceMediaGenerator.ts:46](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L46)
-
-Generates images using the native AI SDK image API.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `options` | \{ \} | Native AI SDK `generateImage()` options. |
-
-#### Returns
-
-`Promise`\<`GenerateImageResult`\>
-
-The native AI SDK image-generation result.
-
-***
-
-### generateSpeech()
-
-```ts
-generateSpeech(options): Promise<SpeechResult>;
-```
-
-Defined in: [IntelligenceMediaGenerator.ts:59](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L59)
-
-Generates speech using the native AI SDK speech API.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `options` | \{ \} | Native AI SDK `generateSpeech()` options. |
-
-#### Returns
-
-`Promise`\<`SpeechResult`\>
-
-The native AI SDK speech-generation result.
-
-***
-
-### generateVideo()
-
-```ts
-generateVideo(options): Promise<GenerateVideoResult>;
-```
-
-Defined in: [IntelligenceMediaGenerator.ts:85](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L85)
-
-Generates videos using the AI SDK experimental video API.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `options` | \{ \} | Native AI SDK `experimental_generateVideo()` options. |
-
-#### Returns
-
-`Promise`\<`GenerateVideoResult`\>
-
-The native AI SDK video-generation result.
-
-***
-
-### transcribe()
-
-```ts
-transcribe(options): Promise<TranscriptionResult>;
-```
-
-Defined in: [IntelligenceMediaGenerator.ts:72](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L72)
-
-Transcribes audio using the native AI SDK transcription API.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `options` | \{ \} | Native AI SDK `transcribe()` options. |
-
-#### Returns
-
-`Promise`\<`TranscriptionResult`\>
-
-The native AI SDK transcription result.

package/data/packages/platform-intelligence/api/Class.IntelligenceStructuredGenerator.md

@@ -1,70 +0,0 @@
----
-title: 'Class: IntelligenceStructuredGenerator'
-generated: true
-editUrl: false
----
-# Class: IntelligenceStructuredGenerator
-
-Defined in: [IntelligenceStructuredGenerator.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceStructuredGenerator.ts#L20)
-
-Executes AI SDK structured-output generation.
-
-## Constructors
-
-### Constructor
-
-```ts
-new IntelligenceStructuredGenerator(): IntelligenceStructuredGenerator;
-```
-
-#### Returns
-
-`IntelligenceStructuredGenerator`
-
-## Methods
-
-### generateObject()
-
-```ts
-generateObject(options): Promise<GenerateObjectResult<unknown>>;
-```
-
-Defined in: [IntelligenceStructuredGenerator.ts:42](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceStructuredGenerator.ts#L42)
-
-Generates a structured object using the native AI SDK object API.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `options` | `Omit`\<`LanguageModelCallOptions`, `"stopSequences"`\> & Omit\<RequestOptions\<ToolSet\>, "timeout"\> & (Prompt & ((\{\} \| \{ schema: FlexibleSchema\<unknown\>; schemaName?: string \| undefined; schemaDescription?: string \| undefined; \} \| \{ ...; \}) & \{ ...; \})) | Native AI SDK `generateObject()` options. |
-
-#### Returns
-
-`Promise`\<`GenerateObjectResult`\<`unknown`\>\>
-
-The native AI SDK object-generation result.
-
-***
-
-### streamObject()
-
-```ts
-streamObject(options): Promise<StreamObjectResult<unknown, unknown, never>>;
-```
-
-Defined in: [IntelligenceStructuredGenerator.ts:55](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceStructuredGenerator.ts#L55)
-
-Streams a structured object using the native AI SDK object API.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `options` | `Omit`\<`LanguageModelCallOptions`, `"stopSequences"`\> & Omit\<RequestOptions\<ToolSet\>, "timeout"\> & (Prompt & ((\{\} \| \{ schema: FlexibleSchema\<unknown\>; schemaName?: string \| undefined; schemaDescription?: string \| undefined; \} \| \{ ...; \}) & \{ ...; \})) | Native AI SDK `streamObject()` options. |
-
-#### Returns
-
-`Promise`\<`StreamObjectResult`\<`unknown`, `unknown`, `never`\>\>
-
-The native AI SDK streaming object result.

package/data/packages/platform-intelligence/api/Class.IntelligenceTelemetryRegistry.md

@@ -1,44 +0,0 @@
----
-title: 'Class: IntelligenceTelemetryRegistry'
-generated: true
-editUrl: false
----
-# Class: IntelligenceTelemetryRegistry
-
-Defined in: [IntelligenceTelemetryRegistry.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTelemetryRegistry.ts#L15)
-
-Registers AI SDK telemetry integrations for the current process.
-
-## Constructors
-
-### Constructor
-
-```ts
-new IntelligenceTelemetryRegistry(): IntelligenceTelemetryRegistry;
-```
-
-#### Returns
-
-`IntelligenceTelemetryRegistry`
-
-## Methods
-
-### register()
-
-```ts
-register(...integrations): Promise<void>;
-```
-
-Defined in: [IntelligenceTelemetryRegistry.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTelemetryRegistry.ts#L36)
-
-Registers one or more native AI SDK telemetry integrations.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| ...`integrations` | `Telemetry`[] | Native AI SDK telemetry integrations. |
-
-#### Returns
-
-`Promise`\<`void`\>

package/data/packages/platform-intelligence/api/Class.IntelligenceTextGenerator.md

@@ -1,138 +0,0 @@
----
-title: 'Class: IntelligenceTextGenerator'
-generated: true
-editUrl: false
----
-# Class: IntelligenceTextGenerator
-
-Defined in: [IntelligenceTextGenerator.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L34)
-
-Executes text completions using the configured intelligence provider.
-
-## Implements
-
-- [`IIntelligenceTextGenerator`](Interface.IIntelligenceTextGenerator)
-- `OnModuleInit`
-
-## Constructors
-
-### Constructor
-
-```ts
-new IntelligenceTextGenerator(
-   configService, 
-   toolRegistry, 
-   providerLoaders, 
-   validateOnModuleInit?): IntelligenceTextGenerator;
-```
-
-Defined in: [IntelligenceTextGenerator.ts:49](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L49)
-
-#### Parameters
-
-| Parameter | Type | Default value |
-| ------ | ------ | ------ |
-| `configService` | `ConfigService` | `undefined` |
-| `toolRegistry` | [`IntelligenceToolRegistry`](Class.IntelligenceToolRegistry) | `undefined` |
-| `providerLoaders` | [`IntelligenceLanguageModelLoaders`](TypeAlias.IntelligenceLanguageModelLoaders) | `undefined` |
-| `validateOnModuleInit` | `boolean` | `true` |
-
-#### Returns
-
-`IntelligenceTextGenerator`
-
-## Methods
-
-### generateText()
-
-```ts
-generateText(prompt, options?): Promise<IIntelligenceTextCompletion>;
-```
-
-Defined in: [IntelligenceTextGenerator.ts:90](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L90)
-
-Generates a completion using the configured provider.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `prompt` | `Prompt` | The assembled prompt payload. |
-| `options?` | [`IIntelligenceTextGenerationOptions`](Interface.IIntelligenceTextGenerationOptions) | Optional overrides for the text generation request. |
-
-#### Returns
-
-`Promise`\<[`IIntelligenceTextCompletion`](Interface.IIntelligenceTextCompletion)\>
-
-#### Implementation of
-
-[`IIntelligenceTextGenerator`](Interface.IIntelligenceTextGenerator).[`generateText`](Interface.IIntelligenceTextGenerator#generatetext)
-
-***
-
-### getConfiguration()
-
-```ts
-getConfiguration(): IIntelligenceProviderConfiguration;
-```
-
-Defined in: [IntelligenceTextGenerator.ts:270](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L270)
-
-Returns the resolved provider configuration with the API key redacted.
-
-#### Returns
-
-[`IIntelligenceProviderConfiguration`](Interface.IIntelligenceProviderConfiguration)
-
-#### Implementation of
-
-[`IIntelligenceTextGenerator`](Interface.IIntelligenceTextGenerator).[`getConfiguration`](Interface.IIntelligenceTextGenerator#getconfiguration)
-
-***
-
-### onModuleInit()
-
-```ts
-onModuleInit(): Promise<void>;
-```
-
-Defined in: [IntelligenceTextGenerator.ts:74](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L74)
-
-Eagerly resolves configuration at startup to fail fast on missing keys.
-
-#### Returns
-
-`Promise`\<`void`\>
-
-#### Implementation of
-
-```ts
-OnModuleInit.onModuleInit
-```
-
-***
-
-### streamText()
-
-```ts
-streamText(prompt, options?): Promise<StreamTextResult<ToolSet, Context, Output<string, string, never>>>;
-```
-
-Defined in: [IntelligenceTextGenerator.ts:195](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L195)
-
-Streams a completion using the configured provider.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `prompt` | `Prompt` | The assembled prompt payload. |
-| `options?` | [`IIntelligenceTextStreamingOptions`](Interface.IIntelligenceTextStreamingOptions) | Optional overrides for the streaming request. |
-
-#### Returns
-
-`Promise`\<`StreamTextResult`\<`ToolSet`, `Context`, `Output`\<`string`, `string`, `never`\>\>\>
-
-#### Implementation of
-
-[`IIntelligenceTextGenerator`](Interface.IIntelligenceTextGenerator).[`streamText`](Interface.IIntelligenceTextGenerator#streamtext)

package/data/packages/platform-intelligence/api/Function.createProviderOptions.md

@@ -1,39 +0,0 @@
----
-title: 'Function: createProviderOptions()'
-generated: true
-editUrl: false
----
-# Function: createProviderOptions()
-
-```ts
-function createProviderOptions(configuration): {
-  apiKey: string;
-  baseURL?: string;
-};
-```
-
-Defined in: [providers/createProviderOptions.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/createProviderOptions.ts#L14)
-
-Creates the provider options object consumed by the AI SDK model factories.
-
-## Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `configuration` | [`IIntelligenceProviderConfiguration`](Interface.IIntelligenceProviderConfiguration) | The resolved provider configuration. |
-
-## Returns
-
-```ts
-{
-  apiKey: string;
-  baseURL?: string;
-}
-```
-
-The options record containing `apiKey` and optionally `baseURL`.
-
-| Name | Type | Defined in |
-| ------ | ------ | ------ |
-| `apiKey` | `string` | [providers/createProviderOptions.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/createProviderOptions.ts#L14) |
-| `baseURL?` | `string` | [providers/createProviderOptions.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/createProviderOptions.ts#L14) |

package/data/packages/platform-intelligence/api/Function.loadAnthropicLanguageModel.md

@@ -1,26 +0,0 @@
----
-title: 'Function: loadAnthropicLanguageModel()'
-generated: true
-editUrl: false
----
-# Function: loadAnthropicLanguageModel()
-
-```ts
-function loadAnthropicLanguageModel(configuration): Promise<LanguageModelV4>;
-```
-
-Defined in: [providers/anthropic/loadAnthropicLanguageModel.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/anthropic/loadAnthropicLanguageModel.ts#L17)
-
-Creates the Anthropic language model from the resolved provider configuration.
-
-## Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `configuration` | [`IIntelligenceProviderConfiguration`](Interface.IIntelligenceProviderConfiguration) | The resolved provider configuration. |
-
-## Returns
-
-`Promise`\<`LanguageModelV4`\>
-
-The configured language model instance.