@breadstone/archipel-mcp 0.0.20 → 0.0.21

package/data/packages/platform-documents/api/Class.ImageProcessingError.md

@@ -0,0 +1,53 @@
+---
+title: 'Class: ImageProcessingError'
+generated: true
+editUrl: false
+---
+# Class: ImageProcessingError
+
+Defined in: [errors/ImageProcessingError.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/ImageProcessingError.ts#L8)
+
+Thrown when image processing fails.
+
+## Extends
+
+- [`DocumentError`](Class.DocumentError)
+
+## Constructors
+
+### Constructor
+
+```ts
+new ImageProcessingError(message, cause?): ImageProcessingError;
+```
+
+Defined in: [errors/ImageProcessingError.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/ImageProcessingError.ts#L11)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `cause?` | `unknown` |
+
+#### Returns
+
+`ImageProcessingError`
+
+#### Overrides
+
+[`DocumentError`](Class.DocumentError).[`constructor`](Class.DocumentError#constructor)
+
+## Properties
+
+### code
+
+```ts
+readonly code: string;
+```
+
+Defined in: [errors/DocumentError.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/errors/DocumentError.ts#L10)
+
+#### Inherited from
+
+[`DocumentError`](Class.DocumentError).[`code`](Class.DocumentError#code)

package/data/packages/platform-documents/api/Class.SharpImageProcessor.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: SharpImageProcessor
 
-Defined in: [processor/SharpImageProcessor.ts:26](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L26)
+Defined in: [processor/SharpImageProcessor.ts:28](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L28)
 
 Sharp-based image processor.
 Handles image resizing and format conversion.
@@ -22,7 +22,7 @@ Handles image resizing and format conversion.
 new SharpImageProcessor(options): SharpImageProcessor;
 ```
 
-Defined in: [processor/SharpImageProcessor.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L36)
+Defined in: [processor/SharpImageProcessor.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L38)
 
 #### Parameters
 
@@ -42,7 +42,7 @@ Defined in: [processor/SharpImageProcessor.ts:36](https://github.com/RueDeRennes
 process(payload): Promise<IImagePayload>;
 ```
 
-Defined in: [processor/SharpImageProcessor.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L51)
+Defined in: [processor/SharpImageProcessor.ts:53](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L53)
 
 Process image payload.
 
@@ -74,7 +74,7 @@ toJpeg(
 quality?): Promise<Buffer<ArrayBufferLike>>;
 ```
 
-Defined in: [processor/SharpImageProcessor.ts:120](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L120)
+Defined in: [processor/SharpImageProcessor.ts:129](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L129)
 
 Convert to JPEG.
 
@@ -108,7 +108,7 @@ toPng(
 height?): Promise<Buffer<ArrayBufferLike>>;
 ```
 
-Defined in: [processor/SharpImageProcessor.ts:95](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L95)
+Defined in: [processor/SharpImageProcessor.ts:102](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-documents/src/processor/SharpImageProcessor.ts#L102)
 
 Convert to PNG.
 

package/data/packages/platform-documents/api/index.md

@@ -11,7 +11,11 @@ editUrl: false
 | ------ | ------ |
 | [BaseDocumentRenderer](Class.BaseDocumentRenderer) | Base class for document renderers. Provides common functionality for template loading, parsing, and image processing. |
 | [DocumentEngine](Class.DocumentEngine) | DocumentEngine orchestrates document generation workflow. Coordinates resource loading and renderer components. |
+| [DocumentError](Class.DocumentError) | Base class for document-related domain errors. |
 | [DocumentModule](Class.DocumentModule) | DocumentModule provides services for document generation and image processing. Uses abstract base classes and interfaces for extensibility. |
+| [DocumentRenderError](Class.DocumentRenderError) | Thrown when document rendering fails. |
+| [DocumentValidationError](Class.DocumentValidationError) | Thrown when document input validation fails. |
+| [ImageProcessingError](Class.ImageProcessingError) | Thrown when image processing fails. |
 | [SharpImageProcessor](Class.SharpImageProcessor) | Sharp-based image processor. Handles image resizing and format conversion. |
 
 ## Interfaces

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

@@ -203,6 +203,29 @@ export class ContractController {
 
 ---
 
+## Error Handling
+
+The library provides a hierarchy of domain error classes for structured error handling:
+
+| Error class                | Base class      | When thrown                                       |
+| -------------------------- | --------------- | ------------------------------------------------- |
+| `DocumentError`            | `Error`         | Base class for all document errors                |
+| `DocumentRenderError`      | `DocumentError` | Template rendering failures (DOCX, PDF)           |
+| `DocumentValidationError`  | `DocumentError` | Invalid templates, missing placeholders           |
+| `ImageProcessingError`     | `DocumentError` | Image resize/conversion failures (Sharp)          |
+
+```typescript
+import {
+  DocumentRenderError,
+  DocumentValidationError,
+  ImageProcessingError,
+} from '@breadstone/archipel-platform-documents';
+```
+
+All errors extend `DocumentError`, so a single `catch (error instanceof DocumentError)` handles any document-related failure.
+
+---
+
 ## Exports Summary
 
 | Export                 | Type           | Description                               |
@@ -217,3 +240,7 @@ export class ContractController {
 | `TemplateFormat`       | Enum           | Template format identifiers               |
 | `IRenderResult`        | Interface      | Render output (buffer, name, contentType) |
 | `IDocumentProbeReport` | Interface      | Template validation report                |
+| `DocumentError`        | Error class    | Base document error                       |
+| `DocumentRenderError`  | Error class    | Render failure error                      |
+| `DocumentValidationError` | Error class | Validation failure error                  |
+| `ImageProcessingError` | Error class    | Image processing failure error            |

package/data/packages/platform-esigning/api/Class.EsigningClientPort.md

@@ -14,8 +14,8 @@ this contract so that the consuming application can switch providers without cha
 ## Extended by
 
 - [`InternalEsigningProvider`](Class.InternalEsigningProvider)
-- [`AdobeSignEsigningProvider`](Class.AdobeSignEsigningProvider)
 - [`DocuSignEsigningProvider`](Class.DocuSignEsigningProvider)
+- [`AdobeSignEsigningProvider`](Class.AdobeSignEsigningProvider)
 - [`DropboxSignEsigningProvider`](Class.DropboxSignEsigningProvider)
 
 ## Constructors

package/data/packages/platform-esigning/api/Class.InternalEsigningProvider.md

@@ -41,7 +41,7 @@ new InternalEsigningProvider(): InternalEsigningProvider;
 get providerId(): string;
 ```
 
-Defined in: [providers/internal/InternalEsigningProvider.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L51)
+Defined in: [providers/internal/InternalEsigningProvider.ts:53](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L53)
 
 Unique identifier of the provider implementation.
 
@@ -63,7 +63,7 @@ Unique identifier of the provider implementation.
 cancelSigningRequest(signingRequestId, _reason?): Promise<void>;
 ```
 
-Defined in: [providers/internal/InternalEsigningProvider.ts:181](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L181)
+Defined in: [providers/internal/InternalEsigningProvider.ts:192](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L192)
 
 Cancel an in-progress signing request.
 
@@ -90,7 +90,7 @@ Cancel an in-progress signing request.
 completeSigner(signingRequestId, signerId): Promise<void>;
 ```
 
-Defined in: [providers/internal/InternalEsigningProvider.ts:208](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L208)
+Defined in: [providers/internal/InternalEsigningProvider.ts:219](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L219)
 
 Marks a signer as having completed their signing.
 This is specific to the internal provider and allows the consuming
@@ -115,7 +115,7 @@ application to programmatically complete a signer's step.
 createSigningRequest(request): Promise<ISigningRequest>;
 ```
 
-Defined in: [providers/internal/InternalEsigningProvider.ts:59](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L59)
+Defined in: [providers/internal/InternalEsigningProvider.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L61)
 
 Create a new signing request (envelope/agreement).
 
@@ -143,7 +143,7 @@ The created signing request with provider-assigned identifiers.
 createSigningSession(request): Promise<ISigningSession>;
 ```
 
-Defined in: [providers/internal/InternalEsigningProvider.ts:121](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L121)
+Defined in: [providers/internal/InternalEsigningProvider.ts:132](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L132)
 
 Generate a signing session (signing link/URL) for a specific signer.
 
@@ -171,7 +171,7 @@ The signing session with the signing URL.
 getSignedDocuments(signingRequestId): Promise<ISignedDocument[]>;
 ```
 
-Defined in: [providers/internal/InternalEsigningProvider.ts:164](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L164)
+Defined in: [providers/internal/InternalEsigningProvider.ts:175](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L175)
 
 Retrieve the final signed documents for a completed signing request.
 
@@ -199,7 +199,7 @@ Array of signed documents with their content.
 getSigningRequest(signingRequestId): Promise<ISigningRequest>;
 ```
 
-Defined in: [providers/internal/InternalEsigningProvider.ts:150](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L150)
+Defined in: [providers/internal/InternalEsigningProvider.ts:161](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L161)
 
 Retrieve the current status and details of a signing request.
 
@@ -230,7 +230,7 @@ verifyWebhook(
 _headers?): Promise<IEsigningWebhookEvent>;
 ```
 
-Defined in: [providers/internal/InternalEsigningProvider.ts:191](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L191)
+Defined in: [providers/internal/InternalEsigningProvider.ts:202](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-esigning/src/providers/internal/InternalEsigningProvider.ts#L202)
 
 Verify a webhook payload signature and return a normalized event.
 

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

@@ -108,6 +108,8 @@ EsigningModule.register({
 
 The `InternalEsigningProvider` manages signing requests in-memory. Suitable for development, testing, or simple self-managed signing workflows.
 
+> **Capacity limit:** The internal provider enforces a maximum of **10,000** stored signing requests. Attempts to create beyond this limit throw an error. Use an external provider for production workloads.
+
 ```typescript
 import { InternalEsigningProvider } from '@breadstone/archipel-platform-esigning';
 

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

@@ -33,7 +33,7 @@ new IntelligenceCapabilityRegistry(): IntelligenceCapabilityRegistry;
 list(): readonly IIntelligenceCapability[];
 ```
 
-Defined in: [IntelligenceCapabilityRegistry.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L36)
+Defined in: [IntelligenceCapabilityRegistry.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L45)
 
 Returns a read-only snapshot of all registered capabilities.
 
@@ -55,7 +55,7 @@ A defensive copy of the registered capabilities.
 register(capability): void;
 ```
 
-Defined in: [IntelligenceCapabilityRegistry.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L25)
+Defined in: [IntelligenceCapabilityRegistry.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L27)
 
 Registers a capability in the registry.
 
@@ -83,7 +83,7 @@ resolve(intent, context):
   | null;
 ```
 
-Defined in: [IntelligenceCapabilityRegistry.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L31)
+Defined in: [IntelligenceCapabilityRegistry.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L40)
 
 Resolves the most suitable capability for the given intent and context.
 

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

@@ -0,0 +1,50 @@
+---
+title: 'Class: IntelligenceConfigurationError'
+generated: true
+editUrl: false
+---
+# Class: IntelligenceConfigurationError
+
+Defined in: [errors/IntelligenceConfigurationError.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/errors/IntelligenceConfigurationError.ts#L6)
+
+Error thrown when an intelligence provider configuration is invalid or missing.
+
+## Extends
+
+- `Error`
+
+## Constructors
+
+### Constructor
+
+```ts
+new IntelligenceConfigurationError(message): IntelligenceConfigurationError;
+```
+
+Defined in: [errors/IntelligenceConfigurationError.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/errors/IntelligenceConfigurationError.ts#L15)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+
+#### Returns
+
+`IntelligenceConfigurationError`
+
+#### Overrides
+
+```ts
+Error.constructor
+```
+
+## Properties
+
+### code
+
+```ts
+readonly code: "INTELLIGENCE_CONFIGURATION" = 'INTELLIGENCE_CONFIGURATION';
+```
+
+Defined in: [errors/IntelligenceConfigurationError.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/errors/IntelligenceConfigurationError.ts#L9)

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

@@ -5,13 +5,14 @@ editUrl: false
 ---
 # Class: IntelligenceTextGenerator
 
-Defined in: [IntelligenceTextGenerator.ts:52](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L52)
+Defined in: [IntelligenceTextGenerator.ts:54](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L54)
 
 Executes text completions using the configured intelligence provider.
 
 ## Implements
 
 - [`IIntelligenceTextGenerator`](Interface.IIntelligenceTextGenerator)
+- `OnModuleInit`
 
 ## Constructors
 
@@ -21,7 +22,7 @@ Executes text completions using the configured intelligence provider.
 new IntelligenceTextGenerator(configService): IntelligenceTextGenerator;
 ```
 
-Defined in: [IntelligenceTextGenerator.ts:65](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L65)
+Defined in: [IntelligenceTextGenerator.ts:67](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L67)
 
 #### Parameters
 
@@ -41,7 +42,7 @@ Defined in: [IntelligenceTextGenerator.ts:65](https://github.com/RueDeRennes/arc
 generateText(prompt, options?): Promise<IIntelligenceTextCompletion>;
 ```
 
-Defined in: [IntelligenceTextGenerator.ts:85](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L85)
+Defined in: [IntelligenceTextGenerator.ts:99](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L99)
 
 Generates a completion using the configured provider.
 
@@ -68,7 +69,7 @@ Generates a completion using the configured provider.
 getConfiguration(): IIntelligenceProviderConfiguration;
 ```
 
-Defined in: [IntelligenceTextGenerator.ts:192](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L192)
+Defined in: [IntelligenceTextGenerator.ts:206](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L206)
 
 Returns the resolved provider configuration with the API key redacted.
 
@@ -79,3 +80,25 @@ Returns the resolved provider configuration with the API key redacted.
 #### Implementation of
 
 [`IIntelligenceTextGenerator`](Interface.IIntelligenceTextGenerator).[`getConfiguration`](Interface.IIntelligenceTextGenerator#getconfiguration)
+
+***
+
+### onModuleInit()
+
+```ts
+onModuleInit(): void;
+```
+
+Defined in: [IntelligenceTextGenerator.ts:86](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceTextGenerator.ts#L86)
+
+Eagerly resolves configuration at startup to fail fast on missing keys.
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+```ts
+OnModuleInit.onModuleInit
+```

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

@@ -0,0 +1,50 @@
+---
+title: 'Class: IntelligenceValidationError'
+generated: true
+editUrl: false
+---
+# Class: IntelligenceValidationError
+
+Defined in: [errors/IntelligenceValidationError.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/errors/IntelligenceValidationError.ts#L6)
+
+Error thrown when an intelligence input validation fails.
+
+## Extends
+
+- `Error`
+
+## Constructors
+
+### Constructor
+
+```ts
+new IntelligenceValidationError(message): IntelligenceValidationError;
+```
+
+Defined in: [errors/IntelligenceValidationError.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/errors/IntelligenceValidationError.ts#L15)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+
+#### Returns
+
+`IntelligenceValidationError`
+
+#### Overrides
+
+```ts
+Error.constructor
+```
+
+## Properties
+
+### code
+
+```ts
+readonly code: "INTELLIGENCE_VALIDATION" = 'INTELLIGENCE_VALIDATION';
+```
+
+Defined in: [errors/IntelligenceValidationError.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/errors/IntelligenceValidationError.ts#L9)

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

@@ -9,7 +9,7 @@ editUrl: false
 function loadProviderFactory(moduleName, exportName): Promise<(model, options) => LanguageModelV2>;
 ```
 
-Defined in: [providers/ProviderFactoryLoader.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/ProviderFactoryLoader.ts#L16)
+Defined in: [providers/ProviderFactoryLoader.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/ProviderFactoryLoader.ts#L17)
 
 Dynamically loads an AI SDK provider factory and returns the exported function reference.
 

package/data/packages/platform-intelligence/api/index.md

@@ -11,9 +11,11 @@ editUrl: false
 | ------ | ------ |
 | [IntelligenceCapabilityRegistrarBase](Class.IntelligenceCapabilityRegistrarBase) | Provides a reusable registration flow that allows feature modules to contribute capabilities to the global intelligence registry while keeping their implementation details private. |
 | [IntelligenceCapabilityRegistry](Class.IntelligenceCapabilityRegistry) | Central registry responsible for resolving intelligence capabilities based on intent metadata. |
+| [IntelligenceConfigurationError](Class.IntelligenceConfigurationError) | Error thrown when an intelligence provider configuration is invalid or missing. |
 | [IntelligenceModule](Class.IntelligenceModule) | Core module exposing the shared intelligence infrastructure to feature modules. |
 | [IntelligenceProviderError](Class.IntelligenceProviderError) | Error thrown when an intelligence provider call fails. |
 | [IntelligenceTextGenerator](Class.IntelligenceTextGenerator) | Executes text completions using the configured intelligence provider. |
+| [IntelligenceValidationError](Class.IntelligenceValidationError) | Error thrown when an intelligence input validation fails. |
 
 ## Interfaces
 

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

@@ -150,6 +150,38 @@ All errors are wrapped in `IntelligenceProviderError` with `provider`, `model`,
 
 ---
 
+## Error Handling
+
+The library provides three domain error classes for different failure scenarios:
+
+| Error class                        | Code                          | When thrown                                                           |
+| ---------------------------------- | ----------------------------- | --------------------------------------------------------------------- |
+| `IntelligenceProviderError`        | `INTELLIGENCE_PROVIDER`       | Provider SDK failures during text generation                          |
+| `IntelligenceValidationError`      | `INTELLIGENCE_VALIDATION`     | Invalid generation parameters (temperature, topP, maxOutputTokens)    |
+| `IntelligenceConfigurationError`   | `INTELLIGENCE_CONFIGURATION`  | Unsupported provider, missing API key, or missing SDK package         |
+
+```typescript
+import {
+  IntelligenceProviderError,
+  IntelligenceValidationError,
+  IntelligenceConfigurationError,
+} from '@breadstone/archipel-platform-intelligence';
+```
+
+---
+
+## Lifecycle
+
+`IntelligenceTextGenerator` implements `OnModuleInit` and validates the provider configuration eagerly at startup. Missing API keys or unsupported providers throw `IntelligenceConfigurationError` before the first request is processed.
+
+---
+
+## Capability Registry Limits
+
+`IntelligenceCapabilityRegistry` enforces a maximum of **500** registered capabilities. Attempts to register beyond this limit are logged as warnings and silently ignored. This prevents unbounded memory growth in applications with dynamic capability registration.
+
+---
+
 ## API Reference
 
 See the full [API documentation](./api/) for all exported types, interfaces, and classes.

package/data/packages/platform-logging/api/Class.LoggerModule.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: LoggerModule
 
-Defined in: [LoggerModule.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-logging/src/LoggerModule.ts#L31)
+Defined in: [LoggerModule.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-logging/src/LoggerModule.ts#L35)
 
 Global logging module that configures the NestJS Logger with an application-wide log level.
 

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

@@ -54,6 +54,8 @@ export class PaymentService {
 | --------------- | -------------------------------------------------------------- | -------- | ------- |
 | `APP_LOG_LEVEL` | Application log level (`'debug'`, `'info'`, `'warn'`, `'error'`) | No       | `warn`  |
 
+> **Startup validation:** The module validates `APP_LOG_LEVEL` at initialization. An unrecognized value triggers a warning and falls back to `warn`.
+
 ---
 
 ## Exports Summary

package/data/packages/platform-mailing/api/Class.MailDeliveryError.md

@@ -0,0 +1,65 @@
+---
+title: 'Class: MailDeliveryError'
+generated: true
+editUrl: false
+---
+# Class: MailDeliveryError
+
+Defined in: [platform-mailing/src/errors/MailDeliveryError.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/errors/MailDeliveryError.ts#L6)
+
+Domain error thrown when email delivery fails.
+
+## Extends
+
+- `Error`
+
+## Constructors
+
+### Constructor
+
+```ts
+new MailDeliveryError(
+   provider, 
+   message, 
+   cause?): MailDeliveryError;
+```
+
+Defined in: [platform-mailing/src/errors/MailDeliveryError.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/errors/MailDeliveryError.ts#L16)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `provider` | `string` |
+| `message` | `string` |
+| `cause?` | `unknown` |
+
+#### Returns
+
+`MailDeliveryError`
+
+#### Overrides
+
+```ts
+Error.constructor
+```
+
+## Properties
+
+### code
+
+```ts
+readonly code: "MAIL_DELIVERY" = 'MAIL_DELIVERY';
+```
+
+Defined in: [platform-mailing/src/errors/MailDeliveryError.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/errors/MailDeliveryError.ts#L9)
+
+***
+
+### provider
+
+```ts
+readonly provider: string;
+```
+
+Defined in: [platform-mailing/src/errors/MailDeliveryError.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/errors/MailDeliveryError.ts#L10)

package/data/packages/platform-mailing/api/Class.MailgunDeliveryStrategy.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: MailgunDeliveryStrategy
 
-Defined in: [platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts#L18)
+Defined in: [platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts#L19)
 
 Delivers emails via the Mailgun API.
 
@@ -21,7 +21,7 @@ Delivers emails via the Mailgun API.
 new MailgunDeliveryStrategy(configService): MailgunDeliveryStrategy;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts#L34)
+Defined in: [platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts#L35)
 
 Constructs a new instance of the `MailgunDeliveryStrategy` class.
 
@@ -53,7 +53,7 @@ send(
 _attachments?): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts:59](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts#L59)
+Defined in: [platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts:60](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/MailgunDeliveryStrategy.ts#L60)
 
 Sends an email using the Mailgun transport.
 

package/data/packages/platform-mailing/api/Class.PostmarkDeliveryStrategy.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: PostmarkDeliveryStrategy
 
-Defined in: [platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts#L16)
+Defined in: [platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts#L17)
 
 The `PostmarkDeliveryStrategy` class.
 
@@ -21,7 +21,7 @@ The `PostmarkDeliveryStrategy` class.
 new PostmarkDeliveryStrategy(configService): PostmarkDeliveryStrategy;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts#L31)
+Defined in: [platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts:32](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts#L32)
 
 Constructs a new instance of the `PostmarkDeliveryStrategy` class.
 
@@ -53,7 +53,7 @@ send(
 _attachments?): Promise<void>;
 ```
 
-Defined in: [platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts#L51)
+Defined in: [platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts:52](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/services/strategies/PostmarkDeliveryStrategy.ts#L52)
 
 Sends an email using the Postmark transport.