hono-apcore 0.1.0 → 0.3.0

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

@@ -1 +1 @@
-{"version":3,"file":"apcore.d.ts","sourceRoot":"","sources":["../../src/core/apcore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apcore.d.ts","sourceRoot":"","sources":["../../src/core/apcore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAU;IACrB,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAE5C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE,qBAA0B;IA0B/C;;;;;;OAMG;IACH,IAAI,YAAY,IAAI,gBAAgB,CAEnC;IAMD,2DAA2D;IAC3D,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD,mEAAmE;IACnE,aAAa,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI3D,gEAAgE;IAChE,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D,+DAA+D;IAC/D,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIjE;;;;;;;;;OASG;IACG,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BrF;;;;;;;;;OASG;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvE;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,uFAAuF;IACvF,OAAO,CAAC,iBAAiB;YAUX,OAAO;IA0BrB;;;;OAIG;cACa,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAEvD;;;;OAIG;cACa,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,qBAA0B,GAAG,UAAU,CAE5E"}

package/dist/core/apcore.js

@@ -1,35 +1,26 @@
 import { Executor, Registry } from 'apcore-js';
 import { ApcoreRegistry } from './registry.js';
 import { ApcoreExecutor } from './executor.js';
-import { ApcoreMcpService } from '../mcp/apcore-mcp.service.js';
-import { ApcoreCliService } from '../cli/apcore-cli.service.js';
-import { ApcoreA2aService } from '../a2a/apcore-a2a.service.js';
 import { HonoContextFactory } from '../context/hono-context.factory.js';
 import { HonoRouteScanner } from '../scanners/hono-route-scanner.js';
-import { ApBindingLoader } from '../bridge/binding-loader.js';
-import { mountMcp as mountMcpEndpoint } from '../mcp/mount.js';
-import { loadSettings, toMcpTransport } from '../config.js';
+import { loadSettings } from '../config.js';
 /**
- * The single entry point for wiring apcore into a Hono app.
+ * Core entry point for wiring apcore into a Hono app.
  *
  * Owns the apcore `Registry` and `Executor`, the tool/route registration
- * surface, and the optional MCP, CLI, and A2A services. Everything else in
- * this package hangs off an instance of this class.
+ * surface, and route scanning. This is the implementation behind both package
+ * entries: the Node subclass adds MCP, CLI, A2A, and YAML bindings, while the
+ * edge entry exposes this class directly.
  *
  * @example
  * ```ts
- * const ap = createApcore({
- *   tools: [listTodos, addTodo],
- *   mcp: { explorer: true, allowExecute: true },
- * });
+ * const ap = createApcore({ tools: [listTodos, addTodo] });
  *
  * app.use('*', apcore(ap));
  * await ap.init(app);                 // register tools, scan routes
- * await ap.mountMcp(app);             // serve MCP on the same port
  * ```
  */
 export class HonoApcore {
-    options;
     /** Canonical `APCORE_*` settings, environment merged with `options.settings`. */
     settings;
     /** Registry wrapper — register and inspect modules. */
@@ -38,39 +29,30 @@ export class HonoApcore {
     executor;
     /** Builds per-request apcore `Context` objects from Hono requests. */
     contextFactory;
-    _mcp;
-    _cli;
-    _a2a;
+    options;
     scanner = new HonoRouteScanner();
     initPromise = null;
     constructor(options = {}) {
         this.options = options;
         this.settings = loadSettings(undefined, options.settings);
-        const registry = new Registry({ extensionsDir: options.extensionsDir ?? null });
-        const executor = new Executor({
+        const registry = new Registry({
+            config: options.config,
+            extensionsDir: options.extensionsDir ?? null,
+        });
+        const executorOptions = {
+            ...options.executorOptions,
             registry,
+            config: options.config,
             acl: options.acl ?? null,
             middlewares: options.middleware ?? null,
-        });
+        };
+        const executor = new Executor(executorOptions);
         this.registry = new ApcoreRegistry(registry);
-        this.executor = new ApcoreExecutor(executor);
+        this.executor = new ApcoreExecutor(executor, executorOptions);
         this.contextFactory = new HonoContextFactory();
-        this._mcp = options.mcp
-            ? new ApcoreMcpService(this.registry, this.executor, {
-                ...options.mcp,
-                // The APCORE_* settings supply the defaults; explicit config wins.
-                transport: options.mcp.transport ?? toMcpTransport(this.settings.transport),
-                host: options.mcp.host ?? this.settings.host,
-                port: options.mcp.port ?? this.settings.port,
-            })
-            : null;
-        this._cli = options.cli ? new ApcoreCliService(this.registry, options.cli) : null;
-        this._a2a = options.a2a
-            ? new ApcoreA2aService(this.registry, this.executor, options.a2a)
-            : null;
     }
     // -------------------------------------------------------------------------
-    // Surfaces
+    // Options
     // -------------------------------------------------------------------------
     /**
      * The route-scan options this instance would use: the `APCORE_*` settings
@@ -82,18 +64,6 @@ export class HonoApcore {
     get routeOptions() {
         return this.mergeRouteOptions();
     }
-    /** The MCP service, or `null` when `options.mcp` was omitted. */
-    get mcp() {
-        return this._mcp;
-    }
-    /** The CLI service, or `null` when `options.cli` was omitted. */
-    get cli() {
-        return this._cli;
-    }
-    /** The A2A service, or `null` when `options.a2a` was omitted. */
-    get a2a() {
-        return this._a2a;
-    }
     // -------------------------------------------------------------------------
     // Registration
     // -------------------------------------------------------------------------
@@ -141,18 +111,6 @@ export class HonoApcore {
         }
         return ids;
     }
-    /**
-     * Load a YAML bindings file and register its entries.
-     *
-     * @param filePath - Path to the YAML file. Defaults to `options.bindings`.
-     * @param resolveTarget - Resolves each entry's `target` to a live handler.
-     */
-    async loadBindings(filePath, resolveTarget) {
-        const path = filePath ?? this.options.bindings;
-        if (!path)
-            return [];
-        return new ApBindingLoader(this.registry, resolveTarget).loadFromFile(path);
-    }
     // -------------------------------------------------------------------------
     // Lifecycle
     // -------------------------------------------------------------------------
@@ -190,60 +148,34 @@ export class HonoApcore {
     async runInit(app, routeOptions) {
         if (!this.settings.enabled)
             return;
-        if (this.options.extensionsDir) {
+        if (this.options.extensionsDir ||
+            this.options.config?.getDeclared('extensions.root') !== undefined ||
+            this.options.config?.getDeclared('extensions.roots') !== undefined) {
             await this.registry.discover();
         }
         if (this.options.tools?.length) {
             await this.registerTools(this.options.tools);
         }
-        if (this.options.bindings) {
-            await this.loadBindings();
-        }
+        await this.loadConfiguredBindings();
         if (app) {
             await this.scanRoutes(app, routeOptions);
         }
         // Surfaces start last, so every module is registered before a client can
         // list the tools.
-        if (this._a2a && this.options.a2a?.port !== undefined) {
-            await this._a2a.start();
-        }
-        if (this._mcp && this.options.mcp?.transport) {
-            await this._mcp.start();
-        }
+        await this.startSurfaces();
     }
     /**
-     * Mount the MCP endpoint into the Hono app so one port serves both HTTP and
-     * MCP. Node runtime only — see {@link mountMcp}.
+     * Register file-backed bindings before routes are scanned.
      *
-     * @throws {Error} When the instance was created without `options.mcp`.
+     * The core entry leaves this empty; the Node entry loads YAML from disk.
      */
-    async mountMcp(app, options = {}) {
-        if (!this._mcp) {
-            throw new Error('mountMcp() requires the MCP surface. Pass an `mcp` block to createApcore().');
-        }
-        return mountMcpEndpoint(app, this._mcp, {
-            explorer: this.options.mcp?.explorer,
-            explorerPrefix: this.options.mcp?.explorerPrefix,
-            allowExecute: this.options.mcp?.allowExecute,
-            ...options,
-        });
-    }
+    async loadConfiguredBindings() { }
     /**
-     * Convert the registered modules to OpenAI-compatible tool definitions.
+     * Start configured standalone surfaces after every module is registered.
      *
-     * @throws {Error} When the instance was created without `options.mcp`.
+     * The core entry leaves this empty; the Node entry starts MCP, CLI, and A2A.
      */
-    async toOpenaiTools(options) {
-        if (!this._mcp) {
-            throw new Error('toOpenaiTools() requires the MCP surface. Pass an `mcp` block to createApcore().');
-        }
-        return this._mcp.toOpenaiTools(options);
-    }
-    /** Shut down the MCP and A2A surfaces. */
-    async close() {
-        await this._mcp?.stop();
-        this._a2a?.stop();
-    }
+    async startSurfaces() { }
 }
 /**
  * Create a {@link HonoApcore} instance.

package/dist/core/apcore.js.map

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

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

@@ -0,0 +1,65 @@
+import { HonoApcore as HonoApcoreCore } from './apcore.js';
+import { ApcoreMcpService } from '../mcp/apcore-mcp.service.js';
+import { ApcoreCliService } from '../cli/apcore-cli.service.js';
+import { ApcoreA2aService } from '../a2a/apcore-a2a.service.js';
+import type { TargetResolver } from '../bridge/binding-loader.js';
+import type { MountableApp } from '../mcp/mount.js';
+import type { McpApp } from '../mcp/apcore-mcp.service.js';
+import type { HonoApcoreOptions, MountMcpOptions } from '../types.js';
+/**
+ * Node entry for {@link HonoApcore}.
+ *
+ * Adds the optional MCP, CLI, and A2A surfaces plus YAML bindings loaded from
+ * disk. The edge entry exposes the same core behaviour without these
+ * Node-only dependencies.
+ */
+export declare class HonoApcore extends HonoApcoreCore {
+    private readonly _mcp;
+    private readonly _cli;
+    private readonly _a2a;
+    constructor(options?: HonoApcoreOptions);
+    private get nodeOptions();
+    /** The MCP service, or `null` when `options.mcp` was omitted. */
+    get mcp(): ApcoreMcpService | null;
+    /** The CLI service, or `null` when `options.cli` was omitted. */
+    get cli(): ApcoreCliService | null;
+    /** The A2A service, or `null` when `options.a2a` was omitted. */
+    get a2a(): ApcoreA2aService | null;
+    /**
+     * Load a YAML bindings file and register its entries.
+     *
+     * @param filePath - Path to the YAML file. Defaults to `options.bindings`.
+     * @param resolveTarget - Resolves each entry's `target` to a live handler.
+     */
+    loadBindings(filePath?: string, resolveTarget?: TargetResolver): Promise<string[]>;
+    /**
+     * Mount the MCP endpoint into the Hono app so one port serves both HTTP and
+     * MCP. Node runtime only — see {@link mountMcpEndpoint}.
+     *
+     * @throws {Error} When the instance was created without `options.mcp`.
+     */
+    mountMcp(app: MountableApp, options?: MountMcpOptions): Promise<McpApp>;
+    /**
+     * Convert the registered modules to OpenAI-compatible tool definitions.
+     *
+     * @throws {Error} When the instance was created without `options.mcp`.
+     */
+    toOpenaiTools(options?: {
+        embedAnnotations?: boolean;
+        strict?: boolean;
+        tags?: string[];
+        prefix?: string;
+    }): Promise<unknown[]>;
+    /** Shut down the MCP and A2A surfaces. */
+    close(): Promise<void>;
+    protected loadConfiguredBindings(): Promise<void>;
+    protected startSurfaces(): Promise<void>;
+}
+/**
+ * Create a Node {@link HonoApcore} instance.
+ *
+ * Sugar for `new HonoApcore(options)`, matching the `createX()` style the
+ * Hono ecosystem uses.
+ */
+export declare function createApcore(options?: HonoApcoreOptions): HonoApcore;
+//# sourceMappingURL=apcore.node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore.node.d.ts","sourceRoot":"","sources":["../../src/core/apcore.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;gBAEnC,OAAO,GAAE,iBAAsB;IAqB3C,OAAO,KAAK,WAAW,GAEtB;IAED,iEAAiE;IACjE,IAAI,GAAG,IAAI,gBAAgB,GAAG,IAAI,CAEjC;IAED,iEAAiE;IACjE,IAAI,GAAG,IAAI,gBAAgB,GAAG,IAAI,CAEjC;IAED,iEAAiE;IACjE,IAAI,GAAG,IAAI,gBAAgB,GAAG,IAAI,CAEjC;IAED;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMxF;;;;;OAKG;IACG,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAejF;;;;OAIG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE;QAC5B,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,OAAO,CAAC,OAAO,EAAE,CAAC;IAStB,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;cAKH,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;cAMvC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CASxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAExE"}

package/dist/core/apcore.node.js

@@ -0,0 +1,120 @@
+import { HonoApcore as HonoApcoreCore } from './apcore.js';
+import { ApcoreMcpService } from '../mcp/apcore-mcp.service.js';
+import { ApcoreCliService } from '../cli/apcore-cli.service.js';
+import { ApcoreA2aService } from '../a2a/apcore-a2a.service.js';
+import { ApBindingLoader } from '../bridge/binding-loader.js';
+import { mountMcp as mountMcpEndpoint } from '../mcp/mount.js';
+import { toMcpTransport } from '../config.js';
+/**
+ * Node entry for {@link HonoApcore}.
+ *
+ * Adds the optional MCP, CLI, and A2A surfaces plus YAML bindings loaded from
+ * disk. The edge entry exposes the same core behaviour without these
+ * Node-only dependencies.
+ */
+export class HonoApcore extends HonoApcoreCore {
+    _mcp;
+    _cli;
+    _a2a;
+    constructor(options = {}) {
+        super(options);
+        this._mcp = options.mcp
+            ? new ApcoreMcpService(this.registry, this.executor, {
+                ...options.mcp,
+                // The APCORE_* settings supply the defaults; explicit config wins.
+                transport: options.mcp.transport ?? toMcpTransport(this.settings.transport),
+                host: options.mcp.host ?? this.settings.host,
+                port: options.mcp.port ?? this.settings.port,
+            })
+            : null;
+        this._cli = options.cli
+            ? new ApcoreCliService(this.registry, options.cli, this.executor)
+            : null;
+        this._a2a = options.a2a
+            ? new ApcoreA2aService(this.registry, this.executor, options.a2a)
+            : null;
+    }
+    get nodeOptions() {
+        return this.options;
+    }
+    /** The MCP service, or `null` when `options.mcp` was omitted. */
+    get mcp() {
+        return this._mcp;
+    }
+    /** The CLI service, or `null` when `options.cli` was omitted. */
+    get cli() {
+        return this._cli;
+    }
+    /** The A2A service, or `null` when `options.a2a` was omitted. */
+    get a2a() {
+        return this._a2a;
+    }
+    /**
+     * Load a YAML bindings file and register its entries.
+     *
+     * @param filePath - Path to the YAML file. Defaults to `options.bindings`.
+     * @param resolveTarget - Resolves each entry's `target` to a live handler.
+     */
+    async loadBindings(filePath, resolveTarget) {
+        const path = filePath ?? this.nodeOptions.bindings;
+        if (!path)
+            return [];
+        return new ApBindingLoader(this.registry, resolveTarget).loadFromFile(path);
+    }
+    /**
+     * Mount the MCP endpoint into the Hono app so one port serves both HTTP and
+     * MCP. Node runtime only — see {@link mountMcpEndpoint}.
+     *
+     * @throws {Error} When the instance was created without `options.mcp`.
+     */
+    async mountMcp(app, options = {}) {
+        if (!this._mcp) {
+            throw new Error('mountMcp() requires the MCP surface. Pass an `mcp` block to createApcore().');
+        }
+        return mountMcpEndpoint(app, this._mcp, {
+            explorer: this.nodeOptions.mcp?.explorer,
+            explorerPrefix: this.nodeOptions.mcp?.explorerPrefix,
+            allowExecute: this.nodeOptions.mcp?.allowExecute,
+            ...options,
+        });
+    }
+    /**
+     * Convert the registered modules to OpenAI-compatible tool definitions.
+     *
+     * @throws {Error} When the instance was created without `options.mcp`.
+     */
+    async toOpenaiTools(options) {
+        if (!this._mcp) {
+            throw new Error('toOpenaiTools() requires the MCP surface. Pass an `mcp` block to createApcore().');
+        }
+        return this._mcp.toOpenaiTools(options);
+    }
+    /** Shut down the MCP and A2A surfaces. */
+    async close() {
+        await this._mcp?.stop();
+        this._a2a?.stop();
+    }
+    async loadConfiguredBindings() {
+        if (this.nodeOptions.bindings) {
+            await this.loadBindings();
+        }
+    }
+    async startSurfaces() {
+        if (this._a2a && this.nodeOptions.a2a?.port !== undefined) {
+            await this._a2a.start();
+        }
+        if (this._mcp && this.nodeOptions.mcp?.transport) {
+            await this._mcp.start();
+        }
+    }
+}
+/**
+ * Create a Node {@link HonoApcore} instance.
+ *
+ * Sugar for `new HonoApcore(options)`, matching the `createX()` style the
+ * Hono ecosystem uses.
+ */
+export function createApcore(options = {}) {
+    return new HonoApcore(options);
+}
+//# sourceMappingURL=apcore.node.js.map

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

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

package/dist/core/executor.d.ts

@@ -1,4 +1,5 @@
-import type { Context, Executor, PreflightResult } from 'apcore-js';
+import { Executor } from 'apcore-js';
+import type { Context, ExecutionStrategy, PreflightResult, StepMiddleware } from 'apcore-js';
 /**
  * Thin wrapper around the upstream apcore-js `Executor`.
  *
@@ -7,9 +8,16 @@ import type { Context, Executor, PreflightResult } from 'apcore-js';
  */
 export declare class ApcoreExecutor {
     private readonly executor;
-    constructor(executor: Executor);
+    private readonly executorOptions?;
+    constructor(executor: Executor, executorOptions?: Omit<ConstructorParameters<typeof Executor>[0], "strategy"> | undefined);
     /** The underlying apcore-js `Executor`. */
     get raw(): Executor;
+    /** Observe pipeline steps using the SDK's step middleware hooks. */
+    addStepMiddleware(middleware: StepMiddleware): this;
+    /** Execute with an SDK pipeline trace, optionally selecting a per-call strategy. */
+    callWithTrace(moduleId: string, inputs?: Record<string, unknown> | null, context?: Context | null, options?: {
+        strategy?: ExecutionStrategy | string | null;
+    } | null): ReturnType<Executor['callWithTrace']>;
     /**
      * Execute a module by ID.
      *

package/dist/core/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEpE;;;;;GAKG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAE/C,2CAA2C;IAC3C,IAAI,GAAG,IAAI,QAAQ,CAElB;IAED;;;;;;OAMG;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;;;OAGG;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;;;OAGG;IACH,QAAQ,CACN,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,eAAe,CAAC;CAG5B"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE7F;;;;;GAKG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBADhB,QAAQ,EAAE,QAAQ,EAClB,eAAe,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,YAAA;IAGhG,2CAA2C;IAC3C,IAAI,GAAG,IAAI,QAAQ,CAElB;IAED,oEAAoE;IACpE,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAKnD,oFAAoF;IACpF,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACvC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,EACxB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,GAChE,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAiBxC;;;;;;OAMG;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;;;OAGG;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;;;OAGG;IACH,QAAQ,CACN,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,eAAe,CAAC;CAG5B"}

package/dist/core/executor.js

@@ -1,3 +1,4 @@
+import { Executor } from 'apcore-js';
 /**
  * Thin wrapper around the upstream apcore-js `Executor`.
  *
@@ -6,13 +7,37 @@
  */
 export class ApcoreExecutor {
     executor;
-    constructor(executor) {
+    executorOptions;
+    constructor(executor, executorOptions) {
         this.executor = executor;
+        this.executorOptions = executorOptions;
     }
     /** The underlying apcore-js `Executor`. */
     get raw() {
         return this.executor;
     }
+    /** Observe pipeline steps using the SDK's step middleware hooks. */
+    addStepMiddleware(middleware) {
+        this.executor.addStepMiddleware(middleware);
+        return this;
+    }
+    /** Execute with an SDK pipeline trace, optionally selecting a per-call strategy. */
+    callWithTrace(moduleId, inputs, context, options) {
+        const strategy = typeof options?.strategy === 'string'
+            ? new Executor({
+                ...this.executorOptions,
+                registry: this.executor.registry,
+                middlewares: this.executor.middlewares,
+                // The running executor binds its current providers to these gates.
+                // Seeding startup providers here would revive a cleared policy.
+                acl: null,
+                approvalHandler: null,
+                policy: null,
+                strategy: options.strategy,
+            }).currentStrategy
+            : options?.strategy;
+        return this.executor.callWithTrace(moduleId, inputs ?? {}, context, { strategy });
+    }
     /**
      * Execute a module by ID.
      *

package/dist/core/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD,2CAA2C;IAC3C,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,QAAQ,CACN,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;CACF"}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAEN;IACA;IAFnB,YACmB,QAAkB,EAClB,eAA6E;QAD7E,aAAQ,GAAR,QAAQ,CAAU;QAClB,oBAAe,GAAf,eAAe,CAA8D;IAC7F,CAAC;IAEJ,2CAA2C;IAC3C,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,oEAAoE;IACpE,iBAAiB,CAAC,UAA0B;QAC1C,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oFAAoF;IACpF,aAAa,CACX,QAAgB,EAChB,MAAuC,EACvC,OAAwB,EACxB,OAAiE;QAEjE,MAAM,QAAQ,GAAG,OAAO,OAAO,EAAE,QAAQ,KAAK,QAAQ;YACpD,CAAC,CAAC,IAAI,QAAQ,CAAC;gBACX,GAAG,IAAI,CAAC,eAAe;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;gBAChC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW;gBACtC,mEAAmE;gBACnE,gEAAgE;gBAChE,GAAG,EAAE,IAAI;gBACT,eAAe,EAAE,IAAI;gBACrB,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC,CAAC,eAAe;YACpB,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,QAAQ,CACN,QAAgB,EAChB,MAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/core/middleware.d.ts

@@ -2,7 +2,7 @@ import type { Context as HonoContext, MiddlewareHandler } from 'hono';
 import type { Context as ApcoreContext } from 'apcore-js';
 import { HonoContextFactory } from '../context/hono-context.factory.js';
 import type { HonoApcore } from './apcore.js';
-import type { HonoApcoreOptions } from '../types.js';
+import type { HonoApcoreCoreOptions } from '../types.js';
 declare module 'hono' {
     interface ContextVariableMap {
         /** The {@link HonoApcore} instance installed by the `apcore()` middleware. */
@@ -45,7 +45,7 @@ export interface ApcoreMiddlewareOptions {
  *   instance when you need to register tools or mount MCP.
  */
 export declare function apcore(instance: HonoApcore, options?: ApcoreMiddlewareOptions): MiddlewareHandler;
-export declare function apcore(options?: HonoApcoreOptions & ApcoreMiddlewareOptions): MiddlewareHandler;
+export declare function apcore(options?: HonoApcoreCoreOptions & ApcoreMiddlewareOptions): MiddlewareHandler;
 /**
  * Read the {@link HonoApcore} instance the `apcore()` middleware installed.
  *

package/dist/core/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/core/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAkB;QAC1B,8EAA8E;QAC9E,MAAM,EAAE,UAAU,CAAC;QACnB,0EAA0E;QAC1E,aAAa,EAAE,aAAa,CAAC;KAC9B;CACF;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,UAAU,EACpB,OAAO,CAAC,EAAE,uBAAuB,GAChC,iBAAiB,CAAC;AACrB,wBAAgB,MAAM,CACpB,OAAO,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,GACpD,iBAAiB,CAAC;AAsCrB;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,GAAG,UAAU,CAQpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,GAAG,aAAa,CAQ9D"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/core/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAkB;QAC1B,8EAA8E;QAC9E,MAAM,EAAE,UAAU,CAAC;QACnB,0EAA0E;QAC1E,aAAa,EAAE,aAAa,CAAC;KAC9B;CACF;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,UAAU,EACpB,OAAO,CAAC,EAAE,uBAAuB,GAChC,iBAAiB,CAAC;AACrB,wBAAgB,MAAM,CACpB,OAAO,CAAC,EAAE,qBAAqB,GAAG,uBAAuB,GACxD,iBAAiB,CAAC;AAsCrB;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,GAAG,UAAU,CAQpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,GAAG,aAAa,CAQ9D"}

package/dist/core/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/core/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAsDxE,MAAM,UAAU,MAAM,CACpB,iBAA8E,EAC9E,YAAsC;IAEtC,wEAAwE;IACxE,8DAA8D;IAC9D,MAAM,UAAU,GACd,iBAAiB,KAAK,SAAS;QAC/B,OAAQ,iBAAgC,CAAC,YAAY,KAAK,UAAU,CAAC;IAEvE,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAE,iBAAgC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAEjD,CAAC;IAEd,IAAI,QAAQ,GAA2B,QAAQ,CAAC;IAChD,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,kBAAkB,EAAE,CAAC;IAC3E,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IAElD,OAAO,KAAK,UAAU,gBAAgB,CAAC,CAAC,EAAE,IAAI;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACzD,QAAQ,GAAG,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACnC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEvB,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,CAAC,CAAC,GAAG,CAAC,kBAAkB,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,CAAc;IACtC,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAc;IAC7C,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/core/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAsDxE,MAAM,UAAU,MAAM,CACpB,iBAAkF,EAClF,YAAsC;IAEtC,wEAAwE;IACxE,8DAA8D;IAC9D,MAAM,UAAU,GACd,iBAAiB,KAAK,SAAS;QAC/B,OAAQ,iBAAgC,CAAC,YAAY,KAAK,UAAU,CAAC;IAEvE,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAE,iBAAgC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAEjD,CAAC;IAEd,IAAI,QAAQ,GAA2B,QAAQ,CAAC;IAChD,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,kBAAkB,EAAE,CAAC;IAC3E,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IAElD,OAAO,KAAK,UAAU,gBAAgB,CAAC,CAAC,EAAE,IAAI;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACzD,QAAQ,GAAG,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACnC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEvB,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,CAAC,CAAC,GAAG,CAAC,kBAAkB,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,CAAc;IACtC,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAc;IAC7C,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/registry.d.ts

@@ -1,5 +1,5 @@
 import type { ModuleDescriptor, Registry } from 'apcore-js';
-import type { ScannedModule } from 'apcore-toolkit';
+import type { ScannedModule } from 'apcore-toolkit/browser';
 import type { ApToolDefinition, RegisterMethodOptions, RegisterObjectOptions } from '../types.js';
 import type { BoundExecuteFn } from '../utils/module-factory.js';
 import type { ToolConversionOptions } from '../tools/define-tool.js';

package/dist/core/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AA+BrE;;;;;;GAMG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAM/C,2CAA2C;IAC3C,IAAI,GAAG,IAAI,QAAQ,CAElB;IAMK,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,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI9E,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAI3B,IAAI,KAAK,IAAI,MAAM,CAElB;IAMD;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAkBvD;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKxD,+EAA+E;IAC/E,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;IAalF;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtF;;;;OAIG;IACG,YAAY,CAChB,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC;IAKlB,iEAAiE;IAC3D,aAAa,CACjB,KAAK,EAAE,gBAAgB,EAAE,EACzB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC;IAQpB;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4CrE;;;;;;;;OAQG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAyCxE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AA+BrE;;;;;;GAMG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAM/C,2CAA2C;IAC3C,IAAI,GAAG,IAAI,QAAQ,CAElB;IAMK,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,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI9E,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAI3B,IAAI,KAAK,IAAI,MAAM,CAElB;IAMD;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAqBvD;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKxD,+EAA+E;IAC/E,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;IAalF;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtF;;;;OAIG;IACG,YAAY,CAChB,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC;IAKlB,iEAAiE;IAC3D,aAAa,CACjB,KAAK,EAAE,gBAAgB,EAAE,EACzB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC;IAQpB;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4CrE;;;;;;;;OAQG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAyCxE"}

package/dist/core/registry.js

@@ -1,4 +1,4 @@
-import { createScannedModule, moduleToDict, modulesToDicts } from 'apcore-toolkit';
+import { createScannedModule, moduleToDict, modulesToDicts } from 'apcore-toolkit/browser';
 import { generateModuleId, normalizeName, normalizeMethodName } from '../utils/id-generator.js';
 import { EMPTY_OBJECT_SCHEMA, normalizeResult, scannedModuleToFunctionModule, toModuleAnnotations, } from '../utils/module-factory.js';
 import { toolToScannedModule } from '../tools/define-tool.js';
@@ -101,6 +101,9 @@ export class ApcoreRegistry {
             documentation: def.documentation ?? null,
             examples: (def.examples ?? []),
             metadata: def.metadata ?? {},
+            version: def.version,
+            display: this.registry.get(moduleId)
+                ?.display ?? null,
         });
     }
     /**