nestjs-apcore 0.1.0 → 0.3.1

package/dist/mcp/apcore-mcp.service.js

@@ -11,15 +11,28 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { Injectable, Inject } from '@nestjs/common';
-import { serve, toOpenaiTools } from 'apcore-mcp';
+import { serve, asyncServe, toOpenaiTools } from 'apcore-mcp';
 import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
 import { ApcoreExecutorService } from '../core/apcore-executor.service.js';
 import { APCORE_MCP_MODULE_OPTIONS } from '../constants.js';
+/** Keys shared between serve() and asyncServe() option forwarding. */
+const SHARED_OPTION_KEYS = [
+    'name', 'version', 'tags', 'prefix', 'validateInputs', 'logLevel',
+    'metricsCollector', 'authenticator', 'requireAuth', 'exemptPaths',
+    'approvalHandler', 'outputFormatter',
+];
+/** Keys only used by serve() (transport-specific). */
+const SERVE_ONLY_KEYS = [
+    'transport', 'host', 'port', 'explorer', 'explorerPrefix', 'allowExecute',
+    'dynamic', 'onStartup', 'onShutdown', 'explorerTitle',
+    'explorerProjectName', 'explorerProjectUrl',
+];
 /**
  * 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.
  */
 let ApcoreMcpService = class ApcoreMcpService {
     registry;
@@ -54,46 +67,33 @@ let ApcoreMcpService = class ApcoreMcpService {
     /** Starts the MCP server using the configured transport and options. */
     async start() {
         this._isRunning = true;
-        const serveOptions = {};
-        // Forward all relevant options to serve()
-        if (this.options.transport !== undefined)
-            serveOptions.transport = this.options.transport;
-        if (this.options.host !== undefined)
-            serveOptions.host = this.options.host;
-        if (this.options.port !== undefined)
-            serveOptions.port = this.options.port;
-        if (this.options.name !== undefined)
-            serveOptions.name = this.options.name;
-        if (this.options.version !== undefined)
-            serveOptions.version = this.options.version;
-        if (this.options.tags !== undefined)
-            serveOptions.tags = this.options.tags;
-        if (this.options.prefix !== undefined)
-            serveOptions.prefix = this.options.prefix;
-        if (this.options.explorer !== undefined)
-            serveOptions.explorer = this.options.explorer;
-        if (this.options.explorerPrefix !== undefined)
-            serveOptions.explorerPrefix = this.options.explorerPrefix;
-        if (this.options.allowExecute !== undefined)
-            serveOptions.allowExecute = this.options.allowExecute;
-        if (this.options.dynamic !== undefined)
-            serveOptions.dynamic = this.options.dynamic;
-        if (this.options.validateInputs !== undefined)
-            serveOptions.validateInputs = this.options.validateInputs;
-        if (this.options.logLevel !== undefined)
-            serveOptions.logLevel = this.options.logLevel;
-        if (this.options.onStartup !== undefined)
-            serveOptions.onStartup = this.options.onStartup;
-        if (this.options.onShutdown !== undefined)
-            serveOptions.onShutdown = this.options.onShutdown;
-        if (this.options.metricsCollector !== undefined)
-            serveOptions.metricsCollector = this.options.metricsCollector;
-        if (this.options.authenticator !== undefined)
-            serveOptions.authenticator = this.options.authenticator;
-        if (this.options.exemptPaths !== undefined)
-            serveOptions.exemptPaths = this.options.exemptPaths;
+        const serveOptions = {
+            ...this.collectOptions(SHARED_OPTION_KEYS),
+            ...this.collectOptions(SERVE_ONLY_KEYS),
+        };
         await serve(this.executor.raw, serveOptions);
     }
+    /**
+     * 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.
+     */
+    async asyncServe(options) {
+        const asyncOptions = {
+            ...this.collectOptions(SHARED_OPTION_KEYS),
+        };
+        // Forward per-call options
+        if (options?.endpoint !== undefined)
+            asyncOptions.endpoint = options.endpoint;
+        if (options?.explorer !== undefined)
+            asyncOptions.explorer = options.explorer;
+        if (options?.explorerPrefix !== undefined)
+            asyncOptions.explorerPrefix = options.explorerPrefix;
+        if (options?.allowExecute !== undefined)
+            asyncOptions.allowExecute = options.allowExecute;
+        return asyncServe(this.executor.raw, asyncOptions);
+    }
     /** Stops the MCP server. */
     async stop() {
         this._isRunning = false;
@@ -135,6 +135,23 @@ let ApcoreMcpService = class ApcoreMcpService {
             await this.stop();
         }
     }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Collect defined option values from this.options for the given keys.
+     * Only includes keys whose values are not `undefined`.
+     */
+    collectOptions(keys) {
+        const result = {};
+        for (const key of keys) {
+            const value = this.options[key];
+            if (value !== undefined) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
 };
 ApcoreMcpService = __decorate([
     Injectable(),

package/dist/mcp/apcore-mcp.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"apcore-mcp.service.js","sourceRoot":"","sources":["../../src/mcp/apcore-mcp.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAG5D;;;;;GAKG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAKR;IAEA;IAEA;IARX,UAAU,GAAG,KAAK,CAAC;IAE3B,YAEmB,QAA+B,EAE/B,QAA+B,EAE/B,OAA+B;QAJ/B,aAAQ,GAAR,QAAQ,CAAuB;QAE/B,aAAQ,GAAR,QAAQ,CAAuB;QAE/B,YAAO,GAAP,OAAO,CAAwB;IAC/C,CAAC;IAEJ,0EAA0E;IAC1E,aAAa;IACb,0EAA0E;IAE1E,mDAAmD;IACnD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACxB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS;YACpC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS;SACzC,CAAC,CAAC,MAAM,CAAC;IACZ,CAAC;IAED,0EAA0E;IAC1E,YAAY;IACZ,0EAA0E;IAE1E,wEAAwE;IACxE,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAEvB,MAAM,YAAY,GAA4B,EAAE,CAAC;QAEjD,0CAA0C;QAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,YAAY,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAC1F,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3E,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3E,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3E,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACpF,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3E,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACjF,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvF,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;YAAE,YAAY,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QACzG,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,YAAY,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QACnG,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACpF,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;YAAE,YAAY,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QACzG,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvF,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,YAAY,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAC1F,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,YAAY,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAC7F,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS;YAAE,YAAY,CAAC,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAC/G,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;YAAE,YAAY,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QACtG,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,YAAY,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAEhG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,0EAA0E;IAC1E,kBAAkB;IAClB,0EAA0E;IAE1E;;;;OAIG;IACH,aAAa,CAAC,OAKb;QACC,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,0EAA0E;IAC1E,yBAAyB;IACzB,0EAA0E;IAE1E;;;;;;OAMG;IACH,KAAK,CAAC,sBAAsB;QAC1B,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,eAAe;QACnB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;CACF,CAAA;AArHY,gBAAgB;IAD5B,UAAU,EAAE;IAKR,WAAA,MAAM,CAAC,qBAAqB,CAAC,CAAA;IAE7B,WAAA,MAAM,CAAC,qBAAqB,CAAC,CAAA;IAE7B,WAAA,MAAM,CAAC,yBAAyB,CAAC,CAAA;qCAHP,qBAAqB;QAErB,qBAAqB;GAPvC,gBAAgB,CAqH5B"}
+{"version":3,"file":"apcore-mcp.service.js","sourceRoot":"","sources":["../../src/mcp/apcore-mcp.service.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type { ModuleAnnotations, ModuleExample, Module, Context, Identity, ModuleDescriptor, } from 'apcore-js';
+export type { ModuleAnnotations, ModuleExample, Module, Context, Identity, ModuleDescriptor, PreflightResult, PreflightCheckResult, ValidationResult, } from 'apcore-js';
 /** Annotations describing tool behavior characteristics. */
 export interface ApToolAnnotations {
     readonly?: boolean;
@@ -7,6 +7,11 @@ export interface ApToolAnnotations {
     requiresApproval?: boolean;
     openWorld?: boolean;
     streaming?: boolean;
+    cacheable?: boolean;
+    cacheTtl?: number;
+    cacheKeyFields?: string[] | null;
+    paginated?: boolean;
+    paginationStyle?: 'cursor' | 'offset' | 'page';
 }
 /** Example entry for a tool invocation. */
 export interface ApToolExample {
@@ -39,6 +44,8 @@ export interface ApcoreModuleOptions {
     acl?: unknown | null;
     middleware?: unknown[];
     bindings?: string | null;
+    /** Optional configuration for the MCP server. If provided, ApcoreMcpModule will be automatically imported. */
+    mcp?: ApcoreMcpModuleOptions;
     schema?: {
         adapters?: string[];
         strictOutput?: boolean;
@@ -49,6 +56,14 @@ export interface ApcoreModuleAsyncOptions {
     imports?: unknown[];
     useFactory: (...args: unknown[]) => Promise<ApcoreModuleOptions> | ApcoreModuleOptions;
     inject?: unknown[];
+    /**
+     * Static MCP configuration — evaluated at module-definition time.
+     *
+     * Because `useFactory` resolves asynchronously, dynamic-module imports
+     * (like ApcoreMcpModule) must be decided statically. Provide MCP config
+     * here rather than returning it from the factory.
+     */
+    mcp?: ApcoreMcpModuleOptions;
 }
 /** Options for ApcoreMcpModule.forRoot(). */
 export interface ApcoreMcpModuleOptions {
@@ -62,16 +77,20 @@ export interface ApcoreMcpModuleOptions {
     explorer?: boolean;
     explorerPrefix?: string;
     allowExecute?: boolean;
+    explorerTitle?: string;
+    explorerProjectName?: string;
+    explorerProjectUrl?: string;
     dynamic?: boolean;
     validateInputs?: boolean;
     logLevel?: 'DEBUG' | 'INFO' | 'WARNING' | 'ERROR' | 'CRITICAL';
     onStartup?: () => void | Promise<void>;
     onShutdown?: () => void | Promise<void>;
-    metricsCollector?: {
-        exportPrometheus(): string;
-    };
+    metricsCollector?: import('apcore-mcp').MetricsExporter;
     authenticator?: import('apcore-mcp').Authenticator;
+    requireAuth?: boolean;
     exemptPaths?: string[];
+    approvalHandler?: unknown;
+    outputFormatter?: (result: Record<string, unknown>) => string;
 }
 /** Async options for ApcoreMcpModule.forRootAsync(). */
 export interface ApcoreMcpModuleAsyncOptions {

package/dist/types.d.ts.map

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

package/dist/utils/module-factory.d.ts

@@ -0,0 +1,29 @@
+import { FunctionModule } from 'apcore-js';
+import type { ModuleAnnotations } from 'apcore-js';
+import type { ScannedModule } from 'apcore-toolkit';
+import type { ApToolAnnotations } from '../types.js';
+/**
+ * Execute function signature for NestJS-bound modules.
+ *
+ * Unlike apcore-toolkit's RegistryWriter (which resolves targets via dynamic
+ * import), NestJS modules are already instantiated — we receive a pre-bound
+ * execute function directly.
+ */
+export type BoundExecuteFn = (inputs: Record<string, unknown>, context: unknown) => Promise<Record<string, unknown>> | Record<string, unknown>;
+/**
+ * Convert partial `ApToolAnnotations` (all-optional booleans) to a full
+ * `ModuleAnnotations` (required booleans) by spreading over
+ * `DEFAULT_ANNOTATIONS` from apcore-js.
+ *
+ * Returns `null` when the input is nullish.
+ */
+export declare function toModuleAnnotations(partial: ApToolAnnotations | null | undefined): ModuleAnnotations | null;
+/**
+ * Convert a toolkit ScannedModule + pre-bound execute function into an
+ * apcore-js FunctionModule ready for registry registration.
+ *
+ * This is the NestJS counterpart to apcore-toolkit's RegistryWriter._toFunctionModule(),
+ * adapted for live service instances rather than dynamic imports.
+ */
+export declare function scannedModuleToFunctionModule(mod: ScannedModule, execute: BoundExecuteFn): FunctionModule;
+//# sourceMappingURL=module-factory.d.ts.map

package/dist/utils/module-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-factory.d.ts","sourceRoot":"","sources":["../../src/utils/module-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA4C,MAAM,WAAW,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,WAAW,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAC5C,iBAAiB,GAAG,IAAI,CAG1B;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,cAAc,GACtB,cAAc,CAuBhB"}

package/dist/utils/module-factory.js

@@ -0,0 +1,45 @@
+import { FunctionModule, DEFAULT_ANNOTATIONS, jsonSchemaToTypeBox } from 'apcore-js';
+import { annotationsToDict } from 'apcore-toolkit';
+/**
+ * Convert partial `ApToolAnnotations` (all-optional booleans) to a full
+ * `ModuleAnnotations` (required booleans) by spreading over
+ * `DEFAULT_ANNOTATIONS` from apcore-js.
+ *
+ * Returns `null` when the input is nullish.
+ */
+export function toModuleAnnotations(partial) {
+    if (partial == null)
+        return null;
+    return { ...DEFAULT_ANNOTATIONS, ...partial };
+}
+/**
+ * Convert a toolkit ScannedModule + pre-bound execute function into an
+ * apcore-js FunctionModule ready for registry registration.
+ *
+ * This is the NestJS counterpart to apcore-toolkit's RegistryWriter._toFunctionModule(),
+ * adapted for live service instances rather than dynamic imports.
+ */
+export function scannedModuleToFunctionModule(mod, execute) {
+    // Filter out internal keys (e.g. _execute) from metadata before
+    // forwarding to FunctionModule so they don't leak into the public API.
+    const cleanMetadata = {};
+    for (const [k, v] of Object.entries(mod.metadata)) {
+        if (!k.startsWith('_')) {
+            cleanMetadata[k] = v;
+        }
+    }
+    return new FunctionModule({
+        execute,
+        moduleId: mod.moduleId,
+        inputSchema: jsonSchemaToTypeBox(mod.inputSchema),
+        outputSchema: jsonSchemaToTypeBox(mod.outputSchema),
+        description: mod.description,
+        documentation: mod.documentation,
+        tags: mod.tags.length > 0 ? [...mod.tags] : null,
+        version: mod.version,
+        annotations: annotationsToDict(mod.annotations),
+        metadata: Object.keys(cleanMetadata).length > 0 ? cleanMetadata : null,
+        examples: mod.examples.length > 0 ? [...mod.examples] : null,
+    });
+}
+//# sourceMappingURL=module-factory.js.map

package/dist/utils/module-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-factory.js","sourceRoot":"","sources":["../../src/utils/module-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAgBnD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA6C;IAE7C,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,EAAE,GAAG,mBAAmB,EAAE,GAAG,OAAO,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,GAAkB,EAClB,OAAuB;IAEvB,gEAAgE;IAChE,uEAAuE;IACvE,MAAM,aAAa,GAA4B,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,cAAc,CAAC;QACxB,OAAO;QACP,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,WAAW,EAAE,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC;QACjD,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC;QACnD,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QAChD,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAA6B;QAC3E,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI;QACtE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAqB,CAAC,CAAC,CAAC,IAAI;KAClF,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestjs-apcore",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "NestJS adapter for the apcore AI-Perceivable module ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,6 +32,7 @@
   "peerDependencies": {
     "@nestjs/common": ">=10.0.0",
     "@nestjs/core": ">=10.0.0",
+    "apcore-mcp": "^0.10.0",
     "reflect-metadata": ">=0.1.13",
     "rxjs": ">=7.0.0"
   },
@@ -44,12 +45,15 @@
     },
     "zod": {
       "optional": true
+    },
+    "apcore-mcp": {
+      "optional": true
     }
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "apcore-js": "^0.6.0",
-    "apcore-mcp": "^0.7.0",
+    "apcore-js": "^0.13.0",
+    "apcore-toolkit": "^0.2.0",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
@@ -61,6 +65,7 @@
     "@types/js-yaml": "^4.0.0",
     "@types/node": "^20.0.0",
     "@vitest/coverage-v8": "^3.0.0",
+    "apcore-mcp": "^0.10.0",
     "apdev-js": "^0.2.0",
     "class-transformer": "^0.5.0",
     "class-validator": "^0.14.0",