nestjs-apcore 0.3.2 → 0.5.0

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

@@ -0,0 +1,55 @@
+import { createCli, configureManHelp } from 'apcore-cli';
+import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
+import type { ApcoreCliModuleOptions } from '../types.js';
+/**
+ * NestJS-injectable service that exposes apcore-cli utilities.
+ *
+ * Wraps `createCli`, `buildProgramManPage`, and `configureManHelp` from
+ * `apcore-cli`, applying module-level defaults (docsUrl, verboseHelp) on
+ * construction so that injected consumers get a pre-configured CLI builder.
+ *
+ * @example
+ * ```ts
+ * const program = cliService.createProgram();
+ * cliService.configureManHelp(program, 'my-tool', '1.0.0', 'My Tool');
+ * program.parse();
+ * ```
+ */
+export declare class ApcoreCliService {
+    private readonly registry;
+    private readonly options;
+    constructor(registry: ApcoreRegistryService, options: ApcoreCliModuleOptions);
+    /**
+     * Build and return a Commander program.
+     *
+     * Built-in apcore options (`--input`, `--yes`, `--large-input`, `--format`)
+     * are hidden by default; pass `--help --verbose` at runtime (or set
+     * `verboseHelp: true` in module options) to show them.
+     *
+     * @param extensionsDir  Override the extensions directory (default: value from options).
+     */
+    createProgram(extensionsDir?: string): ReturnType<typeof createCli>;
+    /**
+     * Add `--help --man` support to an existing Commander program.
+     *
+     * When the user runs `<prog> --help --man`, the full man page is written to
+     * stdout. Enabled by `apcore-cli` 0.4.0's `configureManHelp()`.
+     */
+    configureManHelp(program: Parameters<typeof configureManHelp>[0], progName: string, version: string, description?: string, docsUrl?: string): void;
+    /**
+     * Update the docs URL used by man pages and per-command help output.
+     *
+     * Delegates to `apcore-cli`'s module-level `setDocsUrl()`.
+     */
+    setDocsUrl(url: string | null): void;
+    /**
+     * Toggle verbose help mode.
+     *
+     * When `true`, `--help` shows all options including built-in apcore options.
+     * Delegates to `apcore-cli`'s module-level `setVerboseHelp()`.
+     */
+    setVerboseHelp(verbose: boolean): void;
+    /** Number of modules currently in the registry. */
+    get moduleCount(): number;
+}
+//# sourceMappingURL=apcore-cli.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-cli.service.d.ts","sourceRoot":"","sources":["../../src/cli/apcore-cli.service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EAGT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,qBACa,gBAAgB;IAGzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,QAAQ,EAAE,qBAAqB,EAE/B,OAAO,EAAE,sBAAsB;IAclD;;;;;;;;OAQG;IACH,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC;IAYnE;;;;;OAKG;IACH,gBAAgB,CACd,OAAO,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAC/C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAcP;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIpC;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQtC,mDAAmD;IACnD,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}

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

@@ -0,0 +1,106 @@
+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 { createCli, setDocsUrl, setVerboseHelp, configureManHelp, } from 'apcore-cli';
+import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
+import { APCORE_CLI_MODULE_OPTIONS } from '../constants.js';
+/**
+ * NestJS-injectable service that exposes apcore-cli utilities.
+ *
+ * Wraps `createCli`, `buildProgramManPage`, and `configureManHelp` from
+ * `apcore-cli`, applying module-level defaults (docsUrl, verboseHelp) on
+ * construction so that injected consumers get a pre-configured CLI builder.
+ *
+ * @example
+ * ```ts
+ * const program = cliService.createProgram();
+ * cliService.configureManHelp(program, 'my-tool', '1.0.0', 'My Tool');
+ * program.parse();
+ * ```
+ */
+let ApcoreCliService = class ApcoreCliService {
+    registry;
+    options;
+    constructor(registry, options) {
+        this.registry = registry;
+        this.options = options;
+        if (options.docsUrl !== undefined) {
+            setDocsUrl(options.docsUrl);
+        }
+        if (options.verboseHelp !== undefined) {
+            setVerboseHelp(options.verboseHelp);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Program builder
+    // -------------------------------------------------------------------------
+    /**
+     * Build and return a Commander program.
+     *
+     * Built-in apcore options (`--input`, `--yes`, `--large-input`, `--format`)
+     * are hidden by default; pass `--help --verbose` at runtime (or set
+     * `verboseHelp: true` in module options) to show them.
+     *
+     * @param extensionsDir  Override the extensions directory (default: value from options).
+     */
+    createProgram(extensionsDir) {
+        return createCli(extensionsDir ?? this.options.extensionsDir, this.options.progName, this.options.verboseHelp ?? false);
+    }
+    // -------------------------------------------------------------------------
+    // Man page / help
+    // -------------------------------------------------------------------------
+    /**
+     * Add `--help --man` support to an existing Commander program.
+     *
+     * When the user runs `<prog> --help --man`, the full man page is written to
+     * stdout. Enabled by `apcore-cli` 0.4.0's `configureManHelp()`.
+     */
+    configureManHelp(program, progName, version, description, docsUrl) {
+        configureManHelp(program, progName, version, description, docsUrl ?? this.options.docsUrl ?? undefined);
+    }
+    // -------------------------------------------------------------------------
+    // Runtime configuration
+    // -------------------------------------------------------------------------
+    /**
+     * Update the docs URL used by man pages and per-command help output.
+     *
+     * Delegates to `apcore-cli`'s module-level `setDocsUrl()`.
+     */
+    setDocsUrl(url) {
+        setDocsUrl(url);
+    }
+    /**
+     * Toggle verbose help mode.
+     *
+     * When `true`, `--help` shows all options including built-in apcore options.
+     * Delegates to `apcore-cli`'s module-level `setVerboseHelp()`.
+     */
+    setVerboseHelp(verbose) {
+        setVerboseHelp(verbose);
+    }
+    // -------------------------------------------------------------------------
+    // Registry accessors
+    // -------------------------------------------------------------------------
+    /** Number of modules currently in the registry. */
+    get moduleCount() {
+        return this.registry.count;
+    }
+};
+ApcoreCliService = __decorate([
+    Injectable(),
+    __param(0, Inject(ApcoreRegistryService)),
+    __param(1, Inject(APCORE_CLI_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [ApcoreRegistryService, Object])
+], ApcoreCliService);
+export { ApcoreCliService };
+//# sourceMappingURL=apcore-cli.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-cli.service.js","sourceRoot":"","sources":["../../src/cli/apcore-cli.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EACL,SAAS,EACT,UAAU,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAG5D;;;;;;;;;;;;;GAaG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAGR;IAEA;IAJnB,YAEmB,QAA+B,EAE/B,OAA+B;QAF/B,aAAQ,GAAR,QAAQ,CAAuB;QAE/B,YAAO,GAAP,OAAO,CAAwB;QAEhD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACtC,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;;;;;;;OAQG;IACH,aAAa,CAAC,aAAsB;QAClC,OAAO,SAAS,CACd,aAAa,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,EAC3C,IAAI,CAAC,OAAO,CAAC,QAAQ,EACrB,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,KAAK,CAClC,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;;;;OAKG;IACH,gBAAgB,CACd,OAA+C,EAC/C,QAAgB,EAChB,OAAe,EACf,WAAoB,EACpB,OAAgB;QAEhB,gBAAgB,CACd,OAAO,EACP,QAAQ,EACR,OAAO,EACP,WAAW,EACX,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS,CAC7C,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,wBAAwB;IACxB,4EAA4E;IAE5E;;;;OAIG;IACH,UAAU,CAAC,GAAkB;QAC3B,UAAU,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,OAAgB;QAC7B,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAC5E,qBAAqB;IACrB,4EAA4E;IAE5E,mDAAmD;IACnD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;CACF,CAAA;AA7FY,gBAAgB;IAD5B,UAAU,EAAE;IAGR,WAAA,MAAM,CAAC,qBAAqB,CAAC,CAAA;IAE7B,WAAA,MAAM,CAAC,yBAAyB,CAAC,CAAA;qCADP,qBAAqB;GAHvC,gBAAgB,CA6F5B"}

package/dist/constants.d.ts

@@ -1,5 +1,7 @@
 export declare const APCORE_MODULE_OPTIONS: "APCORE_MODULE_OPTIONS";
 export declare const APCORE_MCP_MODULE_OPTIONS: "APCORE_MCP_MODULE_OPTIONS";
+export declare const APCORE_CLI_MODULE_OPTIONS: "APCORE_CLI_MODULE_OPTIONS";
+export declare const APCORE_A2A_MODULE_OPTIONS: "APCORE_A2A_MODULE_OPTIONS";
 export declare const AP_TOOL_METADATA_KEY: "apcore:tool";
 export declare const AP_MODULE_METADATA_KEY: "apcore:module";
 export declare const AP_CONTEXT_METADATA_KEY: "apcore:context";

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,yBAAyB,EAAG,2BAAoC,CAAC;AAG9E,eAAO,MAAM,oBAAoB,EAAG,aAAsB,CAAC;AAC3D,eAAO,MAAM,sBAAsB,EAAG,eAAwB,CAAC;AAC/D,eAAO,MAAM,uBAAuB,EAAG,gBAAyB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AACtE,eAAO,MAAM,yBAAyB,EAAG,2BAAoC,CAAC;AAC9E,eAAO,MAAM,yBAAyB,EAAG,2BAAoC,CAAC;AAC9E,eAAO,MAAM,yBAAyB,EAAG,2BAAoC,CAAC;AAG9E,eAAO,MAAM,oBAAoB,EAAG,aAAsB,CAAC;AAC3D,eAAO,MAAM,sBAAsB,EAAG,eAAwB,CAAC;AAC/D,eAAO,MAAM,uBAAuB,EAAG,gBAAyB,CAAC"}

package/dist/constants.js

@@ -1,6 +1,8 @@
 // NestJS dependency-injection tokens
 export const APCORE_MODULE_OPTIONS = 'APCORE_MODULE_OPTIONS';
 export const APCORE_MCP_MODULE_OPTIONS = 'APCORE_MCP_MODULE_OPTIONS';
+export const APCORE_CLI_MODULE_OPTIONS = 'APCORE_CLI_MODULE_OPTIONS';
+export const APCORE_A2A_MODULE_OPTIONS = 'APCORE_A2A_MODULE_OPTIONS';
 // Reflect metadata keys used by decorators
 export const AP_TOOL_METADATA_KEY = 'apcore:tool';
 export const AP_MODULE_METADATA_KEY = 'apcore:module';

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAAoC,CAAC;AAE9E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAsB,CAAC;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAwB,CAAC;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAyB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAAoC,CAAC;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAAoC,CAAC;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAAoC,CAAC;AAE9E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAsB,CAAC;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAwB,CAAC;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAyB,CAAC"}

package/dist/context/nest-context.factory.d.ts

@@ -0,0 +1,36 @@
+import { Context } from 'apcore-js';
+/** Minimal request shape required by NestContextFactory (Express and Fastify compatible). */
+export interface NestRequest {
+    headers: Record<string, string | string[] | undefined>;
+}
+/**
+ * Creates apcore Context objects from NestJS HTTP requests.
+ *
+ * Identity extraction priority:
+ *   1. `x-user-id` header
+ *   2. `Authorization: Bearer <token>` header (identity id = "bearer")
+ *   3. Falls back to anonymous identity
+ *
+ * W3C Trace Context propagation:
+ *   When a `traceparent` header is present, its trace_id is used via
+ *   Context.create — strict 32-hex validation and W3C-invalid rejection
+ *   are enforced by the SDK, not this factory. See PROTOCOL_SPEC §10.5.
+ *
+ * Correlation ID:
+ *   If `x-correlation-id` or `x-request-id` is present, the value is
+ *   stored in context.data["x-correlation-id"] alongside traceId so
+ *   existing log pipelines remain correlatable.
+ */
+export declare class NestContextFactory {
+    /**
+     * Create an apcore Context from a NestJS HTTP request.
+     *
+     * @param req - Request object (from @Req() decorator or an interceptor).
+     *              Compatible with Express and Fastify request shapes.
+     */
+    createContext(req: NestRequest): Context;
+    private _extractTraceParent;
+    private _extractIdentity;
+    private _extractData;
+}
+//# sourceMappingURL=nest-context.factory.d.ts.map

package/dist/context/nest-context.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-context.factory.d.ts","sourceRoot":"","sources":["../../src/context/nest-context.factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAgC,MAAM,WAAW,CAAC;AAGlE,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,kBAAkB;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO;IAOxC,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,YAAY;CASrB"}

package/dist/context/nest-context.factory.js

@@ -0,0 +1,82 @@
+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;
+};
+import { Injectable } from '@nestjs/common';
+import { Context, TraceContext, createIdentity } from 'apcore-js';
+/**
+ * Creates apcore Context objects from NestJS HTTP requests.
+ *
+ * Identity extraction priority:
+ *   1. `x-user-id` header
+ *   2. `Authorization: Bearer <token>` header (identity id = "bearer")
+ *   3. Falls back to anonymous identity
+ *
+ * W3C Trace Context propagation:
+ *   When a `traceparent` header is present, its trace_id is used via
+ *   Context.create — strict 32-hex validation and W3C-invalid rejection
+ *   are enforced by the SDK, not this factory. See PROTOCOL_SPEC §10.5.
+ *
+ * Correlation ID:
+ *   If `x-correlation-id` or `x-request-id` is present, the value is
+ *   stored in context.data["x-correlation-id"] alongside traceId so
+ *   existing log pipelines remain correlatable.
+ */
+let NestContextFactory = class NestContextFactory {
+    /**
+     * Create an apcore Context from a NestJS HTTP request.
+     *
+     * @param req - Request object (from @Req() decorator or an interceptor).
+     *              Compatible with Express and Fastify request shapes.
+     */
+    createContext(req) {
+        const identity = this._extractIdentity(req);
+        const traceParent = this._extractTraceParent(req);
+        const data = this._extractData(req);
+        return Context.create(identity, traceParent, null, data);
+    }
+    _extractTraceParent(req) {
+        const headers = _normalizeHeaders(req.headers);
+        return TraceContext.extract(headers);
+    }
+    _extractIdentity(req) {
+        const headers = req.headers;
+        const userId = headers['x-user-id'];
+        if (typeof userId === 'string' && userId.length > 0) {
+            return createIdentity(userId, 'user');
+        }
+        const auth = headers['authorization'];
+        if (typeof auth === 'string' && auth.toLowerCase().startsWith('bearer ')) {
+            return createIdentity('bearer', 'api_key');
+        }
+        return createIdentity('anonymous', 'anonymous');
+    }
+    _extractData(req) {
+        const data = {};
+        const headers = req.headers;
+        const correlationId = headers['x-correlation-id'] ?? headers['x-request-id'];
+        if (typeof correlationId === 'string' && correlationId.length > 0) {
+            data['x-correlation-id'] = correlationId;
+        }
+        return data;
+    }
+};
+NestContextFactory = __decorate([
+    Injectable()
+], NestContextFactory);
+export { NestContextFactory };
+function _normalizeHeaders(headers) {
+    const result = {};
+    for (const [key, value] of Object.entries(headers)) {
+        if (typeof value === 'string') {
+            result[key.toLowerCase()] = value;
+        }
+        else if (Array.isArray(value) && value.length > 0) {
+            result[key.toLowerCase()] = value[0];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=nest-context.factory.js.map

package/dist/context/nest-context.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-context.factory.js","sourceRoot":"","sources":["../../src/context/nest-context.factory.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAQlE;;;;;;;;;;;;;;;;;GAiBG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,GAAgB;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;IAEO,mBAAmB,CAAC,GAAgB;QAC1C,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAEO,gBAAgB,CAAC,GAAgB;QACvC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,OAAO,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;QACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACzE,OAAO,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,cAAc,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;IAEO,YAAY,CAAC,GAAgB;QACnC,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,MAAM,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7E,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClE,IAAI,CAAC,kBAAkB,CAAC,GAAG,aAAa,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AA5CY,kBAAkB;IAD9B,UAAU,EAAE;GACA,kBAAkB,CA4C9B;;AAED,SAAS,iBAAiB,CACxB,OAAsD;IAEtD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;QACpC,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -41,6 +41,6 @@ export declare class ApcoreExecutorService {
      * @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>, context?: Context | null): PreflightResult;
+    validate(moduleId: string, inputs?: Record<string, unknown>, context?: Context | null): Promise<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,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"}
+{"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,OAAO,CAAC,eAAe,CAAC;CAG5B"}

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

@@ -13,7 +13,7 @@ export declare class ApcoreRegistryService {
     constructor(registry: Registry);
     /** Return the underlying apcore-js Registry instance. */
     get raw(): Registry;
-    register(moduleId: string, module: unknown): void;
+    register(moduleId: string, module: unknown): Promise<void>;
     unregister(moduleId: string): boolean;
     get(moduleId: string): unknown | null;
     has(moduleId: string): boolean;
@@ -54,7 +54,7 @@ export declare class ApcoreRegistryService {
      *
      * @returns The module ID under which the method was registered.
      */
-    registerMethod(options: RegisterMethodOptions): string;
+    registerMethod(options: RegisterMethodOptions): Promise<string>;
     /**
      * Register multiple methods from a service instance as FunctionModules.
      *
@@ -64,6 +64,6 @@ export declare class ApcoreRegistryService {
      *
      * @returns An array of module IDs that were registered.
      */
-    registerService(options: RegisterServiceOptions): string[];
+    registerService(options: RegisterServiceOptions): Promise<string[]>;
 }
 //# sourceMappingURL=apcore-registry.service.d.ts.map

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":"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"}
+{"version":3,"file":"apcore-registry.service.d.ts","sourceRoot":"","sources":["../../src/core/apcore-registry.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAQ1C,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;IAIK,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,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;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiDrE;;;;;;;;OAQG;IACG,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAwD1E"}

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

@@ -8,7 +8,14 @@ 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 { normalizeResult } from 'apcore-js';
+/** Normalize a raw execute result to a plain Record<string, unknown>. */
+function normalizeResult(raw) {
+    if (raw === null || raw === undefined)
+        return {};
+    if (typeof raw === 'object' && !Array.isArray(raw))
+        return raw;
+    return { result: raw };
+}
 import { createScannedModule, moduleToDict, modulesToDicts } from 'apcore-toolkit';
 import { normalizeClassName, normalizeMethodName, generateModuleId, } from '../utils/id-generator.js';
 import { scannedModuleToFunctionModule, toModuleAnnotations, } from '../utils/module-factory.js';
@@ -47,8 +54,8 @@ let ApcoreRegistryService = class ApcoreRegistryService {
         return this.registry;
     }
     // ---- delegated methods ----
-    register(moduleId, module) {
-        this.registry.register(moduleId, module);
+    async register(moduleId, module) {
+        await this.registry.register(moduleId, module);
     }
     unregister(moduleId) {
         return this.registry.unregister(moduleId);
@@ -132,7 +139,7 @@ let ApcoreRegistryService = class ApcoreRegistryService {
      *
      * @returns The module ID under which the method was registered.
      */
-    registerMethod(options) {
+    async registerMethod(options) {
         const { instance, method, description, id, inputSchema, outputSchema, annotations, tags, documentation, examples, } = options;
         // Validate the method exists on the instance
         const fn = instance[method];
@@ -159,7 +166,7 @@ let ApcoreRegistryService = class ApcoreRegistryService {
             return normalizeResult(raw);
         };
         const fm = scannedModuleToFunctionModule(scanned, execute);
-        this.registry.register(moduleId, fm);
+        await this.registry.register(moduleId, fm);
         return moduleId;
     }
     /**
@@ -171,7 +178,7 @@ let ApcoreRegistryService = class ApcoreRegistryService {
      *
      * @returns An array of module IDs that were registered.
      */
-    registerService(options) {
+    async registerService(options) {
         const { instance, description, methods, exclude = [], namespace, annotations, tags, methodOptions = {}, } = options;
         // Determine which methods to register
         let methodNames;
@@ -189,7 +196,7 @@ let ApcoreRegistryService = class ApcoreRegistryService {
             const normalizedMethod = normalizeMethodName(methodName);
             const methodDesc = perMethodOpts.description ?? description ?? `${methodName}`;
             const moduleId = perMethodOpts.id ?? `${ns}.${normalizedMethod}`;
-            const id = this.registerMethod({
+            const id = await this.registerMethod({
                 instance,
                 method: methodName,
                 description: methodDesc,

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":"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"}
+{"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.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;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"}
+{"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;AAUpE,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;IA2ChE;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa;CAwDtE"}

package/dist/core/apcore.module.js

@@ -11,6 +11,8 @@ 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 { ApcoreCliModule } from '../cli/apcore-cli.module.js';
+import { ApcoreA2aModule } from '../a2a/apcore-a2a.module.js';
 import { APCORE_MODULE_OPTIONS } from '../constants.js';
 /**
  * Main NestJS dynamic module for the apcore ecosystem.
@@ -45,6 +47,12 @@ let ApcoreModule = ApcoreModule_1 = class ApcoreModule {
         if (options.mcp) {
             imports.push(ApcoreMcpModule.forRoot(options.mcp));
         }
+        if (options.cli) {
+            imports.push(ApcoreCliModule.forRoot(options.cli));
+        }
+        if (options.a2a) {
+            imports.push(ApcoreA2aModule.forRoot(options.a2a));
+        }
         return {
             module: ApcoreModule_1,
             imports,
@@ -73,6 +81,12 @@ let ApcoreModule = ApcoreModule_1 = class ApcoreModule {
         if (options.mcp) {
             imports.push(ApcoreMcpModule.forRoot(options.mcp));
         }
+        if (options.cli) {
+            imports.push(ApcoreCliModule.forRoot(options.cli));
+        }
+        if (options.a2a) {
+            imports.push(ApcoreA2aModule.forRoot(options.a2a));
+        }
         return {
             module: ApcoreModule_1,
             imports,

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

@@ -1 +1 @@
-{"version":3,"file":"apcore.module.js","sourceRoot":"","sources":["../../src/core/apcore.module.ts"],"names":[],"mappings":"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"}
+{"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,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,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;QACD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,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;QACD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,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;AAjHY,YAAY;IAFxB,MAAM,EAAE;IACR,MAAM,CAAC,EAAE,CAAC;GACE,YAAY,CAiHxB"}

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

@@ -37,7 +37,7 @@ export declare class ApToolScannerService extends BaseScanner implements OnModul
     /** Configure include/exclude filters applied during scanAndRegister(). */
     setScanOptions(options: ScanOptions): void;
     getSourceName(): string;
-    onModuleInit(): void;
+    onModuleInit(): Promise<void>;
     /**
      * Scan all NestJS providers 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,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"}
+{"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;AAChD,OAAO,EAAE,WAAW,EAAiD,MAAM,gBAAgB,CAAC;AAQ5F,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;IAIjB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;;;;;;;OAQG;IACH,IAAI,IAAI,aAAa,EAAE;IAsBvB;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAQ1D;;OAEG;YACW,eAAe;IA0B7B;;OAEG;IACH,OAAO,CAAC,YAAY;CA4HrB"}

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

@@ -12,8 +12,15 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import { Inject, Injectable, Logger } from '@nestjs/common';
 import { ModulesContainer } from '@nestjs/core';
-import { normalizeResult } from 'apcore-js';
 import { BaseScanner, createScannedModule, enrichSchemaDescriptions } from 'apcore-toolkit';
+/** Normalize a raw execute result to a plain Record<string, unknown>. */
+function normalizeResult(raw) {
+    if (raw === null || raw === undefined)
+        return {};
+    if (typeof raw === 'object' && !Array.isArray(raw))
+        return raw;
+    return { result: raw };
+}
 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';
@@ -69,8 +76,8 @@ let ApToolScannerService = class ApToolScannerService extends BaseScanner {
     getSourceName() {
         return 'nestjs-decorators';
     }
-    onModuleInit() {
-        this.scanAndRegister();
+    async onModuleInit() {
+        await this.scanAndRegister();
     }
     /**
      * Scan all NestJS providers for @ApTool decorated methods.
@@ -111,11 +118,11 @@ let ApToolScannerService = class ApToolScannerService extends BaseScanner {
     /**
      * Scan, deduplicate, filter, then register all discovered modules.
      */
-    scanAndRegister() {
+    async 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);
+            scannedModules = this.filterModules(scannedModules, this._scanOptions.include, this._scanOptions.exclude);
         }
         for (const mod of scannedModules) {
             const execute = this._executeFns.get(mod.moduleId);
@@ -124,7 +131,7 @@ let ApToolScannerService = class ApToolScannerService extends BaseScanner {
                 continue;
             }
             const fm = scannedModuleToFunctionModule(mod, execute);
-            this.registry.register(mod.moduleId, fm);
+            await this.registry.register(mod.moduleId, fm);
         }
     }
     /**