hono-apcore 0.1.0

package/dist/core/middleware.d.ts

@@ -0,0 +1,61 @@
+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';
+declare module 'hono' {
+    interface ContextVariableMap {
+        /** The {@link HonoApcore} instance installed by the `apcore()` middleware. */
+        apcore: HonoApcore;
+        /** The per-request apcore `Context` (identity, trace, correlation id). */
+        apcoreContext: ApcoreContext;
+    }
+}
+/** Options for the {@link apcore} middleware. */
+export interface ApcoreMiddlewareOptions {
+    /** Factory used to build the per-request apcore `Context`. */
+    contextFactory?: HonoContextFactory;
+    /**
+     * Skip building a per-request `Context`. Set this when a route never calls
+     * modules through the executor and you want to shave the work.
+     */
+    skipContext?: boolean;
+}
+/**
+ * Hono middleware that puts the apcore instance and a per-request apcore
+ * `Context` on the Hono context.
+ *
+ * Downstream handlers read them with {@link getApcore} and
+ * {@link getApcoreContext} — or, since the variable map is augmented,
+ * directly via `c.get('apcore')`.
+ *
+ * @example
+ * ```ts
+ * const ap = createApcore({ mcp: { explorer: true } });
+ * app.use('*', apcore(ap));
+ *
+ * app.get('/orders', async (c) => {
+ *   const result = await getApcore(c).executor.call('orders.list', {}, getApcoreContext(c));
+ *   return c.json(result);
+ * });
+ * ```
+ *
+ * @param instance - An existing {@link HonoApcore}, or options to build one.
+ *   Passing options is a convenience for simple apps; keep a reference to the
+ *   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;
+/**
+ * Read the {@link HonoApcore} instance the `apcore()` middleware installed.
+ *
+ * @throws {Error} When the middleware has not run for this request.
+ */
+export declare function getApcore(c: HonoContext): HonoApcore;
+/**
+ * Read the per-request apcore `Context` the `apcore()` middleware built.
+ *
+ * @throws {Error} When the middleware has not run, or ran with `skipContext`.
+ */
+export declare function getApcoreContext(c: HonoContext): ApcoreContext;
+//# sourceMappingURL=middleware.d.ts.map

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

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

package/dist/core/middleware.js

@@ -0,0 +1,51 @@
+import { APCORE_CONTEXT_VAR, APCORE_VAR } from '../constants.js';
+import { HonoContextFactory } from '../context/hono-context.factory.js';
+export function apcore(instanceOrOptions, maybeOptions) {
+    // Resolved lazily so this module never imports the class eagerly — that
+    // would make apcore.ts and middleware.ts a hard import cycle.
+    const isInstance = instanceOrOptions !== undefined &&
+        typeof instanceOrOptions.registerTool === 'function';
+    const instance = isInstance ? instanceOrOptions : undefined;
+    const options = (isInstance ? maybeOptions : instanceOrOptions);
+    let resolved = instance;
+    const contextFactory = options?.contextFactory ?? new HonoContextFactory();
+    const skipContext = options?.skipContext ?? false;
+    return async function apcoreMiddleware(c, next) {
+        if (!resolved) {
+            const { HonoApcore: Ctor } = await import('./apcore.js');
+            resolved = new Ctor(options ?? {});
+            await resolved.init();
+        }
+        await resolved.ready();
+        c.set(APCORE_VAR, resolved);
+        if (!skipContext) {
+            c.set(APCORE_CONTEXT_VAR, contextFactory.createContext(c));
+        }
+        await next();
+    };
+}
+/**
+ * Read the {@link HonoApcore} instance the `apcore()` middleware installed.
+ *
+ * @throws {Error} When the middleware has not run for this request.
+ */
+export function getApcore(c) {
+    const instance = c.get(APCORE_VAR);
+    if (!instance) {
+        throw new Error('No apcore instance on the Hono context. Install the apcore() middleware before this route.');
+    }
+    return instance;
+}
+/**
+ * Read the per-request apcore `Context` the `apcore()` middleware built.
+ *
+ * @throws {Error} When the middleware has not run, or ran with `skipContext`.
+ */
+export function getApcoreContext(c) {
+    const context = c.get(APCORE_CONTEXT_VAR);
+    if (!context) {
+        throw new Error('No apcore Context on the Hono context. Install the apcore() middleware without skipContext.');
+    }
+    return context;
+}
+//# sourceMappingURL=middleware.js.map

package/dist/core/middleware.js.map

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

package/dist/core/registry.d.ts

@@ -0,0 +1,79 @@
+import type { ModuleDescriptor, Registry } from 'apcore-js';
+import type { ScannedModule } from 'apcore-toolkit';
+import type { ApToolDefinition, RegisterMethodOptions, RegisterObjectOptions } from '../types.js';
+import type { BoundExecuteFn } from '../utils/module-factory.js';
+import type { ToolConversionOptions } from '../tools/define-tool.js';
+/**
+ * Thin wrapper around the upstream apcore-js `Registry`.
+ *
+ * Delegates the core operations and adds the registration conveniences a
+ * Hono app wants: registering a {@link ApToolDefinition}, a single method of
+ * a service object, or every method at once.
+ */
+export declare class ApcoreRegistry {
+    private readonly registry;
+    constructor(registry: Registry);
+    /** The underlying apcore-js `Registry`. */
+    get raw(): Registry;
+    register(moduleId: string, module: unknown): Promise<void>;
+    unregister(moduleId: string): boolean;
+    get(moduleId: string): unknown | null;
+    has(moduleId: string): boolean;
+    list(options?: {
+        tags?: string[];
+        prefix?: string;
+    }): string[];
+    getDefinition(moduleId: string): ModuleDescriptor | null;
+    on(event: string, callback: (moduleId: string, module: unknown) => void): void;
+    discover(): Promise<number>;
+    get count(): number;
+    /**
+     * Convert a registered module's descriptor into a toolkit `ScannedModule`.
+     *
+     * Returns `null` when the module is not registered.
+     */
+    toScannedModule(moduleId: string): ScannedModule | null;
+    /**
+     * Serialise one registered module to a snake_case dictionary via
+     * apcore-toolkit's `moduleToDict()`. Returns `null` when not found.
+     */
+    toDict(moduleId: string): Record<string, unknown> | null;
+    /** Serialise every registered module (optionally filtered) to dictionaries. */
+    toDicts(options?: {
+        tags?: string[];
+        prefix?: string;
+    }): Record<string, unknown>[];
+    /**
+     * Register a scanned module together with its bound execute function.
+     *
+     * The lowest-level entry point — the tool registrar, the route scanner, and
+     * the YAML binding loader all funnel through here.
+     */
+    registerScanned(module: ScannedModule, execute: BoundExecuteFn): Promise<string>;
+    /**
+     * Register a single {@link ApToolDefinition}.
+     *
+     * @returns The module ID it was registered under.
+     */
+    registerTool(tool: ApToolDefinition, options?: ToolConversionOptions): Promise<string>;
+    /** Register several tool definitions, preserving their order. */
+    registerTools(tools: ApToolDefinition[], options?: ToolConversionOptions): Promise<string[]>;
+    /**
+     * Register one method of a service object as a module.
+     *
+     * @returns The module ID it was registered under.
+     * @throws {Error} When `method` is not a function on `instance`.
+     */
+    registerMethod(options: RegisterMethodOptions): Promise<string>;
+    /**
+     * Register several — or every — method of a service object.
+     *
+     * With `methods: '*'`, public methods are discovered by walking the
+     * prototype chain and own enumerable properties, minus anything in
+     * `exclude`.
+     *
+     * @returns The module IDs that were registered.
+     */
+    registerObject(options: RegisterObjectOptions): Promise<string[]>;
+}
+//# sourceMappingURL=registry.d.ts.map

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

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

package/dist/core/registry.js

@@ -0,0 +1,218 @@
+import { createScannedModule, moduleToDict, modulesToDicts } from 'apcore-toolkit';
+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';
+/**
+ * Collect every own method name along an object's prototype chain, stopping
+ * before `Object.prototype`. `constructor` is excluded.
+ *
+ * Own enumerable function-valued properties are included too, so object
+ * literals of arrow functions register as readily as class instances.
+ */
+function getAllMethodNames(instance) {
+    const methods = new Set();
+    for (const [name, value] of Object.entries(instance)) {
+        if (typeof value === 'function')
+            methods.add(name);
+    }
+    let proto = Object.getPrototypeOf(instance);
+    while (proto && proto !== Object.prototype) {
+        for (const name of Object.getOwnPropertyNames(proto)) {
+            if (name === 'constructor')
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(proto, name);
+            if (descriptor && typeof descriptor.value === 'function') {
+                methods.add(name);
+            }
+        }
+        proto = Object.getPrototypeOf(proto);
+    }
+    return [...methods];
+}
+/**
+ * Thin wrapper around the upstream apcore-js `Registry`.
+ *
+ * Delegates the core operations and adds the registration conveniences a
+ * Hono app wants: registering a {@link ApToolDefinition}, a single method of
+ * a service object, or every method at once.
+ */
+export class ApcoreRegistry {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    // -------------------------------------------------------------------------
+    // Raw access
+    // -------------------------------------------------------------------------
+    /** The underlying apcore-js `Registry`. */
+    get raw() {
+        return this.registry;
+    }
+    // -------------------------------------------------------------------------
+    // Delegated operations
+    // -------------------------------------------------------------------------
+    async register(moduleId, module) {
+        await this.registry.register(moduleId, module);
+    }
+    unregister(moduleId) {
+        return this.registry.unregister(moduleId);
+    }
+    get(moduleId) {
+        return this.registry.get(moduleId);
+    }
+    has(moduleId) {
+        return this.registry.has(moduleId);
+    }
+    list(options) {
+        return this.registry.list(options);
+    }
+    getDefinition(moduleId) {
+        return this.registry.getDefinition(moduleId);
+    }
+    on(event, callback) {
+        this.registry.on(event, callback);
+    }
+    discover() {
+        return this.registry.discover();
+    }
+    get count() {
+        return this.registry.count;
+    }
+    // -------------------------------------------------------------------------
+    // Serialisation helpers (via apcore-toolkit)
+    // -------------------------------------------------------------------------
+    /**
+     * Convert a registered module's descriptor into a toolkit `ScannedModule`.
+     *
+     * Returns `null` when the module is not registered.
+     */
+    toScannedModule(moduleId) {
+        const def = this.registry.getDefinition(moduleId);
+        if (!def)
+            return null;
+        return createScannedModule({
+            moduleId: def.moduleId,
+            description: def.description,
+            inputSchema: def.inputSchema,
+            outputSchema: def.outputSchema,
+            tags: def.tags ?? [],
+            target: moduleId,
+            annotations: def.annotations ?? null,
+            documentation: def.documentation ?? null,
+            examples: (def.examples ?? []),
+            metadata: def.metadata ?? {},
+        });
+    }
+    /**
+     * Serialise one registered module to a snake_case dictionary via
+     * apcore-toolkit's `moduleToDict()`. Returns `null` when not found.
+     */
+    toDict(moduleId) {
+        const scanned = this.toScannedModule(moduleId);
+        return scanned ? moduleToDict(scanned) : null;
+    }
+    /** Serialise every registered module (optionally filtered) to dictionaries. */
+    toDicts(options) {
+        const scanned = [];
+        for (const id of this.registry.list(options)) {
+            const module = this.toScannedModule(id);
+            if (module)
+                scanned.push(module);
+        }
+        return modulesToDicts(scanned);
+    }
+    // -------------------------------------------------------------------------
+    // Registration conveniences
+    // -------------------------------------------------------------------------
+    /**
+     * Register a scanned module together with its bound execute function.
+     *
+     * The lowest-level entry point — the tool registrar, the route scanner, and
+     * the YAML binding loader all funnel through here.
+     */
+    async registerScanned(module, execute) {
+        await this.registry.register(module.moduleId, scannedModuleToFunctionModule(module, execute));
+        return module.moduleId;
+    }
+    /**
+     * Register a single {@link ApToolDefinition}.
+     *
+     * @returns The module ID it was registered under.
+     */
+    async registerTool(tool, options) {
+        const { module, execute } = toolToScannedModule(tool, options);
+        return this.registerScanned(module, execute);
+    }
+    /** Register several tool definitions, preserving their order. */
+    async registerTools(tools, options) {
+        const ids = [];
+        for (const tool of tools) {
+            ids.push(await this.registerTool(tool, options));
+        }
+        return ids;
+    }
+    /**
+     * Register one method of a service object as a module.
+     *
+     * @returns The module ID it was registered under.
+     * @throws {Error} When `method` is not a function on `instance`.
+     */
+    async registerMethod(options) {
+        const { instance, method, description, id, inputSchema, outputSchema, annotations, tags, documentation, examples, } = options;
+        const fn = instance[method];
+        if (typeof fn !== 'function') {
+            throw new Error(`Method "${method}" does not exist on ${instance.constructor?.name ?? 'object'}`);
+        }
+        const objectName = instance.constructor?.name ?? 'object';
+        const moduleId = generateModuleId(objectName, method, true, id);
+        const scanned = createScannedModule({
+            moduleId,
+            description,
+            inputSchema: inputSchema ?? { ...EMPTY_OBJECT_SCHEMA },
+            outputSchema: outputSchema ?? { ...EMPTY_OBJECT_SCHEMA },
+            tags: tags ?? [],
+            target: `${objectName}.${method}`,
+            annotations: toModuleAnnotations(annotations),
+            documentation: documentation ?? null,
+            examples: examples ?? [],
+        });
+        const execute = async (inputs, context) => {
+            const raw = await fn.call(instance, inputs, context);
+            return normalizeResult(raw);
+        };
+        return this.registerScanned(scanned, execute);
+    }
+    /**
+     * Register several — or every — method of a service object.
+     *
+     * With `methods: '*'`, public methods are discovered by walking the
+     * prototype chain and own enumerable properties, minus anything in
+     * `exclude`.
+     *
+     * @returns The module IDs that were registered.
+     */
+    async registerObject(options) {
+        const { instance, description, methods, exclude = [], namespace, annotations, tags, methodOptions = {}, } = options;
+        const methodNames = (methods === '*' ? getAllMethodNames(instance) : methods).filter((name) => !exclude.includes(name));
+        const ns = namespace ?? normalizeName(instance.constructor?.name ?? 'object');
+        const registeredIds = [];
+        for (const methodName of methodNames) {
+            const perMethod = methodOptions[methodName] ?? {};
+            const moduleId = perMethod.id ?? `${ns}.${normalizeMethodName(methodName)}`;
+            registeredIds.push(await this.registerMethod({
+                instance,
+                method: methodName,
+                description: perMethod.description ?? description ?? methodName,
+                id: moduleId,
+                inputSchema: perMethod.inputSchema,
+                outputSchema: perMethod.outputSchema,
+                annotations: perMethod.annotations ?? annotations,
+                tags: perMethod.tags ?? tags,
+                documentation: perMethod.documentation,
+                examples: perMethod.examples,
+            }));
+        }
+        return registeredIds;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOnF,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,IAAI,OAAO,KAAK,KAAK,UAAU;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,KAAK,GAAkB,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAkB,CAAC;IAC5E,OAAO,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IAAI,IAAI,KAAK,aAAa;gBAAE,SAAS;YACrC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAChE,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAkB,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E,2CAA2C;IAC3C,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,4EAA4E;IAC5E,uBAAuB;IACvB,4EAA4E;IAE5E,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,MAAe;QAC9C,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,OAA8C;QACjD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,EAAE,CAAC,KAAa,EAAE,QAAqD;QACrE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,4EAA4E;IAC5E,6CAA6C;IAC7C,4EAA4E;IAE5E;;;;OAIG;IACH,eAAe,CAAC,QAAgB;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,OAAO,mBAAmB,CAAC;YACzB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAsC;YACvD,YAAY,EAAE,GAAG,CAAC,YAAuC;YACzD,IAAI,EAAG,GAAG,CAAC,IAAiB,IAAI,EAAE;YAClC,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;YACpC,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;YACxC,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAY;YACzC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,QAAgB;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;IAED,+EAA+E;IAC/E,OAAO,CAAC,OAA8C;QACpD,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YACxC,IAAI,MAAM;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,4EAA4E;IAC5E,4BAA4B;IAC5B,4EAA4E;IAE5E;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,MAAqB,EAAE,OAAuB;QAClE,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9F,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAChB,IAAsB,EACtB,OAA+B;QAE/B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,aAAa,CACjB,KAAyB,EACzB,OAA+B;QAE/B,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,MAAM,EACJ,QAAQ,EACR,MAAM,EACN,WAAW,EACX,EAAE,EACF,WAAW,EACX,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,aAAa,EACb,QAAQ,GACT,GAAG,OAAO,CAAC;QAEZ,MAAM,EAAE,GAAI,QAAoC,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,WAAW,MAAM,uBAAuB,QAAQ,CAAC,WAAW,EAAE,IAAI,IAAI,QAAQ,EAAE,CACjF,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,IAAI,IAAI,QAAQ,CAAC;QAC1D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAEhE,MAAM,OAAO,GAAG,mBAAmB,CAAC;YAClC,QAAQ;YACR,WAAW;YACX,WAAW,EAAG,WAAuC,IAAI,EAAE,GAAG,mBAAmB,EAAE;YACnF,YAAY,EAAG,YAAwC,IAAI,EAAE,GAAG,mBAAmB,EAAE;YACrF,IAAI,EAAE,IAAI,IAAI,EAAE;YAChB,MAAM,EAAE,GAAG,UAAU,IAAI,MAAM,EAAE;YACjC,WAAW,EAAE,mBAAmB,CAAC,WAAW,CAAC;YAC7C,aAAa,EAAE,aAAa,IAAI,IAAI;YACpC,QAAQ,EAAE,QAAQ,IAAI,EAAE;SACzB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAmB,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACxD,MAAM,GAAG,GAAG,MAAO,EAAsC,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC1F,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC,CAAC;QAEF,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,MAAM,EACJ,QAAQ,EACR,WAAW,EACX,OAAO,EACP,OAAO,GAAG,EAAE,EACZ,SAAS,EACT,WAAW,EACX,IAAI,EACJ,aAAa,GAAG,EAAE,GACnB,GAAG,OAAO,CAAC;QAEZ,MAAM,WAAW,GAAG,CAClB,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CACxD,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAE5C,MAAM,EAAE,GAAG,SAAS,IAAI,aAAa,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,IAAI,QAAQ,CAAC,CAAC;QAC9E,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,IAAI,GAAG,EAAE,IAAI,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;YAE5E,aAAa,CAAC,IAAI,CAChB,MAAM,IAAI,CAAC,cAAc,CAAC;gBACxB,QAAQ;gBACR,MAAM,EAAE,UAAU;gBAClB,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,WAAW,IAAI,UAAU;gBAC/D,EAAE,EAAE,QAAQ;gBACZ,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,YAAY,EAAE,SAAS,CAAC,YAAY;gBACpC,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,WAAW;gBACjD,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,IAAI;gBAC5B,aAAa,EAAE,SAAS,CAAC,aAAa;gBACtC,QAAQ,EAAE,SAAS,CAAC,QAAQ;aAC7B,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+export { HonoApcore, createApcore } from './core/apcore.js';
+export { ApcoreRegistry } from './core/registry.js';
+export { ApcoreExecutor } from './core/executor.js';
+export { apcore, getApcore, getApcoreContext } from './core/middleware.js';
+export type { ApcoreMiddlewareOptions } from './core/middleware.js';
+export { defineTool, defineToolset, resolveToolId, toolToScannedModule } from './tools/index.js';
+export type { ToolConversionOptions } from './tools/index.js';
+export { HonoRouteScanner, buildRequestUrl } from './scanners/index.js';
+export type { HonoAppLike } from './scanners/index.js';
+export { HonoContextFactory, defaultContextFactory, toHeaders } from './context/index.js';
+export type { HeaderSource } from './context/index.js';
+export { SchemaExtractor, SchemaExtractionError, defaultSchemaExtractor, TypeBoxAdapter, ZodAdapter, JsonSchemaAdapter, } from './schema/index.js';
+export type { SchemaAdapter } from './schema/index.js';
+export { ApcoreMcpService, mountMcp, toHonoHandler, RESPONSE_ALREADY_SENT } from './mcp/index.js';
+export type { McpApp, MountableApp } from './mcp/index.js';
+export { ApcoreCliService } from './cli/index.js';
+export { ApcoreA2aService } from './a2a/index.js';
+export { ApBindingLoader, resolverFromObjects } from './bridge/index.js';
+export type { TargetResolver } from './bridge/index.js';
+export { modulesToBindings, renderBindingsYaml, writeBindingsFile } from './output/index.js';
+export type { BindingRecord } from './output/index.js';
+export { loadSettings, toMcpTransport, APCORE_SETTING_DEFAULTS } from './config.js';
+export type { ApcoreSettings, EnvSource } from './config.js';
+export { toSnakeCase, normalizeName, normalizeMethodName, generateModuleId, applyModulePrefix, } from './utils/id-generator.js';
+export { scannedModuleToFunctionModule, toModuleAnnotations, normalizeResult, EMPTY_OBJECT_SCHEMA, } from './utils/module-factory.js';
+export type { BoundExecuteFn } from './utils/module-factory.js';
+export { APCORE_VAR, APCORE_CONTEXT_VAR, APCORE_ENV_PREFIX, DEFAULT_MCP_ENDPOINT, DEFAULT_EXPLORER_PREFIX, HONO_ALREADY_SENT_HEADER, } from './constants.js';
+export { Registry, Executor, Context as ApcoreRequestContext, createIdentity, ACL, Config, FunctionModule, TraceContext, registerSysModules, ACLDeniedError, ModuleError, ModuleNotFoundError, ModuleExecuteError, SchemaValidationError, ErrorCodes, DEFAULT_ANNOTATIONS, VERSION as APCORE_VERSION, } from 'apcore-js';
+export { BaseScanner, createScannedModule, cloneModule, filterModules, deduplicateIds, moduleToDict, modulesToDicts, annotationsToDict, formatModule, formatModules, toMarkdown, enrichSchemaDescriptions, resolveHttpVerb, generateSuggestedAlias, hasPathParams, extractPathParamNames, substitutePathParams, SCANNER_VERB_MAP, } from 'apcore-toolkit';
+export type { ScannedModule } from 'apcore-toolkit';
+export type { Identity } from 'apcore-js';
+export type { ModuleAnnotations, ModuleExample, Module, Context, ModuleDescriptor, PreflightResult, PreflightCheckResult, ValidationResult, ApToolAnnotations, ApToolExample, ApToolHandler, ApToolDefinition, ApToolsetOptions, HonoApcoreOptions, ApcoreMcpOptions, ApcoreCliOptions, ApcoreA2aOptions, MountMcpOptions, RouteScanOptions, RouteOverride, RegisterMethodOptions, RegisterObjectOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,71 @@
+// ---------------------------------------------------------------------------
+// Core
+// ---------------------------------------------------------------------------
+export { HonoApcore, createApcore } from './core/apcore.js';
+export { ApcoreRegistry } from './core/registry.js';
+export { ApcoreExecutor } from './core/executor.js';
+export { apcore, getApcore, getApcoreContext } from './core/middleware.js';
+// ---------------------------------------------------------------------------
+// Tools
+// ---------------------------------------------------------------------------
+export { defineTool, defineToolset, resolveToolId, toolToScannedModule } from './tools/index.js';
+// ---------------------------------------------------------------------------
+// Route scanning
+// ---------------------------------------------------------------------------
+export { HonoRouteScanner, buildRequestUrl } from './scanners/index.js';
+// ---------------------------------------------------------------------------
+// Context
+// ---------------------------------------------------------------------------
+export { HonoContextFactory, defaultContextFactory, toHeaders } from './context/index.js';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+export { SchemaExtractor, SchemaExtractionError, defaultSchemaExtractor, TypeBoxAdapter, ZodAdapter, JsonSchemaAdapter, } from './schema/index.js';
+// ---------------------------------------------------------------------------
+// MCP
+// ---------------------------------------------------------------------------
+export { ApcoreMcpService, mountMcp, toHonoHandler, RESPONSE_ALREADY_SENT } from './mcp/index.js';
+// ---------------------------------------------------------------------------
+// CLI
+// ---------------------------------------------------------------------------
+export { ApcoreCliService } from './cli/index.js';
+// ---------------------------------------------------------------------------
+// A2A
+// ---------------------------------------------------------------------------
+export { ApcoreA2aService } from './a2a/index.js';
+// ---------------------------------------------------------------------------
+// YAML bindings
+// ---------------------------------------------------------------------------
+export { ApBindingLoader, resolverFromObjects } from './bridge/index.js';
+// ---------------------------------------------------------------------------
+// Output writers
+// ---------------------------------------------------------------------------
+export { modulesToBindings, renderBindingsYaml, writeBindingsFile } from './output/index.js';
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+export { loadSettings, toMcpTransport, APCORE_SETTING_DEFAULTS } from './config.js';
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+export { toSnakeCase, normalizeName, normalizeMethodName, generateModuleId, applyModulePrefix, } from './utils/id-generator.js';
+export { scannedModuleToFunctionModule, toModuleAnnotations, normalizeResult, EMPTY_OBJECT_SCHEMA, } from './utils/module-factory.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export { APCORE_VAR, APCORE_CONTEXT_VAR, APCORE_ENV_PREFIX, DEFAULT_MCP_ENDPOINT, DEFAULT_EXPLORER_PREFIX, HONO_ALREADY_SENT_HEADER, } from './constants.js';
+// ---------------------------------------------------------------------------
+// apcore-js re-exports
+//
+// The core SDK is a hard dependency, so these are always importable straight
+// from `hono-apcore`. The MCP, CLI, and A2A packages are *optional* peers and
+// are deliberately not re-exported — importing them eagerly would pull
+// `node:http` into edge builds. Import those symbols from `apcore-mcp`,
+// `apcore-cli`, and `apcore-a2a` directly.
+// ---------------------------------------------------------------------------
+export { Registry, Executor, Context as ApcoreRequestContext, createIdentity, ACL, Config, FunctionModule, TraceContext, registerSysModules, ACLDeniedError, ModuleError, ModuleNotFoundError, ModuleExecuteError, SchemaValidationError, ErrorCodes, DEFAULT_ANNOTATIONS, VERSION as APCORE_VERSION, } from 'apcore-js';
+// ---------------------------------------------------------------------------
+// apcore-toolkit re-exports (scanning and serialisation helpers)
+// ---------------------------------------------------------------------------
+export { BaseScanner, createScannedModule, cloneModule, filterModules, deduplicateIds, moduleToDict, modulesToDicts, annotationsToDict, formatModule, formatModules, toMarkdown, enrichSchemaDescriptions, resolveHttpVerb, generateSuggestedAlias, hasPathParams, extractPathParamNames, substitutePathParams, SCANNER_VERB_MAP, } from 'apcore-toolkit';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1,83 @@
+import type { ApcoreExecutor } from '../core/executor.js';
+import type { ApcoreRegistry } from '../core/registry.js';
+import type { ApcoreMcpOptions } from '../types.js';
+/**
+ * The embeddable MCP app returned by `apcore-mcp`'s `asyncServe()`.
+ *
+ * `handler` is a Node.js `(req, res)` function — see
+ * {@link mountMcp} for wiring it into a Hono app on the Node runtime.
+ */
+export interface McpApp {
+    handler: (req: unknown, res: unknown) => Promise<void>;
+    close: () => Promise<void>;
+}
+/**
+ * Manages the MCP (Model Context Protocol) server for a Hono app.
+ *
+ * `apcore-mcp` is an **optional** peer dependency and is loaded lazily, so
+ * importing `hono-apcore` stays safe on runtimes without `node:http`
+ * (Workers, Deno, Bun) as long as the MCP surface goes unused there.
+ *
+ * Two deployment shapes are supported:
+ *
+ * - **Standalone** — {@link start} runs an MCP server on its own port, next
+ *   to the Hono HTTP server. Configure `transport` to enable it.
+ * - **Embedded** — {@link asyncServe} returns a request handler that
+ *   {@link mountMcp} wires into the Hono app itself, so one port serves both.
+ */
+export declare class ApcoreMcpService {
+    private readonly registry;
+    private readonly executor;
+    private readonly options;
+    private _isRunning;
+    private _app;
+    constructor(registry: ApcoreRegistry, executor: ApcoreExecutor, options: ApcoreMcpOptions);
+    /** Whether a standalone MCP server has been started. */
+    get isRunning(): boolean;
+    /** The embedded MCP app, once {@link asyncServe} has built one. */
+    get app(): McpApp | null;
+    /** Number of tools exposed, honouring the module-level `tags` / `prefix`. */
+    get toolCount(): number;
+    /**
+     * Start a standalone MCP server using the configured transport.
+     *
+     * With `transport: 'stdio'` this occupies the process's stdio, so it is the
+     * right choice for a CLI-launched MCP server and the wrong one for a web
+     * process — use {@link asyncServe} there.
+     *
+     * @param overrides - Per-call option overrides, e.g. the flags the
+     *   `hono-apcore serve` command accepts.
+     */
+    start(overrides?: Partial<ApcoreMcpOptions>): Promise<void>;
+    /**
+     * Build an embeddable MCP request handler without starting a server.
+     *
+     * Repeated calls return the same app; call {@link stop} to tear it down.
+     *
+     * @param options - Per-call overrides for endpoint and Explorer settings.
+     */
+    asyncServe(options?: {
+        endpoint?: string;
+        explorer?: boolean;
+        explorerPrefix?: string;
+        allowExecute?: boolean;
+        dynamic?: boolean;
+    }): Promise<McpApp>;
+    /** Tear down the embedded MCP app and mark the service stopped. */
+    stop(): Promise<void>;
+    /** Stop, then start the standalone MCP server. */
+    restart(): Promise<void>;
+    /**
+     * Convert the registered modules to OpenAI-compatible tool definitions,
+     * ready to hand to a chat-completions `tools` parameter.
+     */
+    toOpenaiTools(options?: {
+        embedAnnotations?: boolean;
+        strict?: boolean;
+        tags?: string[];
+        prefix?: string;
+    }): Promise<unknown[]>;
+    /** Collect the defined values for `keys`, applying any option renames. */
+    private collectOptions;
+}
+//# sourceMappingURL=apcore-mcp.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-mcp.service.d.ts","sourceRoot":"","sources":["../../src/mcp/apcore-mcp.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AA+CD;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAuB;gBAGhB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,gBAAgB;IAO5C,wDAAwD;IACxD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,mEAAmE;IACnE,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAEvB;IAED,6EAA6E;IAC7E,IAAI,SAAS,IAAI,MAAM,CAKtB;IAMD;;;;;;;;;OASG;IACG,KAAK,CAAC,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrE;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BnB,mEAAmE;IAC7D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,kDAAkD;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;;OAGG;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;IAetB,0EAA0E;IAC1E,OAAO,CAAC,cAAc;CAevB"}