nestjs-apcore 0.1.0

package/dist/decorators/ap-tool.decorator.js

@@ -0,0 +1,7 @@
+import { AP_TOOL_METADATA_KEY } from '../constants.js';
+export function ApTool(options) {
+    return (target, propertyKey, _descriptor) => {
+        Reflect.defineMetadata(AP_TOOL_METADATA_KEY, options, target, propertyKey);
+    };
+}
+//# sourceMappingURL=ap-tool.decorator.js.map

package/dist/decorators/ap-tool.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ap-tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/ap-tool.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,MAAM,UAAU,MAAM,CAAC,OAAsB;IAC3C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE;QAC1C,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,4 @@
+export { ApTool } from './ap-tool.decorator.js';
+export { ApModule } from './ap-module.decorator.js';
+export { ApContext } from './ap-context.decorator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/decorators/index.js

@@ -0,0 +1,4 @@
+export { ApTool } from './ap-tool.decorator.js';
+export { ApModule } from './ap-module.decorator.js';
+export { ApContext } from './ap-context.decorator.js';
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export { ApcoreModule } from './core/apcore.module.js';
+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 { JWTAuthenticator, getCurrentIdentity, identityStorage } from 'apcore-mcp';
+export type { Authenticator, ClaimMapping, JWTAuthenticatorOptions } from 'apcore-mcp';
+export { ApTool, ApModule, ApContext } from './decorators/index.js';
+export { ApToolScannerService } 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';
+export { ZodAdapter } from './schema/adapters/zod.adapter.js';
+export { DtoAdapter } from './schema/adapters/dto.adapter.js';
+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 { 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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,41 @@
+// ---------------------------------------------------------------------------
+// Core
+// ---------------------------------------------------------------------------
+export { ApcoreModule } from './core/apcore.module.js';
+export { ApcoreRegistryService } from './core/apcore-registry.service.js';
+export { ApcoreExecutorService } from './core/apcore-executor.service.js';
+// ---------------------------------------------------------------------------
+// MCP
+// ---------------------------------------------------------------------------
+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';
+// Re-export apcore-mcp auth utilities
+export { JWTAuthenticator, getCurrentIdentity, identityStorage } from 'apcore-mcp';
+// ---------------------------------------------------------------------------
+// Decorators
+// ---------------------------------------------------------------------------
+export { ApTool, ApModule, ApContext } from './decorators/index.js';
+export { ApToolScannerService } from './decorators/ap-tool-scanner.service.js';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+export { SchemaExtractor, SchemaExtractionError } from './schema/schema-extractor.service.js';
+export { TypeBoxAdapter } from './schema/adapters/typebox.adapter.js';
+export { ZodAdapter } from './schema/adapters/zod.adapter.js';
+export { DtoAdapter } from './schema/adapters/dto.adapter.js';
+export { JsonSchemaAdapter } from './schema/adapters/json-schema.adapter.js';
+// ---------------------------------------------------------------------------
+// Bridge
+// ---------------------------------------------------------------------------
+export { ApBindingLoader } from './bridge/index.js';
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+export { normalizeClassName, normalizeMethodName, generateModuleId, } from './utils/id-generator.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export { APCORE_MODULE_OPTIONS, APCORE_MCP_MODULE_OPTIONS, AP_TOOL_METADATA_KEY, AP_MODULE_METADATA_KEY, AP_CONTEXT_METADATA_KEY, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

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

@@ -0,0 +1,28 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { ApcoreMcpModuleOptions, ApcoreMcpModuleAsyncOptions } from '../types.js';
+/**
+ * NestJS dynamic module for the MCP (Model Context Protocol) server.
+ *
+ * Provides {@link ApcoreMcpService} and the {@link APCORE_MCP_MODULE_OPTIONS}
+ * token. Requires that {@link ApcoreRegistryService} and
+ * {@link ApcoreExecutorService} are available in the injection context
+ * (typically via importing `ApcoreModule`).
+ */
+export declare class ApcoreMcpModule {
+    /**
+     * Synchronous configuration.
+     *
+     * Creates the {@link ApcoreMcpService} via a factory that injects
+     * {@link ApcoreRegistryService} and {@link ApcoreExecutorService}
+     * from the parent context.
+     */
+    static forRoot(options: ApcoreMcpModuleOptions): DynamicModule;
+    /**
+     * Asynchronous configuration using the `useFactory` / `inject` pattern.
+     *
+     * Supports an `imports` array so that injected dependencies (e.g. a
+     * ConfigService) are available to the factory function.
+     */
+    static forRootAsync(options: ApcoreMcpModuleAsyncOptions): DynamicModule;
+}
+//# sourceMappingURL=apcore-mcp.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-mcp.module.d.ts","sourceRoot":"","sources":["../../src/mcp/apcore-mcp.module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAKpE,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,qBACa,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa;IAkB9D;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,2BAA2B,GAAG,aAAa;CA2BzE"}

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

@@ -0,0 +1,77 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var ApcoreMcpModule_1;
+import { Module } from '@nestjs/common';
+import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
+import { ApcoreExecutorService } from '../core/apcore-executor.service.js';
+import { ApcoreMcpService } from './apcore-mcp.service.js';
+import { APCORE_MCP_MODULE_OPTIONS } from '../constants.js';
+/**
+ * NestJS dynamic module for the MCP (Model Context Protocol) server.
+ *
+ * Provides {@link ApcoreMcpService} and the {@link APCORE_MCP_MODULE_OPTIONS}
+ * token. Requires that {@link ApcoreRegistryService} and
+ * {@link ApcoreExecutorService} are available in the injection context
+ * (typically via importing `ApcoreModule`).
+ */
+let ApcoreMcpModule = ApcoreMcpModule_1 = class ApcoreMcpModule {
+    /**
+     * Synchronous configuration.
+     *
+     * Creates the {@link ApcoreMcpService} via a factory that injects
+     * {@link ApcoreRegistryService} and {@link ApcoreExecutorService}
+     * from the parent context.
+     */
+    static forRoot(options) {
+        return {
+            module: ApcoreMcpModule_1,
+            providers: [
+                { provide: APCORE_MCP_MODULE_OPTIONS, useValue: options },
+                {
+                    provide: ApcoreMcpService,
+                    useFactory: (registry, executor) => new ApcoreMcpService(registry, executor, options),
+                    inject: [ApcoreRegistryService, ApcoreExecutorService],
+                },
+            ],
+            exports: [ApcoreMcpService, APCORE_MCP_MODULE_OPTIONS],
+        };
+    }
+    /**
+     * Asynchronous configuration using the `useFactory` / `inject` pattern.
+     *
+     * Supports an `imports` array so that injected dependencies (e.g. a
+     * ConfigService) are available to the factory function.
+     */
+    static forRootAsync(options) {
+        return {
+            module: ApcoreMcpModule_1,
+            imports: (options.imports ?? []),
+            providers: [
+                {
+                    provide: APCORE_MCP_MODULE_OPTIONS,
+                    useFactory: options.useFactory,
+                    inject: (options.inject ?? []),
+                },
+                {
+                    provide: ApcoreMcpService,
+                    useFactory: (opts, registry, executor) => new ApcoreMcpService(registry, executor, opts),
+                    inject: [
+                        APCORE_MCP_MODULE_OPTIONS,
+                        ApcoreRegistryService,
+                        ApcoreExecutorService,
+                    ],
+                },
+            ],
+            exports: [ApcoreMcpService, APCORE_MCP_MODULE_OPTIONS],
+        };
+    }
+};
+ApcoreMcpModule = ApcoreMcpModule_1 = __decorate([
+    Module({})
+], ApcoreMcpModule);
+export { ApcoreMcpModule };
+//# sourceMappingURL=apcore-mcp.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-mcp.module.js","sourceRoot":"","sources":["../../src/mcp/apcore-mcp.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAM5D;;;;;;;GAOG;AAEI,IAAM,eAAe,uBAArB,MAAM,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAA+B;QAC5C,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBACzD;oBACE,OAAO,EAAE,gBAAgB;oBACzB,UAAU,EAAE,CACV,QAA+B,EAC/B,QAA+B,EAC/B,EAAE,CAAC,IAAI,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC;oBACtD,MAAM,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;SACvD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAoC;QACtD,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAoB;YACnD,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,yBAAyB;oBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAqB;iBACnD;gBACD;oBACE,OAAO,EAAE,gBAAgB;oBACzB,UAAU,EAAE,CACV,IAA4B,EAC5B,QAA+B,EAC/B,QAA+B,EAC/B,EAAE,CAAC,IAAI,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC;oBACnD,MAAM,EAAE;wBACN,yBAAyB;wBACzB,qBAAqB;wBACrB,qBAAqB;qBACtB;iBACF;aACF;YACD,OAAO,EAAE,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;SACvD,CAAC;IACJ,CAAC;CACF,CAAA;AA3DY,eAAe;IAD3B,MAAM,CAAC,EAAE,CAAC;GACE,eAAe,CA2D3B"}

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

@@ -0,0 +1,53 @@
+import type { OnApplicationBootstrap, OnModuleDestroy } from '@nestjs/common';
+import type { OpenAIToolDef } 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.
+ */
+export declare class ApcoreMcpService implements OnApplicationBootstrap, OnModuleDestroy {
+    private readonly registry;
+    private readonly executor;
+    private readonly options;
+    private _isRunning;
+    constructor(registry: ApcoreRegistryService, executor: ApcoreExecutorService, options: ApcoreMcpModuleOptions);
+    /** Whether the MCP server is currently running. */
+    get isRunning(): boolean;
+    /**
+     * Number of tools available in the registry, filtered by the module-level
+     * `tags` and `prefix` options when provided.
+     */
+    get toolCount(): number;
+    /** Starts the MCP server using the configured transport and options. */
+    start(): Promise<void>;
+    /** Stops the MCP server. */
+    stop(): Promise<void>;
+    /** Restarts the MCP server (stop, then start). */
+    restart(): Promise<void>;
+    /**
+     * Convert the registered tools to OpenAI-compatible tool definitions.
+     *
+     * Delegates to `toOpenaiTools()` from `apcore-mcp`.
+     */
+    toOpenaiTools(options?: {
+        embedAnnotations?: boolean;
+        strict?: boolean;
+        tags?: string[];
+        prefix?: string;
+    }): OpenAIToolDef[];
+    /**
+     * Auto-starts the MCP server when a transport is configured.
+     *
+     * Uses `OnApplicationBootstrap` (not `OnModuleInit`) so that all
+     * tools registered via decorators, programmatic calls, or YAML
+     * bindings during `onModuleInit` are available before the server starts.
+     */
+    onApplicationBootstrap(): Promise<void>;
+    /** Auto-stops the MCP server on module destruction. */
+    onModuleDestroy(): Promise<void>;
+}
+//# sourceMappingURL=apcore-mcp.service.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,148 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+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 { ApcoreRegistryService } from '../core/apcore-registry.service.js';
+import { ApcoreExecutorService } from '../core/apcore-executor.service.js';
+import { APCORE_MCP_MODULE_OPTIONS } from '../constants.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.
+ */
+let ApcoreMcpService = class ApcoreMcpService {
+    registry;
+    executor;
+    options;
+    _isRunning = false;
+    constructor(registry, executor, options) {
+        this.registry = registry;
+        this.executor = executor;
+        this.options = options;
+    }
+    // -----------------------------------------------------------------------
+    // Properties
+    // -----------------------------------------------------------------------
+    /** Whether the MCP server is currently running. */
+    get isRunning() {
+        return this._isRunning;
+    }
+    /**
+     * Number of tools available in the registry, filtered by the module-level
+     * `tags` and `prefix` options when provided.
+     */
+    get toolCount() {
+        return this.registry.list({
+            tags: this.options.tags ?? undefined,
+            prefix: this.options.prefix ?? undefined,
+        }).length;
+    }
+    // -----------------------------------------------------------------------
+    // Lifecycle
+    // -----------------------------------------------------------------------
+    /** 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;
+        await serve(this.executor.raw, serveOptions);
+    }
+    /** Stops the MCP server. */
+    async stop() {
+        this._isRunning = false;
+    }
+    /** Restarts the MCP server (stop, then start). */
+    async restart() {
+        await this.stop();
+        await this.start();
+    }
+    // -----------------------------------------------------------------------
+    // Tool conversion
+    // -----------------------------------------------------------------------
+    /**
+     * Convert the registered tools to OpenAI-compatible tool definitions.
+     *
+     * Delegates to `toOpenaiTools()` from `apcore-mcp`.
+     */
+    toOpenaiTools(options) {
+        return toOpenaiTools(this.executor.raw, options);
+    }
+    // -----------------------------------------------------------------------
+    // NestJS lifecycle hooks
+    // -----------------------------------------------------------------------
+    /**
+     * Auto-starts the MCP server when a transport is configured.
+     *
+     * Uses `OnApplicationBootstrap` (not `OnModuleInit`) so that all
+     * tools registered via decorators, programmatic calls, or YAML
+     * bindings during `onModuleInit` are available before the server starts.
+     */
+    async onApplicationBootstrap() {
+        if (this.options.transport) {
+            await this.start();
+        }
+    }
+    /** Auto-stops the MCP server on module destruction. */
+    async onModuleDestroy() {
+        if (this._isRunning) {
+            await this.stop();
+        }
+    }
+};
+ApcoreMcpService = __decorate([
+    Injectable(),
+    __param(0, Inject(ApcoreRegistryService)),
+    __param(1, Inject(ApcoreExecutorService)),
+    __param(2, Inject(APCORE_MCP_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [ApcoreRegistryService,
+        ApcoreExecutorService, Object])
+], ApcoreMcpService);
+export { ApcoreMcpService };
+//# sourceMappingURL=apcore-mcp.service.js.map

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

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

package/dist/schema/adapters/dto.adapter.d.ts

@@ -0,0 +1,44 @@
+import type { TSchema } from '@sinclair/typebox';
+import type { SchemaAdapter } from './schema-adapter.interface.js';
+/**
+ * SchemaAdapter that converts class-validator decorated DTO classes into
+ * JSON Schema / TSchema objects.
+ *
+ * Detection relies on querying class-validator's global MetadataStorage for
+ * validation metadata associated with the target constructor.
+ */
+export declare class DtoAdapter implements SchemaAdapter {
+    readonly name: "dto";
+    readonly priority = 20;
+    /**
+     * Returns `true` when `input` is a class constructor that has at least one
+     * class-validator decorator registered in the global MetadataStorage.
+     */
+    detect(input: unknown): boolean;
+    /**
+     * Converts a class-validator DTO into a TSchema-compatible JSON Schema
+     * object (type: 'object' with properties and required).
+     */
+    extract(input: unknown): TSchema;
+    /**
+     * Reads class-validator metadata from the global MetadataStorage and builds
+     * a JSON Schema object.
+     *
+     * Mapping rules:
+     * - isString          -> type: 'string'
+     * - isNumber          -> type: 'number'
+     * - isInt             -> type: 'integer'
+     * - isBoolean         -> type: 'boolean'
+     * - isEmail           -> type: 'string', format: 'email'
+     * - isUrl / isURL     -> type: 'string', format: 'uri'
+     * - isEnum            -> type: 'string', enum: Object.values(constraints[0])
+     * - isOptional        -> not included in required[]
+     * - minLength         -> minLength constraint
+     * - maxLength         -> maxLength constraint
+     * - min               -> minimum
+     * - max               -> maximum
+     * - isArray           -> type: 'array'
+     */
+    extractJsonSchema(input: unknown): Record<string, unknown>;
+}
+//# sourceMappingURL=dto.adapter.d.ts.map

package/dist/schema/adapters/dto.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto.adapter.d.ts","sourceRoot":"","sources":["../../../src/schema/adapters/dto.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAwDnE;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,QAAQ,CAAC,QAAQ,MAAM;IAEvB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAmB/B;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIhC;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAiI3D"}