nestjs-apcore 0.1.0 → 0.3.0

package/dist/core/apcore.module.js

@@ -9,6 +9,8 @@ import { Global, Module } from '@nestjs/common';
 import { Registry, Executor } from 'apcore-js';
 import { ApcoreRegistryService } from './apcore-registry.service.js';
 import { ApcoreExecutorService } from './apcore-executor.service.js';
+import { ApToolScannerService } from '../decorators/ap-tool-scanner.service.js';
+import { ApcoreMcpModule } from '../mcp/apcore-mcp.module.js';
 import { APCORE_MODULE_OPTIONS } from '../constants.js';
 /**
  * Main NestJS dynamic module for the apcore ecosystem.
@@ -16,6 +18,9 @@ import { APCORE_MODULE_OPTIONS } from '../constants.js';
  * Marked `@Global()` so that {@link ApcoreRegistryService} and
  * {@link ApcoreExecutorService} are available application-wide without
  * importing this module into every feature module.
+ *
+ * Now also handles automatic tool discovery via {@link ApToolScannerService}
+ * and optional MCP server integration.
  */
 let ApcoreModule = ApcoreModule_1 = class ApcoreModule {
     /**
@@ -25,7 +30,7 @@ let ApcoreModule = ApcoreModule_1 = class ApcoreModule {
      * wraps them in NestJS-injectable services, and exports them together with
      * the raw options token.
      */
-    static forRoot(options) {
+    static forRoot(options = {}) {
         const registry = new Registry({
             extensionsDir: options.extensionsDir ?? null,
         });
@@ -36,17 +41,24 @@ let ApcoreModule = ApcoreModule_1 = class ApcoreModule {
         });
         const registryService = new ApcoreRegistryService(registry);
         const executorService = new ApcoreExecutorService(executor);
+        const imports = [];
+        if (options.mcp) {
+            imports.push(ApcoreMcpModule.forRoot(options.mcp));
+        }
         return {
             module: ApcoreModule_1,
+            imports,
             providers: [
                 { provide: APCORE_MODULE_OPTIONS, useValue: options },
                 { provide: ApcoreRegistryService, useValue: registryService },
                 { provide: ApcoreExecutorService, useValue: executorService },
+                ApToolScannerService,
             ],
             exports: [
                 APCORE_MODULE_OPTIONS,
                 ApcoreRegistryService,
                 ApcoreExecutorService,
+                ApToolScannerService,
             ],
         };
     }
@@ -57,9 +69,13 @@ let ApcoreModule = ApcoreModule_1 = class ApcoreModule {
      * ConfigService) are available to the factory function.
      */
     static forRootAsync(options) {
+        const imports = [...(options.imports ?? [])];
+        if (options.mcp) {
+            imports.push(ApcoreMcpModule.forRoot(options.mcp));
+        }
         return {
             module: ApcoreModule_1,
-            imports: (options.imports ?? []),
+            imports,
             providers: [
                 {
                     provide: APCORE_MODULE_OPTIONS,
@@ -88,11 +104,13 @@ let ApcoreModule = ApcoreModule_1 = class ApcoreModule {
                     },
                     inject: [APCORE_MODULE_OPTIONS, ApcoreRegistryService],
                 },
+                ApToolScannerService,
             ],
             exports: [
                 APCORE_MODULE_OPTIONS,
                 ApcoreRegistryService,
                 ApcoreExecutorService,
+                ApToolScannerService,
             ],
         };
     }

package/dist/core/apcore.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"apcore.module.js","sourceRoot":"","sources":["../../src/core/apcore.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAMxD;;;;;;GAMG;AAGI,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAA4B;QACzC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC5B,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;SAC7C,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC5B,QAAQ;YACR,GAAG,EAAG,OAAO,CAAC,GAAkB,IAAI,IAAI;YACxC,WAAW,EAAG,OAAO,CAAC,UAA2B,IAAI,IAAI;SAC1D,CAAC,CAAC;QAEH,MAAM,eAAe,GAAG,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,eAAe,GAAG,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAE5D,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBACrD,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe,EAAE;gBAC7D,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe,EAAE;aAC9D;YACD,OAAO,EAAE;gBACP,qBAAqB;gBACrB,qBAAqB;gBACrB,qBAAqB;aACtB;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAiC;QACnD,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAoB;YACnD,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,qBAAqB;oBAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAqB;iBACnD;gBACD;oBACE,OAAO,EAAE,qBAAqB;oBAC9B,UAAU,EAAE,CAAC,IAAyB,EAAE,EAAE;wBACxC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;4BAC5B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;yBAC1C,CAAC,CAAC;wBACH,OAAO,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;oBAC7C,CAAC;oBACD,MAAM,EAAE,CAAC,qBAAqB,CAAC;iBAChC;gBACD;oBACE,OAAO,EAAE,qBAAqB;oBAC9B,UAAU,EAAE,CACV,IAAyB,EACzB,eAAsC,EACtC,EAAE;wBACF,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;4BAC5B,QAAQ,EAAE,eAAe,CAAC,GAAG;4BAC7B,GAAG,EAAG,IAAI,CAAC,GAAkB,IAAI,IAAI;4BACrC,WAAW,EAAG,IAAI,CAAC,UAA2B,IAAI,IAAI;yBACvD,CAAC,CAAC;wBACH,OAAO,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;oBAC7C,CAAC;oBACD,MAAM,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;iBACvD;aACF;YACD,OAAO,EAAE;gBACP,qBAAqB;gBACrB,qBAAqB;gBACrB,qBAAqB;aACtB;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AAtFY,YAAY;IAFxB,MAAM,EAAE;IACR,MAAM,CAAC,EAAE,CAAC;GACE,YAAY,CAsFxB"}
+{"version":3,"file":"apcore.module.js","sourceRoot":"","sources":["../../src/core/apcore.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAMxD;;;;;;;;;GASG;AAGI,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,UAA+B,EAAE;QAC9C,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC5B,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;SAC7C,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC5B,QAAQ;YACR,GAAG,EAAG,OAAO,CAAC,GAAkB,IAAI,IAAI;YACxC,WAAW,EAAG,OAAO,CAAC,UAA2B,IAAI,IAAI;SAC1D,CAAC,CAAC;QAEH,MAAM,eAAe,GAAG,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,eAAe,GAAG,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAE5D,MAAM,OAAO,GAAU,EAAE,CAAC;QAC1B,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,OAAO;YACP,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBACrD,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe,EAAE;gBAC7D,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe,EAAE;gBAC7D,oBAAoB;aACrB;YACD,OAAO,EAAE;gBACP,qBAAqB;gBACrB,qBAAqB;gBACrB,qBAAqB;gBACrB,oBAAoB;aACrB;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAiC;QACnD,MAAM,OAAO,GAAU,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,OAAO;YACP,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,qBAAqB;oBAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAqB;iBACnD;gBACD;oBACE,OAAO,EAAE,qBAAqB;oBAC9B,UAAU,EAAE,CAAC,IAAyB,EAAE,EAAE;wBACxC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;4BAC5B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;yBAC1C,CAAC,CAAC;wBACH,OAAO,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;oBAC7C,CAAC;oBACD,MAAM,EAAE,CAAC,qBAAqB,CAAC;iBAChC;gBACD;oBACE,OAAO,EAAE,qBAAqB;oBAC9B,UAAU,EAAE,CACV,IAAyB,EACzB,eAAsC,EACtC,EAAE;wBACF,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;4BAC5B,QAAQ,EAAE,eAAe,CAAC,GAAG;4BAC7B,GAAG,EAAG,IAAI,CAAC,GAAkB,IAAI,IAAI;4BACrC,WAAW,EAAG,IAAI,CAAC,UAA2B,IAAI,IAAI;yBACvD,CAAC,CAAC;wBACH,OAAO,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;oBAC7C,CAAC;oBACD,MAAM,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;iBACvD;gBACD,oBAAoB;aACrB;YACD,OAAO,EAAE;gBACP,qBAAqB;gBACrB,qBAAqB;gBACrB,qBAAqB;gBACrB,oBAAoB;aACrB;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AArGY,YAAY;IAFxB,MAAM,EAAE;IACR,MAAM,CAAC,EAAE,CAAC;GACE,YAAY,CAqGxB"}

package/dist/decorators/ap-tool-scanner.service.d.ts

@@ -1,25 +1,64 @@
 import { type OnModuleInit } from '@nestjs/common';
 import { ModulesContainer } from '@nestjs/core';
+import { BaseScanner } from 'apcore-toolkit';
+import type { ScannedModule } from 'apcore-toolkit';
 import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
+import type { BoundExecuteFn } from '../utils/module-factory.js';
+/**
+ * Options for controlling the scan behaviour.
+ */
+export interface ScanOptions {
+    /** Regex pattern — only register modules whose ID matches. */
+    include?: string;
+    /** Regex pattern — skip modules whose ID matches. */
+    exclude?: string;
+}
 /**
  * NestJS service that auto-discovers and registers `@ApTool` decorated
  * methods at module initialization time.
  *
- * Iterates all providers in all NestJS modules via `ModulesContainer`,
- * reads decorator metadata, and registers each decorated method as a
- * module in the `ApcoreRegistryService`.
+ * Extends apcore-toolkit's {@link BaseScanner} to leverage shared scanning
+ * utilities (filterModules, deduplicateIds, extractDocstring,
+ * enrichSchemaDescriptions) and produce standardised {@link ScannedModule}
+ * intermediates before registration.
  */
-export declare class ApToolScannerService implements OnModuleInit {
+export declare class ApToolScannerService extends BaseScanner implements OnModuleInit {
     private readonly registry;
     private readonly modulesContainer;
     private readonly schemaExtractor;
+    private _scanOptions;
+    /**
+     * Parallel map keyed by moduleId that holds the bound execute functions.
+     * Kept separate from ScannedModule.metadata so that `scan()` produces
+     * clean, serialisable intermediates without leaking closures.
+     */
+    private readonly _executeFns;
     constructor(registry: ApcoreRegistryService, modulesContainer: ModulesContainer);
+    /** Configure include/exclude filters applied during scanAndRegister(). */
+    setScanOptions(options: ScanOptions): void;
+    getSourceName(): string;
     onModuleInit(): void;
     /**
-     * Scan all NestJS providers for @ApTool decorated methods and register
-     * them in the apcore registry.
+     * Scan all NestJS providers for @ApTool decorated methods.
+     *
+     * Returns ScannedModule[] (the apcore-toolkit standard intermediate)
+     * without registering — useful for inspection, filtering, or serialisation.
+     *
+     * Execute functions are stored in a parallel map accessible via
+     * {@link getExecuteFn} rather than embedded in metadata.
+     */
+    scan(): ScannedModule[];
+    /**
+     * Retrieve the bound execute function for a scanned module.
+     *
+     * Available after {@link scan} has been called. Returns `undefined` if
+     * the moduleId was not discovered during the last scan.
+     */
+    getExecuteFn(moduleId: string): BoundExecuteFn | undefined;
+    /**
+     * Scan, deduplicate, filter, then register all discovered modules.
      */
-    private scan;
+    private scanAndRegister;
     /**
      * Scan a single provider instance for @ApTool decorated methods.
      */

package/dist/decorators/ap-tool-scanner.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ap-tool-scanner.service.d.ts","sourceRoot":"","sources":["../../src/decorators/ap-tool-scanner.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AA8C3E;;;;;;;GAOG;AACH,qBACa,oBAAqB,YAAW,YAAY;IAKrD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IANnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;gBAItC,QAAQ,EAAE,qBAAqB,EAE/B,gBAAgB,EAAE,gBAAgB;IAGrD,YAAY,IAAI,IAAI;IAIpB;;;OAGG;IACH,OAAO,CAAC,IAAI;IAgBZ;;OAEG;IACH,OAAO,CAAC,YAAY;CAyGrB"}
+{"version":3,"file":"ap-tool-scanner.service.d.ts","sourceRoot":"","sources":["../../src/decorators/ap-tool-scanner.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAiD,MAAM,gBAAgB,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAgB3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AA6BjE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBACa,oBAAqB,SAAQ,WAAY,YAAW,YAAY;IAazE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAdnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,YAAY,CAAmB;IAEvC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;gBAI9C,QAAQ,EAAE,qBAAqB,EAE/B,gBAAgB,EAAE,gBAAgB;IAKrD,0EAA0E;IAC1E,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAI1C,aAAa,IAAI,MAAM;IAIvB,YAAY,IAAI,IAAI;IAIpB;;;;;;;;OAQG;IACH,IAAI,IAAI,aAAa,EAAE;IAsBvB;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAQ1D;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,YAAY;CA4HrB"}

package/dist/decorators/ap-tool-scanner.service.js

@@ -10,117 +10,169 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-import { Inject, Injectable } from '@nestjs/common';
+import { Inject, Injectable, Logger } from '@nestjs/common';
 import { ModulesContainer } from '@nestjs/core';
-import { Type as t } from '@sinclair/typebox';
-import { FunctionModule } from 'apcore-js';
+import { normalizeResult } from 'apcore-js';
+import { BaseScanner, createScannedModule, enrichSchemaDescriptions } from 'apcore-toolkit';
 import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
 import { SchemaExtractor } from '../schema/schema-extractor.service.js';
 import { AP_TOOL_METADATA_KEY, AP_MODULE_METADATA_KEY, AP_CONTEXT_METADATA_KEY, } from '../constants.js';
 import { normalizeClassName, normalizeMethodName, generateModuleId, } from '../utils/id-generator.js';
+import { scannedModuleToFunctionModule, toModuleAnnotations, } from '../utils/module-factory.js';
+const logger = new Logger('ApToolScannerService');
 /**
- * Normalize a method return value to a Record<string, unknown>.
- *
- * - null / undefined -> {}
- * - non-object (string, number, boolean, array) -> { result: value }
- * - object -> returned as-is
- */
-function normalizeReturnValue(value) {
-    if (value == null) {
-        return {};
-    }
-    if (typeof value !== 'object' || Array.isArray(value)) {
-        return { result: value };
-    }
-    return value;
-}
-/**
- * Try to extract a TSchema from the given input using SchemaExtractor.
- * Falls back to the raw value if extraction fails.
+ * Try to extract a JSON Schema from the given input using SchemaExtractor.
+ * Falls back to the raw value if extraction fails, logging a warning.
  */
-function tryExtractSchema(extractor, input) {
+function tryExtractJsonSchema(extractor, input, moduleId, field) {
     try {
-        return extractor.extract(input);
+        return extractor.extractJsonSchema(input);
     }
-    catch {
-        return input;
+    catch (err) {
+        logger.warn(`Failed to extract ${field} for "${moduleId}": ${err instanceof Error ? err.message : String(err)}. ` +
+            'Falling back to raw value.');
+        if (input != null && typeof input === 'object') {
+            return input;
+        }
+        return { type: 'object', properties: {} };
     }
 }
 /**
  * NestJS service that auto-discovers and registers `@ApTool` decorated
  * methods at module initialization time.
  *
- * Iterates all providers in all NestJS modules via `ModulesContainer`,
- * reads decorator metadata, and registers each decorated method as a
- * module in the `ApcoreRegistryService`.
+ * Extends apcore-toolkit's {@link BaseScanner} to leverage shared scanning
+ * utilities (filterModules, deduplicateIds, extractDocstring,
+ * enrichSchemaDescriptions) and produce standardised {@link ScannedModule}
+ * intermediates before registration.
  */
-let ApToolScannerService = class ApToolScannerService {
+let ApToolScannerService = class ApToolScannerService extends BaseScanner {
     registry;
     modulesContainer;
     schemaExtractor = new SchemaExtractor();
+    _scanOptions = {};
+    /**
+     * Parallel map keyed by moduleId that holds the bound execute functions.
+     * Kept separate from ScannedModule.metadata so that `scan()` produces
+     * clean, serialisable intermediates without leaking closures.
+     */
+    _executeFns = new Map();
     constructor(registry, modulesContainer) {
+        super();
         this.registry = registry;
         this.modulesContainer = modulesContainer;
     }
+    /** Configure include/exclude filters applied during scanAndRegister(). */
+    setScanOptions(options) {
+        this._scanOptions = options;
+    }
+    getSourceName() {
+        return 'nestjs-decorators';
+    }
     onModuleInit() {
-        this.scan();
+        this.scanAndRegister();
     }
     /**
-     * Scan all NestJS providers for @ApTool decorated methods and register
-     * them in the apcore registry.
+     * Scan all NestJS providers for @ApTool decorated methods.
+     *
+     * Returns ScannedModule[] (the apcore-toolkit standard intermediate)
+     * without registering — useful for inspection, filtering, or serialisation.
+     *
+     * Execute functions are stored in a parallel map accessible via
+     * {@link getExecuteFn} rather than embedded in metadata.
      */
     scan() {
+        this._executeFns.clear();
+        const modules = [];
         for (const nestModule of this.modulesContainer.values()) {
             for (const wrapper of nestModule.providers.values()) {
                 const instance = wrapper.instance;
                 const metatype = wrapper.metatype;
-                // Skip providers without a real instance or metatype (e.g. value providers)
                 if (!instance || !metatype || typeof metatype !== 'function') {
                     continue;
                 }
-                this.scanProvider(instance, metatype);
+                modules.push(...this.scanProvider(instance, metatype));
             }
         }
+        return this.deduplicateIds(modules);
+    }
+    /**
+     * Retrieve the bound execute function for a scanned module.
+     *
+     * Available after {@link scan} has been called. Returns `undefined` if
+     * the moduleId was not discovered during the last scan.
+     */
+    getExecuteFn(moduleId) {
+        return this._executeFns.get(moduleId);
+    }
+    // -------------------------------------------------------------------------
+    // Private
+    // -------------------------------------------------------------------------
+    /**
+     * Scan, deduplicate, filter, then register all discovered modules.
+     */
+    scanAndRegister() {
+        let scannedModules = this.scan();
+        // Apply include/exclude filtering via inherited BaseScanner.filterModules()
+        if (this._scanOptions.include || this._scanOptions.exclude) {
+            scannedModules = this.filterModules(scannedModules, this._scanOptions);
+        }
+        for (const mod of scannedModules) {
+            const execute = this._executeFns.get(mod.moduleId);
+            if (typeof execute !== 'function') {
+                logger.error(`No execute function found for module "${mod.moduleId}" — skipping registration.`);
+                continue;
+            }
+            const fm = scannedModuleToFunctionModule(mod, execute);
+            this.registry.register(mod.moduleId, fm);
+        }
     }
     /**
      * Scan a single provider instance for @ApTool decorated methods.
      */
     scanProvider(instance, metatype) {
-        // Read @ApModule metadata from the class (if any) to get namespace
+        const results = [];
         const moduleOptions = Reflect.getMetadata(AP_MODULE_METADATA_KEY, metatype);
         const namespace = moduleOptions?.namespace ?? normalizeClassName(metatype.name);
-        // Iterate all methods on the prototype
         const prototype = Object.getPrototypeOf(instance);
         if (!prototype)
-            return;
+            return results;
         const methodNames = Object.getOwnPropertyNames(prototype).filter((name) => {
             if (name === 'constructor')
                 return false;
             const descriptor = Object.getOwnPropertyDescriptor(prototype, name);
-            // Only include actual methods (not getters/setters)
             return descriptor !== undefined && typeof descriptor.value === 'function';
         });
         for (const methodName of methodNames) {
-            // Check for @ApTool metadata on this method
             const toolOptions = Reflect.getMetadata(AP_TOOL_METADATA_KEY, prototype, methodName);
             if (!toolOptions)
                 continue;
-            // Read @ApContext metadata (parameter index) if present
             const contextIndex = Reflect.getMetadata(AP_CONTEXT_METADATA_KEY, prototype, methodName);
-            // Generate module ID
             const normalizedMethod = normalizeMethodName(methodName);
             const moduleId = toolOptions.id ?? generateModuleId(namespace, normalizedMethod);
-            // Extract schemas via SchemaExtractor (try/catch, use raw on failure)
-            let inputSchema = t.Object({});
-            let outputSchema = t.Object({});
+            // Extract schemas to JSON Schema (toolkit standard)
+            let inputSchema = { type: 'object', properties: {} };
+            let outputSchema = { type: 'object', properties: {} };
             if (toolOptions.inputSchema != null) {
-                inputSchema = tryExtractSchema(this.schemaExtractor, toolOptions.inputSchema);
+                inputSchema = tryExtractJsonSchema(this.schemaExtractor, toolOptions.inputSchema, moduleId, 'inputSchema');
             }
             if (toolOptions.outputSchema != null) {
-                outputSchema = tryExtractSchema(this.schemaExtractor, toolOptions.outputSchema);
+                outputSchema = tryExtractJsonSchema(this.schemaExtractor, toolOptions.outputSchema, moduleId, 'outputSchema');
             }
-            // Build the execute function
+            // Use toolkit's extractDocstring() to auto-fill documentation and
+            // enrich input schema descriptions from JSDoc @param tags when the
+            // decorator doesn't provide them explicitly.
             const fn = instance[methodName];
+            let documentation = toolOptions.documentation ?? null;
+            const docstring = this.extractDocstring(fn);
+            if (documentation == null && docstring.documentation != null) {
+                documentation = docstring.documentation;
+            }
+            // Merge JSDoc @param descriptions into input schema properties via toolkit
+            if (Object.keys(docstring.params).length > 0) {
+                inputSchema = enrichSchemaDescriptions(inputSchema, docstring.params);
+            }
+            // Build the bound execute function
             const execute = async (inputs, context) => {
                 let raw;
                 if (contextIndex != null) {
@@ -138,21 +190,23 @@ let ApToolScannerService = class ApToolScannerService {
                 else {
                     raw = await fn.call(instance, inputs);
                 }
-                return normalizeReturnValue(raw);
+                return normalizeResult(raw);
             };
-            const funcModule = new FunctionModule({
+            // Store execute fn in parallel map (not in ScannedModule.metadata)
+            this._executeFns.set(moduleId, execute);
+            results.push(createScannedModule({
                 moduleId,
                 description: toolOptions.description,
                 inputSchema,
                 outputSchema,
-                tags: toolOptions.tags ?? null,
-                annotations: toolOptions.annotations ?? null,
-                documentation: toolOptions.documentation ?? null,
-                examples: toolOptions.examples ?? null,
-                execute,
-            });
-            this.registry.register(moduleId, funcModule);
+                tags: toolOptions.tags ?? [],
+                target: `${metatype.name}.${methodName}`,
+                annotations: toModuleAnnotations(toolOptions.annotations),
+                documentation,
+                examples: toolOptions.examples ?? [],
+            }));
         }
+        return results;
     }
 };
 ApToolScannerService = __decorate([

package/dist/decorators/ap-tool-scanner.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"ap-tool-scanner.service.js","sourceRoot":"","sources":["../../src/decorators/ap-tool-scanner.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ap-tool-scanner.service.js","sourceRoot":"","sources":["../../src/decorators/ap-tool-scanner.service.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,12 +3,15 @@ export { ApcoreRegistryService } from './core/apcore-registry.service.js';
 export { ApcoreExecutorService } from './core/apcore-executor.service.js';
 export { ApcoreMcpModule } from './mcp/apcore-mcp.module.js';
 export { ApcoreMcpService } from './mcp/apcore-mcp.service.js';
-export { reportProgress, elicit, createBridgeContext } from 'apcore-mcp';
-export type { BridgeContext, OpenAIToolDef, ServeOptions, MetricsExporter, ElicitResult } from 'apcore-mcp';
+export { reportProgress, elicit, createBridgeContext, asyncServe, APCoreMCP } from 'apcore-mcp';
+export type { BridgeContext, OpenAIToolDef, ServeOptions, AsyncServeOptions, AsyncServeApp, MetricsExporter, ElicitResult, APCoreMCPOptions, APCoreMCPServeOptions, APCoreMCPAsyncServeOptions, ToOpenaiToolsOptions, } from 'apcore-mcp';
 export { JWTAuthenticator, getCurrentIdentity, identityStorage } from 'apcore-mcp';
 export type { Authenticator, ClaimMapping, JWTAuthenticatorOptions } from 'apcore-mcp';
+export { BaseScanner, createScannedModule, cloneModule, extractInputSchema, extractOutputSchema, resolveRef, resolveSchema, enrichSchemaDescriptions, YAMLWriter, TypeScriptWriter, RegistryWriter, getWriter, moduleToDict, modulesToDicts, annotationsToDict, resolveTarget, flattenParams, toMarkdown, } from 'apcore-toolkit';
+export type { ScannedModule } from 'apcore-toolkit';
 export { ApTool, ApModule, ApContext } from './decorators/index.js';
 export { ApToolScannerService } from './decorators/ap-tool-scanner.service.js';
+export type { ScanOptions } from './decorators/ap-tool-scanner.service.js';
 export { SchemaExtractor, SchemaExtractionError } from './schema/schema-extractor.service.js';
 export type { SchemaAdapter } from './schema/adapters/schema-adapter.interface.js';
 export { TypeBoxAdapter } from './schema/adapters/typebox.adapter.js';
@@ -18,6 +21,8 @@ export { JsonSchemaAdapter } from './schema/adapters/json-schema.adapter.js';
 export { ApBindingLoader } from './bridge/index.js';
 export type { InstanceProvider } from './bridge/index.js';
 export { normalizeClassName, normalizeMethodName, generateModuleId, } from './utils/id-generator.js';
+export { scannedModuleToFunctionModule, toModuleAnnotations } from './utils/module-factory.js';
+export type { BoundExecuteFn } from './utils/module-factory.js';
 export { APCORE_MODULE_OPTIONS, APCORE_MCP_MODULE_OPTIONS, AP_TOOL_METADATA_KEY, AP_MODULE_METADATA_KEY, AP_CONTEXT_METADATA_KEY, } from './constants.js';
-export type { ModuleAnnotations, ModuleExample, Module, Context, Identity, ModuleDescriptor, ApToolAnnotations, ApToolExample, ApToolOptions, ApModuleOptions, ApcoreModuleOptions, ApcoreModuleAsyncOptions, ApcoreMcpModuleOptions, ApcoreMcpModuleAsyncOptions, RegisterMethodOptions, RegisterServiceOptions, } from './types.js';
+export type { ModuleAnnotations, ModuleExample, Module, Context, Identity, ModuleDescriptor, PreflightResult, PreflightCheckResult, ValidationResult, ApToolAnnotations, ApToolExample, ApToolOptions, ApModuleOptions, ApcoreModuleOptions, ApcoreModuleAsyncOptions, ApcoreMcpModuleOptions, ApcoreMcpModuleAsyncOptions, RegisterMethodOptions, RegisterServiceOptions, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAK1E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG5G,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAKvF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAK/E,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAK7E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAKxB,YAAY,EAEV,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,OAAO,EACP,QAAQ,EACR,gBAAgB,EAEhB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAK1E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAChG,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAKvF,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,wBAAwB,EACxB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAKpD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAK3E,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAK7E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKhE,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAKxB,YAAY,EAEV,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAEhB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -10,10 +10,14 @@ export { ApcoreExecutorService } from './core/apcore-executor.service.js';
 export { ApcoreMcpModule } from './mcp/apcore-mcp.module.js';
 export { ApcoreMcpService } from './mcp/apcore-mcp.service.js';
 // Re-export apcore-mcp helpers and types for convenience
-export { reportProgress, elicit, createBridgeContext } from 'apcore-mcp';
+export { reportProgress, elicit, createBridgeContext, asyncServe, APCoreMCP } from 'apcore-mcp';
 // Re-export apcore-mcp auth utilities
 export { JWTAuthenticator, getCurrentIdentity, identityStorage } from 'apcore-mcp';
 // ---------------------------------------------------------------------------
+// Toolkit (scanner & schema extraction from apcore-toolkit)
+// ---------------------------------------------------------------------------
+export { BaseScanner, createScannedModule, cloneModule, extractInputSchema, extractOutputSchema, resolveRef, resolveSchema, enrichSchemaDescriptions, YAMLWriter, TypeScriptWriter, RegistryWriter, getWriter, moduleToDict, modulesToDicts, annotationsToDict, resolveTarget, flattenParams, toMarkdown, } from 'apcore-toolkit';
+// ---------------------------------------------------------------------------
 // Decorators
 // ---------------------------------------------------------------------------
 export { ApTool, ApModule, ApContext } from './decorators/index.js';
@@ -34,6 +38,7 @@ export { ApBindingLoader } from './bridge/index.js';
 // Utilities
 // ---------------------------------------------------------------------------
 export { normalizeClassName, normalizeMethodName, generateModuleId, } from './utils/id-generator.js';
+export { scannedModuleToFunctionModule, toModuleAnnotations } from './utils/module-factory.js';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,8EAA8E;AAC9E,MAAM;AACN,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,yDAAyD;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGzE,sCAAsC;AACtC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAC9E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE9F,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAE7E,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAC9E,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAC9E,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,8EAA8E;AAC9E,MAAM;AACN,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,yDAAyD;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAehG,sCAAsC;AACtC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnF,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAC9E,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,wBAAwB,EACxB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,gBAAgB,CAAC;AAGxB,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAC9E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAG/E,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE9F,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAE7E,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAC9E,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAG/F,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAC9E,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC"}

package/dist/mcp/apcore-mcp.service.d.ts

@@ -1,13 +1,14 @@
 import type { OnApplicationBootstrap, OnModuleDestroy } from '@nestjs/common';
-import type { OpenAIToolDef } from 'apcore-mcp';
+import type { OpenAIToolDef, AsyncServeApp } from 'apcore-mcp';
 import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
 import { ApcoreExecutorService } from '../core/apcore-executor.service.js';
 import type { ApcoreMcpModuleOptions } from '../types.js';
 /**
  * NestJS service that manages the MCP (Model Context Protocol) server lifecycle.
  *
- * Wraps the `serve()` and `toOpenaiTools()` functions from `apcore-mcp`,
- * integrating them with NestJS lifecycle hooks for automatic startup/shutdown.
+ * Wraps the `serve()`, `asyncServe()`, and `toOpenaiTools()` functions from
+ * `apcore-mcp`, integrating them with NestJS lifecycle hooks for automatic
+ * startup/shutdown.
  */
 export declare class ApcoreMcpService implements OnApplicationBootstrap, OnModuleDestroy {
     private readonly registry;
@@ -24,6 +25,18 @@ export declare class ApcoreMcpService implements OnApplicationBootstrap, OnModul
     get toolCount(): number;
     /** Starts the MCP server using the configured transport and options. */
     start(): Promise<void>;
+    /**
+     * Build an embeddable HTTP request handler without starting a standalone server.
+     *
+     * Returns an `AsyncServeApp` with `handler` and `close` methods, suitable for
+     * mounting into Express, Fastify, or any Node HTTP framework.
+     */
+    asyncServe(options?: {
+        endpoint?: string;
+        explorer?: boolean;
+        explorerPrefix?: string;
+        allowExecute?: boolean;
+    }): Promise<AsyncServeApp>;
     /** Stops the MCP server. */
     stop(): Promise<void>;
     /** Restarts the MCP server (stop, then start). */
@@ -49,5 +62,10 @@ export declare class ApcoreMcpService implements OnApplicationBootstrap, OnModul
     onApplicationBootstrap(): Promise<void>;
     /** Auto-stops the MCP server on module destruction. */
     onModuleDestroy(): Promise<void>;
+    /**
+     * Collect defined option values from this.options for the given keys.
+     * Only includes keys whose values are not `undefined`.
+     */
+    private collectOptions;
 }
 //# sourceMappingURL=apcore-mcp.service.d.ts.map

package/dist/mcp/apcore-mcp.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apcore-mcp.service.d.ts","sourceRoot":"","sources":["../../src/mcp/apcore-mcp.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;GAKG;AACH,qBACa,gBAAiB,YAAW,sBAAsB,EAAE,eAAe;IAK5E,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,OAAO,CAAC,UAAU,CAAS;gBAIR,QAAQ,EAAE,qBAAqB,EAE/B,QAAQ,EAAE,qBAAqB,EAE/B,OAAO,EAAE,sBAAsB;IAOlD,mDAAmD;IACnD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAKtB;IAMD,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B,4BAA4B;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,kDAAkD;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;;;OAIG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE;QACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,aAAa,EAAE;IAQnB;;;;;;OAMG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7C,uDAAuD;IACjD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAKvC"}
+{"version":3,"file":"apcore-mcp.service.d.ts","sourceRoot":"","sources":["../../src/mcp/apcore-mcp.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAgB1D;;;;;;GAMG;AACH,qBACa,gBAAiB,YAAW,sBAAsB,EAAE,eAAe;IAK5E,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,OAAO,CAAC,UAAU,CAAS;gBAIR,QAAQ,EAAE,qBAAqB,EAE/B,QAAQ,EAAE,qBAAqB,EAE/B,OAAO,EAAE,sBAAsB;IAOlD,mDAAmD;IACnD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAKtB;IAMD,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;;;;OAKG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,aAAa,CAAC;IAc1B,4BAA4B;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,kDAAkD;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;;;OAIG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE;QACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,aAAa,EAAE;IAQnB;;;;;;OAMG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7C,uDAAuD;IACjD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtC;;;OAGG;IACH,OAAO,CAAC,cAAc;CAYvB"}