@breadstone/archipel-mcp 0.0.54 → 0.0.56

package/data/packages/platform-intelligence/api/Interface.IIntelligenceTextStreamingOptions.md

@@ -1,170 +0,0 @@
----
-title: 'Interface: IIntelligenceTextStreamingOptions'
-generated: true
-editUrl: false
----
-# Interface: IIntelligenceTextStreamingOptions
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L34)
-
-Options that can be supplied when streaming text with the intelligence provider.
-
-## Extends
-
-- `IntelligenceStreamTextPassthroughOptions`
-
-## Properties
-
-### activeTools?
-
-```ts
-readonly optional activeTools?: string[];
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:98](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L98)
-
-Optional list of tool names available to the model for this request.
-
-***
-
-### maxOutputTokens?
-
-```ts
-readonly optional maxOutputTokens?: number;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:63](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L63)
-
-Optional maximum output tokens override.
-
-***
-
-### model?
-
-```ts
-readonly optional model?: LanguageModel;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:42](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L42)
-
-Optional per-request AI SDK model override.
-
-***
-
-### onChunk?
-
-```ts
-readonly optional onChunk?: StreamTextOnChunkCallback<ToolSet>;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:105](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L105)
-
-Optional callback invoked for every emitted stream chunk.
-
-***
-
-### onEnd?
-
-```ts
-readonly optional onEnd?: GenerateTextOnEndCallback<NoInfer<ToolSet>, NoInfer<Context>>;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:119](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L119)
-
-Optional callback invoked when the full stream finishes.
-
-***
-
-### onError?
-
-```ts
-readonly optional onError?: StreamTextOnErrorCallback;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:126](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L126)
-
-Optional callback invoked when streaming fails.
-
-***
-
-### onStepEnd?
-
-```ts
-readonly optional onStepEnd?: GenerateTextOnStepEndCallback<NoInfer<ToolSet>, NoInfer<Context>>;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:112](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L112)
-
-Optional callback invoked when a stream step completes.
-
-***
-
-### stopWhen?
-
-```ts
-readonly optional stopWhen?: StopCondition<ToolSet> | StopCondition<ToolSet>[];
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:91](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L91)
-
-Optional AI SDK stop condition for multi-step tool execution.
-
-***
-
-### temperature?
-
-```ts
-readonly optional temperature?: number;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:49](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L49)
-
-Optional sampling temperature override.
-
-***
-
-### timeout?
-
-```ts
-readonly optional timeout?: TimeoutConfiguration<ToolSet>;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:70](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L70)
-
-Native AI SDK timeout configuration.
-
-***
-
-### toolChoice?
-
-```ts
-readonly optional toolChoice?: ToolChoice<ToolSet>;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:84](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L84)
-
-Optional AI SDK tool choice strategy.
-
-***
-
-### tools?
-
-```ts
-readonly optional tools?: ToolSet;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:77](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L77)
-
-Optional AI SDK tools available for this streaming request.
-
-***
-
-### topP?
-
-```ts
-readonly optional topP?: number;
-```
-
-Defined in: [contracts/IIntelligenceTextStreamingOptions.ts:56](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceTextStreamingOptions.ts#L56)
-
-Optional top-p (nucleus) sampling override.

package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceLanguageModelLoader.md

@@ -1,24 +0,0 @@
----
-title: 'Type Alias: IntelligenceLanguageModelLoader'
-generated: true
-editUrl: false
----
-# Type Alias: IntelligenceLanguageModelLoader
-
-```ts
-type IntelligenceLanguageModelLoader = (configuration) => Promise<LanguageModelV4>;
-```
-
-Defined in: [providers/IntelligenceLanguageModelLoader.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/IntelligenceLanguageModelLoader.ts#L13)
-
-Represents a factory responsible for creating a configured language model instance.
-
-## Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `configuration` | [`IIntelligenceProviderConfiguration`](Interface.IIntelligenceProviderConfiguration) |
-
-## Returns
-
-`Promise`\<`LanguageModelV4`\>

package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceLanguageModelLoaders.md

@@ -1,14 +0,0 @@
----
-title: 'Type Alias: IntelligenceLanguageModelLoaders'
-generated: true
-editUrl: false
----
-# Type Alias: IntelligenceLanguageModelLoaders
-
-```ts
-type IntelligenceLanguageModelLoaders = Partial<Record<IntelligenceProviderName, IntelligenceLanguageModelLoader>>;
-```
-
-Defined in: [providers/IntelligenceLanguageModelLoaders.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/IntelligenceLanguageModelLoaders.ts#L13)
-
-Maps configured intelligence providers to their tree-shakable model loader.

package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceRealtimeModelLoader.md

@@ -1,25 +0,0 @@
----
-title: 'Type Alias: IntelligenceRealtimeModelLoader'
-generated: true
-editUrl: false
----
-# Type Alias: IntelligenceRealtimeModelLoader
-
-```ts
-type IntelligenceRealtimeModelLoader = (configuration, options) => Promise<RealtimeModelV4>;
-```
-
-Defined in: [providers/IntelligenceRealtimeModelLoader.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/IntelligenceRealtimeModelLoader.ts#L14)
-
-Creates a configured Vercel AI SDK realtime model behind the Archipel facade.
-
-## Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `configuration` | [`IIntelligenceProviderConfiguration`](Interface.IIntelligenceProviderConfiguration) |
-| `options` | `IIntelligenceRealtimeModelLoaderOptions` |
-
-## Returns
-
-`Promise`\<`RealtimeModelV4`\>

package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceRealtimeModelLoaders.md

@@ -1,14 +0,0 @@
----
-title: 'Type Alias: IntelligenceRealtimeModelLoaders'
-generated: true
-editUrl: false
----
-# Type Alias: IntelligenceRealtimeModelLoaders
-
-```ts
-type IntelligenceRealtimeModelLoaders = Partial<Record<IntelligenceProviderName, IntelligenceRealtimeModelLoader>>;
-```
-
-Defined in: [providers/IntelligenceRealtimeModelLoaders.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/IntelligenceRealtimeModelLoaders.ts#L13)
-
-Maps configured intelligence providers to tree-shakable realtime model loaders.

package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceTextStream.md

@@ -1,14 +0,0 @@
----
-title: 'Type Alias: IntelligenceTextStream'
-generated: true
-editUrl: false
----
-# Type Alias: IntelligenceTextStream
-
-```ts
-type IntelligenceTextStream = ReturnType<typeof streamText>;
-```
-
-Defined in: [contracts/IntelligenceTextStream.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceTextStream.ts#L12)
-
-Native AI SDK streaming result returned by the intelligence text generator.

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

@@ -1,150 +0,0 @@
----
-title: platform-logging
-description: Configurable logging module for NestJS with log-level management, request context propagation, and structured logging.
-order: 6
-tags: [logging, log-level, nestjs, request-context, structured-logging, correlation-id]
-package: '@breadstone/archipel-platform-logging'
----
-
-# platform-logging
-
-Configurable logging module for NestJS applications with application-wide log-level management, request-scoped context propagation, and structured logging. Wraps the built-in NestJS `Logger` and configures it via the central `ConfigModule`.
-
-**Package:** `@breadstone/archipel-platform-logging`
-
-<InstallTabs />
-
-## Quick Start
-
-```typescript
-import { Module } from '@nestjs/common';
-import { LoggerModule } from '@breadstone/archipel-platform-logging';
-
-@Module({
-  imports: [LoggerModule],
-})
-export class AppModule {}
-```
-
-The module is `@Global()` — once imported, `Logger` is available for injection across the entire application.
-
----
-
-## Using the Logger
-
-Inject the standard NestJS `Logger` provided by `LoggerModule`:
-
-```typescript
-import { Injectable, Logger } from '@nestjs/common';
-
-@Injectable()
-export class PaymentService {
-  constructor(private readonly _logger: Logger) {}
-
-  public async processPayment(orderId: string): Promise<void> {
-    this._logger.log(`Processing payment for order ${orderId}`);
-    // ...
-  }
-}
-```
-
----
-
-## Request Context Propagation
-
-### RequestIdMiddleware
-
-Extracts or generates a unique `x-request-id` per request and stores it in `AsyncLocalStorage` via `RequestContextStore`. Apply it globally:
-
-```typescript
-import { RequestIdMiddleware } from '@breadstone/archipel-platform-logging';
-
-export class AppModule implements NestModule {
-  public configure(consumer: MiddlewareConsumer): void {
-    consumer.apply(RequestIdMiddleware).forRoutes('*');
-  }
-}
-```
-
-The middleware:
-
-1. Reads the `x-request-id` header from the incoming request (if present from an API gateway or load balancer)
-2. Generates a UUID v4 if no header is found
-3. Sets the `x-request-id` header on the response
-4. Wraps the request execution in `RequestContextStore.run()` so the ID is available anywhere in the call stack
-
-### RequestContextStore
-
-`AsyncLocalStorage`-based per-request context store. Access the current request context from anywhere without passing parameters:
-
-```typescript
-import { RequestContextStore, type IRequestContext } from '@breadstone/archipel-platform-logging';
-
-// Get current context
-const context: IRequestContext | undefined = RequestContextStore.get();
-const requestId: string | undefined = RequestContextStore.getRequestId();
-
-// Run a callback within a context (used internally by middleware)
-RequestContextStore.run({ requestId: 'abc-123', userId: 'user-1' }, () => {
-  // context is available in all nested calls
-});
-```
-
-#### IRequestContext
-
-| Field       | Type     | Description                       |
-| ----------- | -------- | --------------------------------- |
-| `requestId` | `string` | Unique request correlation ID     |
-| `userId`    | `string?`| Optional authenticated user ID    |
-
-### ContextLogger
-
-Structured logger that automatically enriches every log entry with the current request context:
-
-```typescript
-import { ContextLogger } from '@breadstone/archipel-platform-logging';
-
-@Injectable()
-export class OrderService {
-  private readonly _logger = new ContextLogger(OrderService.name);
-
-  public async placeOrder(dto: CreateOrderDto): Promise<void> {
-    this._logger.log('Placing order', { orderId: dto.orderId });
-    // Output: { requestId: "abc-123", userId: "user-1", orderId: "...", message: "Placing order" }
-  }
-}
-```
-
-Methods: `log()`, `warn()`, `error()`, `debug()`, `verbose()` — all accept an optional `data` record that is merged with the request context.
-
----
-
-## Environment Variables
-
-| Variable        | Description                                                    | Required | Default |
-| --------------- | -------------------------------------------------------------- | -------- | ------- |
-| `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`.
-
----
-
-## Peer Dependencies
-
-| Package   | Required | Notes                                          |
-| --------- | -------- | ---------------------------------------------- |
-| `express` | Yes      | Required for `RequestIdMiddleware` types (`Request`, `Response`) |
-
----
-
-## Exports Summary
-
-| Export                  | Type          | Description                                                        |
-| ----------------------- | ------------- | ------------------------------------------------------------------ |
-| `LoggerModule`          | NestJS Module | Global logging module with log-level control                       |
-| `Logger`                | Provider      | NestJS Logger configured with `APP_LOG_LEVEL`                      |
-| `ContextLogger`         | Class         | Structured logger enriched with request context                    |
-| `RequestContextStore`   | Class         | AsyncLocalStorage-based per-request context (requestId, userId)    |
-| `RequestIdMiddleware`   | Middleware    | Extracts/generates `x-request-id` and wraps in context store       |
-| `IRequestContext`       | Interface     | Shape of the per-request context                                   |
-| `REQUEST_ID_HEADER`     | Constant      | Header name (`'x-request-id'`)                                     |