nestjs-apcore 0.3.2 → 0.5.0

package/README.md

@@ -33,7 +33,7 @@ npm install class-validator class-transformer  # DtoAdapter
 npm install @sinclair/typebox                  # TypeBoxAdapter (recommended)
 ```
 
-**Requirements:** Node.js >= 18, NestJS >= 10
+**Requirements:** Node.js >= 18, NestJS >= 10 (tested with NestJS 11)
 
 ## Quick Start
 
@@ -167,10 +167,22 @@ ApcoreModule.forRootAsync({
 | `explorer` | `boolean` | Enable Tool Explorer web UI |
 | `allowExecute` | `boolean` | Allow tool execution from Explorer |
 | `authenticator` | `Authenticator` | JWT or custom auth strategy |
+| `requireAuth` | `boolean` | Reject unauthenticated requests (default: `true`) |
+| `exemptPaths` | `string[]` | Paths exempt from auth (default: `["/health", "/metrics"]`) |
 | `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 |
+| `metricsCollector` | `MetricsExporter \| true` | Enables `/metrics` endpoint; `true` auto-instantiates |
+| `observability` | `ObservabilityFlag` | Full stack: metrics + usage middleware + `/usage` endpoint |
+| `outputFormat` | `'json' \| 'csv' \| 'jsonl'` | Built-in result serialisation format |
+| `redactOutput` | `boolean` | Redact sensitive fields from tool output (default: `true`) |
+| `trace` | `boolean` | Attach pipeline trace to tool responses (default: `false`) |
+| `strategy` | `string` | Execution strategy name (e.g. `"standard"`, `"minimal"`) |
+| `approvalHandler` | `unknown` | Custom approval handler for the executor |
+| `approvalStore` | `unknown` | Pluggable approval store; auto-wires `StorageBackedApprovalHandler` |
+| `approvalNotify` | `function` | Callback on new approval request (Slack/email fan-out) |
+| `mcpMiddleware` | `unknown[]` | Extra apcore middleware to install on the executor |
+| `mcpAcl` | `unknown` | apcore ACL instance for this MCP server |
 | `onStartup` | `() => void` | Callback after server starts |
 | `onShutdown` | `() => void` | Callback before server stops |
 
@@ -222,11 +234,15 @@ export class AppModule {}
 
 | Service | Description |
 |---|---|
-| `ApcoreRegistryService` | Register/unregister tools, query the registry |
-| `ApcoreExecutorService` | Execute tools: `call()`, `stream()`, `validate()` |
+| `ApcoreRegistryService` | Register/unregister tools, query the registry — `register()`, `registerMethod()`, `registerService()` are async since 0.6.0 |
+| `ApcoreExecutorService` | Execute tools: `call()`, `stream()`, `validate()` (async since 0.5.0) |
 | `ApcoreMcpService` | MCP server lifecycle: `start()`, `stop()`, `restart()`, `toOpenaiTools()` |
+| `ApcoreCliService` | CLI lifecycle: `run()` — integrates `apcore-cli` with NestJS |
+| `ApcoreA2aService` | A2A server lifecycle: `start()`, `stop()`, `asyncServe()` |
 | `ApToolScannerService` | Auto-discovers and registers `@ApTool` decorated methods at startup |
 
+> **Breaking change in 0.5.0:** `ApcoreExecutorService.validate()` now returns `Promise<PreflightResult>` — add `await` at call sites.
+
 ### Schema Adapters
 
 Schemas are auto-detected and converted via a priority chain:
@@ -283,11 +299,86 @@ list(inputs: Record<string, unknown>) {
 }
 ```
 
+### A2A Module
+
+Expose your tools as an [Agent-to-Agent](https://a2aprotocol.ai/) server:
+
+```typescript
+ApcoreModule.forRoot({
+  a2a: {
+    name: 'my-agent',
+    port: 9000,
+    url: 'https://my-agent.example.com',
+    explorer: true,
+  },
+})
+```
+
+Embed into the NestJS HTTP server instead of running standalone:
+
+```typescript
+const a2aApp = await a2aService.asyncServe();
+nestApp.use('/a2a', a2aApp);
+```
+
+The `A2AClient` is also re-exported for calling remote A2A servers:
+
+```typescript
+import { A2AClient } from 'nestjs-apcore';
+const client = new A2AClient({ baseUrl: 'https://other-agent.example.com' });
+const result = await client.runTask({ skill: 'weather.forecast', input: { city: 'Tokyo' } });
+```
+
+### CLI Module
+
+Integrate `apcore-cli` with NestJS for a standalone command-line interface:
+
+```typescript
+ApcoreModule.forRoot({
+  cli: {
+    progName: 'my-cli',
+    docsUrl: 'https://docs.example.com',
+  },
+})
+```
+
 ### Re-exported Utilities
 
-From `apcore-mcp`:
-- `reportProgress`, `elicit`, `createBridgeContext`
-- `JWTAuthenticator`, `getCurrentIdentity`, `identityStorage`
+All utilities are importable directly from `nestjs-apcore`.
+
+**`apcore-mcp`:**
+- `reportProgress`, `elicit`, `createBridgeContext`, `toOpenaiTools`
+- `JWTAuthenticator`, `getCurrentIdentity`, `identityStorage`, `buildExplorerAuthHook`
+- `MCPServerFactory` (`MCPServer`), `ExecutionRouter`, `AsyncTaskBridge`, `ApprovalBridge`
+- `ElicitationApprovalHandler`, `StorageBackedApprovalHandler`, `InMemoryApprovalStore`
+- `OpenAIConverter`, `AnnotationMapper`, `McpSchemaConverter`, `McpErrorMapper`, `ModuleIDNormalizer`
+- `installObservability`, `parseTraceparent`, `buildTraceparent`
+- Constants: `MCP_NAMESPACE`, `MCP_ENV_PREFIX`, `MCP_DEFAULTS`, `MCP_PROGRESS_KEY`, `MCP_ELICIT_KEY`, `REGISTRY_EVENTS`, `APCORE_EVENTS`, `MODULE_ID_PATTERN`, `ErrorCodes`
+
+**`apcore-a2a`:**
+- `serveA2A`, `asyncServeA2A`, `A2AClient`, `AgentCardBuilder`, `SkillMapper`, `PartConverter`
+- `A2AServerFactory`, `ApCoreAgentExecutor`
+- `A2AJWTAuthenticator`, `createAuthMiddleware`, `authIdentityStore`, `getAuthIdentity`
+- `A2ASchemaConverter`, `A2AErrorMapper`
+
+**`apcore-cli`:**
+- `createCli`, `main`, `buildModuleCommand`, `applyToolkitIntegration`
+- `LazyModuleGroup`, `GroupedModuleGroup`, `LazyGroup`, `ApcliGroup`, `ExposureFilter`
+- `ConfigResolver`, `DEFAULTS`, `registerConfigNamespace`
+- Discovery: `registerListCommand`, `registerDescribeCommand`, `registerExecCommand`, `registerValidateCommand`
+- System: `registerHealthCommand`, `registerUsageCommand`, `registerEnableCommand`, `registerDisableCommand`, `registerReloadCommand`, `registerConfigCommand`, `registerPipelineCommand`, `registerInitCommand`, `registerCompletionCommand`, `configureManHelp`
+- `setLogLevel`, `getLogLevel`, `resolveRefs`, `schemaToCliOptions`
+- Security: `AuditLogger`, `setAuditLogger`, `getAuditLogger`, `AuthProvider`, `ConfigEncryptor`, `Sandbox`
+
+**`apcore-toolkit`:**
+- `BaseScanner`, `filterModules`, `deduplicateIds`, `inferAnnotationsFromMethod`
+- `createScannedModule`, `cloneModule`, `moduleToDict`, `modulesToDicts`, `annotationsToDict`
+- Schema: `extractInputSchema`, `extractOutputSchema`, `resolveRef`, `resolveSchema`, `deepResolveRefs`, `enrichSchemaDescriptions`
+- Formatting: `toMarkdown`, `formatSchema`, `formatModule`, `formatModules`, `formatCsv`, `formatJsonl`
+- Writers: `YAMLWriter`, `TypeScriptWriter`, `RegistryWriter`, `HTTPProxyRegistryWriter`, `getWriter`
+- Verifiers: `YAMLVerifier`, `SyntaxVerifier`, `RegistryVerifier`, `MagicBytesVerifier`, `JSONVerifier`, `runVerifierChain`
+- HTTP utils: `SCANNER_VERB_MAP`, `resolveHttpVerb`, `hasPathParams`, `generateSuggestedAlias`, `extractPathParamNames`, `substitutePathParams`
+- `BindingLoader`, `AIEnhancer`, `DisplayResolver`, `resolveTarget`
 
 ## Examples
 

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

@@ -0,0 +1,19 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { ApcoreA2aModuleOptions, ApcoreA2aModuleAsyncOptions } from '../types.js';
+/**
+ * NestJS dynamic module for A2A (Agent-to-Agent) server integration.
+ *
+ * Provides {@link ApcoreA2aService} for serving the registered apcore modules
+ * as A2A skills. Supports both a standalone HTTP server (set `port` in options)
+ * and an embedded Express app (via `service.asyncServe()`).
+ *
+ * Requires {@link ApcoreRegistryService} and {@link ApcoreExecutorService} in
+ * the injection context (typically via importing `ApcoreModule`).
+ */
+export declare class ApcoreA2aModule {
+    /** Synchronous configuration. */
+    static forRoot(options?: ApcoreA2aModuleOptions): DynamicModule;
+    /** Asynchronous configuration using `useFactory` / `inject`. */
+    static forRootAsync(options: ApcoreA2aModuleAsyncOptions): DynamicModule;
+}
+//# sourceMappingURL=apcore-a2a.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-a2a.module.d.ts","sourceRoot":"","sources":["../../src/a2a/apcore-a2a.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;;;;;;;;;GASG;AACH,qBACa,eAAe;IAC1B,iCAAiC;IACjC,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,sBAA2B,GAAG,aAAa;IAkBnE,gEAAgE;IAChE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,2BAA2B,GAAG,aAAa;CA2BzE"}

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

@@ -0,0 +1,68 @@
+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 ApcoreA2aModule_1;
+import { Module } from '@nestjs/common';
+import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
+import { ApcoreExecutorService } from '../core/apcore-executor.service.js';
+import { ApcoreA2aService } from './apcore-a2a.service.js';
+import { APCORE_A2A_MODULE_OPTIONS } from '../constants.js';
+/**
+ * NestJS dynamic module for A2A (Agent-to-Agent) server integration.
+ *
+ * Provides {@link ApcoreA2aService} for serving the registered apcore modules
+ * as A2A skills. Supports both a standalone HTTP server (set `port` in options)
+ * and an embedded Express app (via `service.asyncServe()`).
+ *
+ * Requires {@link ApcoreRegistryService} and {@link ApcoreExecutorService} in
+ * the injection context (typically via importing `ApcoreModule`).
+ */
+let ApcoreA2aModule = ApcoreA2aModule_1 = class ApcoreA2aModule {
+    /** Synchronous configuration. */
+    static forRoot(options = {}) {
+        return {
+            module: ApcoreA2aModule_1,
+            providers: [
+                { provide: APCORE_A2A_MODULE_OPTIONS, useValue: options },
+                {
+                    provide: ApcoreA2aService,
+                    useFactory: (registry, executor) => new ApcoreA2aService(registry, executor, options),
+                    inject: [ApcoreRegistryService, ApcoreExecutorService],
+                },
+            ],
+            exports: [ApcoreA2aService, APCORE_A2A_MODULE_OPTIONS],
+        };
+    }
+    /** Asynchronous configuration using `useFactory` / `inject`. */
+    static forRootAsync(options) {
+        return {
+            module: ApcoreA2aModule_1,
+            imports: (options.imports ?? []),
+            providers: [
+                {
+                    provide: APCORE_A2A_MODULE_OPTIONS,
+                    useFactory: options.useFactory,
+                    inject: (options.inject ?? []),
+                },
+                {
+                    provide: ApcoreA2aService,
+                    useFactory: (opts, registry, executor) => new ApcoreA2aService(registry, executor, opts),
+                    inject: [
+                        APCORE_A2A_MODULE_OPTIONS,
+                        ApcoreRegistryService,
+                        ApcoreExecutorService,
+                    ],
+                },
+            ],
+            exports: [ApcoreA2aService, APCORE_A2A_MODULE_OPTIONS],
+        };
+    }
+};
+ApcoreA2aModule = ApcoreA2aModule_1 = __decorate([
+    Module({})
+], ApcoreA2aModule);
+export { ApcoreA2aModule };
+//# sourceMappingURL=apcore-a2a.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-a2a.module.js","sourceRoot":"","sources":["../../src/a2a/apcore-a2a.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;;;;;;;;;GASG;AAEI,IAAM,eAAe,uBAArB,MAAM,eAAe;IAC1B,iCAAiC;IACjC,MAAM,CAAC,OAAO,CAAC,UAAkC,EAAE;QACjD,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,gEAAgE;IAChE,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;AAhDY,eAAe;IAD3B,MAAM,CAAC,EAAE,CAAC;GACE,eAAe,CAgD3B"}

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

@@ -0,0 +1,58 @@
+import type { OnApplicationBootstrap, OnModuleDestroy } from '@nestjs/common';
+import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
+import { ApcoreExecutorService } from '../core/apcore-executor.service.js';
+import type { ApcoreA2aModuleOptions } from '../types.js';
+/**
+ * NestJS service that manages the A2A (Agent-to-Agent) server lifecycle.
+ *
+ * Wraps `serve()` and `asyncServe()` from `apcore-a2a`, integrating them with
+ * NestJS lifecycle hooks for automatic startup/shutdown.
+ *
+ * **Standalone HTTP server** — set `port` in module options. The server starts
+ * automatically on `onApplicationBootstrap`.
+ *
+ * **Embedded Express app** — call `asyncServe()` to get an Express application
+ * and mount it in your NestJS HTTP server:
+ *
+ * @example
+ * ```ts
+ * // In a NestJS bootstrap file:
+ * const a2aApp = await a2aService.asyncServe();
+ * app.use('/a2a', a2aApp);
+ * ```
+ */
+export declare class ApcoreA2aService implements OnApplicationBootstrap, OnModuleDestroy {
+    private readonly registry;
+    private readonly executor;
+    private readonly options;
+    private _isRunning;
+    constructor(registry: ApcoreRegistryService, executor: ApcoreExecutorService, options: ApcoreA2aModuleOptions);
+    /** Whether the standalone A2A HTTP server is currently running. */
+    get isRunning(): boolean;
+    /** Number of skills (modules) exposed to A2A clients. */
+    get skillCount(): number;
+    /**
+     * Start a standalone A2A HTTP server with the configured options.
+     *
+     * Automatically called on `onApplicationBootstrap` when `port` is set.
+     */
+    start(): void;
+    /**
+     * Build an embeddable Express application without starting a standalone server.
+     *
+     * Mount the returned app in your NestJS HTTP server or Express middleware chain.
+     */
+    asyncServe(overrides?: Partial<ApcoreA2aModuleOptions>): Promise<unknown>;
+    /** Stop tracking the running state (the underlying HTTP server manages its own lifecycle). */
+    stop(): void;
+    /**
+     * Auto-starts the standalone A2A server when `port` is configured.
+     *
+     * Uses `OnApplicationBootstrap` so all modules registered during
+     * `onModuleInit` are available before the server starts.
+     */
+    onApplicationBootstrap(): void;
+    /** Marks the service as stopped on module destruction. */
+    onModuleDestroy(): void;
+}
+//# sourceMappingURL=apcore-a2a.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-a2a.service.d.ts","sourceRoot":"","sources":["../../src/a2a/apcore-a2a.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9E,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;;;;;;;;;;;;;;;;;;GAkBG;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,mEAAmE;IACnE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,yDAAyD;IACzD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAMD;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAwBb;;;;OAIG;IACG,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB/E,8FAA8F;IAC9F,IAAI,IAAI,IAAI;IAQZ;;;;;OAKG;IACH,sBAAsB,IAAI,IAAI;IAM9B,0DAA0D;IAC1D,eAAe,IAAI,IAAI;CAKxB"}

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

@@ -0,0 +1,145 @@
+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, asyncServe } from 'apcore-a2a';
+import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
+import { ApcoreExecutorService } from '../core/apcore-executor.service.js';
+import { APCORE_A2A_MODULE_OPTIONS } from '../constants.js';
+/**
+ * NestJS service that manages the A2A (Agent-to-Agent) server lifecycle.
+ *
+ * Wraps `serve()` and `asyncServe()` from `apcore-a2a`, integrating them with
+ * NestJS lifecycle hooks for automatic startup/shutdown.
+ *
+ * **Standalone HTTP server** — set `port` in module options. The server starts
+ * automatically on `onApplicationBootstrap`.
+ *
+ * **Embedded Express app** — call `asyncServe()` to get an Express application
+ * and mount it in your NestJS HTTP server:
+ *
+ * @example
+ * ```ts
+ * // In a NestJS bootstrap file:
+ * const a2aApp = await a2aService.asyncServe();
+ * app.use('/a2a', a2aApp);
+ * ```
+ */
+let ApcoreA2aService = class ApcoreA2aService {
+    registry;
+    executor;
+    options;
+    _isRunning = false;
+    constructor(registry, executor, options) {
+        this.registry = registry;
+        this.executor = executor;
+        this.options = options;
+    }
+    // -------------------------------------------------------------------------
+    // Properties
+    // -------------------------------------------------------------------------
+    /** Whether the standalone A2A HTTP server is currently running. */
+    get isRunning() {
+        return this._isRunning;
+    }
+    /** Number of skills (modules) exposed to A2A clients. */
+    get skillCount() {
+        return this.registry.list().length;
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    /**
+     * Start a standalone A2A HTTP server with the configured options.
+     *
+     * Automatically called on `onApplicationBootstrap` when `port` is set.
+     */
+    start() {
+        this._isRunning = true;
+        serve(this.executor.raw, {
+            name: this.options.name,
+            description: this.options.description,
+            version: this.options.version,
+            url: this.options.url,
+            host: this.options.host,
+            port: this.options.port,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            auth: this.options.auth,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            taskStore: this.options.taskStore,
+            corsOrigins: this.options.corsOrigins,
+            explorer: this.options.explorer,
+            explorerPrefix: this.options.explorerPrefix,
+            executionTimeout: this.options.executionTimeout,
+            metrics: this.options.metrics,
+            logLevel: this.options.logLevel,
+            shutdownTimeout: this.options.shutdownTimeout,
+        });
+    }
+    /**
+     * Build an embeddable Express application without starting a standalone server.
+     *
+     * Mount the returned app in your NestJS HTTP server or Express middleware chain.
+     */
+    async asyncServe(overrides) {
+        const opts = { ...this.options, ...overrides };
+        return asyncServe(this.executor.raw, {
+            name: opts.name,
+            description: opts.description,
+            version: opts.version,
+            url: opts.url,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            auth: opts.auth,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            taskStore: opts.taskStore,
+            corsOrigins: opts.corsOrigins,
+            explorer: opts.explorer,
+            explorerPrefix: opts.explorerPrefix,
+            executionTimeout: opts.executionTimeout,
+            metrics: opts.metrics,
+        });
+    }
+    /** Stop tracking the running state (the underlying HTTP server manages its own lifecycle). */
+    stop() {
+        this._isRunning = false;
+    }
+    // -------------------------------------------------------------------------
+    // NestJS lifecycle hooks
+    // -------------------------------------------------------------------------
+    /**
+     * Auto-starts the standalone A2A server when `port` is configured.
+     *
+     * Uses `OnApplicationBootstrap` so all modules registered during
+     * `onModuleInit` are available before the server starts.
+     */
+    onApplicationBootstrap() {
+        if (this.options.port !== undefined) {
+            this.start();
+        }
+    }
+    /** Marks the service as stopped on module destruction. */
+    onModuleDestroy() {
+        if (this._isRunning) {
+            this.stop();
+        }
+    }
+};
+ApcoreA2aService = __decorate([
+    Injectable(),
+    __param(0, Inject(ApcoreRegistryService)),
+    __param(1, Inject(ApcoreExecutorService)),
+    __param(2, Inject(APCORE_A2A_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [ApcoreRegistryService,
+        ApcoreExecutorService, Object])
+], ApcoreA2aService);
+export { ApcoreA2aService };
+//# sourceMappingURL=apcore-a2a.service.js.map

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

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

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

@@ -21,7 +21,7 @@ export declare class ApBindingLoader {
      * @param content - Raw YAML string
      * @returns Array of registered module IDs
      */
-    loadFromString(content: string): string[];
+    loadFromString(content: string): Promise<string[]>;
     /**
      * Read a YAML file from disk and register its bindings.
      *

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":"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"}
+{"version":3,"file":"binding-loader.d.ts","sourceRoot":"","sources":["../../src/bridge/binding-loader.ts"],"names":[],"mappings":"AAWA,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;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmDxD;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAIxD"}

package/dist/bridge/binding-loader.js

@@ -13,8 +13,15 @@ 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 { normalizeResult } from 'apcore-js';
 import { createScannedModule } 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 { scannedModuleToFunctionModule, toModuleAnnotations, } from '../utils/module-factory.js';
 /**
@@ -38,7 +45,7 @@ let ApBindingLoader = class ApBindingLoader {
      * @param content - Raw YAML string
      * @returns Array of registered module IDs
      */
-    loadFromString(content) {
+    async loadFromString(content) {
         const parsed = yaml.load(content);
         const bindings = parsed?.bindings ?? [];
         const ids = [];
@@ -77,7 +84,7 @@ let ApBindingLoader = class ApBindingLoader {
                 documentation: binding.documentation ?? null,
             });
             const fm = scannedModuleToFunctionModule(scanned, execute);
-            this.registry.register(moduleId, fm);
+            await this.registry.register(moduleId, fm);
             ids.push(moduleId);
         }
         return ids;
@@ -90,7 +97,7 @@ let ApBindingLoader = class ApBindingLoader {
      */
     async loadFromFile(filePath) {
         const content = await readFile(filePath, 'utf-8');
-        return this.loadFromString(content);
+        return await this.loadFromString(content);
     }
 };
 ApBindingLoader = __decorate([

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/cli/apcore-cli.module.d.ts

@@ -0,0 +1,18 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { ApcoreCliModuleOptions, ApcoreCliModuleAsyncOptions } from '../types.js';
+/**
+ * NestJS dynamic module for apcore-cli integration.
+ *
+ * Provides {@link ApcoreCliService} for building Commander programs, generating
+ * man pages, and configuring `--help --man` / `--help --verbose` support.
+ *
+ * Requires {@link ApcoreRegistryService} in the injection context
+ * (typically via importing `ApcoreModule`).
+ */
+export declare class ApcoreCliModule {
+    /** Synchronous configuration. */
+    static forRoot(options?: ApcoreCliModuleOptions): DynamicModule;
+    /** Asynchronous configuration using `useFactory` / `inject`. */
+    static forRootAsync(options: ApcoreCliModuleAsyncOptions): DynamicModule;
+}
+//# sourceMappingURL=apcore-cli.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-cli.module.d.ts","sourceRoot":"","sources":["../../src/cli/apcore-cli.module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAIpE,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,qBACa,eAAe;IAC1B,iCAAiC;IACjC,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,sBAA2B,GAAG,aAAa;IAgBnE,gEAAgE;IAChE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,2BAA2B,GAAG,aAAa;CAsBzE"}

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

@@ -0,0 +1,62 @@
+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 ApcoreCliModule_1;
+import { Module } from '@nestjs/common';
+import { ApcoreRegistryService } from '../core/apcore-registry.service.js';
+import { ApcoreCliService } from './apcore-cli.service.js';
+import { APCORE_CLI_MODULE_OPTIONS } from '../constants.js';
+/**
+ * NestJS dynamic module for apcore-cli integration.
+ *
+ * Provides {@link ApcoreCliService} for building Commander programs, generating
+ * man pages, and configuring `--help --man` / `--help --verbose` support.
+ *
+ * Requires {@link ApcoreRegistryService} in the injection context
+ * (typically via importing `ApcoreModule`).
+ */
+let ApcoreCliModule = ApcoreCliModule_1 = class ApcoreCliModule {
+    /** Synchronous configuration. */
+    static forRoot(options = {}) {
+        return {
+            module: ApcoreCliModule_1,
+            providers: [
+                { provide: APCORE_CLI_MODULE_OPTIONS, useValue: options },
+                {
+                    provide: ApcoreCliService,
+                    useFactory: (registry) => new ApcoreCliService(registry, options),
+                    inject: [ApcoreRegistryService],
+                },
+            ],
+            exports: [ApcoreCliService, APCORE_CLI_MODULE_OPTIONS],
+        };
+    }
+    /** Asynchronous configuration using `useFactory` / `inject`. */
+    static forRootAsync(options) {
+        return {
+            module: ApcoreCliModule_1,
+            imports: (options.imports ?? []),
+            providers: [
+                {
+                    provide: APCORE_CLI_MODULE_OPTIONS,
+                    useFactory: options.useFactory,
+                    inject: (options.inject ?? []),
+                },
+                {
+                    provide: ApcoreCliService,
+                    useFactory: (opts, registry) => new ApcoreCliService(registry, opts),
+                    inject: [APCORE_CLI_MODULE_OPTIONS, ApcoreRegistryService],
+                },
+            ],
+            exports: [ApcoreCliService, APCORE_CLI_MODULE_OPTIONS],
+        };
+    }
+};
+ApcoreCliModule = ApcoreCliModule_1 = __decorate([
+    Module({})
+], ApcoreCliModule);
+export { ApcoreCliModule };
+//# sourceMappingURL=apcore-cli.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-cli.module.js","sourceRoot":"","sources":["../../src/cli/apcore-cli.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAM5D;;;;;;;;GAQG;AAEI,IAAM,eAAe,uBAArB,MAAM,eAAe;IAC1B,iCAAiC;IACjC,MAAM,CAAC,OAAO,CAAC,UAAkC,EAAE;QACjD,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,CAAC,QAA+B,EAAE,EAAE,CAC9C,IAAI,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC;oBACzC,MAAM,EAAE,CAAC,qBAAqB,CAAC;iBAChC;aACF;YACD,OAAO,EAAE,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,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,EAAE,CAAC,IAAI,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC;oBACzC,MAAM,EAAE,CAAC,yBAAyB,EAAE,qBAAqB,CAAC;iBAC3D;aACF;YACD,OAAO,EAAE,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;SACvD,CAAC;IACJ,CAAC;CACF,CAAA;AAzCY,eAAe;IAD3B,MAAM,CAAC,EAAE,CAAC;GACE,eAAe,CAyC3B"}