nestjs-apcore 0.1.0 → 0.3.0

package/README.md

@@ -5,7 +5,8 @@ NestJS adapter for the [apcore](https://github.com/aipartnerup/apcore-js) AI-Per
 ## Features
 
 - **Decorator-driven** — Mark methods with `@ApTool` and classes with `@ApModule` to expose them as AI tools
-- **Auto-discovery** — `ApToolScannerService` scans all providers at startup and registers decorated methods automatically
+- **Auto-discovery** — tools are scanned and registered at startup automatically
+- **One-stop setup** — `ApcoreModule.forRoot()` handles Registry, Executor, Scanner, and optional MCP server in a single call
 - **Multi-schema support** — TypeBox, Zod, class-validator DTOs, and plain JSON Schema, auto-detected via a priority chain
 - **MCP server built-in** — Serve tools over stdio, Streamable HTTP, or SSE transports with optional Tool Explorer UI
 - **OpenAI-compatible** — Convert registered tools to OpenAI function-calling format with `toOpenaiTools()`
@@ -36,26 +37,26 @@ npm install @sinclair/typebox                  # TypeBoxAdapter (recommended)
 
 ## Quick Start
 
-### 1. Wire up modules
+### 1. Wire up the module
 
 ```typescript
 // app.module.ts
 import { Module } from '@nestjs/common';
-import { ApcoreModule, ApcoreMcpModule, ApToolScannerService } from 'nestjs-apcore';
+import { ApcoreModule } from 'nestjs-apcore';
 
 @Module({
   imports: [
-    ApcoreModule.forRoot({}),
-    ApcoreMcpModule.forRoot({
-      transport: 'streamable-http',
-      port: 8000,
-      name: 'my-app',
-      version: '1.0.0',
-      explorer: true,
+    ApcoreModule.forRoot({
+      mcp: {
+        transport: 'streamable-http',
+        port: 8000,
+        name: 'my-app',
+        explorer: true,
+        allowExecute: true,
+      },
     }),
     TodoModule,
   ],
-  providers: [ApToolScannerService],
 })
 export class AppModule {}
 ```
@@ -127,47 +128,64 @@ Your service is now available as:
 
 ## API Reference
 
-### Modules
+### ApcoreModule
 
-#### `ApcoreModule`
-
-Provides the core `Registry` and `Executor` as NestJS singletons.
+The single entry point. Provides the core `Registry`, `Executor`, and `ApToolScannerService` as global NestJS singletons. Optionally integrates the MCP server.
 
 ```typescript
-// Sync
-ApcoreModule.forRoot({ extensionsDir?, acl?, middleware?, bindings? })
+// Sync — with MCP server
+ApcoreModule.forRoot({
+  extensionsDir?: string | null,
+  acl?: unknown,
+  middleware?: unknown[],
+  mcp?: ApcoreMcpModuleOptions,  // if provided, MCP server starts automatically
+})
+
+// Sync — without MCP (Registry + Executor only)
+ApcoreModule.forRoot()
 
 // Async (e.g. inject ConfigService)
-ApcoreModule.forRootAsync({ imports, useFactory, inject })
+ApcoreModule.forRootAsync({
+  imports: [ConfigModule],
+  useFactory: (config: ConfigService) => ({
+    extensionsDir: config.get('EXTENSIONS_DIR'),
+  }),
+  inject: [ConfigService],
+  mcp: { transport: 'streamable-http', port: 8000 },  // static, evaluated at definition time
+})
 ```
 
-#### `ApcoreMcpModule`
+#### MCP Options
 
-Configures and starts the MCP server.
-
-The MCP server runs **standalone on its own port** (e.g. 8000), separate from NestJS's REST server (e.g. 3000). Both share the same Registry and Executor instances.
+| Field | Type | Description |
+|---|---|---|
+| `transport` | `'stdio' \| 'streamable-http' \| 'sse'` | Transport protocol |
+| `host` | `string` | Bind host |
+| `port` | `number` | Bind port |
+| `name` | `string` | Server name |
+| `version` | `string` | Server version |
+| `explorer` | `boolean` | Enable Tool Explorer web UI |
+| `allowExecute` | `boolean` | Allow tool execution from Explorer |
+| `authenticator` | `Authenticator` | JWT or custom auth strategy |
+| `tags` | `string[]` | Only expose tools with these tags |
+| `prefix` | `string` | Only expose tools with this ID prefix |
+| `logLevel` | `string` | `'DEBUG' \| 'INFO' \| 'WARNING' \| 'ERROR' \| 'CRITICAL'` |
+| `metricsCollector` | `MetricsExporter` | Enables `/metrics` Prometheus endpoint |
+| `onStartup` | `() => void` | Callback after server starts |
+| `onShutdown` | `() => void` | Callback before server stops |
+
+#### Standalone MCP Module
+
+If you prefer to configure the MCP server separately (e.g. different lifecycle), you can import `ApcoreMcpModule` directly:
 
 ```typescript
-ApcoreMcpModule.forRoot({
-  transport: 'stdio' | 'streamable-http' | 'sse',
-  host?: string,
-  port?: number,
-  name?: string,
-  version?: string,
-  tags?: string[],          // only expose tools matching these tags
-  prefix?: string,          // only expose tools with this ID prefix
-  explorer?: boolean,       // enable Tool Explorer web UI
-  explorerPrefix?: string,  // URL prefix for the Explorer
-  allowExecute?: boolean,   // allow execution from Explorer
-  dynamic?: boolean,        // enable dynamic tool list updates
-  validateInputs?: boolean,
-  logLevel?: 'DEBUG' | 'INFO' | 'WARNING' | 'ERROR' | 'CRITICAL',
-  authenticator?: Authenticator,   // JWT or custom auth
-  exemptPaths?: string[],          // paths that bypass auth (default: ['/health', '/metrics'])
-  metricsCollector?: { exportPrometheus(): string },
-  onStartup?: () => void | Promise<void>,
-  onShutdown?: () => void | Promise<void>,
+@Module({
+  imports: [
+    ApcoreModule.forRoot(),
+    ApcoreMcpModule.forRoot({ transport: 'streamable-http', port: 8000 }),
+  ],
 })
+export class AppModule {}
 ```
 
 ### Decorators
@@ -242,17 +260,20 @@ bindings:
 
 ### JWT Authentication
 
-Enable JWT auth by passing a `JWTAuthenticator` to `ApcoreMcpModule`. The Explorer UI and `/health` endpoint are always exempt.
+Enable JWT auth by passing a `JWTAuthenticator` in the `mcp` config. The Explorer UI and `/health` endpoint are always exempt.
 
 ```typescript
-import { JWTAuthenticator, getCurrentIdentity } from 'nestjs-apcore';
+import { ApcoreModule, JWTAuthenticator, getCurrentIdentity } from 'nestjs-apcore';
 
 // In app.module.ts
-const jwtSecret = process.env.JWT_SECRET;
-ApcoreMcpModule.forRoot({
-  transport: 'streamable-http',
-  port: 8000,
-  authenticator: jwtSecret ? new JWTAuthenticator({ secret: jwtSecret }) : undefined,
+ApcoreModule.forRoot({
+  mcp: {
+    transport: 'streamable-http',
+    port: 8000,
+    authenticator: process.env.JWT_SECRET
+      ? new JWTAuthenticator({ secret: process.env.JWT_SECRET })
+      : undefined,
+  },
 })
 
 // Inside any @ApTool method
@@ -262,8 +283,6 @@ list(inputs: Record<string, unknown>) {
 }
 ```
 
-`JWTAuthenticator` options: `secret`, `algorithms` (default `['HS256']`), `audience`, `issuer`, `claimMapping`, `requireClaims`, `requireAuth` (default `true`).
-
 ### Re-exported Utilities
 
 From `apcore-mcp`:
@@ -272,7 +291,7 @@ From `apcore-mcp`:
 
 ## Examples
 
-The `demo/` directory contains a full working app with Todo and Weather services:
+The [`demo/`](./demo) directory contains a full working app with Todo and Weather services:
 
 ```bash
 cd demo
@@ -280,12 +299,15 @@ npm install
 npx tsx src/main.ts
 ```
 
-Or with Docker:
+## Detailed Documentation
 
-```bash
-cd demo
-docker compose up --build
-```
+For in-depth documentation on each subsystem, see [`docs/features/`](./docs/features/):
+
+- [Feature Overview](./docs/features/overview.md) — architecture and dependency graph
+- [MCP Server Integration](./docs/features/mcp-server-integration.md) — module configuration, services API, dual-server architecture
+- [@ApTool Decorator + Scanner](./docs/features/aptool-decorator-scanner.md) — decorators, ID generation, scan process
+- [Schema Extraction](./docs/features/schema-extraction.md) — adapter chain, supported types, custom adapters
+- [NestJS DI Bridge](./docs/features/di-bridge.md) — `registerMethod()`, `registerService()`, YAML bindings
 
 ## Scripts
 

package/dist/bridge/binding-loader.d.ts

@@ -7,8 +7,8 @@ export type InstanceProvider = (className: string) => object | undefined;
  * NestJS injectable service that loads YAML binding files and registers
  * modules with the ApcoreRegistryService.
  *
- * Each binding maps a module_id to a "ClassName.methodName" target,
- * optionally providing schema, annotations, tags, and documentation.
+ * Uses apcore-toolkit's {@link createScannedModule} to produce standardised
+ * intermediates, then converts to FunctionModule via the shared factory.
  */
 export declare class ApBindingLoader {
     private readonly registry;

package/dist/bridge/binding-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binding-loader.d.ts","sourceRoot":"","sources":["../../src/bridge/binding-loader.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAuB3E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAmBzE;;;;;;GAMG;AACH,qBACa,eAAe;IAGxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAGzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAHjB,QAAQ,EAAE,qBAAqB,EAG/B,gBAAgB,CAAC,EAAE,gBAAgB,YAAA;IAGtD;;;;;;OAMG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAkDzC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAIxD"}
+{"version":3,"file":"binding-loader.d.ts","sourceRoot":"","sources":["../../src/bridge/binding-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AA2B3E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAEzE;;;;;;GAMG;AACH,qBACa,eAAe;IAGxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAGzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAHjB,QAAQ,EAAE,qBAAqB,EAG/B,gBAAgB,CAAC,EAAE,gBAAgB,YAAA;IAGtD;;;;;;OAMG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAmDzC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAIxD"}

package/dist/bridge/binding-loader.js

@@ -13,31 +13,16 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { Injectable, Inject, Optional } from '@nestjs/common';
 import * as yaml from 'js-yaml';
 import { readFile } from 'node:fs/promises';
-import { Type as t } from '@sinclair/typebox';
-import { FunctionModule } from 'apcore-js';
+import { normalizeResult } from 'apcore-js';
+import { createScannedModule } from 'apcore-toolkit';
 import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
-/**
- * Normalize a method return value to a Record<string, unknown>.
- *
- * - null / undefined -> {}
- * - non-object (string, number, boolean) or 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;
-}
+import { scannedModuleToFunctionModule, toModuleAnnotations, } from '../utils/module-factory.js';
 /**
  * NestJS injectable service that loads YAML binding files and registers
  * modules with the ApcoreRegistryService.
  *
- * Each binding maps a module_id to a "ClassName.methodName" target,
- * optionally providing schema, annotations, tags, and documentation.
+ * Uses apcore-toolkit's {@link createScannedModule} to produce standardised
+ * intermediates, then converts to FunctionModule via the shared factory.
  */
 let ApBindingLoader = class ApBindingLoader {
     registry;
@@ -65,12 +50,12 @@ let ApBindingLoader = class ApBindingLoader {
             if (this.instanceProvider) {
                 instance = this.instanceProvider(className);
             }
-            // Build the execute function
+            // Build the bound execute function
             let execute;
             if (instance && methodName in instance) {
                 execute = async (inputs) => {
                     const raw = await instance[methodName](inputs);
-                    return normalizeReturnValue(raw);
+                    return normalizeResult(raw);
                 };
             }
             else {
@@ -80,18 +65,19 @@ let ApBindingLoader = class ApBindingLoader {
                     };
                 };
             }
-            const funcModule = new FunctionModule({
+            // Build ScannedModule intermediate via toolkit
+            const scanned = createScannedModule({
                 moduleId,
                 description: binding.description,
-                inputSchema: binding.input_schema ?? t.Object({}),
-                outputSchema: binding.output_schema ?? t.Object({}),
-                tags: binding.tags ?? null,
-                annotations: binding.annotations ?? null,
+                inputSchema: binding.input_schema ?? { type: 'object', properties: {} },
+                outputSchema: binding.output_schema ?? { type: 'object', properties: {} },
+                tags: binding.tags ?? [],
+                target: binding.target,
+                annotations: toModuleAnnotations(binding.annotations),
                 documentation: binding.documentation ?? null,
-                examples: null,
-                execute,
             });
-            this.registry.register(moduleId, funcModule);
+            const fm = scannedModuleToFunctionModule(scanned, execute);
+            this.registry.register(moduleId, fm);
             ids.push(moduleId);
         }
         return ids;

package/dist/bridge/binding-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding-loader.js","sourceRoot":"","sources":["../../src/bridge/binding-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"binding-loader.js","sourceRoot":"","sources":["../../src/bridge/binding-loader.ts"],"names":[],"mappings":"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"}

package/dist/core/apcore-executor.service.d.ts

@@ -1,5 +1,5 @@
 import type { Executor } from 'apcore-js';
-import type { Context, ValidationResult } from 'apcore-js';
+import type { Context, PreflightResult } from 'apcore-js';
 /**
  * NestJS-injectable wrapper around the upstream apcore-js {@link Executor}.
  *
@@ -34,9 +34,13 @@ export declare class ApcoreExecutorService {
     /**
      * Validate inputs against a module's input schema without executing it.
      *
+     * Returns a PreflightResult containing per-check results, approval
+     * requirements, and overall validity.
+     *
      * @param moduleId  Fully-qualified module identifier.
-     * @param inputs    Key/value inputs to validate.
+     * @param inputs    Key/value inputs to validate (defaults to `{}`).
+     * @param context   Optional execution context for call-chain checks.
      */
-    validate(moduleId: string, inputs: Record<string, unknown>): ValidationResult;
+    validate(moduleId: string, inputs?: Record<string, unknown>, context?: Context | null): PreflightResult;
 }
 //# sourceMappingURL=apcore-executor.service.d.ts.map

package/dist/core/apcore-executor.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apcore-executor.service.d.ts","sourceRoot":"","sources":["../../src/core/apcore-executor.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE3D;;;;;GAKG;AACH,qBACa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAM/C,yDAAyD;IACzD,IAAI,GAAG,IAAI,QAAQ,CAElB;IAED;;;;;;;OAOG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAInC;;;;;;;;;OASG;IACI,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI1C;;;;;OAKG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,gBAAgB;CAGpB"}
+{"version":3,"file":"apcore-executor.service.d.ts","sourceRoot":"","sources":["../../src/core/apcore-executor.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;;GAKG;AACH,qBACa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAM/C,yDAAyD;IACzD,IAAI,GAAG,IAAI,QAAQ,CAElB;IAED;;;;;;;OAOG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAInC;;;;;;;;;OASG;IACI,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI1C;;;;;;;;;OASG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GACvB,eAAe;CAGnB"}

package/dist/core/apcore-executor.service.js

@@ -53,11 +53,15 @@ let ApcoreExecutorService = class ApcoreExecutorService {
     /**
      * Validate inputs against a module's input schema without executing it.
      *
+     * Returns a PreflightResult containing per-check results, approval
+     * requirements, and overall validity.
+     *
      * @param moduleId  Fully-qualified module identifier.
-     * @param inputs    Key/value inputs to validate.
+     * @param inputs    Key/value inputs to validate (defaults to `{}`).
+     * @param context   Optional execution context for call-chain checks.
      */
-    validate(moduleId, inputs) {
-        return this.executor.validate(moduleId, inputs);
+    validate(moduleId, inputs, context) {
+        return this.executor.validate(moduleId, inputs ?? {}, context);
     }
 };
 ApcoreExecutorService = __decorate([

package/dist/core/apcore-executor.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"apcore-executor.service.js","sourceRoot":"","sources":["../../src/core/apcore-executor.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C;;;;;GAKG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACH;IAA7B,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD,0EAA0E;IAC1E,aAAa;IACb,0EAA0E;IAE1E,yDAAyD;IACzD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CACN,QAAgB,EAChB,MAA+B;QAE/B,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;CACF,CAAA;AA1DY,qBAAqB;IADjC,UAAU,EAAE;;GACA,qBAAqB,CA0DjC"}
+{"version":3,"file":"apcore-executor.service.js","sourceRoot":"","sources":["../../src/core/apcore-executor.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C;;;;;GAKG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACH;IAA7B,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD,0EAA0E;IAC1E,aAAa;IACb,0EAA0E;IAE1E,yDAAyD;IACzD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CACN,QAAgB,EAChB,MAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;CACF,CAAA;AA/DY,qBAAqB;IADjC,UAAU,EAAE;;GACA,qBAAqB,CA+DjC"}

package/dist/core/apcore-registry.service.d.ts

@@ -1,10 +1,12 @@
 import type { Registry } from 'apcore-js';
 import type { ModuleDescriptor } from 'apcore-js';
+import type { ScannedModule } from 'apcore-toolkit';
 import type { RegisterMethodOptions, RegisterServiceOptions } from '../types.js';
 /**
  * NestJS-injectable service that wraps an upstream apcore-js Registry,
  * delegating core operations and adding convenience methods for
- * registering NestJS service methods as FunctionModules.
+ * registering NestJS service methods via apcore-toolkit's ScannedModule
+ * intermediate representation.
  */
 export declare class ApcoreRegistryService {
     private readonly registry;
@@ -24,16 +26,31 @@ export declare class ApcoreRegistryService {
     discover(): Promise<number>;
     get count(): number;
     /**
-     * Register a single method from a service instance as a FunctionModule.
+     * Convert a registered module's descriptor to a toolkit ScannedModule.
+     *
+     * Returns `null` if the module is not found.
+     */
+    toScannedModule(moduleId: string): ScannedModule | null;
+    /**
+     * Serialise a registered module to a plain snake_case dictionary
+     * via apcore-toolkit's `moduleToDict()`.
      *
-     * Generates a module ID from the class name + method name when no
-     * explicit id is provided (e.g. EmailService.sendEmail -> email.send_email).
+     * Returns `null` if the module is not found.
+     */
+    toDict(moduleId: string): Record<string, unknown> | null;
+    /**
+     * Serialise all registered modules (optionally filtered by tags/prefix)
+     * to an array of snake_case dictionaries via apcore-toolkit.
+     */
+    toDicts(options?: {
+        tags?: string[];
+        prefix?: string;
+    }): Record<string, unknown>[];
+    /**
+     * Register a single method from a service instance as a FunctionModule.
      *
-     * The execute function calls the method on the bound instance and
-     * normalizes the return value:
-     *   - null / undefined -> {}
-     *   - non-object -> { result: value }
-     *   - object -> returned as-is
+     * Produces a toolkit {@link ScannedModule} intermediate, then converts it
+     * to a FunctionModule with the method bound to the service instance.
      *
      * @returns The module ID under which the method was registered.
      */

package/dist/core/apcore-registry.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apcore-registry.service.d.ts","sourceRoot":"","sources":["../../src/core/apcore-registry.service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AA+CjF;;;;GAIG;AACH,qBACa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAI/C,yDAAyD;IACzD,IAAI,GAAG,IAAI,QAAQ,CAElB;IAID,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIjD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIrC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAIrC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAI9D,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIxD,EAAE,CACA,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GACpD,IAAI;IAIP,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAI3B,IAAI,KAAK,IAAI,MAAM,CAElB;IAID;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM;IA4CtD;;;;;;;;OAQG;IACH,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,EAAE;CAwD3D"}
+{"version":3,"file":"apcore-registry.service.d.ts","sourceRoot":"","sources":["../../src/core/apcore-registry.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAkCjF;;;;;GAKG;AACH,qBACa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAI/C,yDAAyD;IACzD,IAAI,GAAG,IAAI,QAAQ,CAElB;IAID,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIjD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIrC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAIrC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAI9D,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIxD,EAAE,CACA,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GACpD,IAAI;IAIP,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAI3B,IAAI,KAAK,IAAI,MAAM,CAElB;IAID;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAkBvD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMxD;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAYlF;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM;IAiDtD;;;;;;;;OAQG;IACH,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,EAAE;CAwD3D"}

package/dist/core/apcore-registry.service.js

@@ -8,25 +8,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { Injectable } from '@nestjs/common';
-import { Type as t } from '@sinclair/typebox';
-import { FunctionModule } from 'apcore-js';
+import { normalizeResult } from 'apcore-js';
+import { createScannedModule, moduleToDict, modulesToDicts } from 'apcore-toolkit';
 import { normalizeClassName, normalizeMethodName, generateModuleId, } from '../utils/id-generator.js';
-/**
- * Normalize a method return value to a Record<string, unknown>.
- *
- * - null / undefined -> {}
- * - non-object (string, number, boolean) -> { 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;
-}
+import { scannedModuleToFunctionModule, toModuleAnnotations, } from '../utils/module-factory.js';
 /**
  * Collect all own method names from a prototype chain up to (but not
  * including) Object.prototype. Excludes 'constructor'.
@@ -48,7 +33,8 @@ function getAllMethodNames(instance) {
 /**
  * NestJS-injectable service that wraps an upstream apcore-js Registry,
  * delegating core operations and adding convenience methods for
- * registering NestJS service methods as FunctionModules.
+ * registering NestJS service methods via apcore-toolkit's ScannedModule
+ * intermediate representation.
  */
 let ApcoreRegistryService = class ApcoreRegistryService {
     registry;
@@ -88,18 +74,61 @@ let ApcoreRegistryService = class ApcoreRegistryService {
     get count() {
         return this.registry.count;
     }
+    // ---- serialisation helpers (via apcore-toolkit) ----
+    /**
+     * Convert a registered module's descriptor to a toolkit ScannedModule.
+     *
+     * Returns `null` if the module is not found.
+     */
+    toScannedModule(moduleId) {
+        const def = this.registry.getDefinition(moduleId);
+        if (!def)
+            return null;
+        return createScannedModule({
+            moduleId: def.moduleId,
+            description: def.description,
+            inputSchema: def.inputSchema,
+            outputSchema: def.outputSchema,
+            tags: def.tags ?? [],
+            target: moduleId,
+            annotations: def.annotations ?? null,
+            documentation: def.documentation ?? null,
+            examples: (def.examples ?? []),
+            metadata: def.metadata ?? {},
+        });
+    }
+    /**
+     * Serialise a registered module to a plain snake_case dictionary
+     * via apcore-toolkit's `moduleToDict()`.
+     *
+     * Returns `null` if the module is not found.
+     */
+    toDict(moduleId) {
+        const scanned = this.toScannedModule(moduleId);
+        if (!scanned)
+            return null;
+        return moduleToDict(scanned);
+    }
+    /**
+     * Serialise all registered modules (optionally filtered by tags/prefix)
+     * to an array of snake_case dictionaries via apcore-toolkit.
+     */
+    toDicts(options) {
+        const ids = this.registry.list(options);
+        const scanned = [];
+        for (const id of ids) {
+            const s = this.toScannedModule(id);
+            if (s)
+                scanned.push(s);
+        }
+        return modulesToDicts(scanned);
+    }
     // ---- NestJS convenience methods ----
     /**
      * Register a single method from a service instance as a FunctionModule.
      *
-     * Generates a module ID from the class name + method name when no
-     * explicit id is provided (e.g. EmailService.sendEmail -> email.send_email).
-     *
-     * The execute function calls the method on the bound instance and
-     * normalizes the return value:
-     *   - null / undefined -> {}
-     *   - non-object -> { result: value }
-     *   - object -> returned as-is
+     * Produces a toolkit {@link ScannedModule} intermediate, then converts it
+     * to a FunctionModule with the method bound to the service instance.
      *
      * @returns The module ID under which the method was registered.
      */
@@ -112,21 +141,25 @@ let ApcoreRegistryService = class ApcoreRegistryService {
         }
         const className = instance.constructor.name;
         const moduleId = generateModuleId(className, method, true, id);
-        const funcModule = new FunctionModule({
+        // Build ScannedModule intermediate via toolkit
+        const scanned = createScannedModule({
             moduleId,
             description,
-            inputSchema: inputSchema ?? t.Object({}),
-            outputSchema: outputSchema ?? t.Object({}),
-            tags: tags ?? null,
-            annotations: annotations,
+            inputSchema: inputSchema ?? { type: 'object', properties: {} },
+            outputSchema: outputSchema ?? { type: 'object', properties: {} },
+            tags: tags ?? [],
+            target: `${className}.${method}`,
+            annotations: toModuleAnnotations(annotations),
             documentation: documentation ?? null,
-            examples: examples ?? null,
-            execute: async (inputs) => {
-                const raw = await fn.call(instance, inputs);
-                return normalizeReturnValue(raw);
-            },
+            examples: examples ?? [],
         });
-        this.registry.register(moduleId, funcModule);
+        // Bound execute function using normalizeResult from apcore-js
+        const execute = async (inputs) => {
+            const raw = await fn.call(instance, inputs);
+            return normalizeResult(raw);
+        };
+        const fm = scannedModuleToFunctionModule(scanned, execute);
+        this.registry.register(moduleId, fm);
         return moduleId;
     }
     /**

package/dist/core/apcore-registry.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"apcore-registry.service.js","sourceRoot":"","sources":["../../src/core/apcore-registry.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAI3C,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,KAAK,GAAkB,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAkB,CAAC;IAE5E,OAAO,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IACE,IAAI,KAAK,aAAa;gBACtB,OAAQ,KAAiC,CAAC,IAAI,CAAC,KAAK,UAAU,EAC9D,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAkB,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC;AAED;;;;GAIG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACH;IAA7B,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD,uBAAuB;IAEvB,yDAAyD;IACzD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,8BAA8B;IAE9B,QAAQ,CAAC,QAAgB,EAAE,MAAe;QACxC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,OAA8C;QACjD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,EAAE,CACA,KAAa,EACb,QAAqD;QAErD,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,uCAAuC;IAEvC;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,OAA8B;QAC3C,MAAM,EACJ,QAAQ,EACR,MAAM,EACN,WAAW,EACX,EAAE,EACF,WAAW,EACX,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,aAAa,EACb,QAAQ,GACT,GAAG,OAAO,CAAC;QAEZ,6CAA6C;QAC7C,MAAM,EAAE,GAAI,QAAoC,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,WAAW,MAAM,uBAAuB,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;QAC5C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAE/D,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC;YACpC,QAAQ;YACR,WAAW;YACX,WAAW,EAAG,WAAuB,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,YAAY,EAAG,YAAwB,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,IAAI,EAAE,IAAI,IAAI,IAAI;YAClB,WAAW,EAAE,WAA4C;YACzD,aAAa,EAAE,aAAa,IAAI,IAAI;YACpC,QAAQ,EAAE,QAAQ,IAAI,IAAI;YAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,MAAM,GAAG,GAAG,MAAO,EAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC1D,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;OAQG;IACH,eAAe,CAAC,OAA+B;QAC7C,MAAM,EACJ,QAAQ,EACR,WAAW,EACX,OAAO,EACP,OAAO,GAAG,EAAE,EACZ,SAAS,EACT,WAAW,EACX,IAAI,EACJ,aAAa,GAAG,EAAE,GACnB,GAAG,OAAO,CAAC;QAEZ,sCAAsC;QACtC,IAAI,WAAqB,CAAC;QAE1B,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAC9C,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAClC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,aAAa,GAAG,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAEtD,kEAAkE;YAClE,MAAM,EAAE,GACN,SAAS,IAAI,kBAAkB,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC7D,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;YAEzD,MAAM,UAAU,GACd,aAAa,CAAC,WAAW,IAAI,WAAW,IAAI,GAAG,UAAU,EAAE,CAAC;YAE9D,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,IAAI,GAAG,EAAE,IAAI,gBAAgB,EAAE,CAAC;YAEjE,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC;gBAC7B,QAAQ;gBACR,MAAM,EAAE,UAAU;gBAClB,WAAW,EAAE,UAAU;gBACvB,EAAE,EAAE,QAAQ;gBACZ,WAAW,EAAE,aAAa,CAAC,WAAW;gBACtC,YAAY,EAAE,aAAa,CAAC,YAAY;gBACxC,WAAW,EAAE,aAAa,CAAC,WAAW,IAAI,WAAW;gBACrD,IAAI,EAAE,aAAa,CAAC,IAAI,IAAI,IAAI;gBAChC,aAAa,EAAE,aAAa,CAAC,aAAa;gBAC1C,QAAQ,EAAE,aAAa,CAAC,QAAQ;aACjC,CAAC,CAAC;YAEH,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;CACF,CAAA;AAhLY,qBAAqB;IADjC,UAAU,EAAE;;GACA,qBAAqB,CAgLjC"}
+{"version":3,"file":"apcore-registry.service.js","sourceRoot":"","sources":["../../src/core/apcore-registry.service.ts"],"names":[],"mappings":"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"}

package/dist/core/apcore.module.d.ts

@@ -6,6 +6,9 @@ import type { ApcoreModuleOptions, ApcoreModuleAsyncOptions } from '../types.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.
  */
 export declare class ApcoreModule {
     /**
@@ -15,7 +18,7 @@ export declare class ApcoreModule {
      * wraps them in NestJS-injectable services, and exports them together with
      * the raw options token.
      */
-    static forRoot(options: ApcoreModuleOptions): DynamicModule;
+    static forRoot(options?: ApcoreModuleOptions): DynamicModule;
     /**
      * Asynchronous configuration using the `useFactory` / `inject` pattern.
      *

package/dist/core/apcore.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apcore.module.d.ts","sourceRoot":"","sources":["../../src/core/apcore.module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAMpE,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,qBAEa,YAAY;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa;IA6B3D;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa;CA2CtE"}
+{"version":3,"file":"apcore.module.d.ts","sourceRoot":"","sources":["../../src/core/apcore.module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAQpE,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;GASG;AACH,qBAEa,YAAY;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa;IAqChE;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa;CAkDtE"}