@breadstone/archipel-mcp 0.0.55 → 0.0.56
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/data/guides/ai-image-generation.md +52 -47
- package/data/guides/ai-realtime-voice.md +48 -41
- package/data/guides/ai-text-generation.md +54 -60
- package/data/guides/health-indicators.md +67 -66
- package/data/guides/intelligence-prompts-warm-up.md +52 -63
- package/data/packages/platform-intelligence/api/Class.AnthropicIntelligenceProviderAdapter.md +57 -13
- package/data/packages/platform-intelligence/api/Class.GatewayIntelligenceProviderAdapter.md +57 -13
- package/data/packages/platform-intelligence/api/Class.GoogleIntelligenceProviderAdapter.md +57 -13
- package/data/packages/platform-intelligence/api/Class.GrokIntelligenceProviderAdapter.md +57 -13
- package/data/packages/platform-intelligence/api/Class.IntelligenceAgent.md +5 -5
- package/data/packages/platform-intelligence/api/Class.IntelligenceEmbeddingGenerator.md +4 -4
- package/data/packages/platform-intelligence/api/Class.IntelligenceHealthIndicator.md +10 -9
- package/data/packages/platform-intelligence/api/Class.IntelligenceImageGenerator.md +117 -0
- package/data/packages/platform-intelligence/api/Class.IntelligenceLanguageGenerator.md +7 -7
- package/data/packages/platform-intelligence/api/Class.IntelligenceModule.md +2 -2
- package/data/packages/platform-intelligence/api/Class.IntelligencePromptPolicyPort.md +1 -1
- package/data/packages/platform-intelligence/api/Class.IntelligenceProviderAdapterPort.md +104 -0
- package/data/packages/platform-intelligence/api/Class.IntelligenceProviderDiagnostics.md +3 -3
- package/data/packages/platform-intelligence/api/Class.IntelligenceProviderRegistry.md +5 -5
- package/data/packages/platform-intelligence/api/Class.IntelligenceRealtimeMeteringPort.md +1 -1
- package/data/packages/platform-intelligence/api/Class.IntelligenceRealtimeSessionFactory.md +5 -5
- package/data/packages/platform-intelligence/api/Class.IntelligenceRealtimeSessionPort.md +15 -15
- package/data/packages/platform-intelligence/api/Class.IntelligenceReranker.md +3 -3
- package/data/packages/platform-intelligence/api/Class.IntelligenceSpeechGenerator.md +117 -0
- package/data/packages/platform-intelligence/api/Class.IntelligenceToolRegistry.md +5 -5
- package/data/packages/platform-intelligence/api/Class.IntelligenceTranscriptionGenerator.md +139 -0
- package/data/packages/platform-intelligence/api/Class.IntelligenceVideoGenerator.md +117 -0
- package/data/packages/platform-intelligence/api/Class.MiMoIntelligenceProviderAdapter.md +57 -13
- package/data/packages/platform-intelligence/api/Class.OpenAIIntelligenceProviderAdapter.md +38 -18
- package/data/packages/platform-intelligence/api/Function.createIntelligenceJsonSchema.md +1 -1
- package/data/packages/platform-intelligence/api/Function.defineIntelligenceTool.md +1 -1
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceAgentConfiguration.md +7 -7
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceEmbeddingBatchOptions.md +25 -9
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceEmbeddingBatchResult.md +7 -7
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceEmbeddingOptions.md +24 -8
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceEmbeddingResult.md +7 -7
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceFileUploadOptions.md +23 -7
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceFileUploadResult.md +6 -6
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceGeneratedFile.md +4 -4
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceGenerationStepStartEvent.md +5 -5
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceImageGenerationOptions.md +29 -13
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceImageGenerationResult.md +6 -6
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceLanguageCompletion.md +13 -13
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceLanguageGenerationOptions.md +33 -17
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceLanguageStream.md +5 -5
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceModelReference.md +3 -3
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceModelRequestOptions.md +24 -4
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceModelStatus.md +3 -3
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceModuleOptions.md +30 -8
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceObjectStream.md +5 -5
- package/data/packages/platform-intelligence/api/Interface.IIntelligencePrompt.md +5 -5
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceProviderLoadRequest.md +20 -6
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceProviderProbeResult.md +7 -7
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceRealtimeSessionOptions.md +21 -9
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceRealtimeUsage.md +174 -10
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceRequestOptions.md +22 -6
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceRerankingOptions.md +26 -10
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceRerankingResult.md +4 -4
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceSkillUploadOptions.md +22 -6
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceSkillUploadResult.md +8 -8
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceSpeechGenerationOptions.md +29 -13
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceSpeechGenerationResult.md +5 -5
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceStreamingTranscriptionOptions.md +25 -9
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceToolCall.md +4 -4
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceToolDefinition.md +7 -7
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceToolExecutionEndEvent.md +5 -5
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceToolExecutionStartEvent.md +3 -3
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceTranscriptionOptions.md +24 -8
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceTranscriptionResult.md +8 -8
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceTranscriptionStream.md +9 -9
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceUsage.md +161 -4
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceVideoGenerationOptions.md +34 -18
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceVideoGenerationResult.md +5 -5
- package/data/packages/platform-intelligence/api/TypeAlias.IIntelligenceModelMessage.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IIntelligenceSchema.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceCapability.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceDefaultModels.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceJsonValue.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceProviderName.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceProviderOptions.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceProviderProbeStatus.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceProviderToolOptions.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceRequestTimeouts.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceToolChoice.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceToolOutput.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceToolSet.md +1 -1
- package/data/packages/platform-intelligence/api/TypeAlias.IntelligenceTranscriptionStreamPart.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.AI_GATEWAY_API_KEY.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.AI_GATEWAY_BASE_URL.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.AI_GATEWAY_CONFIG_ENTRIES.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_API_KEY.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_BASE_URL.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_MAX_OUTPUT_TOKENS.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_MODEL.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_PROVIDER.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_TEMPERATURE.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_TOP_P.md +1 -1
- package/data/packages/platform-intelligence/api/Variable.IntelligenceCapabilityNames.md +11 -11
- package/data/packages/platform-intelligence/api/Variable.PLATFORM_INTELLIGENCE_CONFIG_ENTRIES.md +2 -2
- package/data/packages/platform-intelligence/api/index.md +8 -5
- package/data/packages/platform-intelligence/index.md +86 -0
- package/package.json +1 -1
- package/data/packages/platform-intelligence/api/Class.IntelligenceMediaGenerator.md +0 -140
- package/data/packages/platform-intelligence/api/Interface.IIntelligenceProviderAdapter.md +0 -73
|
@@ -9,6 +9,6 @@ editUrl: false
|
|
|
9
9
|
const INTELLIGENCE_BASE_URL: IConfigKey<string>;
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
Defined in: [env.ts:
|
|
12
|
+
Defined in: [env.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L30)
|
|
13
13
|
|
|
14
14
|
Global base URL override for the intelligence provider.
|
|
@@ -9,6 +9,6 @@ editUrl: false
|
|
|
9
9
|
const INTELLIGENCE_MAX_OUTPUT_TOKENS: IConfigKey<number>;
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
Defined in: [env.ts:
|
|
12
|
+
Defined in: [env.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L21)
|
|
13
13
|
|
|
14
14
|
Maximum number of output tokens for the AI model.
|
|
@@ -9,6 +9,6 @@ editUrl: false
|
|
|
9
9
|
const INTELLIGENCE_MODEL: IConfigKey<string>;
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
Defined in: [env.ts:
|
|
12
|
+
Defined in: [env.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L12)
|
|
13
13
|
|
|
14
14
|
AI model identifier to use for text generation.
|
|
@@ -9,6 +9,6 @@ editUrl: false
|
|
|
9
9
|
const INTELLIGENCE_PROVIDER: IConfigKey<string>;
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
Defined in: [env.ts:
|
|
12
|
+
Defined in: [env.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L24)
|
|
13
13
|
|
|
14
14
|
Intelligence provider name (e.g. openai, anthropic, google, grok, mimo, gateway).
|
|
@@ -9,6 +9,6 @@ editUrl: false
|
|
|
9
9
|
const INTELLIGENCE_TEMPERATURE: IConfigKey<number>;
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
Defined in: [env.ts:
|
|
12
|
+
Defined in: [env.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L15)
|
|
13
13
|
|
|
14
14
|
Sampling temperature for the AI model.
|
|
@@ -9,6 +9,6 @@ editUrl: false
|
|
|
9
9
|
const INTELLIGENCE_TOP_P: IConfigKey<number>;
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
Defined in: [env.ts:
|
|
12
|
+
Defined in: [env.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L18)
|
|
13
13
|
|
|
14
14
|
Top-p (nucleus sampling) for the AI model.
|
|
@@ -20,7 +20,7 @@ const IntelligenceCapabilityNames: {
|
|
|
20
20
|
};
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
Defined in: contracts/IntelligenceCapabilityNames.ts:6
|
|
23
|
+
Defined in: [contracts/IntelligenceCapabilityNames.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L6)
|
|
24
24
|
|
|
25
25
|
Capability identifiers understood by the intelligence provider registry.
|
|
26
26
|
|
|
@@ -28,13 +28,13 @@ Capability identifiers understood by the intelligence provider registry.
|
|
|
28
28
|
|
|
29
29
|
| Name | Type | Default value | Defined in |
|
|
30
30
|
| ------ | ------ | ------ | ------ |
|
|
31
|
-
| <a id="property-embedding"></a> `Embedding` | `"embedding"` | `'embedding'` | contracts/IntelligenceCapabilityNames.ts:8 |
|
|
32
|
-
| <a id="property-files"></a> `Files` | `"files"` | `'files'` | contracts/IntelligenceCapabilityNames.ts:15 |
|
|
33
|
-
| <a id="property-image"></a> `Image` | `"image"` | `'image'` | contracts/IntelligenceCapabilityNames.ts:9 |
|
|
34
|
-
| <a id="property-language"></a> `Language` | `"language"` | `'language'` | contracts/IntelligenceCapabilityNames.ts:7 |
|
|
35
|
-
| <a id="property-realtime"></a> `Realtime` | `"realtime"` | `'realtime'` | contracts/IntelligenceCapabilityNames.ts:14 |
|
|
36
|
-
| <a id="property-reranking"></a> `Reranking` | `"reranking"` | `'reranking'` | contracts/IntelligenceCapabilityNames.ts:13 |
|
|
37
|
-
| <a id="property-skills"></a> `Skills` | `"skills"` | `'skills'` | contracts/IntelligenceCapabilityNames.ts:16 |
|
|
38
|
-
| <a id="property-speech"></a> `Speech` | `"speech"` | `'speech'` | contracts/IntelligenceCapabilityNames.ts:10 |
|
|
39
|
-
| <a id="property-transcription"></a> `Transcription` | `"transcription"` | `'transcription'` | contracts/IntelligenceCapabilityNames.ts:11 |
|
|
40
|
-
| <a id="property-video"></a> `Video` | `"video"` | `'video'` | contracts/IntelligenceCapabilityNames.ts:12 |
|
|
31
|
+
| <a id="property-embedding"></a> `Embedding` | `"embedding"` | `'embedding'` | [contracts/IntelligenceCapabilityNames.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L8) |
|
|
32
|
+
| <a id="property-files"></a> `Files` | `"files"` | `'files'` | [contracts/IntelligenceCapabilityNames.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L15) |
|
|
33
|
+
| <a id="property-image"></a> `Image` | `"image"` | `'image'` | [contracts/IntelligenceCapabilityNames.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L9) |
|
|
34
|
+
| <a id="property-language"></a> `Language` | `"language"` | `'language'` | [contracts/IntelligenceCapabilityNames.ts:7](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L7) |
|
|
35
|
+
| <a id="property-realtime"></a> `Realtime` | `"realtime"` | `'realtime'` | [contracts/IntelligenceCapabilityNames.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L14) |
|
|
36
|
+
| <a id="property-reranking"></a> `Reranking` | `"reranking"` | `'reranking'` | [contracts/IntelligenceCapabilityNames.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L13) |
|
|
37
|
+
| <a id="property-skills"></a> `Skills` | `"skills"` | `'skills'` | [contracts/IntelligenceCapabilityNames.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L16) |
|
|
38
|
+
| <a id="property-speech"></a> `Speech` | `"speech"` | `'speech'` | [contracts/IntelligenceCapabilityNames.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L10) |
|
|
39
|
+
| <a id="property-transcription"></a> `Transcription` | `"transcription"` | `'transcription'` | [contracts/IntelligenceCapabilityNames.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L11) |
|
|
40
|
+
| <a id="property-video"></a> `Video` | `"video"` | `'video'` | [contracts/IntelligenceCapabilityNames.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceCapabilityNames.ts#L12) |
|
package/data/packages/platform-intelligence/api/Variable.PLATFORM_INTELLIGENCE_CONFIG_ENTRIES.md
CHANGED
|
@@ -9,6 +9,6 @@ editUrl: false
|
|
|
9
9
|
const PLATFORM_INTELLIGENCE_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, "module">>;
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
Defined in: [env.ts:
|
|
12
|
+
Defined in: [env.ts:37](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L37)
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
Provider-neutral configuration entries required by `platform-intelligence`.
|
|
@@ -18,12 +18,13 @@ editUrl: false
|
|
|
18
18
|
| [IntelligenceAgentFactory](Class.IntelligenceAgentFactory) | Creates reusable provider-neutral tool-loop agents. |
|
|
19
19
|
| [IntelligenceConfigurationError](Class.IntelligenceConfigurationError) | Error thrown when an intelligence provider configuration is invalid or missing. |
|
|
20
20
|
| [IntelligenceEmbeddingGenerator](Class.IntelligenceEmbeddingGenerator) | Provider-neutral single and batch embedding facade. |
|
|
21
|
-
| [IntelligenceHealthIndicator](Class.IntelligenceHealthIndicator) | Health indicator for the intelligence infrastructure.
|
|
21
|
+
| [IntelligenceHealthIndicator](Class.IntelligenceHealthIndicator) | Health indicator for the intelligence infrastructure. Performs a bounded remote readiness probe for the default language model and reports the locally registered capability topology. |
|
|
22
|
+
| [IntelligenceImageGenerator](Class.IntelligenceImageGenerator) | Provider-neutral image generation facade. |
|
|
22
23
|
| [IntelligenceLanguageGenerator](Class.IntelligenceLanguageGenerator) | Provider-neutral language generation, structured output, and streaming facade. |
|
|
23
|
-
| [IntelligenceMediaGenerator](Class.IntelligenceMediaGenerator) | Single provider-neutral facade for image, speech, transcription, and video. |
|
|
24
24
|
| [IntelligenceModule](Class.IntelligenceModule) | Core module exposing the shared intelligence infrastructure. |
|
|
25
25
|
| [IntelligencePromptExecutor](Class.IntelligencePromptExecutor) | Validates and executes reusable intelligence prompt invocations. |
|
|
26
26
|
| [IntelligencePromptPolicyPort](Class.IntelligencePromptPolicyPort) | Resolves provider-neutral prompt requirements into effective generation settings. |
|
|
27
|
+
| [IntelligenceProviderAdapterPort](Class.IntelligenceProviderAdapterPort) | Port implemented by every intelligence provider adapter. |
|
|
27
28
|
| [IntelligenceProviderAssetUploader](Class.IntelligenceProviderAssetUploader) | Uploads provider-managed files and skills behind provider-neutral contracts. |
|
|
28
29
|
| [IntelligenceProviderDiagnostics](Class.IntelligenceProviderDiagnostics) | Performs bounded, provider-neutral provider availability diagnostics. |
|
|
29
30
|
| [IntelligenceProviderError](Class.IntelligenceProviderError) | Error thrown when an intelligence provider call fails. |
|
|
@@ -33,11 +34,14 @@ editUrl: false
|
|
|
33
34
|
| [IntelligenceRealtimeSessionFactory](Class.IntelligenceRealtimeSessionFactory) | Creates and owns server-side, provider-neutral realtime AI sessions. |
|
|
34
35
|
| [IntelligenceRealtimeSessionPort](Class.IntelligenceRealtimeSessionPort) | Provider-neutral control surface for one realtime model connection. |
|
|
35
36
|
| [IntelligenceReranker](Class.IntelligenceReranker) | Provider-neutral semantic reranking facade. |
|
|
37
|
+
| [IntelligenceSpeechGenerator](Class.IntelligenceSpeechGenerator) | Provider-neutral speech generation facade. |
|
|
36
38
|
| [IntelligenceToolBase](Class.IntelligenceToolBase) | Base class for class-based intelligence tools. |
|
|
37
39
|
| [IntelligenceToolRegistry](Class.IntelligenceToolRegistry) | Registry for class-based intelligence tools. |
|
|
40
|
+
| [IntelligenceTranscriptionGenerator](Class.IntelligenceTranscriptionGenerator) | Provider-neutral bounded and streaming transcription facade. |
|
|
38
41
|
| [IntelligenceValidationError](Class.IntelligenceValidationError) | Error thrown when an intelligence input validation fails. |
|
|
42
|
+
| [IntelligenceVideoGenerator](Class.IntelligenceVideoGenerator) | Provider-neutral video generation facade. |
|
|
39
43
|
| [MiMoIntelligenceProviderAdapter](Class.MiMoIntelligenceProviderAdapter) | Xiaomi MiMo OpenAI-compatible language adapter. |
|
|
40
|
-
| [OpenAIIntelligenceProviderAdapter](Class.OpenAIIntelligenceProviderAdapter) | OpenAI adapter for language, embeddings, images, audio, realtime, files, and skills. |
|
|
44
|
+
| [OpenAIIntelligenceProviderAdapter](Class.OpenAIIntelligenceProviderAdapter) | OpenAI adapter for language, embeddings, images, audio, video, realtime, files, and skills. |
|
|
41
45
|
|
|
42
46
|
## Interfaces
|
|
43
47
|
|
|
@@ -71,7 +75,6 @@ editUrl: false
|
|
|
71
75
|
| [IIntelligencePromptInvocation](Interface.IIntelligencePromptInvocation) | Bound prompt definition ready for execution. |
|
|
72
76
|
| [IIntelligencePromptPolicyRequest](Interface.IIntelligencePromptPolicyRequest) | Policy resolution request for one prompt invocation. |
|
|
73
77
|
| [IIntelligencePromptRenderContext](Interface.IIntelligencePromptRenderContext) | Input exposed to pure prompt rendering functions. |
|
|
74
|
-
| [IIntelligenceProviderAdapter](Interface.IIntelligenceProviderAdapter) | Provider adapter registered with the intelligence capability registry. |
|
|
75
78
|
| [IIntelligenceProviderConfiguration](Interface.IIntelligenceProviderConfiguration) | Describes the resolved configuration for the intelligence provider. |
|
|
76
79
|
| [IIntelligenceProviderLoadRequest](Interface.IIntelligenceProviderLoadRequest) | Internal model/API load request passed to a provider adapter. |
|
|
77
80
|
| [IIntelligenceProviderProbeResult](Interface.IIntelligenceProviderProbeResult) | Provider-neutral result of a bounded provider availability probe. |
|
|
@@ -173,7 +176,7 @@ editUrl: false
|
|
|
173
176
|
| [OPENAI\_BASE\_URL](Variable.OPENAI_BASE_URL) | OpenAI-specific base URL. |
|
|
174
177
|
| [OPENAI\_CONFIG\_ENTRIES](Variable.OPENAI_CONFIG_ENTRIES) | Configuration entries used by the OpenAI intelligence provider. |
|
|
175
178
|
| [OpenAIIntelligenceToolNames](Variable.OpenAIIntelligenceToolNames) | OpenAI provider-defined tool names exposed through Archipel. |
|
|
176
|
-
| [PLATFORM\_INTELLIGENCE\_CONFIG\_ENTRIES](Variable.PLATFORM_INTELLIGENCE_CONFIG_ENTRIES) |
|
|
179
|
+
| [PLATFORM\_INTELLIGENCE\_CONFIG\_ENTRIES](Variable.PLATFORM_INTELLIGENCE_CONFIG_ENTRIES) | Provider-neutral configuration entries required by `platform-intelligence`. |
|
|
177
180
|
| [XAI\_API\_KEY](Variable.XAI_API_KEY) | xAI-specific API key alias for Grok. |
|
|
178
181
|
| [XAI\_BASE\_URL](Variable.XAI_BASE_URL) | xAI-specific base URL alias for Grok. |
|
|
179
182
|
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Platform Intelligence
|
|
3
|
+
description: Provider-neutral language, embedding, image, speech, transcription, video, reranking, realtime, agent, file, and skill infrastructure for NestJS.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Platform Intelligence
|
|
7
|
+
|
|
8
|
+
Applications depend on Archipel capability facades and register only the
|
|
9
|
+
provider subpaths they use. Provider SDKs, ESM loading, model construction,
|
|
10
|
+
timeouts, retries, and error normalization stay inside the package.
|
|
11
|
+
|
|
12
|
+
```mermaid
|
|
13
|
+
flowchart LR
|
|
14
|
+
App["Application services"] --> Facades["Archipel capability facades"]
|
|
15
|
+
Facades --> Registry["Provider registry"]
|
|
16
|
+
Registry --> Port["IntelligenceProviderAdapterPort"]
|
|
17
|
+
Port --> OpenAI["/provider/openai"]
|
|
18
|
+
Port --> Anthropic["/provider/anthropic"]
|
|
19
|
+
Port --> Google["/provider/google"]
|
|
20
|
+
Port --> Grok["/provider/grok"]
|
|
21
|
+
Port --> MiMo["/provider/mimo"]
|
|
22
|
+
Port --> Gateway["/provider/gateway"]
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Providers
|
|
26
|
+
|
|
27
|
+
| Provider | Import subpath | Configuration entries |
|
|
28
|
+
| ----------------- | ---------------------- | --------------------------- |
|
|
29
|
+
| OpenAI | `/provider/openai` | `OPENAI_CONFIG_ENTRIES` |
|
|
30
|
+
| Anthropic | `/provider/anthropic` | `ANTHROPIC_CONFIG_ENTRIES` |
|
|
31
|
+
| Google | `/provider/google` | `GOOGLE_CONFIG_ENTRIES` |
|
|
32
|
+
| xAI / Grok | `/provider/grok` | `GROK_CONFIG_ENTRIES` |
|
|
33
|
+
| Xiaomi MiMo | `/provider/mimo` | `MIMO_CONFIG_ENTRIES` |
|
|
34
|
+
| Vercel AI Gateway | `/provider/gateway` | `AI_GATEWAY_CONFIG_ENTRIES` |
|
|
35
|
+
|
|
36
|
+
OpenAI, Anthropic, Google, Grok, and MiMo also expose provider-owned tools from
|
|
37
|
+
their `/tools` subpaths. Provider-specific environment keys are exported only
|
|
38
|
+
from the corresponding provider entrypoint; the package root stays
|
|
39
|
+
provider-neutral. Provider entrypoints do not re-export tool factories, so
|
|
40
|
+
provider tools remain a separate opt-in runtime boundary.
|
|
41
|
+
|
|
42
|
+
The standard package test target first runs the Nx package build and then the
|
|
43
|
+
provider-entrypoint and generator-topology contract tests. The build compiles
|
|
44
|
+
every declared subpath, while the tests keep package exports, TypeScript paths,
|
|
45
|
+
provider-local barrels, optional provider dependencies, and the
|
|
46
|
+
provider-neutral root surface synchronized.
|
|
47
|
+
|
|
48
|
+
## Capability Surface
|
|
49
|
+
|
|
50
|
+
| Surface | Responsibility |
|
|
51
|
+
| ------------------------------------ | ---------------------------------------------- |
|
|
52
|
+
| `IntelligenceLanguageGenerator` | Text, structured output, streams, and tools |
|
|
53
|
+
| `IntelligenceEmbeddingGenerator` | Single and batch embeddings |
|
|
54
|
+
| `IntelligenceImageGenerator` | Image generation and editing |
|
|
55
|
+
| `IntelligenceSpeechGenerator` | Text-to-speech generation |
|
|
56
|
+
| `IntelligenceTranscriptionGenerator` | Bounded and live transcription |
|
|
57
|
+
| `IntelligenceVideoGenerator` | Text/image-to-video generation |
|
|
58
|
+
| `IntelligenceReranker` | Provider-neutral semantic ranking |
|
|
59
|
+
| `IntelligenceRealtimeSessionFactory` | Server-owned bidirectional audio/text sessions |
|
|
60
|
+
| `IntelligenceAgentFactory` | Bounded reusable tool-loop agents |
|
|
61
|
+
| `IntelligenceProviderAssetUploader` | Provider files and skills |
|
|
62
|
+
| `IntelligenceProviderDiagnostics` | Bounded provider/model probes |
|
|
63
|
+
|
|
64
|
+
## Normalized Usage
|
|
65
|
+
|
|
66
|
+
Capability results use `IIntelligenceUsage` to transport provider-reported
|
|
67
|
+
input, output, total, cache-read, cache-write, reasoning, and text/image/audio
|
|
68
|
+
modality counters. Missing counters are `null`, not zero. Image generation
|
|
69
|
+
reconciles the normalized result with provider metadata so text input, image
|
|
70
|
+
input, and generated image output remain separately accountable when the
|
|
71
|
+
provider exposes them.
|
|
72
|
+
|
|
73
|
+
Archipel deliberately does not assign monetary prices or application billing
|
|
74
|
+
units. Consumers persist and price the normalized usage according to their own
|
|
75
|
+
provider, model, currency, entitlement, and audit policies.
|
|
76
|
+
|
|
77
|
+
OpenAI video uses an internal asynchronous create/poll/download bridge because
|
|
78
|
+
the OpenAI AI SDK provider does not expose a video-model handle. The bridge is
|
|
79
|
+
owned by `/provider/openai`; applications continue to use the provider-neutral
|
|
80
|
+
`IntelligenceVideoGenerator` contract. The current OpenAI Videos API and Sora
|
|
81
|
+
2 models are scheduled to shut down on September 24, 2026, so their eventual
|
|
82
|
+
replacement remains isolated to that provider entry point.
|
|
83
|
+
|
|
84
|
+
See the [package README](https://github.com/RueDeRennes/archipel/tree/main/libs/platform-intelligence)
|
|
85
|
+
for registration and migration examples and the generated API pages for
|
|
86
|
+
contract details.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@breadstone/archipel-mcp",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.56",
|
|
4
4
|
"description": "MCP server providing Archipel platform knowledge - documentation, query patterns, and coding conventions - to AI development tools.",
|
|
5
5
|
"type": "commonjs",
|
|
6
6
|
"main": "./src/main.js",
|
|
@@ -1,140 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 'Class: IntelligenceMediaGenerator'
|
|
3
|
-
generated: true
|
|
4
|
-
editUrl: false
|
|
5
|
-
---
|
|
6
|
-
# Class: IntelligenceMediaGenerator
|
|
7
|
-
|
|
8
|
-
Defined in: [IntelligenceMediaGenerator.ts:49](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L49)
|
|
9
|
-
|
|
10
|
-
Single provider-neutral facade for image, speech, transcription, and video.
|
|
11
|
-
|
|
12
|
-
## Constructors
|
|
13
|
-
|
|
14
|
-
### Constructor
|
|
15
|
-
|
|
16
|
-
```ts
|
|
17
|
-
new IntelligenceMediaGenerator(modelResolver): IntelligenceMediaGenerator;
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
Defined in: [IntelligenceMediaGenerator.ts:59](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L59)
|
|
21
|
-
|
|
22
|
-
#### Parameters
|
|
23
|
-
|
|
24
|
-
| Parameter | Type |
|
|
25
|
-
| ------ | ------ |
|
|
26
|
-
| `modelResolver` | `IntelligenceModelResolver` |
|
|
27
|
-
|
|
28
|
-
#### Returns
|
|
29
|
-
|
|
30
|
-
`IntelligenceMediaGenerator`
|
|
31
|
-
|
|
32
|
-
## Methods
|
|
33
|
-
|
|
34
|
-
### generateImage()
|
|
35
|
-
|
|
36
|
-
```ts
|
|
37
|
-
generateImage(options): Promise<IIntelligenceImageGenerationResult>;
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
Defined in: [IntelligenceMediaGenerator.ts:76](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L76)
|
|
41
|
-
|
|
42
|
-
Generates one or more images.
|
|
43
|
-
|
|
44
|
-
#### Parameters
|
|
45
|
-
|
|
46
|
-
| Parameter | Type |
|
|
47
|
-
| ------ | ------ |
|
|
48
|
-
| `options` | [`IIntelligenceImageGenerationOptions`](Interface.IIntelligenceImageGenerationOptions) |
|
|
49
|
-
|
|
50
|
-
#### Returns
|
|
51
|
-
|
|
52
|
-
`Promise`\<[`IIntelligenceImageGenerationResult`](Interface.IIntelligenceImageGenerationResult)\>
|
|
53
|
-
|
|
54
|
-
***
|
|
55
|
-
|
|
56
|
-
### generateSpeech()
|
|
57
|
-
|
|
58
|
-
```ts
|
|
59
|
-
generateSpeech(options): Promise<IIntelligenceSpeechGenerationResult>;
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
Defined in: [IntelligenceMediaGenerator.ts:119](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L119)
|
|
63
|
-
|
|
64
|
-
Generates spoken audio from text.
|
|
65
|
-
|
|
66
|
-
#### Parameters
|
|
67
|
-
|
|
68
|
-
| Parameter | Type |
|
|
69
|
-
| ------ | ------ |
|
|
70
|
-
| `options` | [`IIntelligenceSpeechGenerationOptions`](Interface.IIntelligenceSpeechGenerationOptions) |
|
|
71
|
-
|
|
72
|
-
#### Returns
|
|
73
|
-
|
|
74
|
-
`Promise`\<[`IIntelligenceSpeechGenerationResult`](Interface.IIntelligenceSpeechGenerationResult)\>
|
|
75
|
-
|
|
76
|
-
***
|
|
77
|
-
|
|
78
|
-
### generateVideo()
|
|
79
|
-
|
|
80
|
-
```ts
|
|
81
|
-
generateVideo(options): Promise<IIntelligenceVideoGenerationResult>;
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
Defined in: [IntelligenceMediaGenerator.ts:235](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L235)
|
|
85
|
-
|
|
86
|
-
Generates one or more videos.
|
|
87
|
-
|
|
88
|
-
#### Parameters
|
|
89
|
-
|
|
90
|
-
| Parameter | Type |
|
|
91
|
-
| ------ | ------ |
|
|
92
|
-
| `options` | [`IIntelligenceVideoGenerationOptions`](Interface.IIntelligenceVideoGenerationOptions) |
|
|
93
|
-
|
|
94
|
-
#### Returns
|
|
95
|
-
|
|
96
|
-
`Promise`\<[`IIntelligenceVideoGenerationResult`](Interface.IIntelligenceVideoGenerationResult)\>
|
|
97
|
-
|
|
98
|
-
***
|
|
99
|
-
|
|
100
|
-
### streamTranscription()
|
|
101
|
-
|
|
102
|
-
```ts
|
|
103
|
-
streamTranscription(options): Promise<IIntelligenceTranscriptionStream>;
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
Defined in: [IntelligenceMediaGenerator.ts:187](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L187)
|
|
107
|
-
|
|
108
|
-
Streams incremental and final transcripts from live raw audio.
|
|
109
|
-
|
|
110
|
-
#### Parameters
|
|
111
|
-
|
|
112
|
-
| Parameter | Type |
|
|
113
|
-
| ------ | ------ |
|
|
114
|
-
| `options` | [`IIntelligenceStreamingTranscriptionOptions`](Interface.IIntelligenceStreamingTranscriptionOptions) |
|
|
115
|
-
|
|
116
|
-
#### Returns
|
|
117
|
-
|
|
118
|
-
`Promise`\<[`IIntelligenceTranscriptionStream`](Interface.IIntelligenceTranscriptionStream)\>
|
|
119
|
-
|
|
120
|
-
***
|
|
121
|
-
|
|
122
|
-
### transcribe()
|
|
123
|
-
|
|
124
|
-
```ts
|
|
125
|
-
transcribe(options): Promise<IIntelligenceTranscriptionResult>;
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
Defined in: [IntelligenceMediaGenerator.ts:154](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceMediaGenerator.ts#L154)
|
|
129
|
-
|
|
130
|
-
Transcribes bounded audio input.
|
|
131
|
-
|
|
132
|
-
#### Parameters
|
|
133
|
-
|
|
134
|
-
| Parameter | Type |
|
|
135
|
-
| ------ | ------ |
|
|
136
|
-
| `options` | [`IIntelligenceTranscriptionOptions`](Interface.IIntelligenceTranscriptionOptions) |
|
|
137
|
-
|
|
138
|
-
#### Returns
|
|
139
|
-
|
|
140
|
-
`Promise`\<[`IIntelligenceTranscriptionResult`](Interface.IIntelligenceTranscriptionResult)\>
|
|
@@ -1,73 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 'Interface: IIntelligenceProviderAdapter'
|
|
3
|
-
generated: true
|
|
4
|
-
editUrl: false
|
|
5
|
-
---
|
|
6
|
-
# Interface: IIntelligenceProviderAdapter
|
|
7
|
-
|
|
8
|
-
Defined in: providers/IIntelligenceProviderAdapter.ts:17
|
|
9
|
-
|
|
10
|
-
Provider adapter registered with the intelligence capability registry.
|
|
11
|
-
|
|
12
|
-
The loaded handle is intentionally opaque. Only Archipel's internal
|
|
13
|
-
execution adapters unwrap it into an AI SDK model or provider API.
|
|
14
|
-
|
|
15
|
-
## Properties
|
|
16
|
-
|
|
17
|
-
### capabilities
|
|
18
|
-
|
|
19
|
-
```ts
|
|
20
|
-
readonly capabilities: readonly IntelligenceCapability[];
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
Defined in: providers/IIntelligenceProviderAdapter.ts:21
|
|
24
|
-
|
|
25
|
-
***
|
|
26
|
-
|
|
27
|
-
### provider
|
|
28
|
-
|
|
29
|
-
```ts
|
|
30
|
-
readonly provider: string;
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Defined in: providers/IIntelligenceProviderAdapter.ts:20
|
|
34
|
-
|
|
35
|
-
## Methods
|
|
36
|
-
|
|
37
|
-
### load()
|
|
38
|
-
|
|
39
|
-
```ts
|
|
40
|
-
load(request): Promise<unknown>;
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
Defined in: providers/IIntelligenceProviderAdapter.ts:27
|
|
44
|
-
|
|
45
|
-
#### Parameters
|
|
46
|
-
|
|
47
|
-
| Parameter | Type |
|
|
48
|
-
| ------ | ------ |
|
|
49
|
-
| `request` | [`IIntelligenceProviderLoadRequest`](Interface.IIntelligenceProviderLoadRequest) |
|
|
50
|
-
|
|
51
|
-
#### Returns
|
|
52
|
-
|
|
53
|
-
`Promise`\<`unknown`\>
|
|
54
|
-
|
|
55
|
-
***
|
|
56
|
-
|
|
57
|
-
### probe()?
|
|
58
|
-
|
|
59
|
-
```ts
|
|
60
|
-
optional probe(request): Promise<IIntelligenceProviderProbeResult>;
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
Defined in: providers/IIntelligenceProviderAdapter.ts:28
|
|
64
|
-
|
|
65
|
-
#### Parameters
|
|
66
|
-
|
|
67
|
-
| Parameter | Type |
|
|
68
|
-
| ------ | ------ |
|
|
69
|
-
| `request` | [`IIntelligenceProviderLoadRequest`](Interface.IIntelligenceProviderLoadRequest) |
|
|
70
|
-
|
|
71
|
-
#### Returns
|
|
72
|
-
|
|
73
|
-
`Promise`\<[`IIntelligenceProviderProbeResult`](Interface.IIntelligenceProviderProbeResult)\>
|