@frontmcp/skills 1.0.0-beta.13 → 1.0.0-beta.14

package/catalog/frontmcp-development/references/create-job.md

@@ -607,6 +607,16 @@ class DataServer {}
 | Job times out unexpectedly | Default 5-minute timeout too short              | Set `timeout` in `@Job` to a higher value (e.g., `600000` for 10 minutes)    |
 | Permission denied error    | User lacks required roles or scopes             | Verify user has one of the `roles` and all `scopes` defined in `permissions` |
 
+## Examples
+
+| Example                                                                  | Level        | Description                                                                                                        |
+| ------------------------------------------------------------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------ |
+| [`basic-report-job`](../examples/create-job/basic-report-job.md)         | Basic        | A minimal job that generates a report with progress tracking and structured output.                                |
+| [`job-with-permissions`](../examples/create-job/job-with-permissions.md) | Advanced     | A data export job with declarative permission controls, plus a function-style job for simple tasks.                |
+| [`job-with-retry`](../examples/create-job/job-with-retry.md)             | Intermediate | A job that syncs data from an external API with automatic retry, exponential backoff, and batch progress tracking. |
+
+> See all examples in [`examples/create-job/`](../examples/create-job/)
+
 ## Reference
 
 - [Jobs Documentation](https://docs.agentfront.dev/frontmcp/servers/jobs)

package/catalog/frontmcp-development/references/create-plugin-hooks.md

@@ -369,6 +369,16 @@ Any stage can have `@Will`, `@Did`, `@Stage`, or `@Around` hooks.
 | Multiple hooks execute in wrong order         | Priorities not set or conflicting                | Set explicit `priority` values; higher numbers execute first                      |
 | `@Stage` replacement causes downstream errors | Return value shape does not match stage contract | Ensure the return matches what the next stage expects (e.g., MCP response format) |
 
+## Examples
+
+| Example                                                                                                               | Level        | Description                                                                                                                                                                                                   |
+| --------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`basic-logging-plugin`](../examples/create-plugin-hooks/basic-logging-plugin.md)                                     | Basic        | Demonstrates a plugin that logs tool execution using `@Will` and `@Did` hook decorators from the pre-built `ToolHook` export.                                                                                 |
+| [`caching-with-around`](../examples/create-plugin-hooks/caching-with-around.md)                                       | Intermediate | Demonstrates wrapping tool execution with an `@Around` hook to implement result caching with TTL-based expiry.                                                                                                |
+| [`tool-level-hooks-and-stage-replacement`](../examples/create-plugin-hooks/tool-level-hooks-and-stage-replacement.md) | Advanced     | Demonstrates two advanced patterns: adding `@Will`/`@Did` hooks directly on a `@Tool` class (scoped to that tool only), and using `@Stage` in a plugin to replace a flow stage entirely with a filtered mock. |
+
+> See all examples in [`examples/create-plugin-hooks/`](../examples/create-plugin-hooks/)
+
 ## Reference
 
 - [Plugin Hooks Documentation](https://docs.agentfront.dev/frontmcp/plugins/creating-plugins)

package/catalog/frontmcp-development/references/create-plugin.md

@@ -500,6 +500,16 @@ plugins/
 | `ProviderNotRegisteredError` for context extension   | Token in `contextExtensions` not in `providers`  | Ensure the token used in `contextExtensions[].token` is registered in the plugin's `providers` array. Use `{ provide: MyToken, useClass: MyService }` or list the class directly. If using `dynamicProviders()`, return the provider there |
 | Provider works in tools but not in context extension | Using class reference instead of Symbol token    | Create a typed `Token<T> = Symbol('name')` in `symbols.ts`, use it in both `providers` and `contextExtensions`. Direct class references can fail if not constructable without dependencies                                                 |
 
+## Examples
+
+| Example                                                                                       | Level        | Description                                                                                                               |
+| --------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------- |
+| [`basic-plugin-with-provider`](../examples/create-plugin/basic-plugin-with-provider.md)       | Basic        | A minimal plugin that contributes an injectable service via the `providers` and `exports` arrays.                         |
+| [`configurable-dynamic-plugin`](../examples/create-plugin/configurable-dynamic-plugin.md)     | Advanced     | A plugin that accepts runtime configuration via `DynamicPlugin` and extends decorator metadata with custom fields.        |
+| [`plugin-with-context-extension`](../examples/create-plugin/plugin-with-context-extension.md) | Intermediate | A plugin that adds a `this.auditLog` property to all execution contexts using context extensions and module augmentation. |
+
+> See all examples in [`examples/create-plugin/`](../examples/create-plugin/)
+
 ## Reference
 
 - [Plugin System Documentation](https://docs.agentfront.dev/frontmcp/plugins/creating-plugins)

package/catalog/frontmcp-development/references/create-prompt.md

@@ -437,6 +437,16 @@ This creates the prompt file, spec file, and updates barrel exports.
 | Type error on `execute()` return                  | Returning plain string instead of `GetPromptResult` | Wrap return in `{ messages: [{ role: 'user', content: { type: 'text', text: '...' } }] }` |
 | `this.get(TOKEN)` throws DependencyNotFoundError  | Provider not registered in scope                    | Register provider in `providers` array of `@App` or `@FrontMcp`                           |
 
+## Examples
+
+| Example                                                                             | Level        | Description                                                                                          |
+| ----------------------------------------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------- |
+| [`basic-prompt`](../examples/create-prompt/basic-prompt.md)                         | Basic        | A simple prompt that generates a structured code review message from user-provided arguments.        |
+| [`dynamic-rag-prompt`](../examples/create-prompt/dynamic-rag-prompt.md)             | Advanced     | A prompt that queries a knowledge base via DI to build context-aware messages at runtime.            |
+| [`multi-turn-debug-session`](../examples/create-prompt/multi-turn-debug-session.md) | Intermediate | A prompt that uses alternating user/assistant messages to guide a structured debugging conversation. |
+
+> See all examples in [`examples/create-prompt/`](../examples/create-prompt/)
+
 ## Reference
 
 - [Prompts Documentation](https://docs.agentfront.dev/frontmcp/servers/prompts)

package/catalog/frontmcp-development/references/create-provider.md

@@ -267,6 +267,15 @@ frontmcp dev
 | Type mismatch on `this.get(TOKEN)`   | Token typed with wrong interface                    | Ensure `Token<T>` generic matches the provider's implemented interface |
 | Provider not destroyed on shutdown   | Missing `onDestroy()` method                        | Implement `onDestroy()` to close connections and release resources     |
 
+## Examples
+
+| Example                                                                               | Level        | Description                                                                                           |
+| ------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------- |
+| [`basic-database-provider`](../examples/create-provider/basic-database-provider.md)   | Basic        | A provider that manages a database connection pool with `onInit()` and `onDestroy()` lifecycle hooks. |
+| [`config-and-api-providers`](../examples/create-provider/config-and-api-providers.md) | Intermediate | A configuration provider with readonly environment settings and an HTTP API client provider.          |
+
+> See all examples in [`examples/create-provider/`](../examples/create-provider/)
+
 ## Reference
 
 - [Providers Documentation](https://docs.agentfront.dev/frontmcp/extensibility/providers)

package/catalog/frontmcp-development/references/create-resource.md

@@ -465,24 +465,55 @@ type ResourceArgumentCompleter = (partial: string) => Promise<ResourceCompletion
 
 ### How to Implement
 
-Override the `getArgumentCompleter(argName)` method in your `ResourceContext` subclass. Return a completer function for argument names you support, or `null` for unknown arguments.
+There are two approaches, both with full DI access via `this.get()`:
+
+#### Convention-Based (Preferred)
+
+Define a method named `${argName}Completer` on your `ResourceContext` subclass. The framework discovers it automatically -- no override needed.
+
+```typescript
+@ResourceTemplate({
+  name: 'user-profile',
+  description: 'User profile by ID',
+  uriTemplate: 'users://{userId}/profile',
+  mimeType: 'application/json',
+})
+class UserProfileResource extends ResourceContext<{ userId: string }> {
+  async execute(uri: string, params: { userId: string }) {
+    const user = await this.get(UserService).findById(params.userId);
+    return { id: user.id, name: user.name, email: user.email };
+  }
+
+  async userIdCompleter(partial: string): Promise<ResourceCompletionResult> {
+    const users = await this.get(UserService).search(partial);
+    return { values: users.map((u) => u.id), total: users.length };
+  }
+}
+```
+
+The naming convention is `${argName}Completer` -- for a URI parameter `{accountName}`, define `accountNameCompleter(partial)`.
+
+#### Override-Based
+
+Override the `getArgumentCompleter(argName)` method for dynamic dispatch across multiple parameters. Return a completer function for argument names you support, or `null` for unknown arguments.
 
 ```typescript
 getArgumentCompleter(argName: string): ResourceArgumentCompleter | null {
-  if (argName === 'myParam') {
+  if (argName === 'userId') {
     return async (partial) => {
-      // Search or filter based on partial input
-      const matches = await findMatches(partial);
-      return { values: matches, total: matches.length };
+      const users = await this.get(UserService).search(partial);
+      return { values: users.map((u) => u.id), total: users.length };
     };
   }
   return null;
 }
 ```
 
+Convention-based completers take priority when both are present on the same class.
+
 ### Complete Example
 
-A user profile template resource that autocompletes user IDs by searching a user service:
+A user profile template resource that autocompletes user IDs using the convention-based approach:
 
 ```typescript
 @ResourceTemplate({
@@ -497,14 +528,9 @@ class UserProfileResource extends ResourceContext<{ userId: string }> {
     return { id: user.id, name: user.name, email: user.email };
   }
 
-  getArgumentCompleter(argName: string): ResourceArgumentCompleter | null {
-    if (argName === 'userId') {
-      return async (partial) => {
-        const users = await this.get(UserService).search(partial);
-        return { values: users.map((u) => u.id), total: users.length };
-      };
-    }
-    return null;
+  async userIdCompleter(partial: string): Promise<ResourceCompletionResult> {
+    const users = await this.get(UserService).search(partial);
+    return { values: users.map((u) => u.id), total: users.length };
   }
 }
 ```
@@ -540,8 +566,9 @@ When a client requests completions for the `userId` parameter with a partial str
 
 ### Autocompletion
 
-- [ ] Template resources with dynamic params implement `getArgumentCompleter()`
+- [ ] Template resources with dynamic params define `${argName}Completer` methods or override `getArgumentCompleter()`
 - [ ] Completer returns `{ values, total?, hasMore? }` matching the partial input
+- [ ] Completers use `this.get()` for DI (both convention and override patterns support full DI)
 
 ## Troubleshooting
 
@@ -553,6 +580,16 @@ When a client requests completions for the `userId` parameter with a partial str
 | Binary content is garbled                        | Returning raw buffer in `text` field             | Use `blob: buffer.toString('base64')` instead of `text` for binary data            |
 | `this.get(TOKEN)` throws DependencyNotFoundError | Provider not registered in scope                 | Register provider in `providers` array of `@App` or `@FrontMcp`                    |
 
+## Examples
+
+| Example                                                                               | Level        | Description                                                                          |
+| ------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------ |
+| [`basic-static-resource`](../examples/create-resource/basic-static-resource.md)       | Basic        | A static resource that exposes application configuration at a fixed URI.             |
+| [`binary-and-multi-content`](../examples/create-resource/binary-and-multi-content.md) | Advanced     | A resource serving binary blob data and a resource returning multiple content items. |
+| [`parameterized-template`](../examples/create-resource/parameterized-template.md)     | Intermediate | A resource template with typed URI parameters and argument autocompletion.           |
+
+> See all examples in [`examples/create-resource/`](../examples/create-resource/)
+
 ## Reference
 
 - [Resources Documentation](https://docs.agentfront.dev/frontmcp/servers/resources)

package/catalog/frontmcp-development/references/create-skill-with-tools.md

@@ -727,6 +727,16 @@ class DeployServiceSkill extends SkillContext {}
 | Instructions are empty at runtime            | `{ file: './path.md' }` path is relative to wrong directory | Use a path relative to the skill file's location, not the project root                 |
 | Parameters not visible to AI client          | `parameters` defined as a plain object instead of an array  | Use array format: `[{ name, description, type, required }]`                            |
 
+## Examples
+
+| Example                                                                                           | Level        | Description                                                                                                          |
+| ------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------- |
+| [`basic-tool-orchestration`](../examples/create-skill-with-tools/basic-tool-orchestration.md)     | Basic        | A skill that guides an AI client through a deploy workflow using referenced MCP tools.                               |
+| [`directory-skill-with-tools`](../examples/create-skill-with-tools/directory-skill-with-tools.md) | Advanced     | A directory-based skill loaded with `skillDir()`, plus a class-based skill using Agent Skills spec metadata fields.  |
+| [`incident-response-skill`](../examples/create-skill-with-tools/incident-response-skill.md)       | Intermediate | A skill that uses object-style tool references with purpose descriptions and required flags, plus strict validation. |
+
+> See all examples in [`examples/create-skill-with-tools/`](../examples/create-skill-with-tools/)
+
 ## Reference
 
 - [Skills Documentation](https://docs.agentfront.dev/frontmcp/servers/skills)

package/catalog/frontmcp-development/references/create-skill.md

@@ -606,6 +606,16 @@ class DevServer {}
 | Skill parameters are ignored by the AI           | Parameters are declared but not referenced in the instruction text      | Mention each parameter by name in the instructions so the AI knows how to apply them   |
 | Directory-based skill missing bundled files      | Subdirectories are not named `scripts/`, `references/`, or `assets/`    | Use the exact conventional directory names; other names are not auto-bundled           |
 
+## Examples
+
+| Example                                                                      | Level        | Description                                                                                                             |
+| ---------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| [`basic-inline-skill`](../examples/create-skill/basic-inline-skill.md)       | Basic        | A minimal instruction-only skill with inline content and the function builder alternative.                              |
+| [`directory-based-skill`](../examples/create-skill/directory-based-skill.md) | Advanced     | A skill loaded from a directory structure with SKILL.md frontmatter, plus file-based and URL-based instruction sources. |
+| [`parameterized-skill`](../examples/create-skill/parameterized-skill.md)     | Intermediate | A skill with customizable parameters, usage examples for AI guidance, and controlled visibility.                        |
+
+> See all examples in [`examples/create-skill/`](../examples/create-skill/)
+
 ## Reference
 
 - **Docs:** <https://docs.agentfront.dev/frontmcp/servers/skills>

package/catalog/frontmcp-development/references/create-tool-annotations.md

@@ -37,3 +37,12 @@ Annotations provide hints to MCP clients about tool behavior:
 - Set `destructiveHint: true` for delete/overwrite operations (triggers client warnings)
 - Set `idempotentHint: true` for safe-to-retry tools
 - Set `openWorldHint: false` for tools that only access local data
+
+## Examples
+
+| Example                                                                                     | Level        | Description                                                                                                                     |
+| ------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
+| [`destructive-delete-tool`](../examples/create-tool-annotations/destructive-delete-tool.md) | Intermediate | Demonstrates annotating a tool that deletes data, enabling MCP clients to warn users before execution.                          |
+| [`readonly-query-tool`](../examples/create-tool-annotations/readonly-query-tool.md)         | Basic        | Demonstrates annotating a tool that only reads data, signaling to MCP clients that it has no side effects and is safe to retry. |
+
+> See all examples in [`examples/create-tool-annotations/`](../examples/create-tool-annotations/)

package/catalog/frontmcp-development/references/create-tool-output-schema-types.md

@@ -59,3 +59,13 @@ When `outputSchema` is omitted, the tool returns unvalidated content. This:
 - Risks leaking internal fields to the client
 - Prevents CodeCall from inferring return types
 - Loses compile-time type checking on `Out` generic
+
+## Examples
+
+| Example                                                                                                     | Level        | Description                                                                                                                                                    |
+| ----------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`primitive-and-media-outputs`](../examples/create-tool-output-schema-types/primitive-and-media-outputs.md) | Intermediate | Demonstrates using primitive string literals and media types as `outputSchema` for tools that return plain text, images, or multi-content arrays.              |
+| [`zod-raw-shape-output`](../examples/create-tool-output-schema-types/zod-raw-shape-output.md)               | Basic        | Demonstrates the recommended approach of using a Zod raw shape as `outputSchema` for structured, validated JSON output.                                        |
+| [`zod-schema-advanced-output`](../examples/create-tool-output-schema-types/zod-schema-advanced-output.md)   | Advanced     | Demonstrates using full Zod schema objects (not raw shapes) as `outputSchema`, including `z.object()`, `z.array()`, `z.union()`, and `z.discriminatedUnion()`. |
+
+> See all examples in [`examples/create-tool-output-schema-types/`](../examples/create-tool-output-schema-types/)

package/catalog/frontmcp-development/references/create-tool.md

@@ -581,6 +581,16 @@ class ConvertCurrencyTool extends ToolContext {
 | Output contains unexpected fields                | No `outputSchema` defined                   | Add `outputSchema` to strip unvalidated fields from response                 |
 | Tool times out                                   | No timeout configured for long operation    | Add `timeout: { executeMs: 30_000 }` to `@Tool` options                      |
 
+## Examples
+
+| Example                                                                                                   | Level        | Description                                                                                                    |
+| --------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------- |
+| [`basic-class-tool`](../examples/create-tool/basic-class-tool.md)                                         | Basic        | A minimal tool using the class-based pattern with Zod input validation and output schema.                      |
+| [`tool-with-di-and-errors`](../examples/create-tool/tool-with-di-and-errors.md)                           | Intermediate | A tool that resolves a database service via DI and uses `this.fail()` for business-logic errors.               |
+| [`tool-with-rate-limiting-and-progress`](../examples/create-tool/tool-with-rate-limiting-and-progress.md) | Advanced     | A batch processing tool that uses rate limiting, concurrency control, progress notifications, and annotations. |
+
+> See all examples in [`examples/create-tool/`](../examples/create-tool/)
+
 ## Reference
 
 - [Tools Documentation](https://docs.agentfront.dev/frontmcp/servers/tools)

package/catalog/frontmcp-development/references/create-workflow.md

@@ -750,6 +750,16 @@ class CiServer {}
 | Webhook trigger does not fire                       | Missing or mismatched `webhook.secret`                         | Ensure `webhook.secret` matches the sender's HMAC secret and `webhook.path` is correct             |
 | Workflow exceeds timeout                            | Total step execution time exceeds the default 600000 ms        | Increase `timeout` at the workflow level or add per-step `timeout` overrides                       |
 
+## Examples
+
+| Example                                                                                       | Level        | Description                                                                                                                       |
+| --------------------------------------------------------------------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
+| [`basic-deploy-pipeline`](../examples/create-workflow/basic-deploy-pipeline.md)               | Basic        | A linear workflow that builds, tests, and deploys a service with step dependencies and dynamic input.                             |
+| [`parallel-validation-pipeline`](../examples/create-workflow/parallel-validation-pipeline.md) | Intermediate | A workflow that validates multiple datasets in parallel, then conditionally merges results or notifies on failure.                |
+| [`webhook-triggered-workflow`](../examples/create-workflow/webhook-triggered-workflow.md)     | Advanced     | A CI/CD workflow triggered by a webhook, featuring `continueOnError`, per-step conditions, and the `workflow()` function builder. |
+
+> See all examples in [`examples/create-workflow/`](../examples/create-workflow/)
+
 ## Reference
 
 - [Workflows Documentation](https://docs.agentfront.dev/frontmcp/servers/workflows)

package/catalog/frontmcp-development/references/decorators-guide.md

@@ -744,6 +744,16 @@ class AuditHooks {
 
 ---
 
+## Examples
+
+| Example                                                                                                        | Level        | Description                                                                                                                                                                               |
+| -------------------------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`agent-skill-job-workflow`](../examples/decorators-guide/agent-skill-job-workflow.md)                         | Advanced     | Demonstrates the advanced decorator types: `@Agent` for autonomous AI agents, `@Skill` for knowledge packages, `@Job` for background tasks, and `@Workflow` for multi-step orchestration. |
+| [`basic-server-with-app-and-tools`](../examples/decorators-guide/basic-server-with-app-and-tools.md)           | Basic        | Demonstrates the minimal decorator hierarchy to create a working FrontMCP server with one app containing a tool and a resource.                                                           |
+| [`multi-app-with-plugins-and-providers`](../examples/decorators-guide/multi-app-with-plugins-and-providers.md) | Intermediate | Demonstrates a server with multiple `@App` modules, a `@Provider` for dependency injection, and a `@Plugin` for cross-cutting concerns.                                                   |
+
+> See all examples in [`examples/decorators-guide/`](../examples/decorators-guide/)
+
 ## Reference
 
 - **Official docs:** [FrontMCP Decorators Overview](https://docs.agentfront.dev/frontmcp/sdk-reference/decorators/overview)

package/catalog/frontmcp-development/references/official-adapters.md

@@ -193,6 +193,16 @@ class IntegrationHub {}
 | Stale tools after API update       | Spec polling not configured                            | Add `polling: { intervalMs: 300000 }` to refresh every 5 minutes                                                                                                                |
 | TypeScript error importing adapter | Wrong import path                                      | Import from `@frontmcp/adapters`: `import { OpenapiAdapter } from '@frontmcp/adapters'`                                                                                         |
 
+## Examples
+
+| Example                                                                                                     | Level        | Description                                                                                                                                                   |
+| ----------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`authenticated-adapter-with-polling`](../examples/official-adapters/authenticated-adapter-with-polling.md) | Intermediate | Demonstrates configuring authentication (API key and bearer token) and automatic spec polling for OpenAPI adapters.                                           |
+| [`basic-openapi-adapter`](../examples/official-adapters/basic-openapi-adapter.md)                           | Basic        | Demonstrates converting an OpenAPI specification into MCP tools automatically using `OpenapiAdapter` with minimal configuration.                              |
+| [`multi-api-hub-with-inline-spec`](../examples/official-adapters/multi-api-hub-with-inline-spec.md)         | Advanced     | Demonstrates registering multiple OpenAPI adapters from different APIs in a single app, including one with an inline spec definition instead of a remote URL. |
+
+> See all examples in [`examples/official-adapters/`](../examples/official-adapters/)
+
 ## Reference
 
 - [Adapter Overview Documentation](https://docs.agentfront.dev/frontmcp/adapters/overview)

package/catalog/frontmcp-development/references/official-plugins.md

@@ -731,6 +731,16 @@ class ProductionServer {}
 | Dashboard returns 404             | Plugin is in beta and auto-disabled in production (`NODE_ENV=production`)        | Dashboard is unstable — avoid in production. For dev: set `enabled: true` explicitly |
 | Approval webhook times out        | Callback URL not reachable from the external approval service                    | Verify `callbackPath` is publicly accessible and matches the webhook configuration   |
 
+## Examples
+
+| Example                                                                                            | Level        | Description                                                                                                                                                                  |
+| -------------------------------------------------------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`cache-and-feature-flags`](../examples/official-plugins/cache-and-feature-flags.md)               | Intermediate | Demonstrates combining the Cache plugin for tool result caching with the Feature Flags plugin for gating tools behind flags.                                                 |
+| [`production-multi-plugin-setup`](../examples/official-plugins/production-multi-plugin-setup.md)   | Advanced     | Demonstrates a production-ready server configuration combining CodeCall, Remember, Approval, Cache, and Feature Flags plugins with Redis storage and external flag services. |
+| [`remember-plugin-session-memory`](../examples/official-plugins/remember-plugin-session-memory.md) | Basic        | Demonstrates installing the Remember plugin and using `this.remember` in tools to store and retrieve session memory.                                                         |
+
+> See all examples in [`examples/official-plugins/`](../examples/official-plugins/)
+
 ## Reference
 
 - [Plugins Overview Documentation](https://docs.agentfront.dev/frontmcp/plugins/overview)

package/catalog/frontmcp-extensibility/SKILL.md

@@ -9,7 +9,7 @@ priority: 10
 visibility: both
 license: Apache-2.0
 metadata:
-  docs: https://docs.agentfront.dev/frontmcp/extensibility/overview
+  docs: https://docs.agentfront.dev/frontmcp/extensibility/providers
 ---
 
 # FrontMCP Extensibility

package/catalog/frontmcp-extensibility/examples/vectoriadb/product-catalog-search.md

@@ -0,0 +1,175 @@
+---
+name: product-catalog-search
+reference: vectoriadb
+level: advanced
+description: 'Shows advanced VectoriaDB usage with typed document metadata, batch operations, filtered search by multiple criteria, and batch indexing of a product catalog.'
+tags: [extensibility, vectoriadb, product, catalog, search]
+features:
+  - 'Typed document metadata with `ProductDoc extends DocumentMetadata`'
+  - 'Batch operations with `db.addMany()` for efficient catalog indexing'
+  - 'Multi-criteria filtered search combining category, price, and stock status'
+  - '`maxDocuments` option for DoS protection on large datasets'
+  - '`FileStorageAdapter` for persisting the entire product index to disk'
+  - 'Semantic matching: "something to block office noise" finds "noise-canceling headphones"'
+---
+
+# VectoriaDB: Product Catalog with Typed Metadata and Batch Operations
+
+Shows advanced VectoriaDB usage with typed document metadata, batch operations, filtered search by multiple criteria, and batch indexing of a product catalog.
+
+## Code
+
+```typescript
+// src/providers/product-search.provider.ts
+import { Provider, ProviderScope } from '@frontmcp/sdk';
+import { VectoriaDB, FileStorageAdapter } from 'vectoriadb';
+import type { DocumentMetadata } from 'vectoriadb';
+
+export const ProductSearch = Symbol('ProductSearch');
+
+// Typed metadata for product documents
+interface ProductDoc extends DocumentMetadata {
+  name: string;
+  category: string;
+  price: number;
+  inStock: boolean;
+}
+
+@Provider({ name: 'product-search', provide: ProductSearch, scope: ProviderScope.GLOBAL })
+export class ProductSearchProvider {
+  private db: VectoriaDB<ProductDoc>;
+  private ready: Promise<void>;
+
+  constructor() {
+    this.db = new VectoriaDB<ProductDoc>({
+      modelName: 'Xenova/all-MiniLM-L6-v2',
+      cacheDir: './.cache/transformers',
+      useHNSW: true,
+      defaultSimilarityThreshold: 0.3,
+      defaultTopK: 10,
+      maxDocuments: 100000, // DoS protection
+      storageAdapter: new FileStorageAdapter({ cacheDir: './.cache/product-vectors' }),
+    });
+    this.ready = this.db.initialize();
+  }
+
+  // Batch indexing for large catalogs
+  async indexProducts(
+    products: Array<{
+      id: string;
+      description: string;
+      name: string;
+      category: string;
+      price: number;
+      inStock: boolean;
+    }>,
+  ) {
+    await this.ready;
+
+    // Use addMany for efficient batch operations
+    await this.db.addMany(
+      products.map((p) => ({
+        id: p.id,
+        text: `${p.name}: ${p.description}`,
+        metadata: {
+          id: p.id,
+          name: p.name,
+          category: p.category,
+          price: p.price,
+          inStock: p.inStock,
+        },
+      })),
+    );
+
+    await this.db.saveToStorage();
+  }
+
+  // Multi-criteria filtered search
+  async search(query: string, filters?: { category?: string; maxPrice?: number; inStockOnly?: boolean }, limit = 10) {
+    await this.ready;
+
+    return this.db.search(query, {
+      topK: limit,
+      threshold: 0.4,
+      filter: (meta) => {
+        if (filters?.category && meta.category !== filters.category) return false;
+        if (filters?.maxPrice !== undefined && meta.price > filters.maxPrice) return false;
+        if (filters?.inStockOnly && !meta.inStock) return false;
+        return true;
+      },
+    });
+  }
+}
+```
+
+```typescript
+// src/tools/find-products.tool.ts
+import { Tool, ToolContext } from '@frontmcp/sdk';
+import { z } from 'zod';
+import { ProductSearch } from '../providers/product-search.provider';
+
+@Tool({
+  name: 'find_products',
+  description: 'Find products using natural language (e.g., "something to block office noise")',
+  inputSchema: {
+    query: z.string().min(1).describe('Natural language product search'),
+    category: z.string().optional().describe('Filter by category'),
+    maxPrice: z.number().positive().optional().describe('Maximum price'),
+    inStockOnly: z.boolean().default(true).describe('Only show in-stock products'),
+    limit: z.number().int().min(1).max(20).default(5).describe('Max results'),
+  },
+  outputSchema: {
+    products: z.array(
+      z.object({
+        id: z.string(),
+        name: z.string(),
+        category: z.string(),
+        price: z.number(),
+        score: z.number(),
+        inStock: z.boolean(),
+      }),
+    ),
+    total: z.number(),
+  },
+})
+export class FindProductsTool extends ToolContext {
+  async execute(input: { query: string; category?: string; maxPrice?: number; inStockOnly: boolean; limit: number }) {
+    const search = this.get(ProductSearch);
+
+    const results = await search.search(
+      input.query,
+      {
+        category: input.category,
+        maxPrice: input.maxPrice,
+        inStockOnly: input.inStockOnly,
+      },
+      input.limit,
+    );
+
+    return {
+      products: results.map((r) => ({
+        id: r.id,
+        name: r.metadata.name,
+        category: r.metadata.category,
+        price: r.metadata.price,
+        score: r.score,
+        inStock: r.metadata.inStock,
+      })),
+      total: results.length,
+    };
+  }
+}
+```
+
+## What This Demonstrates
+
+- Typed document metadata with `ProductDoc extends DocumentMetadata`
+- Batch operations with `db.addMany()` for efficient catalog indexing
+- Multi-criteria filtered search combining category, price, and stock status
+- `maxDocuments` option for DoS protection on large datasets
+- `FileStorageAdapter` for persisting the entire product index to disk
+- Semantic matching: "something to block office noise" finds "noise-canceling headphones"
+
+## Related
+
+- See `vectoriadb` for the full configuration reference, engine comparison, and TFIDFVectoria examples