@breadstone/archipel-mcp 0.0.54 → 0.0.55

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

@@ -0,0 +1,78 @@
+---
+title: 'Class: GrokIntelligenceProviderAdapter'
+generated: true
+editUrl: false
+---
+# Class: GrokIntelligenceProviderAdapter
+
+Defined in: providers/grok/GrokIntelligenceProviderAdapter.ts:19
+
+xAI Grok adapter for language, image, speech, transcription, video, realtime, and files.
+
+## Implements
+
+- [`IIntelligenceProviderAdapter`](Interface.IIntelligenceProviderAdapter)
+
+## Constructors
+
+### Constructor
+
+```ts
+new GrokIntelligenceProviderAdapter(): GrokIntelligenceProviderAdapter;
+```
+
+#### Returns
+
+`GrokIntelligenceProviderAdapter`
+
+## Properties
+
+### capabilities
+
+```ts
+readonly capabilities: readonly ["language", "image", "speech", "transcription", "video", "realtime", "files"];
+```
+
+Defined in: providers/grok/GrokIntelligenceProviderAdapter.ts:31
+
+#### Implementation of
+
+[`IIntelligenceProviderAdapter`](Interface.IIntelligenceProviderAdapter).[`capabilities`](Interface.IIntelligenceProviderAdapter#capabilities)
+
+***
+
+### provider
+
+```ts
+readonly provider: "grok" = IntelligenceProviderNames.Grok;
+```
+
+Defined in: providers/grok/GrokIntelligenceProviderAdapter.ts:30
+
+#### Implementation of
+
+[`IIntelligenceProviderAdapter`](Interface.IIntelligenceProviderAdapter).[`provider`](Interface.IIntelligenceProviderAdapter#provider)
+
+## Methods
+
+### load()
+
+```ts
+load(request): Promise<unknown>;
+```
+
+Defined in: providers/grok/GrokIntelligenceProviderAdapter.ts:45
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `request` | [`IIntelligenceProviderLoadRequest`](Interface.IIntelligenceProviderLoadRequest) |
+
+#### Returns
+
+`Promise`\<`unknown`\>
+
+#### Implementation of
+
+[`IIntelligenceProviderAdapter`](Interface.IIntelligenceProviderAdapter).[`load`](Interface.IIntelligenceProviderAdapter#load)

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

@@ -0,0 +1,95 @@
+---
+title: 'Class: IntelligenceAgent'
+generated: true
+editUrl: false
+---
+# Class: IntelligenceAgent
+
+Defined in: IntelligenceAgent.ts:17
+
+Reusable provider-neutral agent backed by the language capability.
+
+## Constructors
+
+### Constructor
+
+```ts
+new IntelligenceAgent(configuration, languageGenerator): IntelligenceAgent;
+```
+
+Defined in: IntelligenceAgent.ts:27
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `configuration` | [`IIntelligenceAgentConfiguration`](Interface.IIntelligenceAgentConfiguration) |
+| `languageGenerator` | [`IntelligenceLanguageGenerator`](Class.IntelligenceLanguageGenerator) |
+
+#### Returns
+
+`IntelligenceAgent`
+
+## Accessors
+
+### name
+
+#### Get Signature
+
+```ts
+get name(): string | undefined;
+```
+
+Defined in: IntelligenceAgent.ts:37
+
+Optional stable agent name used by application observability.
+
+##### Returns
+
+`string` \| `undefined`
+
+## Methods
+
+### generate()
+
+```ts
+generate(prompt, options?): Promise<IIntelligenceLanguageCompletion<string>>;
+```
+
+Defined in: IntelligenceAgent.ts:46
+
+Executes one bounded agent run.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `prompt` | [`IIntelligencePrompt`](Interface.IIntelligencePrompt) |
+| `options` | [`IIntelligenceLanguageGenerationOptions`](Interface.IIntelligenceLanguageGenerationOptions) |
+
+#### Returns
+
+`Promise`\<[`IIntelligenceLanguageCompletion`](Interface.IIntelligenceLanguageCompletion)\<`string`\>\>
+
+***
+
+### stream()
+
+```ts
+stream(prompt, options?): Promise<IIntelligenceLanguageStream>;
+```
+
+Defined in: IntelligenceAgent.ts:51
+
+Streams one agent run.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `prompt` | [`IIntelligencePrompt`](Interface.IIntelligencePrompt) |
+| `options` | [`IIntelligenceLanguageGenerationOptions`](Interface.IIntelligenceLanguageGenerationOptions) |
+
+#### Returns
+
+`Promise`\<[`IIntelligenceLanguageStream`](Interface.IIntelligenceLanguageStream)\>

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

@@ -7,14 +7,14 @@ editUrl: false
 
 Defined in: [IntelligenceAgentFactory.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceAgentFactory.ts#L16)
 
-Creates AI SDK 7 tool-loop agents with platform-registered tools merged in.
+Creates reusable provider-neutral tool-loop agents.
 
 ## Constructors
 
 ### Constructor
 
 ```ts
-new IntelligenceAgentFactory(toolRegistry): IntelligenceAgentFactory;
+new IntelligenceAgentFactory(languageGenerator): IntelligenceAgentFactory;
 ```
 
 Defined in: [IntelligenceAgentFactory.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceAgentFactory.ts#L25)
@@ -23,7 +23,7 @@ Defined in: [IntelligenceAgentFactory.ts:25](https://github.com/RueDeRennes/arch
 
 | Parameter | Type |
 | ------ | ------ |
-| `toolRegistry` | [`IntelligenceToolRegistry`](Class.IntelligenceToolRegistry) |
+| `languageGenerator` | [`IntelligenceLanguageGenerator`](Class.IntelligenceLanguageGenerator) |
 
 #### Returns
 
@@ -31,34 +31,22 @@ Defined in: [IntelligenceAgentFactory.ts:25](https://github.com/RueDeRennes/arch
 
 ## Methods
 
-### createToolLoopAgent()
+### create()
 
 ```ts
-createToolLoopAgent<TOOLS, RUNTIME_CONTEXT>(settings): Promise<ToolLoopAgent<never, TOOLS, RUNTIME_CONTEXT, never>>;
+create(configuration): IntelligenceAgent;
 ```
 
-Defined in: [IntelligenceAgentFactory.ts:47](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceAgentFactory.ts#L47)
+Defined in: [IntelligenceAgentFactory.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceAgentFactory.ts#L38)
 
-Creates a native AI SDK `ToolLoopAgent`.
-
-Registered platform tools are merged before request-specific tools, so
-request-specific tools can intentionally override a platform tool name.
-
-#### Type Parameters
-
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TOOLS` *extends* `ToolSet` | `ToolSet` |
-| `RUNTIME_CONTEXT` *extends* `Record`\<`string`, `unknown`\> | `Record`\<`string`, `unknown`\> |
+Creates a reusable agent that resolves its provider model only when run.
 
 #### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `settings` | `ToolLoopAgentSettings`\<`never`, `TOOLS`, `RUNTIME_CONTEXT`, `never`\> | Native AI SDK tool-loop agent settings. |
+| Parameter | Type |
+| ------ | ------ |
+| `configuration` | [`IIntelligenceAgentConfiguration`](Interface.IIntelligenceAgentConfiguration) |
 
 #### Returns
 
-`Promise`\<`ToolLoopAgent`\<`never`, `TOOLS`, `RUNTIME_CONTEXT`, `never`\>\>
-
-A configured AI SDK tool-loop agent.
+[`IntelligenceAgent`](Class.IntelligenceAgent)

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

@@ -5,18 +5,26 @@ editUrl: false
 ---
 # Class: IntelligenceEmbeddingGenerator
 
-Defined in: [IntelligenceEmbeddingGenerator.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceEmbeddingGenerator.ts#L20)
+Defined in: [IntelligenceEmbeddingGenerator.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceEmbeddingGenerator.ts#L27)
 
-Executes AI SDK embedding operations.
+Provider-neutral single and batch embedding facade.
 
 ## Constructors
 
 ### Constructor
 
 ```ts
-new IntelligenceEmbeddingGenerator(): IntelligenceEmbeddingGenerator;
+new IntelligenceEmbeddingGenerator(modelResolver): IntelligenceEmbeddingGenerator;
 ```
 
+Defined in: [IntelligenceEmbeddingGenerator.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceEmbeddingGenerator.ts#L36)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `modelResolver` | `IntelligenceModelResolver` |
+
 #### Returns
 
 `IntelligenceEmbeddingGenerator`
@@ -26,45 +34,41 @@ new IntelligenceEmbeddingGenerator(): IntelligenceEmbeddingGenerator;
 ### embed()
 
 ```ts
-embed(options): Promise<EmbedResult>;
+embed(options): Promise<IIntelligenceEmbeddingResult>;
 ```
 
-Defined in: [IntelligenceEmbeddingGenerator.ts:42](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceEmbeddingGenerator.ts#L42)
+Defined in: [IntelligenceEmbeddingGenerator.ts:53](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceEmbeddingGenerator.ts#L53)
 
-Embeds a single value.
+Embeds one text value.
 
 #### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `options` | \{ \} | Native AI SDK `embed()` options. |
+| Parameter | Type |
+| ------ | ------ |
+| `options` | [`IIntelligenceEmbeddingOptions`](Interface.IIntelligenceEmbeddingOptions) |
 
 #### Returns
 
-`Promise`\<`EmbedResult`\>
-
-The native AI SDK embedding result.
+`Promise`\<[`IIntelligenceEmbeddingResult`](Interface.IIntelligenceEmbeddingResult)\>
 
 ***
 
 ### embedMany()
 
 ```ts
-embedMany(options): Promise<EmbedManyResult>;
+embedMany(options): Promise<IIntelligenceEmbeddingBatchResult>;
 ```
 
-Defined in: [IntelligenceEmbeddingGenerator.ts:55](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceEmbeddingGenerator.ts#L55)
+Defined in: [IntelligenceEmbeddingGenerator.ts:85](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceEmbeddingGenerator.ts#L85)
 
-Embeds multiple values.
+Embeds multiple values with bounded provider parallelism.
 
 #### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `options` | \{ \} | Native AI SDK `embedMany()` options. |
+| Parameter | Type |
+| ------ | ------ |
+| `options` | [`IIntelligenceEmbeddingBatchOptions`](Interface.IIntelligenceEmbeddingBatchOptions) |
 
 #### Returns
 
-`Promise`\<`EmbedManyResult`\>
-
-The native AI SDK embedding result.
+`Promise`\<[`IIntelligenceEmbeddingBatchResult`](Interface.IIntelligenceEmbeddingBatchResult)\>

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

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

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

@@ -0,0 +1,159 @@
+---
+title: 'Class: IntelligenceLanguageGenerator'
+generated: true
+editUrl: false
+---
+# Class: IntelligenceLanguageGenerator
+
+Defined in: IntelligenceLanguageGenerator.ts:80
+
+Provider-neutral language generation, structured output, and streaming facade.
+
+## Constructors
+
+### Constructor
+
+```ts
+new IntelligenceLanguageGenerator(modelResolver, toolRegistry): IntelligenceLanguageGenerator;
+```
+
+Defined in: IntelligenceLanguageGenerator.ts:91
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `modelResolver` | `IntelligenceModelResolver` |
+| `toolRegistry` | [`IntelligenceToolRegistry`](Class.IntelligenceToolRegistry) |
+
+#### Returns
+
+`IntelligenceLanguageGenerator`
+
+## Methods
+
+### generateObject()
+
+```ts
+generateObject<T>(
+   prompt, 
+   schema, 
+options?): Promise<IIntelligenceLanguageCompletion<T>>;
+```
+
+Defined in: IntelligenceLanguageGenerator.ts:121
+
+Generates a schema-constrained object through the language capability.
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `T` |
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `prompt` | [`IIntelligencePrompt`](Interface.IIntelligencePrompt) |
+| `schema` | [`IIntelligenceSchema`](TypeAlias.IIntelligenceSchema)\<`T`\> |
+| `options` | [`IIntelligenceLanguageGenerationOptions`](Interface.IIntelligenceLanguageGenerationOptions) |
+
+#### Returns
+
+`Promise`\<[`IIntelligenceLanguageCompletion`](Interface.IIntelligenceLanguageCompletion)\<`T`\>\>
+
+***
+
+### generateText()
+
+```ts
+generateText(prompt, options?): Promise<IIntelligenceLanguageCompletion<string>>;
+```
+
+Defined in: IntelligenceLanguageGenerator.ts:109
+
+Generates plain text and normalized tool metadata.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `prompt` | [`IIntelligencePrompt`](Interface.IIntelligencePrompt) |
+| `options` | [`IIntelligenceLanguageGenerationOptions`](Interface.IIntelligenceLanguageGenerationOptions) |
+
+#### Returns
+
+`Promise`\<[`IIntelligenceLanguageCompletion`](Interface.IIntelligenceLanguageCompletion)\<`string`\>\>
+
+***
+
+### getDefaultModel()
+
+```ts
+getDefaultModel(): IIntelligenceModelStatus;
+```
+
+Defined in: IntelligenceLanguageGenerator.ts:201
+
+Returns the default language model without exposing credentials.
+
+#### Returns
+
+[`IIntelligenceModelStatus`](Interface.IIntelligenceModelStatus)
+
+***
+
+### streamObject()
+
+```ts
+streamObject<T>(
+   prompt, 
+   schema, 
+options?): Promise<IIntelligenceObjectStream<T>>;
+```
+
+Defined in: IntelligenceLanguageGenerator.ts:166
+
+Streams partial structured output through the language capability.
+
+#### Type Parameters
+
+| Type Parameter |
+| ------ |
+| `T` |
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `prompt` | [`IIntelligencePrompt`](Interface.IIntelligencePrompt) |
+| `schema` | [`IIntelligenceSchema`](TypeAlias.IIntelligenceSchema)\<`T`\> |
+| `options` | [`IIntelligenceLanguageGenerationOptions`](Interface.IIntelligenceLanguageGenerationOptions) |
+
+#### Returns
+
+`Promise`\<[`IIntelligenceObjectStream`](Interface.IIntelligenceObjectStream)\<`T`\>\>
+
+***
+
+### streamText()
+
+```ts
+streamText(prompt, options?): Promise<IIntelligenceLanguageStream>;
+```
+
+Defined in: IntelligenceLanguageGenerator.ts:139
+
+Streams text without exposing the native AI SDK stream object.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `prompt` | [`IIntelligencePrompt`](Interface.IIntelligencePrompt) |
+| `options` | [`IIntelligenceLanguageGenerationOptions`](Interface.IIntelligenceLanguageGenerationOptions) |
+
+#### Returns
+
+`Promise`\<[`IIntelligenceLanguageStream`](Interface.IIntelligenceLanguageStream)\>