@breadstone/archipel-mcp 0.0.43 → 0.0.44

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

@@ -1,14 +1,14 @@
 ---
 title: platform-intelligence
-description: Multi-provider AI text generation with capability registry and intent-based orchestration.
+description: Multi-provider AI text generation, streaming, and tool calling.
 order: 16
-tags: [intelligence, ai, openai, anthropic, google, grok, text-generation, capability-registry, health]
+tags: [intelligence, ai, openai, anthropic, google, grok, text-generation, streaming, tool-calling, health]
 package: '@breadstone/archipel-platform-intelligence'
 ---
 
 # platform-intelligence
 
-Multi-provider AI text generation library supporting OpenAI, Anthropic, Google Generative AI, and Grok. Features a capability registry that maps business intents to provider-specific configurations, enabling intent-based orchestration without coupling consumers to a specific LLM.
+Multi-provider AI text generation library supporting OpenAI, Anthropic, Google Generative AI, and Grok. Tool orchestration is delegated to the AI SDK through native and provider-defined tool definitions, `toolChoice`, `activeTools`, and `stopWhen`. Advanced use cases can pass native AI SDK prompts, request-level models, provider options, headers, telemetry, output settings, and step hooks through the platform generator.
 
 **Package:** `@breadstone/archipel-platform-intelligence`
 
@@ -18,101 +18,306 @@ Multi-provider AI text generation library supporting OpenAI, Anthropic, Google G
 
 ```typescript
 import { Module } from '@nestjs/common';
-import { IntelligenceModule } from '@breadstone/archipel-platform-intelligence';
+import { IntelligenceModule, IntelligenceProviderNames } from '@breadstone/archipel-platform-intelligence';
+import { loadOpenAILanguageModel } from '@breadstone/archipel-platform-intelligence/providers/openai';
 
 @Module({
-  imports: [IntelligenceModule],
+  imports: [
+    IntelligenceModule.register({
+      providerLoaders: {
+        [IntelligenceProviderNames.OpenAI]: loadOpenAILanguageModel,
+      },
+    }),
+  ],
 })
 export class AppModule {}
 ```
 
 ---
 
-## Provider Packages
+## Provider Subpaths
 
-Install only the providers you need:
+Import only the providers you need:
 
-| Provider  | Package                                                |
-| --------- | ------------------------------------------------------ |
-| OpenAI    | `@breadstone/archipel-platform-intelligence/openai`    |
-| Anthropic | `@breadstone/archipel-platform-intelligence/anthropic` |
-| Google    | `@breadstone/archipel-platform-intelligence/google`    |
-| Grok      | `@breadstone/archipel-platform-intelligence/grok`      |
+| Provider  | Subpath                                                          |
+| --------- | ---------------------------------------------------------------- |
+| OpenAI    | `@breadstone/archipel-platform-intelligence/providers/openai`    |
+| Anthropic | `@breadstone/archipel-platform-intelligence/providers/anthropic` |
+| Google    | `@breadstone/archipel-platform-intelligence/providers/google`    |
+| Grok      | `@breadstone/archipel-platform-intelligence/providers/grok`      |
 
 ---
 
-## Text Generation
+## Tool Registration
 
-Inject `IntelligenceTextGenerator` and call `generateText()`:
+Tools can be normal Nest providers or direct `IIntelligenceTool` instances. Register classes for custom application tools, or register provider-native wrappers from provider subpaths.
 
 ```typescript
-import { Injectable } from '@nestjs/common';
-import { IntelligenceTextGenerator, IIntelligencePrompt } from '@breadstone/archipel-platform-intelligence';
+import { Injectable, Module } from '@nestjs/common';
+import { tool, type Tool } from 'ai';
+import { z } from 'zod';
+import { IntelligenceModule, IntelligenceProviderNames, IntelligenceToolBase } from '@breadstone/archipel-platform-intelligence';
+import { loadOpenAILanguageModel } from '@breadstone/archipel-platform-intelligence/providers/openai';
+
+interface ICustomerSearchInput {
+  readonly query: string;
+}
 
-@Injectable()
-export class SummaryService {
-  constructor(private readonly _textGenerator: IntelligenceTextGenerator) {}
+interface ICustomerSearchOutput {
+  readonly customers: ReadonlyArray<string>;
+}
 
-  async summarize(content: string): Promise<string> {
-    const prompt: IIntelligencePrompt = {
-      system: 'You are a concise summarizer.',
-      messages: [{ role: 'user', content }],
-    };
+@Injectable()
+export class CustomerSearchTool extends IntelligenceToolBase<ICustomerSearchInput, ICustomerSearchOutput> {
+  public override get name(): string {
+    return 'searchCustomers';
+  }
 
-    const result = await this._textGenerator.generateText(prompt, {
-      provider: 'openai',
-      model: 'gpt-4o',
-      temperature: 0.3,
+  public override get tool(): Tool<ICustomerSearchInput, ICustomerSearchOutput> {
+    return tool({
+      description: 'Searches customers by name, email, or company.',
+      inputSchema: z.object({
+        query: z.string().describe('Customer search query'),
+      }),
+      execute: async (input) => ({ customers: [input.query] }),
     });
-
-    return result.text;
   }
 }
+
+@Module({
+  imports: [
+    IntelligenceModule.register({
+      providerLoaders: {
+        [IntelligenceProviderNames.OpenAI]: loadOpenAILanguageModel,
+      },
+      tools: [CustomerSearchTool],
+    }),
+  ],
+})
+export class AppModule {}
 ```
 
----
+### Provider-Native Tools
+
+Provider SDKs expose built-in tools such as web search, file search, code execution, and URL context. Archipel exports wrappers from provider subpaths so each tool is compatible with `IIntelligenceTool` without importing unused provider SDKs from the root entry.
+
+```typescript
+import { Module } from '@nestjs/common';
+import { IntelligenceModule, IntelligenceProviderNames } from '@breadstone/archipel-platform-intelligence';
+import { loadOpenAILanguageModel } from '@breadstone/archipel-platform-intelligence/providers/openai';
+import { createOpenAIWebSearchTool } from '@breadstone/archipel-platform-intelligence/providers/openai/tools';
+
+@Module({
+  imports: [
+    IntelligenceModule.register({
+      providerLoaders: {
+        [IntelligenceProviderNames.OpenAI]: loadOpenAILanguageModel,
+      },
+      tools: [createOpenAIWebSearchTool({ searchContextSize: 'medium' })],
+    }),
+  ],
+})
+export class AppModule {}
+```
 
-## Capability Registry
+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.
 
-The capability registry decouples consumers from specific providers and models by mapping business intents to configurations.
+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.
 
-### Defining Capabilities
+### Native AI SDK Passthrough
+
+`generateText()` and `streamText()` accept native AI SDK `Prompt` objects directly. The options intentionally extend the native AI SDK call options, so provider-specific features can flow through even when Archipel has no dedicated wrapper for them.
+
+The configured platform model is used by default. For exact AI SDK model factories, pass `model` per request. When every call provides a native model, set `validateOnModuleInit: false` to skip startup validation of platform provider configuration.
 
 ```typescript
-import { IIntelligenceCapability } from '@breadstone/archipel-platform-intelligence';
-
-const SUMMARIZE_CAPABILITY: IIntelligenceCapability = {
-  intent: 'summarize',
-  provider: 'openai',
-  model: 'gpt-4o',
-  temperature: 0.3,
-  maxTokens: 1024,
-};
+import { openai } from '@ai-sdk/openai';
+import { Injectable, Module } from '@nestjs/common';
+import { IntelligenceModule, IntelligenceTextGenerator } from '@breadstone/archipel-platform-intelligence';
+
+@Module({
+  imports: [
+    IntelligenceModule.register({
+      validateOnModuleInit: false,
+    }),
+  ],
+})
+export class RawAiSdkModule {}
+
+@Injectable()
+export class RawAiSdkRecipeService {
+  public constructor(private readonly _textGenerator: IntelligenceTextGenerator) {}
+
+  public async answerWithNativeOptions(): Promise<string> {
+    const completion = await this._textGenerator.generateText(
+      {
+        system: 'Answer concisely and include assumptions.',
+        prompt: 'Compare the operational risks of outdoor work tomorrow.',
+      },
+      {
+        model: openai.responses('gpt-5'),
+        headers: { 'x-use-case': 'outdoor-risk' },
+        providerOptions: {
+          openai: {
+            reasoningEffort: 'medium',
+          },
+        },
+        seed: 42,
+      },
+    );
+
+    return completion.text;
+  }
+}
 ```
 
-### Registering via IntelligenceCapabilityRegistrarBase
+### Outdoor Order Weather Risk Example
+
+Use a class-based application tool for tenant data and a provider-native web search tool for current weather context. Set `INTELLIGENCE_PROVIDER=openai` and `INTELLIGENCE_MODEL=gpt-5` in configuration when this flow should use GPT-5.
 
 ```typescript
-import { Injectable } from '@nestjs/common';
+import { Injectable, Module } from '@nestjs/common';
+import { stepCountIs, tool, type Tool } from 'ai';
+import { z } from 'zod';
 import {
-  IntelligenceCapabilityRegistrarBase,
-  IIntelligenceCapabilityRegistry,
+  IntelligenceModule,
+  IntelligenceProviderNames,
+  IntelligenceTextGenerator,
+  IntelligenceToolBase,
+  type IIntelligenceTextCompletion,
 } from '@breadstone/archipel-platform-intelligence';
+import { OpenAIIntelligenceToolNames, loadOpenAILanguageModel } from '@breadstone/archipel-platform-intelligence/providers/openai';
+import { createOpenAIWebSearchTool } from '@breadstone/archipel-platform-intelligence/providers/openai/tools';
+
+interface IOutdoorOrderLookupInput {
+  readonly date: string;
+}
+
+interface IOutdoorOrderLookupOutput {
+  readonly date: string;
+  readonly orders: ReadonlyArray<{
+    readonly id: string;
+    readonly location: string;
+    readonly scheduledAt: string;
+    readonly outdoorWork: boolean;
+  }>;
+}
 
 @Injectable()
-export class AppCapabilityRegistrar extends IntelligenceCapabilityRegistrarBase {
-  protected registerCapabilities(registry: IIntelligenceCapabilityRegistry): void {
-    registry.register(SUMMARIZE_CAPABILITY);
-    registry.register(TRANSLATE_CAPABILITY);
+export class OutdoorOrdersTool extends IntelligenceToolBase<IOutdoorOrderLookupInput, IOutdoorOrderLookupOutput> {
+  public override get name(): string {
+    return 'get_outdoor_orders';
+  }
+
+  public override get tool(): Tool<IOutdoorOrderLookupInput, IOutdoorOrderLookupOutput> {
+    return tool({
+      description: 'Returns outdoor field orders for the current tenant and date.',
+      inputSchema: z.object({
+        date: z.string().describe('Date in YYYY-MM-DD format'),
+      }),
+      execute: async (input: IOutdoorOrderLookupInput) => ({
+        date: input.date,
+        orders: [
+          {
+            id: 'ord_4711',
+            location: 'Berlin',
+            scheduledAt: `${input.date}T08:00:00+02:00`,
+            outdoorWork: true,
+          },
+        ],
+      }),
+    });
+  }
+}
+
+@Injectable()
+export class OutdoorOrderRiskAnalysisService {
+  public constructor(private readonly _textGenerator: IntelligenceTextGenerator) {}
+
+  public async analyseOutdoorOrders(date: string): Promise<{ readonly text: string; readonly sources: IIntelligenceTextCompletion['sources'] }> {
+    const result = await this._textGenerator.generateText(
+      {
+        system: 'You assess weather-related risks for tenant outdoor field orders.',
+        messages: [{ role: 'user', content: `Review outdoor field orders for ${date} and flag weather-related risks.` }],
+      },
+      {
+        toolChoice: 'auto',
+        activeTools: ['get_outdoor_orders', OpenAIIntelligenceToolNames.WebSearch],
+        stopWhen: stepCountIs(3),
+      },
+    );
+
+    return {
+      text: result.text,
+      sources: result.sources,
+    };
   }
 }
+
+@Module({
+  imports: [
+    IntelligenceModule.register({
+      providerLoaders: {
+        [IntelligenceProviderNames.OpenAI]: loadOpenAILanguageModel,
+      },
+      tools: [
+        OutdoorOrdersTool,
+        createOpenAIWebSearchTool({
+          externalWebAccess: true,
+          searchContextSize: 'medium',
+          filters: { allowedDomains: ['dwd.de'] },
+        }),
+      ],
+    }),
+  ],
+  providers: [OutdoorOrderRiskAnalysisService],
+})
+export class OutdoorOrderRiskAnalysisModule {}
 ```
 
-### Resolving at Runtime
+---
+
+## Text Generation
+
+Inject `IntelligenceTextGenerator` and call `generateText()`:
 
 ```typescript
-const capability = this._registry.resolve('summarize');
-const result = await this._textGenerator.generateText(prompt, capability);
+import { Injectable } from '@nestjs/common';
+import type { Prompt } from 'ai';
+import { IntelligenceTextGenerator } from '@breadstone/archipel-platform-intelligence';
+
+@Injectable()
+export class SummaryService {
+  constructor(private readonly _textGenerator: IntelligenceTextGenerator) {}
+
+  async summarize(content: string): Promise<string> {
+    const prompt: Prompt = {
+      system: 'You are a concise summarizer.',
+      messages: [{ role: 'user', content }],
+    };
+
+    const result = await this._textGenerator.generateText(prompt, {
+      temperature: 0.3,
+      toolChoice: 'auto',
+    });
+
+    return result.text;
+  }
+}
+```
+
+---
+
+## Streaming
+`streamText()` uses the same registered tools and returns the native AI SDK stream result.
+
+```typescript
+const stream = await this._textGenerator.streamText(prompt, {
+  activeTools: ['searchCustomers'],
+  stopWhen: stepCountIs(3),
+});
+
+return stream.toUIMessageStreamResponse();
 ```
 
 ---
@@ -121,10 +326,10 @@ const result = await this._textGenerator.generateText(prompt, capability);
 
 | Variable                         | Description                  | Required           |
 | -------------------------------- | ---------------------------- | ------------------ |
-| `INTELLIGENCE_OPENAI_API_KEY`    | OpenAI API key               | If using OpenAI    |
-| `INTELLIGENCE_ANTHROPIC_API_KEY` | Anthropic API key            | If using Anthropic |
-| `INTELLIGENCE_GOOGLE_API_KEY`    | Google Generative AI API key | If using Google    |
-| `INTELLIGENCE_GROK_API_KEY`      | Grok / xAI API key           | If using Grok      |
+| `OPENAI_API_KEY`                 | OpenAI API key               | If using OpenAI    |
+| `ANTHROPIC_API_KEY`              | Anthropic API key            | If using Anthropic |
+| `GOOGLE_API_KEY`                 | Google Generative AI API key | If using Google    |
+| `GROK_API_KEY`                   | Grok / xAI API key           | If using Grok      |
 
 ---
 
@@ -142,9 +347,7 @@ Override the timeout per call via the options parameter:
 
 ```typescript
 const result = await this._textGenerator.generateText(prompt, {
-  provider: 'openai',
-  model: 'gpt-4o',
-  timeoutMs: 15_000, // 15-second timeout
+  timeoutMs: 15_000,
 });
 ```
 
@@ -160,7 +363,7 @@ The library provides three domain error classes for different failure scenarios:
 | ---------------------------------- | ----------------------------- | --------------------------------------------------------------------- |
 | `IntelligenceProviderError`        | `INTELLIGENCE_PROVIDER`       | Provider SDK failures during text generation                          |
 | `IntelligenceValidationError`      | `INTELLIGENCE_VALIDATION`     | Invalid generation parameters (temperature, topP, maxOutputTokens)    |
-| `IntelligenceConfigurationError`   | `INTELLIGENCE_CONFIGURATION`  | Unsupported provider, missing API key, or missing SDK package         |
+| `IntelligenceConfigurationError`   | `INTELLIGENCE_CONFIGURATION`  | Unsupported provider, missing API key, or missing provider loader     |
 
 ```typescript
 import {
@@ -174,27 +377,33 @@ import {
 
 ## Lifecycle
 
-`IntelligenceTextGenerator` implements `OnModuleInit` and validates the provider configuration eagerly at startup. Missing API keys or unsupported providers throw `IntelligenceConfigurationError` before the first request is processed.
+`IntelligenceTextGenerator` implements `OnModuleInit` and validates the provider configuration plus registered provider loader eagerly at startup. Missing API keys, unsupported providers, or missing loaders throw `IntelligenceConfigurationError` before the first request is processed.
 
 ---
 
-## Capability Registry Limits
+## Tool Registry Limits
 
-`IntelligenceCapabilityRegistry` enforces a maximum of **500** registered capabilities. Attempts to register beyond this limit are logged as warnings and silently ignored. This prevents unbounded memory growth in applications with dynamic capability registration.
+`IntelligenceToolRegistry` enforces a maximum of **128** registered tools. Attempts to register beyond this limit throw `IntelligenceValidationError` to prevent unbounded memory growth.
 
 ---
 
 ## Health Check
 
-The `IntelligenceHealthIndicator` verifies that an `IntelligenceCapabilityRegistry` is injected. If no registry is available, it reports `disabled: true`. Import it from the `/health` subpath:
+The `IntelligenceHealthIndicator` verifies that provider configuration can be resolved. If no text generator is available, it reports `disabled: true`. Import it from the `/health` subpath:
 
 ```typescript
+import { IntelligenceModule, IntelligenceProviderNames } from '@breadstone/archipel-platform-intelligence';
 import { IntelligenceHealthIndicator } from '@breadstone/archipel-platform-intelligence/health';
+import { loadOpenAILanguageModel } from '@breadstone/archipel-platform-intelligence/providers/openai';
 import { HealthModule } from '@breadstone/archipel-platform-health';
 
 @Module({
   imports: [
-    IntelligenceModule.register({ /* ... */ }),
+    IntelligenceModule.register({
+      providerLoaders: {
+        [IntelligenceProviderNames.OpenAI]: loadOpenAILanguageModel,
+      },
+    }),
     HealthModule.withIndicators([IntelligenceHealthIndicator]),
   ],
 })
@@ -203,7 +412,7 @@ export class AppModule {}
 
 | Key | Check | Dependencies |
 | --- | ----- | ------------ |
-| `intelligence` | `up` if `IntelligenceCapabilityRegistry` injected, else `disabled` | `@Optional() IntelligenceCapabilityRegistry` |
+| `intelligence` | `up` when provider configuration resolves, else `down` | `@Optional() IntelligenceTextGenerator` |
 
 ---
 

package/package.json

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

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

@@ -1,94 +0,0 @@
----
-title: 'Abstract Class: IntelligenceCapabilityRegistrarBase'
-generated: true
-editUrl: false
----
-# Abstract Class: IntelligenceCapabilityRegistrarBase
-
-Defined in: [abstracts/IntelligenceCapabilityRegistrarBase.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/abstracts/IntelligenceCapabilityRegistrarBase.ts#L15)
-
-Provides a reusable registration flow that allows feature modules to contribute
-capabilities to the global intelligence registry while keeping their implementation details private.
-
-## Implements
-
-- `OnModuleInit`
-
-## Constructors
-
-### Constructor
-
-```ts
-protected new IntelligenceCapabilityRegistrarBase(registry): IntelligenceCapabilityRegistrarBase;
-```
-
-Defined in: [abstracts/IntelligenceCapabilityRegistrarBase.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/abstracts/IntelligenceCapabilityRegistrarBase.ts#L30)
-
-Initializes a new instance of the IntelligenceCapabilityRegistrarBase class.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `registry` | [`IntelligenceCapabilityRegistry`](Class.IntelligenceCapabilityRegistry) | Registry instance that receives contributed capabilities. |
-
-#### Returns
-
-`IntelligenceCapabilityRegistrarBase`
-
-## Accessors
-
-### registry
-
-#### Get Signature
-
-```ts
-get protected registry(): IntelligenceCapabilityRegistry;
-```
-
-Defined in: [abstracts/IntelligenceCapabilityRegistrarBase.ts:44](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/abstracts/IntelligenceCapabilityRegistrarBase.ts#L44)
-
-Gets the registry instance that should be used to register capabilities.
-
-##### Returns
-
-[`IntelligenceCapabilityRegistry`](Class.IntelligenceCapabilityRegistry)
-
-## Methods
-
-### getCapabilities()
-
-```ts
-abstract protected getCapabilities(): readonly IIntelligenceCapability[];
-```
-
-Defined in: [abstracts/IntelligenceCapabilityRegistrarBase.ts:74](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/abstracts/IntelligenceCapabilityRegistrarBase.ts#L74)
-
-Returns the capabilities that should be registered for the module.
-
-#### Returns
-
-readonly [`IIntelligenceCapability`](Interface.IIntelligenceCapability)[]
-
-***
-
-### onModuleInit()
-
-```ts
-onModuleInit(): void;
-```
-
-Defined in: [abstracts/IntelligenceCapabilityRegistrarBase.ts:58](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/abstracts/IntelligenceCapabilityRegistrarBase.ts#L58)
-
-Template method invoked by NestJS once the provider has been instantiated.
-Registers all capabilities returned by [getCapabilities](#getcapabilities).
-
-#### Returns
-
-`void`
-
-#### Implementation of
-
-```ts
-OnModuleInit.onModuleInit
-```

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

@@ -1,106 +0,0 @@
----
-title: 'Class: IntelligenceCapabilityRegistry'
-generated: true
-editUrl: false
----
-# Class: IntelligenceCapabilityRegistry
-
-Defined in: [IntelligenceCapabilityRegistry.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L15)
-
-Central registry responsible for resolving intelligence capabilities based on intent metadata.
-
-## Implements
-
-- [`IIntelligenceCapabilityRegistry`](Interface.IIntelligenceCapabilityRegistry)
-
-## Constructors
-
-### Constructor
-
-```ts
-new IntelligenceCapabilityRegistry(): IntelligenceCapabilityRegistry;
-```
-
-#### Returns
-
-`IntelligenceCapabilityRegistry`
-
-## Methods
-
-### list()
-
-```ts
-list(): readonly IIntelligenceCapability[];
-```
-
-Defined in: [IntelligenceCapabilityRegistry.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L45)
-
-Returns a read-only snapshot of all registered capabilities.
-
-#### Returns
-
-readonly [`IIntelligenceCapability`](Interface.IIntelligenceCapability)[]
-
-A defensive copy of the registered capabilities.
-
-#### Implementation of
-
-[`IIntelligenceCapabilityRegistry`](Interface.IIntelligenceCapabilityRegistry).[`list`](Interface.IIntelligenceCapabilityRegistry#list)
-
-***
-
-### register()
-
-```ts
-register(capability): void;
-```
-
-Defined in: [IntelligenceCapabilityRegistry.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L27)
-
-Registers a capability in the registry.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `capability` | [`IIntelligenceCapability`](Interface.IIntelligenceCapability) | The capability to register. |
-
-#### Returns
-
-`void`
-
-#### Implementation of
-
-[`IIntelligenceCapabilityRegistry`](Interface.IIntelligenceCapabilityRegistry).[`register`](Interface.IIntelligenceCapabilityRegistry#register)
-
-***
-
-### resolve()
-
-```ts
-resolve(intent, context): 
-  | IIntelligenceCapability
-  | null;
-```
-
-Defined in: [IntelligenceCapabilityRegistry.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/IntelligenceCapabilityRegistry.ts#L40)
-
-Resolves the most suitable capability for the given intent and context.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `intent` | [`IIntelligenceIntent`](Interface.IIntelligenceIntent) | The structured intent to match against. |
-| `context` | [`IIntelligenceContext`](Interface.IIntelligenceContext) | The aggregated context for the request. |
-
-#### Returns
-
-  \| [`IIntelligenceCapability`](Interface.IIntelligenceCapability)
-  \| `null`
-
-The matching capability, or `null` if none qualifies.
-
-#### Implementation of
-
-[`IIntelligenceCapabilityRegistry`](Interface.IIntelligenceCapabilityRegistry).[`resolve`](Interface.IIntelligenceCapabilityRegistry#resolve)