@breadstone/archipel-mcp 0.0.51 → 0.0.53

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: IntelligenceHealthIndicator
 
-Defined in: [health/IntelligenceHealthIndicator.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/health/IntelligenceHealthIndicator.ts#L17)
+Defined in: [health/IntelligenceHealthIndicator.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/health/IntelligenceHealthIndicator.ts#L18)
 
 Health indicator for the intelligence infrastructure.
 Verifies that the intelligence provider configuration can be resolved.
@@ -19,16 +19,17 @@ Verifies that the intelligence provider configuration can be resolved.
 ### Constructor
 
 ```ts
-new IntelligenceHealthIndicator(textGenerator?): IntelligenceHealthIndicator;
+new IntelligenceHealthIndicator(textGenerator?, realtimeSessionFactory?): IntelligenceHealthIndicator;
 ```
 
-Defined in: [health/IntelligenceHealthIndicator.ts:26](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/health/IntelligenceHealthIndicator.ts#L26)
+Defined in: [health/IntelligenceHealthIndicator.ts:28](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/health/IntelligenceHealthIndicator.ts#L28)
 
 #### Parameters
 
 | Parameter | Type |
 | ------ | ------ |
 | `textGenerator?` | [`IntelligenceTextGenerator`](Class.IntelligenceTextGenerator) |
+| `realtimeSessionFactory?` | [`IntelligenceRealtimeSessionFactory`](Class.IntelligenceRealtimeSessionFactory) |
 
 #### Returns
 
@@ -42,7 +43,7 @@ Defined in: [health/IntelligenceHealthIndicator.ts:26](https://github.com/RueDeR
 readonly key: string = 'intelligence';
 ```
 
-Defined in: [health/IntelligenceHealthIndicator.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/health/IntelligenceHealthIndicator.ts#L34)
+Defined in: [health/IntelligenceHealthIndicator.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/health/IntelligenceHealthIndicator.ts#L37)
 
 Unique key identifying the indicator
 
@@ -60,7 +61,7 @@ IHealthIndicator.key
 check(): HealthIndicatorResult<string>;
 ```
 
-Defined in: [health/IntelligenceHealthIndicator.ts:47](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/health/IntelligenceHealthIndicator.ts#L47)
+Defined in: [health/IntelligenceHealthIndicator.ts:50](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/health/IntelligenceHealthIndicator.ts#L50)
 
 Verifies that the provider configuration can be resolved.
 Returns disabled status when no text generator is configured.

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: IntelligenceMediaGenerator
 
-Defined in: IntelligenceMediaGenerator.ts:14
+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.
 
@@ -29,7 +29,7 @@ new IntelligenceMediaGenerator(): IntelligenceMediaGenerator;
 generateImage(options): Promise<GenerateImageResult>;
 ```
 
-Defined in: IntelligenceMediaGenerator.ts:36
+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.
 
@@ -53,7 +53,7 @@ The native AI SDK image-generation result.
 generateSpeech(options): Promise<SpeechResult>;
 ```
 
-Defined in: IntelligenceMediaGenerator.ts:47
+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.
 
@@ -77,7 +77,7 @@ The native AI SDK speech-generation result.
 generateVideo(options): Promise<GenerateVideoResult>;
 ```
 
-Defined in: IntelligenceMediaGenerator.ts:69
+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.
 
@@ -101,7 +101,7 @@ The native AI SDK video-generation result.
 transcribe(options): Promise<TranscriptionResult>;
 ```
 
-Defined in: IntelligenceMediaGenerator.ts:58
+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.
 

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: IntelligenceModule
 
-Defined in: [IntelligenceModule.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceModule.ts#L51)
+Defined in: [IntelligenceModule.ts:59](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceModule.ts#L59)
 
 Core module exposing the shared intelligence infrastructure.
 
@@ -29,7 +29,7 @@ new IntelligenceModule(): IntelligenceModule;
 static register(options?): DynamicModule;
 ```
 
-Defined in: [IntelligenceModule.ts:62](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceModule.ts#L62)
+Defined in: [IntelligenceModule.ts:70](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceModule.ts#L70)
 
 Registers the intelligence module and optional class-based tools.
 

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: IntelligenceProviderAssetUploader
 
-Defined in: IntelligenceProviderAssetUploader.ts:14
+Defined in: [IntelligenceProviderAssetUploader.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceProviderAssetUploader.ts#L20)
 
 Uploads provider-managed files and skills for reuse in AI SDK calls.
 
@@ -29,7 +29,7 @@ new IntelligenceProviderAssetUploader(): IntelligenceProviderAssetUploader;
 uploadFile(options): Promise<UploadFileResult>;
 ```
 
-Defined in: IntelligenceProviderAssetUploader.ts:36
+Defined in: [IntelligenceProviderAssetUploader.ts:42](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceProviderAssetUploader.ts#L42)
 
 Uploads a provider-managed file.
 
@@ -50,10 +50,11 @@ The native AI SDK upload result.
 ### uploadSkill()
 
 ```ts
-uploadSkill(options): Promise<UploadSkillResult>;
+uploadSkill(options): Promise<Omit<SkillsV4UploadSkillResult, "providerReference" | "warnings"> & {
+}>;
 ```
 
-Defined in: IntelligenceProviderAssetUploader.ts:47
+Defined in: [IntelligenceProviderAssetUploader.ts:55](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceProviderAssetUploader.ts#L55)
 
 Uploads a provider-managed skill.
 
@@ -65,6 +66,7 @@ Uploads a provider-managed skill.
 
 #### Returns
 
-`Promise`\<`UploadSkillResult`\>
+`Promise`\<`Omit`\<`SkillsV4UploadSkillResult`, `"providerReference"` \| `"warnings"`\> & \{
+\}\>
 
 The native AI SDK upload result.

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

@@ -0,0 +1,110 @@
+---
+title: 'Class: IntelligenceRealtimeError'
+generated: true
+editUrl: false
+---
+# Class: IntelligenceRealtimeError
+
+Defined in: errors/IntelligenceRealtimeError.ts:12
+
+Error raised by a realtime session, transport, or metering adapter.
+
+## Extends
+
+- `Error`
+
+## Constructors
+
+### Constructor
+
+```ts
+new IntelligenceRealtimeError(
+   message, 
+   phase, 
+   provider, 
+   model, 
+   sessionId, 
+   isRetryable, 
+   cause?): IntelligenceRealtimeError;
+```
+
+Defined in: errors/IntelligenceRealtimeError.ts:25
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `message` | `string` |
+| `phase` | \| `"configuration"` \| `"token"` \| `"connect"` \| `"send"` \| `"receive"` \| `"metering"` \| `"close"` |
+| `provider` | [`IntelligenceProviderName`](TypeAlias.IntelligenceProviderName) |
+| `model` | `string` |
+| `sessionId` | `string` |
+| `isRetryable` | `boolean` |
+| `cause?` | `Error` |
+
+#### Returns
+
+`IntelligenceRealtimeError`
+
+#### Overrides
+
+```ts
+Error.constructor
+```
+
+## Properties
+
+### isRetryable
+
+```ts
+readonly isRetryable: boolean;
+```
+
+Defined in: errors/IntelligenceRealtimeError.ts:19
+
+***
+
+### model
+
+```ts
+readonly model: string;
+```
+
+Defined in: errors/IntelligenceRealtimeError.ts:17
+
+***
+
+### phase
+
+```ts
+readonly phase: 
+  | "configuration"
+  | "token"
+  | "connect"
+  | "send"
+  | "receive"
+  | "metering"
+  | "close";
+```
+
+Defined in: errors/IntelligenceRealtimeError.ts:15
+
+***
+
+### provider
+
+```ts
+readonly provider: IntelligenceProviderName;
+```
+
+Defined in: errors/IntelligenceRealtimeError.ts:16
+
+***
+
+### sessionId
+
+```ts
+readonly sessionId: string;
+```
+
+Defined in: errors/IntelligenceRealtimeError.ts:18

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

@@ -0,0 +1,47 @@
+---
+title: 'Abstract Class: IntelligenceRealtimeMeteringPort'
+generated: true
+editUrl: false
+---
+# Abstract Class: IntelligenceRealtimeMeteringPort
+
+Defined in: realtime/ports/IntelligenceRealtimeMeteringPort.ts:15
+
+Application port for idempotently persisting realtime billing and audit events.
+
+Implementations should treat `eventId` as an idempotency key and persist the
+commercial debit and AI audit record in one application transaction.
+
+## Constructors
+
+### Constructor
+
+```ts
+new IntelligenceRealtimeMeteringPort(): IntelligenceRealtimeMeteringPort;
+```
+
+#### Returns
+
+`IntelligenceRealtimeMeteringPort`
+
+## Methods
+
+### report()
+
+```ts
+abstract report(event): Promise<void>;
+```
+
+Defined in: realtime/ports/IntelligenceRealtimeMeteringPort.ts:23
+
+Persists one metering event.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `event` | [`IntelligenceRealtimeMeteringEvent`](TypeAlias.IntelligenceRealtimeMeteringEvent) | Normalized, idempotently identifiable metering event. |
+
+#### Returns
+
+`Promise`\<`void`\>

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

@@ -0,0 +1,129 @@
+---
+title: 'Class: IntelligenceRealtimeSessionFactory'
+generated: true
+editUrl: false
+---
+# Class: IntelligenceRealtimeSessionFactory
+
+Defined in: IntelligenceRealtimeSessionFactory.ts:35
+
+Creates and owns server-side, provider-neutral realtime AI sessions.
+
+Applications forward normalized events and audio chunks through their own
+authenticated WebSocket gateway. Provider credentials, provider event
+mappings, token creation, and upstream sockets remain inside Archipel.
+
+## Implements
+
+- `OnModuleDestroy`
+
+## Constructors
+
+### Constructor
+
+```ts
+new IntelligenceRealtimeSessionFactory(
+   configService, 
+   toolRegistry, 
+   metering, 
+   providerLoaders, 
+   runtime): IntelligenceRealtimeSessionFactory;
+```
+
+Defined in: IntelligenceRealtimeSessionFactory.ts:55
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `configService` | `ConfigService` |
+| `toolRegistry` | [`IntelligenceToolRegistry`](Class.IntelligenceToolRegistry) |
+| `metering` | [`IntelligenceRealtimeMeteringPort`](Class.IntelligenceRealtimeMeteringPort) |
+| `providerLoaders` | [`IntelligenceRealtimeModelLoaders`](TypeAlias.IntelligenceRealtimeModelLoaders) |
+| `runtime` | `IIntelligenceRealtimeRuntimeOptions` |
+
+#### Returns
+
+`IntelligenceRealtimeSessionFactory`
+
+## Accessors
+
+### activeSessionCount
+
+#### Get Signature
+
+```ts
+get activeSessionCount(): number;
+```
+
+Defined in: IntelligenceRealtimeSessionFactory.ts:74
+
+Number of sessions currently owned by this module instance.
+
+##### Returns
+
+`number`
+
+***
+
+### registeredProviders
+
+#### Get Signature
+
+```ts
+get registeredProviders(): readonly IntelligenceProviderName[];
+```
+
+Defined in: IntelligenceRealtimeSessionFactory.ts:79
+
+Providers currently registered for server-owned realtime sessions.
+
+##### Returns
+
+readonly [`IntelligenceProviderName`](TypeAlias.IntelligenceProviderName)[]
+
+## Methods
+
+### createSession()
+
+```ts
+createSession(options): Promise<IntelligenceRealtimeSessionPort>;
+```
+
+Defined in: IntelligenceRealtimeSessionFactory.ts:93
+
+Creates an isolated realtime session without opening the upstream socket.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options` | [`IIntelligenceRealtimeSessionOptions`](Interface.IIntelligenceRealtimeSessionOptions) | Logical session, provider, model, tools, and event callbacks. |
+
+#### Returns
+
+`Promise`\<[`IntelligenceRealtimeSessionPort`](Class.IntelligenceRealtimeSessionPort)\>
+
+A provider-neutral session. Call `connect()` to start streaming.
+
+***
+
+### onModuleDestroy()
+
+```ts
+onModuleDestroy(): Promise<void>;
+```
+
+Defined in: IntelligenceRealtimeSessionFactory.ts:132
+
+Closes all owned upstream sessions during Nest application shutdown.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+```ts
+OnModuleDestroy.onModuleDestroy
+```