@breadstone/archipel-mcp 0.0.55 → 0.0.57

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

@@ -17,7 +17,7 @@ Options used to create one server-owned realtime model connection.
 readonly optional activeToolNames?: readonly string[];
 ```
 
-Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L31)
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L34)
 
 Optional allow-list of registered Archipel tools exposed to this session.
 
@@ -29,7 +29,7 @@ Optional allow-list of registered Archipel tools exposed to this session.
 readonly optional metadata?: Readonly<Record<string, IntelligenceRealtimeMetadataValue>>;
 ```
 
-Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L34)
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L37)
 
 Bounded, non-sensitive correlation metadata copied to metering events.
 
@@ -41,7 +41,7 @@ Bounded, non-sensitive correlation metadata copied to metering events.
 readonly model: string;
 ```
 
-Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L22)
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L25)
 
 Realtime model identifier such as `gpt-realtime`.
 
@@ -53,7 +53,7 @@ Realtime model identifier such as `gpt-realtime`.
 readonly optional onClose?: (event) => void | Promise<void>;
 ```
 
-Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:43](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L43)
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:46](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L46)
 
 Receives the terminal upstream connection state.
 
@@ -75,7 +75,7 @@ Receives the terminal upstream connection state.
 readonly optional onError?: (error) => void | Promise<void>;
 ```
 
-Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L40)
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:43](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L43)
 
 Receives transport, provider, parsing, and metering adapter failures.
 
@@ -97,7 +97,7 @@ Receives transport, provider, parsing, and metering adapter failures.
 readonly optional onEvent?: (event) => void | Promise<void>;
 ```
 
-Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L37)
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L40)
 
 Receives normalized provider events in wire order.
 
@@ -119,19 +119,31 @@ Receives normalized provider events in wire order.
 readonly optional provider?: string;
 ```
 
-Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L25)
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:28](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L28)
 
 Optional provider override. Defaults to the configured intelligence provider.
 
 ***
 
+### requestId?
+
+```ts
+readonly optional requestId?: string;
+```
+
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L19)
+
+Correlation identifier included in structured Archipel logs.
+
+***
+
 ### sessionConfiguration?
 
 ```ts
 readonly optional sessionConfiguration?: IIntelligenceRealtimeSessionConfiguration;
 ```
 
-Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:28](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L28)
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L31)
 
 Provider-neutral realtime session configuration.
 
@@ -143,6 +155,6 @@ Provider-neutral realtime session configuration.
 readonly sessionId: string;
 ```
 
-Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L19)
+Defined in: [realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/interfaces/IIntelligenceRealtimeSessionOptions.ts#L22)
 
 Application-owned identifier used for persistence, billing, and audit correlation.

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

@@ -5,22 +5,96 @@ editUrl: false
 ---
 # Interface: IIntelligenceRealtimeUsage
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L9)
+Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L15)
 
 Normalized token usage reported by a realtime provider.
 
 Null values mean the provider did not expose that dimension. Applications
 can therefore distinguish missing data from an actual zero-token count.
 
+## Extends
+
+- [`IIntelligenceUsage`](Interface.IIntelligenceUsage)
+
 ## Properties
 
+### cachedInputAudioTokens
+
+```ts
+readonly cachedInputAudioTokens: number | null;
+```
+
+Defined in: [contracts/IIntelligenceUsage.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L27)
+
+Cached input tokens attributed to audio.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`cachedInputAudioTokens`](Interface.IIntelligenceUsage#cachedinputaudiotokens)
+
+***
+
+### cachedInputImageTokens
+
+```ts
+readonly cachedInputImageTokens: number | null;
+```
+
+Defined in: [contracts/IIntelligenceUsage.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L25)
+
+Cached input tokens attributed to images.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`cachedInputImageTokens`](Interface.IIntelligenceUsage#cachedinputimagetokens)
+
+***
+
+### cachedInputTextTokens
+
+```ts
+readonly cachedInputTextTokens: number | null;
+```
+
+Defined in: [contracts/IIntelligenceUsage.ts:23](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L23)
+
+Cached input tokens attributed to text.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`cachedInputTextTokens`](Interface.IIntelligenceUsage#cachedinputtexttokens)
+
+***
+
 ### cachedInputTokens
 
 ```ts
 readonly cachedInputTokens: number | null;
 ```
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L15)
+Defined in: [contracts/IIntelligenceUsage.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L19)
+
+Input tokens read from a provider cache.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`cachedInputTokens`](Interface.IIntelligenceUsage#cachedinputtokens)
+
+***
+
+### cacheWriteInputTokens
+
+```ts
+readonly cacheWriteInputTokens: number | null;
+```
+
+Defined in: [contracts/IIntelligenceUsage.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L21)
+
+Input tokens written to a provider cache.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`cacheWriteInputTokens`](Interface.IIntelligenceUsage#cachewriteinputtokens)
 
 ***
 
@@ -30,7 +104,29 @@ Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:15](https://github
 readonly inputAudioTokens: number | null;
 ```
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L17)
+Defined in: [contracts/IIntelligenceUsage.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L33)
+
+Input tokens attributed to audio.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`inputAudioTokens`](Interface.IIntelligenceUsage#inputaudiotokens)
+
+***
+
+### inputImageTokens
+
+```ts
+readonly inputImageTokens: number | null;
+```
+
+Defined in: [contracts/IIntelligenceUsage.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L31)
+
+Input tokens attributed to images.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`inputImageTokens`](Interface.IIntelligenceUsage#inputimagetokens)
 
 ***
 
@@ -40,7 +136,13 @@ Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:17](https://github
 readonly inputTextTokens: number | null;
 ```
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L16)
+Defined in: [contracts/IIntelligenceUsage.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L29)
+
+Input tokens attributed to text.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`inputTextTokens`](Interface.IIntelligenceUsage#inputtexttokens)
 
 ***
 
@@ -50,7 +152,13 @@ Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:16](https://github
 readonly inputTokens: number | null;
 ```
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L12)
+Defined in: [contracts/IIntelligenceUsage.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L13)
+
+All uncached and cached input tokens reported for the operation.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`inputTokens`](Interface.IIntelligenceUsage#inputtokens)
 
 ***
 
@@ -60,7 +168,29 @@ Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:12](https://github
 readonly outputAudioTokens: number | null;
 ```
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L19)
+Defined in: [contracts/IIntelligenceUsage.ts:39](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L39)
+
+Output tokens attributed to generated audio.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`outputAudioTokens`](Interface.IIntelligenceUsage#outputaudiotokens)
+
+***
+
+### outputImageTokens
+
+```ts
+readonly outputImageTokens: number | null;
+```
+
+Defined in: [contracts/IIntelligenceUsage.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L37)
+
+Output tokens attributed to generated images.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`outputImageTokens`](Interface.IIntelligenceUsage#outputimagetokens)
 
 ***
 
@@ -70,7 +200,13 @@ Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:19](https://github
 readonly outputTextTokens: number | null;
 ```
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L18)
+Defined in: [contracts/IIntelligenceUsage.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L35)
+
+Output tokens attributed to text, including reasoning when the provider does so.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`outputTextTokens`](Interface.IIntelligenceUsage#outputtexttokens)
 
 ***
 
@@ -80,7 +216,13 @@ Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:18](https://github
 readonly outputTokens: number | null;
 ```
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L13)
+Defined in: [contracts/IIntelligenceUsage.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L15)
+
+All output tokens, including any reasoning tokens, reported for the operation.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`outputTokens`](Interface.IIntelligenceUsage#outputtokens)
 
 ***
 
@@ -90,7 +232,23 @@ Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:13](https://github
 readonly rawUsage: unknown;
 ```
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L20)
+Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L18)
+
+***
+
+### reasoningTokens
+
+```ts
+readonly reasoningTokens: number | null;
+```
+
+Defined in: [contracts/IIntelligenceUsage.ts:41](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L41)
+
+Reasoning tokens included in the provider's output total.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`reasoningTokens`](Interface.IIntelligenceUsage#reasoningtokens)
 
 ***
 
@@ -100,4 +258,10 @@ Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:20](https://github
 readonly totalTokens: number | null;
 ```
 
-Defined in: [realtime/contracts/IIntelligenceRealtimeUsage.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/realtime/contracts/IIntelligenceRealtimeUsage.ts#L14)
+Defined in: [contracts/IIntelligenceUsage.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceUsage.ts#L17)
+
+Provider-reported total input and output tokens.
+
+#### Inherited from
+
+[`IIntelligenceUsage`](Interface.IIntelligenceUsage).[`totalTokens`](Interface.IIntelligenceUsage#totaltokens)

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Interface: IIntelligenceRequestOptions
 
-Defined in: contracts/IIntelligenceRequestOptions.ts:12
+Defined in: [contracts/IIntelligenceRequestOptions.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRequestOptions.ts#L12)
 
 Shared execution controls for bounded intelligence requests.
 
@@ -33,7 +33,7 @@ Shared execution controls for bounded intelligence requests.
 readonly optional abortSignal?: AbortSignal;
 ```
 
-Defined in: contracts/IIntelligenceRequestOptions.ts:16
+Defined in: [contracts/IIntelligenceRequestOptions.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRequestOptions.ts#L16)
 
 Caller-driven cancellation signal.
 
@@ -45,7 +45,7 @@ Caller-driven cancellation signal.
 readonly optional headers?: Readonly<Record<string, string>>;
 ```
 
-Defined in: contracts/IIntelligenceRequestOptions.ts:19
+Defined in: [contracts/IIntelligenceRequestOptions.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRequestOptions.ts#L19)
 
 Additional outbound request headers.
 
@@ -57,7 +57,7 @@ Additional outbound request headers.
 readonly optional model?: IIntelligenceModelReference;
 ```
 
-Defined in: contracts/IIntelligenceModelRequestOptions.ts:17
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L24)
 
 Optional provider/model override.
 
@@ -73,7 +73,7 @@ Optional provider/model override.
 readonly optional providerOptions?: Readonly<Record<string, Readonly<Record<string, IntelligenceJsonValue>>>>;
 ```
 
-Defined in: contracts/IIntelligenceModelRequestOptions.ts:23
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L33)
 
 Optional provider-specific settings.
 
@@ -83,13 +83,29 @@ Optional provider-specific settings.
 
 ***
 
+### requestId?
+
+```ts
+readonly optional requestId?: string;
+```
+
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L27)
+
+Correlation identifier included in structured Archipel logs.
+
+#### Inherited from
+
+[`IIntelligenceModelRequestOptions`](Interface.IIntelligenceModelRequestOptions).[`requestId`](Interface.IIntelligenceModelRequestOptions#requestid)
+
+***
+
 ### timeoutMs?
 
 ```ts
 readonly optional timeoutMs?: number;
 ```
 
-Defined in: contracts/IIntelligenceModelRequestOptions.ts:20
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L30)
 
 Total provider-operation timeout in milliseconds.
 

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Interface: IIntelligenceRerankingOptions\<TDocument\>
 
-Defined in: contracts/IIntelligenceRerankingOptions.ts:13
+Defined in: [contracts/IIntelligenceRerankingOptions.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRerankingOptions.ts#L13)
 
 Provider-neutral reranking options.
 
@@ -27,7 +27,7 @@ Provider-neutral reranking options.
 readonly optional abortSignal?: AbortSignal;
 ```
 
-Defined in: contracts/IIntelligenceRequestOptions.ts:16
+Defined in: [contracts/IIntelligenceRequestOptions.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRequestOptions.ts#L16)
 
 Caller-driven cancellation signal.
 
@@ -43,7 +43,7 @@ Caller-driven cancellation signal.
 readonly documents: readonly TDocument[];
 ```
 
-Defined in: contracts/IIntelligenceRerankingOptions.ts:19
+Defined in: [contracts/IIntelligenceRerankingOptions.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRerankingOptions.ts#L19)
 
 ***
 
@@ -53,7 +53,7 @@ Defined in: contracts/IIntelligenceRerankingOptions.ts:19
 readonly optional headers?: Readonly<Record<string, string>>;
 ```
 
-Defined in: contracts/IIntelligenceRequestOptions.ts:19
+Defined in: [contracts/IIntelligenceRequestOptions.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRequestOptions.ts#L19)
 
 Additional outbound request headers.
 
@@ -69,7 +69,7 @@ Additional outbound request headers.
 readonly optional maxRetries?: number;
 ```
 
-Defined in: contracts/IIntelligenceRerankingOptions.ts:20
+Defined in: [contracts/IIntelligenceRerankingOptions.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRerankingOptions.ts#L20)
 
 ***
 
@@ -79,7 +79,7 @@ Defined in: contracts/IIntelligenceRerankingOptions.ts:20
 readonly optional model?: IIntelligenceModelReference;
 ```
 
-Defined in: contracts/IIntelligenceModelRequestOptions.ts:17
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L24)
 
 Optional provider/model override.
 
@@ -95,7 +95,7 @@ Optional provider/model override.
 readonly optional providerOptions?: Readonly<Record<string, Readonly<Record<string, IntelligenceJsonValue>>>>;
 ```
 
-Defined in: contracts/IIntelligenceModelRequestOptions.ts:23
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L33)
 
 Optional provider-specific settings.
 
@@ -111,7 +111,23 @@ Optional provider-specific settings.
 readonly query: string;
 ```
 
-Defined in: contracts/IIntelligenceRerankingOptions.ts:18
+Defined in: [contracts/IIntelligenceRerankingOptions.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRerankingOptions.ts#L18)
+
+***
+
+### requestId?
+
+```ts
+readonly optional requestId?: string;
+```
+
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L27)
+
+Correlation identifier included in structured Archipel logs.
+
+#### Inherited from
+
+[`IIntelligenceRequestOptions`](Interface.IIntelligenceRequestOptions).[`requestId`](Interface.IIntelligenceRequestOptions#requestid)
 
 ***
 
@@ -121,7 +137,7 @@ Defined in: contracts/IIntelligenceRerankingOptions.ts:18
 readonly optional timeoutMs?: number;
 ```
 
-Defined in: contracts/IIntelligenceModelRequestOptions.ts:20
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L30)
 
 Total provider-operation timeout in milliseconds.
 
@@ -137,4 +153,4 @@ Total provider-operation timeout in milliseconds.
 readonly optional topN?: number;
 ```
 
-Defined in: contracts/IIntelligenceRerankingOptions.ts:21
+Defined in: [contracts/IIntelligenceRerankingOptions.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRerankingOptions.ts#L21)

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Interface: IIntelligenceRerankingResult\<TDocument\>
 
-Defined in: contracts/IIntelligenceRerankingResult.ts:12
+Defined in: [contracts/IIntelligenceRerankingResult.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRerankingResult.ts#L12)
 
 Provider-neutral reranking result.
 
@@ -23,7 +23,7 @@ Provider-neutral reranking result.
 readonly model: string;
 ```
 
-Defined in: contracts/IIntelligenceRerankingResult.ts:21
+Defined in: [contracts/IIntelligenceRerankingResult.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRerankingResult.ts#L21)
 
 ***
 
@@ -33,7 +33,7 @@ Defined in: contracts/IIntelligenceRerankingResult.ts:21
 readonly provider: string;
 ```
 
-Defined in: contracts/IIntelligenceRerankingResult.ts:20
+Defined in: [contracts/IIntelligenceRerankingResult.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRerankingResult.ts#L20)
 
 ***
 
@@ -47,4 +47,4 @@ readonly ranking: readonly {
 }[];
 ```
 
-Defined in: contracts/IIntelligenceRerankingResult.ts:15
+Defined in: [contracts/IIntelligenceRerankingResult.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceRerankingResult.ts#L15)

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Interface: IIntelligenceSkillUploadOptions
 
-Defined in: contracts/IIntelligenceSkillUploadOptions.ts:12
+Defined in: [contracts/IIntelligenceSkillUploadOptions.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceSkillUploadOptions.ts#L12)
 
 Provider-neutral skill bundle upload options.
 
@@ -21,7 +21,7 @@ Provider-neutral skill bundle upload options.
 readonly optional displayTitle?: string;
 ```
 
-Defined in: contracts/IIntelligenceSkillUploadOptions.ts:19
+Defined in: [contracts/IIntelligenceSkillUploadOptions.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceSkillUploadOptions.ts#L19)
 
 ***
 
@@ -43,7 +43,7 @@ readonly files: readonly {
 }[];
 ```
 
-Defined in: contracts/IIntelligenceSkillUploadOptions.ts:15
+Defined in: [contracts/IIntelligenceSkillUploadOptions.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceSkillUploadOptions.ts#L15)
 
 ***
 
@@ -53,7 +53,7 @@ Defined in: contracts/IIntelligenceSkillUploadOptions.ts:15
 readonly optional model?: IIntelligenceModelReference;
 ```
 
-Defined in: contracts/IIntelligenceModelRequestOptions.ts:17
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L24)
 
 Optional provider/model override.
 
@@ -69,7 +69,7 @@ Optional provider/model override.
 readonly optional providerOptions?: Readonly<Record<string, Readonly<Record<string, IntelligenceJsonValue>>>>;
 ```
 
-Defined in: contracts/IIntelligenceModelRequestOptions.ts:23
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L33)
 
 Optional provider-specific settings.
 
@@ -79,13 +79,29 @@ Optional provider-specific settings.
 
 ***
 
+### requestId?
+
+```ts
+readonly optional requestId?: string;
+```
+
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L27)
+
+Correlation identifier included in structured Archipel logs.
+
+#### Inherited from
+
+[`IIntelligenceModelRequestOptions`](Interface.IIntelligenceModelRequestOptions).[`requestId`](Interface.IIntelligenceModelRequestOptions#requestid)
+
+***
+
 ### timeoutMs?
 
 ```ts
 readonly optional timeoutMs?: number;
 ```
 
-Defined in: contracts/IIntelligenceModelRequestOptions.ts:20
+Defined in: [contracts/IIntelligenceModelRequestOptions.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IIntelligenceModelRequestOptions.ts#L30)
 
 Total provider-operation timeout in milliseconds.