@breadstone/archipel-mcp 0.0.44 → 0.0.46

package/data/guides/ai-text-generation.md

@@ -23,14 +23,15 @@ Install the AI SDK provider package for the model you want to use:
 | **OpenAI**     | `@ai-sdk/openai`    |
 | **Anthropic**  | `@ai-sdk/anthropic` |
 | **Google**     | `@ai-sdk/google`    |
-| **Grok (xAI)** | `@ai-sdk/openai`    |
+| **Grok (xAI)** | `@ai-sdk/xai`       |
 
 ```bash
 # Example: OpenAI
 yarn add @ai-sdk/openai
-```
 
-> Grok uses the OpenAI-compatible endpoint, so it shares the `@ai-sdk/openai` package.
+# Example: Grok / xAI
+yarn add @ai-sdk/xai
+```
 
 ---
 
@@ -63,7 +64,7 @@ Register only the provider loaders you install. The root entry does not import p
 
 All intelligence settings are read from environment variables via `ConfigService`. No direct `process.env` access is needed.
 
-```env
+```dotenv
 INTELLIGENCE_PROVIDER=openai
 INTELLIGENCE_MODEL=gpt-4o-mini
 INTELLIGENCE_API_KEY=sk-...
@@ -80,11 +81,11 @@ INTELLIGENCE_BASE_URL=              # optional — override for custom endpoints
 | `openai`                | `gpt-4o-mini`              | OpenAI API                         |
 | `anthropic`             | `claude-sonnet-4-20250514` | Anthropic API                      |
 | `google`                | `gemini-2.0-flash`         | Google Gemini API                  |
-| `grok`                  | `grok-3-mini-fast`         | xAI Grok via OpenAI-compatible API |
+| `grok`                  | `grok-3-mini`              | xAI Grok API                       |
 
 Each provider resolves its API key and base URL from dedicated environment variables when the generic `INTELLIGENCE_API_KEY` is not set:
 
-```env
+```dotenv
 # Provider-specific keys (optional — fallback from INTELLIGENCE_API_KEY)
 OPENAI_API_KEY=sk-...
 ANTHROPIC_API_KEY=sk-ant-...
@@ -259,7 +260,7 @@ import { createOpenAIWebSearchTool } from '@breadstone/archipel-platform-intelli
 export class SearchModule {}
 ```
 
-OpenAI, Google, and Anthropic provider subpaths expose wrappers for their built-in web search, file search, code execution, URL context, shell, MCP, and versioned tool families where supported by the underlying SDK.
+OpenAI, Google, Anthropic, and Grok provider subpaths expose wrappers for their built-in web search, file search, code execution, URL context, shell, MCP, X search, image/video understanding, and versioned tool families where supported by the underlying SDK.
 
 ### Native AI SDK Passthrough
 

package/data/guides/authentication-and-authorization.md

@@ -475,7 +475,7 @@ If `mfaRequired` is `true`, the client receives a `challengeId` instead of an `a
 
 ### MFA Configuration
 
-```env
+```dotenv
 AUTH_MFA_ENCRYPTION_KEY=<32-byte-hex-key>
 AUTH_MFA_CHALLENGE_EXPIRES_IN=5m
 AUTH_MFA_MAX_ATTEMPTS=5
@@ -584,7 +584,7 @@ AuthModule.register({
 
 ### Step 4: Set Environment Variables
 
-```env
+```dotenv
 # Google
 AUTH_GOOGLE_CLIENT_ID=your-client-id
 AUTH_GOOGLE_CLIENT_SECRET=your-client-secret

package/data/guides/blob-storage.md

@@ -54,7 +54,7 @@ Each provider reads its credentials from environment variables via the `ConfigMo
 
 ### AWS S3
 
-```env
+```dotenv
 BLOB_AWS_REGION=eu-central-1
 BLOB_AWS_BUCKET=my-app-uploads
 BLOB_AWS_ACCESS_KEY_ID=AKIA...
@@ -67,7 +67,7 @@ BLOB_AWS_SECRET_ACCESS_KEY=secret...
 
 You can authenticate with either a **connection string** or **DefaultAzureCredential** (via managed identity):
 
-```env
+```dotenv
 # Option 1: Connection string
 BLOB_AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=...
 BLOB_AZURE_CONTAINER=uploads
@@ -83,7 +83,7 @@ When using `accountName` without a `connectionString`, the provider authenticate
 
 ### Vercel Blob
 
-```env
+```dotenv
 BLOB_VERCEL_TOKEN=your-vercel-blob-token
 ```
 

package/data/guides/caching.md

@@ -28,7 +28,7 @@ yarn add ioredis
 
 ### Core Variables
 
-```env
+```dotenv
 CACHE_DEFAULT_TTL_MS=60000
 CACHE_MAX_ENTRIES=1000
 CACHE_STALE_WHILE_REVALIDATE=false
@@ -38,7 +38,7 @@ All core variables are optional. When omitted, each cache instance uses the valu
 
 ### Redis Variables
 
-```env
+```dotenv
 REDIS_URL=redis://localhost:6379
 REDIS_KEY_PREFIX=app:
 REDIS_TTL_SECONDS=300

package/data/guides/database-setup.md

@@ -48,19 +48,19 @@ npx prisma init
 
 `platform-database` ships its own config keys and a ready-made entries array. Set the relevant variables in your environment:
 
-```env
+```dotenv
 DATABASE_URL=postgresql://user:password@localhost:5432/mydb
 ```
 
 For Prisma Accelerate (managed connection pooling), add the Accelerate URL from the Prisma Console:
 
-```env
+```dotenv
 DB_ACCELERATE_URL=prisma://accelerate.prisma-data.net/?api_key=your-accelerate-api-key
 ```
 
 Optional environment variables for Prisma Optimize (query analysis dashboard):
 
-```env
+```dotenv
 DB_OPTIMIZE=true
 DB_OPTIMIZE_API_KEY=your-optimize-api-key
 ```
@@ -120,7 +120,7 @@ Accelerate provides connection pooling, global caching, and query optimization
 
 Set `DB_ACCELERATE_URL` in your environment. The module reads it automatically via `ConfigService` — no code changes needed:
 
-```env
+```dotenv
 DB_ACCELERATE_URL=prisma://accelerate.prisma-data.net/?api_key=your-accelerate-api-key
 ```
 

package/data/guides/email-delivery.md

@@ -96,7 +96,7 @@ This ensures that importing the core package does **not** pull in provider-speci
 
 ### Core Variables
 
-```env
+```dotenv
 MAIL_TEMPLATE_ENGINE_FORMAT=html
 MAIL_SENDER_EMAIL=noreply@yourapp.com
 ```
@@ -109,7 +109,7 @@ The delivery strategy and template-fetch strategy are no longer configured via e
 
 #### SMTP
 
-```env
+```dotenv
 MAIL_SMTP_HOST=smtp.example.com
 MAIL_SMTP_PORT=587
 MAIL_SMTP_USER=user@example.com
@@ -119,25 +119,25 @@ MAIL_SMTP_SECURE=true
 
 #### Resend
 
-```env
+```dotenv
 MAIL_RESEND_API_KEY=re_...
 ```
 
 #### Postmark
 
-```env
+```dotenv
 MAIL_POSTMARK_API_KEY=...
 ```
 
 #### SendGrid
 
-```env
+```dotenv
 MAIL_SENDGRID_API_KEY=SG...
 ```
 
 #### Mailgun
 
-```env
+```dotenv
 MAIL_MAILGUN_API_KEY=key-...
 MAIL_MAILGUN_DOMAIN=mg.yourapp.com
 ```

package/data/guides/openapi-and-feature-discovery.md

@@ -24,7 +24,7 @@ yarn add @breadstone/archipel-platform-openapi
 
 All four variables are **required**:
 
-```env
+```dotenv
 APP_VERSION=1.0.0
 SWAGGER_CONTACT_NAME=Your Team
 SWAGGER_CONTACT_URL=https://yourcompany.com

package/data/guides/queue-infrastructure.md

@@ -40,7 +40,7 @@ yarn add @vercel/queue
 
 ### Core Variables
 
-```env
+```dotenv
 QUEUE_MAX_JOBS=10000
 ```
 
@@ -48,7 +48,7 @@ QUEUE_MAX_JOBS=10000
 
 ### BullMQ Variables
 
-```env
+```dotenv
 BULLMQ_REDIS_URL=redis://localhost:6379
 BULLMQ_PREFIX=myapp:
 ```
@@ -57,7 +57,7 @@ BULLMQ_PREFIX=myapp:
 
 ### Azure Service Bus Variables
 
-```env
+```dotenv
 AZURE_CONNECTION_STRING=Endpoint=sb://my-namespace.servicebus.windows.net/;SharedAccessKeyName=...;SharedAccessKey=...
 AZURE_RECEIVE_WAIT_MS=5000
 ```
@@ -66,7 +66,7 @@ AZURE_RECEIVE_WAIT_MS=5000
 
 ### Vercel Queues Variables
 
-```env
+```dotenv
 VERCEL_QUEUE_REGION=iad1
 VERCEL_QUEUE_CONSUMER_GROUP=my-consumer
 VERCEL_QUEUE_TOKEN=

package/data/guides/telemetry-and-observability.md

@@ -43,7 +43,7 @@ When `enabled` is `false`, the module provides a no-op facade (`NoopTelemetryFac
 
 ## Configuration
 
-```env
+```dotenv
 TELEMETRY_ENABLED=true
 TELEMETRY_SERVICE_NAME=my-api
 TELEMETRY_EXPORTER_ENDPOINT=https://otel-collector.example.com:4318

package/data/packages/platform-cryptography/api/Class.OtpService.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: OtpService
 
-Defined in: [otp/OtpService.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L45)
+Defined in: [otp/OtpService.ts:42](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L42)
 
 OTP service implementation backed by otplib v13.
 
@@ -25,7 +25,7 @@ the library version.
 new OtpService(options?): OtpService;
 ```
 
-Defined in: [otp/OtpService.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L61)
+Defined in: [otp/OtpService.ts:57](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L57)
 
 Initializes a new instance of the `OtpService` class.
 
@@ -47,7 +47,7 @@ Initializes a new instance of the `OtpService` class.
 generateSecret(): string;
 ```
 
-Defined in: [otp/OtpService.ts:75](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L75)
+Defined in: [otp/OtpService.ts:66](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L66)
 
 Generates a cryptographically random secret suitable for TOTP.
 
@@ -69,7 +69,7 @@ The generated secret string.
 generateUri(options): string;
 ```
 
-Defined in: [otp/OtpService.ts:80](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L80)
+Defined in: [otp/OtpService.ts:71](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L71)
 
 Generates an `otpauth://` URI for QR code enrollment.
 
@@ -97,7 +97,7 @@ The formatted `otpauth://` URI.
 verify(token, secret): boolean;
 ```
 
-Defined in: [otp/OtpService.ts:92](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L92)
+Defined in: [otp/OtpService.ts:83](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L83)
 
 Verifies a TOTP token against the given secret.
 
@@ -132,7 +132,7 @@ verifyHotp(
 counter): Promise<boolean>;
 ```
 
-Defined in: [otp/OtpService.ts:99](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L99)
+Defined in: [otp/OtpService.ts:96](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L96)
 
 Verifies an HOTP (counter-based) token against the given secret and counter.
 

package/data/packages/platform-cryptography/api/Variable.TOTP_EPOCH_TOLERANCE.md

@@ -9,7 +9,7 @@ editUrl: false
 const TOTP_EPOCH_TOLERANCE: 30 = 30;
 ```
 
-Defined in: [otp/OtpService.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L33)
+Defined in: [otp/OtpService.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L30)
 
 Default TOTP verification tolerance expressed in **seconds** (otplib v13 `epochTolerance`).
 

package/data/packages/platform-feature-flags/index.md

@@ -0,0 +1,103 @@
+---
+title: platform-feature-flags
+description: Provider-agnostic feature flag infrastructure for NestJS with support for Azure App Configuration and Vercel Edge Config.
+order: 3
+tags: [feature-flags, azure, vercel, edge-config, configuration]
+package: '@breadstone/archipel-platform-feature-flags'
+---
+
+# platform-feature-flags
+
+Provider-agnostic feature flag infrastructure for NestJS with support for Azure App Configuration and Vercel Edge Config.
+
+**Package:** `@breadstone/archipel-platform-feature-flags`
+
+<InstallTabs />
+
+## Provider Subpaths
+
+Import only the providers you need:
+
+| Provider                | Subpath                                              | SDK                                                                   |
+| ----------------------- | ---------------------------------------------------- | --------------------------------------------------------------------- |
+| Azure App Configuration | `@breadstone/archipel-platform-feature-flags/azure`  | `@azure/app-configuration-provider` + `@microsoft/feature-management` |
+| Vercel Edge Config      | `@breadstone/archipel-platform-feature-flags/vercel` | `@vercel/edge-config`                                                 |
+
+## Quick Start
+
+```typescript
+import { Module } from '@nestjs/common';
+import { FeatureFlagsModule } from '@breadstone/archipel-platform-feature-flags';
+import { AzureFeatureFlagsClient, AZURE_FEATURE_FLAGS_CONFIG_ENTRIES } from '@breadstone/archipel-platform-feature-flags/azure';
+
+@Module({
+  imports: [
+    FeatureFlagsModule.register({
+      client: AzureFeatureFlagsClient,
+      configEntries: AZURE_FEATURE_FLAGS_CONFIG_ENTRIES,
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+## Environment Variables
+
+### Azure App Configuration
+
+| Variable                                | Required | Description                                      |
+| --------------------------------------- | -------- | ------------------------------------------------ |
+| `AZURE_APP_CONFIGURATION_CONNECTION_STRING` | Yes      | Connection string for Azure App Configuration    |
+| `AZURE_FEATURE_FLAGS_LABEL`             | No       | Label filter for feature flags (e.g., `prod`)    |
+
+### Vercel Edge Config
+
+| Variable                | Required | Description                          |
+| ----------------------- | -------- | ------------------------------------ |
+| `EDGE_CONFIG`           | Yes      | Vercel Edge Config connection string |
+
+---
+
+## Checking Feature Flags
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { FeatureFlagsService } from '@breadstone/archipel-platform-feature-flags';
+
+@Injectable()
+export class MyService {
+  public constructor(private readonly _featureFlags: FeatureFlagsService) {}
+
+  public async doSomething(): Promise<void> {
+    const isEnabled = await this._featureFlags.isEnabled('my-feature');
+
+    if (isEnabled) {
+      // Feature is enabled
+    }
+  }
+}
+```
+
+---
+
+## Architecture
+
+```mermaid
+flowchart TB
+  subgraph FeatureFlagsModule
+    Service[FeatureFlagsService]
+    Port[FeatureFlagsClientPort]
+  end
+
+  subgraph Providers
+    Azure[AzureFeatureFlagsClient]
+    Vercel[VercelFeatureFlagsClient]
+  end
+
+  Service --> Port
+  Port -.-> Azure
+  Port -.-> Vercel
+
+  Azure --> AzureSDK[@azure/app-configuration-provider]
+  Vercel --> VercelSDK[@vercel/edge-config]
+```

package/data/packages/platform-intelligence/api/Function.createGrokCodeExecutionTool.md

@@ -0,0 +1,26 @@
+---
+title: 'Function: createGrokCodeExecutionTool()'
+generated: true
+editUrl: false
+---
+# Function: createGrokCodeExecutionTool()
+
+```ts
+function createGrokCodeExecutionTool(options?): IIntelligenceTool;
+```
+
+Defined in: [providers/grok/tools/createGrokCodeExecutionTool.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/tools/createGrokCodeExecutionTool.ts#L18)
+
+Creates a Grok code-execution tool registration.
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options` | \| `object` & \{ \} \| `undefined` | Grok code-execution tool options. |
+
+## Returns
+
+[`IIntelligenceTool`](Interface.IIntelligenceTool)
+
+Tool registration compatible with the intelligence tool registry.

package/data/packages/platform-intelligence/api/Function.createGrokFileSearchTool.md

@@ -0,0 +1,26 @@
+---
+title: 'Function: createGrokFileSearchTool()'
+generated: true
+editUrl: false
+---
+# Function: createGrokFileSearchTool()
+
+```ts
+function createGrokFileSearchTool(options): IIntelligenceTool;
+```
+
+Defined in: [providers/grok/tools/createGrokFileSearchTool.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/tools/createGrokFileSearchTool.ts#L18)
+
+Creates a Grok file-search tool registration.
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options` | \{ \} & \{ \} | Grok file-search tool options. |
+
+## Returns
+
+[`IIntelligenceTool`](Interface.IIntelligenceTool)
+
+Tool registration compatible with the intelligence tool registry.

package/data/packages/platform-intelligence/api/Function.createGrokMcpServerTool.md

@@ -0,0 +1,26 @@
+---
+title: 'Function: createGrokMcpServerTool()'
+generated: true
+editUrl: false
+---
+# Function: createGrokMcpServerTool()
+
+```ts
+function createGrokMcpServerTool(options): IIntelligenceTool;
+```
+
+Defined in: [providers/grok/tools/createGrokMcpServerTool.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/tools/createGrokMcpServerTool.ts#L18)
+
+Creates a Grok MCP server tool registration.
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options` | \{ \} & \{ \} | Grok MCP server tool options. |
+
+## Returns
+
+[`IIntelligenceTool`](Interface.IIntelligenceTool)
+
+Tool registration compatible with the intelligence tool registry.

package/data/packages/platform-intelligence/api/Function.createGrokViewImageTool.md

@@ -0,0 +1,26 @@
+---
+title: 'Function: createGrokViewImageTool()'
+generated: true
+editUrl: false
+---
+# Function: createGrokViewImageTool()
+
+```ts
+function createGrokViewImageTool(options?): IIntelligenceTool;
+```
+
+Defined in: [providers/grok/tools/createGrokViewImageTool.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/tools/createGrokViewImageTool.ts#L18)
+
+Creates a Grok image-understanding tool registration.
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options` | \| `object` & \{ \} \| `undefined` | Grok image-understanding tool options. |
+
+## Returns
+
+[`IIntelligenceTool`](Interface.IIntelligenceTool)
+
+Tool registration compatible with the intelligence tool registry.

package/data/packages/platform-intelligence/api/Function.createGrokViewXVideoTool.md

@@ -0,0 +1,26 @@
+---
+title: 'Function: createGrokViewXVideoTool()'
+generated: true
+editUrl: false
+---
+# Function: createGrokViewXVideoTool()
+
+```ts
+function createGrokViewXVideoTool(options?): IIntelligenceTool;
+```
+
+Defined in: [providers/grok/tools/createGrokViewXVideoTool.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/tools/createGrokViewXVideoTool.ts#L18)
+
+Creates a Grok X-video understanding tool registration.
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options` | \| `object` & \{ \} \| `undefined` | Grok X-video understanding tool options. |
+
+## Returns
+
+[`IIntelligenceTool`](Interface.IIntelligenceTool)
+
+Tool registration compatible with the intelligence tool registry.

package/data/packages/platform-intelligence/api/Function.createGrokWebSearchTool.md

@@ -0,0 +1,26 @@
+---
+title: 'Function: createGrokWebSearchTool()'
+generated: true
+editUrl: false
+---
+# Function: createGrokWebSearchTool()
+
+```ts
+function createGrokWebSearchTool(options?): IIntelligenceTool;
+```
+
+Defined in: [providers/grok/tools/createGrokWebSearchTool.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/tools/createGrokWebSearchTool.ts#L18)
+
+Creates a Grok web-search tool registration.
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options` | \| \{ \} & \{ \} \| `undefined` | Grok web-search tool options. |
+
+## Returns
+
+[`IIntelligenceTool`](Interface.IIntelligenceTool)
+
+Tool registration compatible with the intelligence tool registry.

package/data/packages/platform-intelligence/api/Function.createGrokXSearchTool.md

@@ -0,0 +1,26 @@
+---
+title: 'Function: createGrokXSearchTool()'
+generated: true
+editUrl: false
+---
+# Function: createGrokXSearchTool()
+
+```ts
+function createGrokXSearchTool(options?): IIntelligenceTool;
+```
+
+Defined in: [providers/grok/tools/createGrokXSearchTool.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/tools/createGrokXSearchTool.ts#L18)
+
+Creates a Grok X-search tool registration.
+
+## Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `options` | \| \{ \} & \{ \} \| `undefined` | Grok X-search tool options. |
+
+## Returns
+
+[`IIntelligenceTool`](Interface.IIntelligenceTool)
+
+Tool registration compatible with the intelligence tool registry.

package/data/packages/platform-intelligence/api/Function.loadGrokLanguageModel.md

@@ -11,7 +11,7 @@ function loadGrokLanguageModel(configuration): LanguageModelV3;
 
 Defined in: [providers/grok/loadGrokLanguageModel.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/loadGrokLanguageModel.ts#L17)
 
-Creates the Grok language model through the OpenAI-compatible xAI endpoint.
+Creates the Grok language model through the native xAI provider.
 
 ## Parameters
 

package/data/packages/platform-intelligence/api/Variable.GrokIntelligenceToolNames.md

@@ -0,0 +1,34 @@
+---
+title: 'Variable: GrokIntelligenceToolNames'
+generated: true
+editUrl: false
+---
+# Variable: GrokIntelligenceToolNames
+
+```ts
+const GrokIntelligenceToolNames: {
+  CodeExecution: "code_execution";
+  FileSearch: "file_search";
+  Mcp: "mcp";
+  ViewImage: "view_image";
+  ViewXVideo: "view_x_video";
+  WebSearch: "web_search";
+  XSearch: "x_search";
+};
+```
+
+Defined in: [providers/grok/GrokIntelligenceToolNames.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/GrokIntelligenceToolNames.ts#L6)
+
+Grok provider-defined tool names exposed through Archipel.
+
+## Type Declaration
+
+| Name | Type | Default value | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="property-codeexecution"></a> `CodeExecution` | `"code_execution"` | `'code_execution'` | [providers/grok/GrokIntelligenceToolNames.ts:7](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/GrokIntelligenceToolNames.ts#L7) |
+| <a id="property-filesearch"></a> `FileSearch` | `"file_search"` | `'file_search'` | [providers/grok/GrokIntelligenceToolNames.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/GrokIntelligenceToolNames.ts#L8) |
+| <a id="property-mcp"></a> `Mcp` | `"mcp"` | `'mcp'` | [providers/grok/GrokIntelligenceToolNames.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/GrokIntelligenceToolNames.ts#L9) |
+| <a id="property-viewimage"></a> `ViewImage` | `"view_image"` | `'view_image'` | [providers/grok/GrokIntelligenceToolNames.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/GrokIntelligenceToolNames.ts#L10) |
+| <a id="property-viewxvideo"></a> `ViewXVideo` | `"view_x_video"` | `'view_x_video'` | [providers/grok/GrokIntelligenceToolNames.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/GrokIntelligenceToolNames.ts#L11) |
+| <a id="property-websearch"></a> `WebSearch` | `"web_search"` | `'web_search'` | [providers/grok/GrokIntelligenceToolNames.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/GrokIntelligenceToolNames.ts#L12) |
+| <a id="property-xsearch"></a> `XSearch` | `"x_search"` | `'x_search'` | [providers/grok/GrokIntelligenceToolNames.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/providers/grok/GrokIntelligenceToolNames.ts#L13) |

package/data/packages/platform-intelligence/api/index.md

@@ -57,6 +57,7 @@ editUrl: false
 | [GROK\_API\_KEY](Variable.GROK_API_KEY) | Grok-specific API key. |
 | [GROK\_BASE\_URL](Variable.GROK_BASE_URL) | Grok-specific base URL. |
 | [GROK\_CONFIG\_ENTRIES](Variable.GROK_CONFIG_ENTRIES) | Configuration entries used by the Grok intelligence provider. |
+| [GrokIntelligenceToolNames](Variable.GrokIntelligenceToolNames) | Grok provider-defined tool names exposed through Archipel. |
 | [INTELLIGENCE\_API\_KEY](Variable.INTELLIGENCE_API_KEY) | Global API key override for the intelligence provider. |
 | [INTELLIGENCE\_BASE\_URL](Variable.INTELLIGENCE_BASE_URL) | Global base URL override for the intelligence provider. |
 | [INTELLIGENCE\_MAX\_OUTPUT\_TOKENS](Variable.INTELLIGENCE_MAX_OUTPUT_TOKENS) | Maximum number of output tokens for the AI model. |
@@ -104,6 +105,13 @@ editUrl: false
 | [createGoogleGoogleSearchTool](Function.createGoogleGoogleSearchTool) | Creates a Google Search grounding tool registration. |
 | [createGoogleUrlContextTool](Function.createGoogleUrlContextTool) | Creates a Google URL context tool registration. |
 | [createGoogleVertexRagStoreTool](Function.createGoogleVertexRagStoreTool) | Creates a Google Vertex RAG Store tool registration. |
+| [createGrokCodeExecutionTool](Function.createGrokCodeExecutionTool) | Creates a Grok code-execution tool registration. |
+| [createGrokFileSearchTool](Function.createGrokFileSearchTool) | Creates a Grok file-search tool registration. |
+| [createGrokMcpServerTool](Function.createGrokMcpServerTool) | Creates a Grok MCP server tool registration. |
+| [createGrokViewImageTool](Function.createGrokViewImageTool) | Creates a Grok image-understanding tool registration. |
+| [createGrokViewXVideoTool](Function.createGrokViewXVideoTool) | Creates a Grok X-video understanding tool registration. |
+| [createGrokWebSearchTool](Function.createGrokWebSearchTool) | Creates a Grok web-search tool registration. |
+| [createGrokXSearchTool](Function.createGrokXSearchTool) | Creates a Grok X-search tool registration. |
 | [createIntelligenceTool](Function.createIntelligenceTool) | Adapts a native AI SDK tool to the Archipel intelligence tool schema. |
 | [createOpenAIApplyPatchTool](Function.createOpenAIApplyPatchTool) | Creates an OpenAI apply-patch tool registration. |
 | [createOpenAICodeInterpreterTool](Function.createOpenAICodeInterpreterTool) | Creates an OpenAI code-interpreter tool registration. |
@@ -119,5 +127,5 @@ editUrl: false
 | [createProviderOptions](Function.createProviderOptions) | Creates the provider options object consumed by the AI SDK model factories. |
 | [loadAnthropicLanguageModel](Function.loadAnthropicLanguageModel) | Creates the Anthropic language model from the resolved provider configuration. |
 | [loadGoogleLanguageModel](Function.loadGoogleLanguageModel) | Creates the Google Gemini language model from the resolved provider configuration. |
-| [loadGrokLanguageModel](Function.loadGrokLanguageModel) | Creates the Grok language model through the OpenAI-compatible xAI endpoint. |
+| [loadGrokLanguageModel](Function.loadGrokLanguageModel) | Creates the Grok language model through the native xAI provider. |
 | [loadOpenAILanguageModel](Function.loadOpenAILanguageModel) | Creates the OpenAI language model from the resolved provider configuration. |

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

@@ -46,6 +46,8 @@ Import only the providers you need:
 | Google    | `@breadstone/archipel-platform-intelligence/providers/google`    |
 | Grok      | `@breadstone/archipel-platform-intelligence/providers/grok`      |
 
+Provider-native tool wrappers are exported through matching `/tools` subpaths, for example `@breadstone/archipel-platform-intelligence/providers/grok/tools`.
+
 ---
 
 ## Tool Registration
@@ -120,7 +122,7 @@ import { createOpenAIWebSearchTool } from '@breadstone/archipel-platform-intelli
 export class AppModule {}
 ```
 
-Provider-native wrappers cover OpenAI web search, file search, code interpreter, image generation, shell, MCP, and tool search; Google Search, Enterprise Web Search, URL Context, Code Execution, File Search, Maps, and Vertex RAG Store; and versioned Anthropic web search, web fetch, code execution, bash, text editor, computer, memory, tool search, and advisor tools.
+Provider-native wrappers cover OpenAI web search, file search, code interpreter, image generation, shell, MCP, and tool search; Google Search, Enterprise Web Search, URL Context, Code Execution, File Search, Maps, and Vertex RAG Store; versioned Anthropic web search, web fetch, code execution, bash, text editor, computer, memory, tool search, and advisor tools; and Grok web search, X search, file search, code execution, MCP, image understanding, and X-video understanding.
 
 The detailed AI text generation guide includes OpenAI recipes for spreadsheet analysis with Code Interpreter, image generation with generated files, deferred tool loading via Tool Search, and grammar-constrained custom tools. In the currently installed OpenAI SDK, `customTool()` constrains provider output but does not run a local `execute` callback; use a normal `tool()` when local execution is required.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breadstone/archipel-mcp",
-  "version": "0.0.44",
+  "version": "0.0.46",
   "description": "MCP server providing Archipel platform knowledge - documentation, query patterns, and coding conventions - to AI development tools.",
   "type": "commonjs",
   "main": "./src/main.js",