hono-apcore 0.1.0

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

@@ -0,0 +1,82 @@
+/**
+ * Manages the A2A (Agent-to-Agent) server that exposes the registered apcore
+ * modules as agent skills.
+ *
+ * `apcore-a2a` is an **optional** peer dependency, loaded lazily.
+ *
+ * - **Standalone** — set `port` and call {@link start}; the A2A server binds
+ *   its own port alongside the Hono HTTP server.
+ * - **Embedded** — {@link asyncServe} returns an Express-compatible app you
+ *   can mount behind a reverse proxy or inside a Node server.
+ */
+export class ApcoreA2aService {
+    registry;
+    executor;
+    options;
+    _isRunning = false;
+    constructor(registry, executor, options = {}) {
+        this.registry = registry;
+        this.executor = executor;
+        this.options = options;
+    }
+    /** Whether the standalone A2A server has been started. */
+    get isRunning() {
+        return this._isRunning;
+    }
+    /** Number of skills (modules) exposed to A2A clients. */
+    get skillCount() {
+        return this.registry.list().length;
+    }
+    /**
+     * Start a standalone A2A HTTP server with the configured options.
+     *
+     * Called automatically by {@link HonoApcore.init} when `port` is set.
+     */
+    async start() {
+        const { serve } = await import('apcore-a2a');
+        this._isRunning = true;
+        serve(this.executor.raw, this.serveOptions());
+    }
+    /**
+     * Build an embeddable A2A application without binding a port.
+     *
+     * @param overrides - Option overrides merged over the configured values.
+     */
+    async asyncServe(overrides) {
+        const { asyncServe } = await import('apcore-a2a');
+        return asyncServe(this.executor.raw, this.serveOptions(overrides));
+    }
+    /**
+     * Mark the service stopped. The underlying HTTP server owns its own
+     * lifecycle and shuts down with the process.
+     */
+    stop() {
+        this._isRunning = false;
+    }
+    serveOptions(overrides) {
+        const opts = { ...this.options, ...overrides };
+        const result = {
+            name: opts.name,
+            description: opts.description,
+            version: opts.version,
+            url: opts.url,
+            host: opts.host,
+            port: opts.port,
+            auth: opts.auth,
+            taskStore: opts.taskStore,
+            corsOrigins: opts.corsOrigins,
+            explorer: opts.explorer,
+            explorerPrefix: opts.explorerPrefix,
+            executionTimeout: opts.executionTimeout,
+            metrics: opts.metrics,
+            logLevel: opts.logLevel,
+            shutdownTimeout: opts.shutdownTimeout,
+        };
+        for (const key of Object.keys(result)) {
+            if (result[key] === undefined)
+                delete result[key];
+        }
+        return result;
+    }
+}
+//# 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":"AAIA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IAIR;IACA;IACA;IALX,UAAU,GAAG,KAAK,CAAC;IAE3B,YACmB,QAAwB,EACxB,QAAwB,EACxB,UAA4B,EAAE;QAF9B,aAAQ,GAAR,QAAQ,CAAgB;QACxB,aAAQ,GAAR,QAAQ,CAAgB;QACxB,YAAO,GAAP,OAAO,CAAuB;IAC9C,CAAC;IAEJ,0DAA0D;IAC1D,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,yDAAyD;IACzD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACtB,KAA0D,CACzD,IAAI,CAAC,QAAQ,CAAC,GAAG,EACjB,IAAI,CAAC,YAAY,EAAE,CACpB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,SAAqC;QACpD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAClD,OAAQ,UAAwE,CAC9E,IAAI,CAAC,QAAQ,CAAC,GAAG,EACjB,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAC7B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAEO,YAAY,CAAC,SAAqC;QACxD,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;QAC/C,MAAM,MAAM,GAA4B;YACtC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/a2a/index.d.ts

@@ -0,0 +1,2 @@
+export { ApcoreA2aService } from './apcore-a2a.service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/a2a/index.js

@@ -0,0 +1,2 @@
+export { ApcoreA2aService } from './apcore-a2a.service.js';
+//# sourceMappingURL=index.js.map

package/dist/a2a/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,45 @@
+import type { ApcoreRegistry } from '../core/registry.js';
+/**
+ * Resolves the `"Object.method"` target of a binding entry to a live handler.
+ *
+ * Returning `undefined` leaves the module registered but non-functional,
+ * which surfaces the missing wiring at call time rather than at boot.
+ */
+export type TargetResolver = (target: string) => ((inputs: Record<string, unknown>, context?: unknown) => unknown) | undefined;
+/**
+ * Builds a resolver over a map of named service objects.
+ *
+ * @example
+ * ```ts
+ * const loader = new ApBindingLoader(apcore.registry, resolverFromObjects({ TodoService: todo }));
+ * await loader.loadFromFile('./bindings.yaml');   // target: TodoService.list
+ * ```
+ */
+export declare function resolverFromObjects(objects: Record<string, object>): TargetResolver;
+/**
+ * Registers apcore modules declared in a YAML bindings file — the zero-code
+ * path for exposing existing functions as AI tools.
+ *
+ * Uses apcore-toolkit's `createScannedModule()` to build the standard
+ * intermediate, then hands it to {@link ApcoreRegistry.registerScanned}.
+ */
+export declare class ApBindingLoader {
+    private readonly registry;
+    private readonly resolveTarget?;
+    constructor(registry: ApcoreRegistry, resolveTarget?: TargetResolver | undefined);
+    /**
+     * Parse YAML describing bindings and register each entry.
+     *
+     * @param content - Raw YAML string.
+     * @returns The module IDs that were registered.
+     */
+    loadFromString(content: string): Promise<string[]>;
+    /**
+     * Read a YAML bindings file from disk and register its entries.
+     *
+     * @param filePath - Absolute or CWD-relative path to the YAML file.
+     * @returns The module IDs that were registered.
+     */
+    loadFromFile(filePath: string): Promise<string[]>;
+}
+//# sourceMappingURL=binding-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding-loader.d.ts","sourceRoot":"","sources":["../../src/bridge/binding-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA0B1D;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,MAAM,KACX,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;AAEnF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,CAcnF;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBADd,QAAQ,EAAE,cAAc,EACxB,aAAa,CAAC,EAAE,cAAc,YAAA;IAGjD;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkCxD;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAGxD"}

package/dist/bridge/binding-loader.js

@@ -0,0 +1,84 @@
+import { readFile } from 'node:fs/promises';
+import * as yaml from 'js-yaml';
+import { createScannedModule } from 'apcore-toolkit';
+import { EMPTY_OBJECT_SCHEMA, normalizeResult, toModuleAnnotations, } from '../utils/module-factory.js';
+/**
+ * Builds a resolver over a map of named service objects.
+ *
+ * @example
+ * ```ts
+ * const loader = new ApBindingLoader(apcore.registry, resolverFromObjects({ TodoService: todo }));
+ * await loader.loadFromFile('./bindings.yaml');   // target: TodoService.list
+ * ```
+ */
+export function resolverFromObjects(objects) {
+    return (target) => {
+        const [objectName, methodName] = target.split('.');
+        if (!objectName || !methodName)
+            return undefined;
+        const instance = objects[objectName];
+        if (!instance)
+            return undefined;
+        const fn = instance[methodName];
+        if (typeof fn !== 'function')
+            return undefined;
+        return (inputs, context) => fn.call(instance, inputs, context);
+    };
+}
+/**
+ * Registers apcore modules declared in a YAML bindings file — the zero-code
+ * path for exposing existing functions as AI tools.
+ *
+ * Uses apcore-toolkit's `createScannedModule()` to build the standard
+ * intermediate, then hands it to {@link ApcoreRegistry.registerScanned}.
+ */
+export class ApBindingLoader {
+    registry;
+    resolveTarget;
+    constructor(registry, resolveTarget) {
+        this.registry = registry;
+        this.resolveTarget = resolveTarget;
+    }
+    /**
+     * Parse YAML describing bindings and register each entry.
+     *
+     * @param content - Raw YAML string.
+     * @returns The module IDs that were registered.
+     */
+    async loadFromString(content) {
+        const parsed = (yaml.load(content) ?? {});
+        const bindings = parsed.bindings ?? [];
+        const ids = [];
+        for (const binding of bindings) {
+            const moduleId = binding.module_id;
+            const handler = this.resolveTarget?.(binding.target);
+            const execute = handler
+                ? async (inputs, context) => normalizeResult(await handler(inputs, context))
+                : async () => ({
+                    error: `No handler resolved for binding target "${binding.target}"`,
+                });
+            const scanned = createScannedModule({
+                moduleId,
+                description: binding.description,
+                inputSchema: binding.input_schema ?? { ...EMPTY_OBJECT_SCHEMA },
+                outputSchema: binding.output_schema ?? { ...EMPTY_OBJECT_SCHEMA },
+                tags: binding.tags ?? [],
+                target: binding.target,
+                annotations: toModuleAnnotations(binding.annotations),
+                documentation: binding.documentation ?? null,
+            });
+            ids.push(await this.registry.registerScanned(scanned, execute));
+        }
+        return ids;
+    }
+    /**
+     * Read a YAML bindings file from disk and register its entries.
+     *
+     * @param filePath - Absolute or CWD-relative path to the YAML file.
+     * @returns The module IDs that were registered.
+     */
+    async loadFromFile(filePath) {
+        return this.loadFromString(await readFile(filePath, 'utf-8'));
+    }
+}
+//# sourceMappingURL=binding-loader.js.map

package/dist/bridge/binding-loader.js.map

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

package/dist/bridge/index.d.ts

@@ -0,0 +1,3 @@
+export { ApBindingLoader, resolverFromObjects } from './binding-loader.js';
+export type { TargetResolver } from './binding-loader.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/bridge/index.js

@@ -0,0 +1,2 @@
+export { ApBindingLoader, resolverFromObjects } from './binding-loader.js';
+//# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,50 @@
+import type { ApcoreRegistry } from '../core/registry.js';
+import type { ApcoreCliOptions } from '../types.js';
+/**
+ * Exposes `apcore-cli` for a Hono app: build a Commander program whose
+ * commands are the app's registered apcore modules.
+ *
+ * `apcore-cli` is an **optional** peer dependency, loaded lazily — importing
+ * `hono-apcore` never pulls in a CLI stack you are not using.
+ *
+ * @example
+ * ```ts
+ * const cli = new ApcoreCliService(apcore.registry, { progName: 'my-app' });
+ * const program = await cli.createProgram();
+ * await cli.configureManHelp(program, 'my-app', '1.0.0', 'My Hono app');
+ * program.parse();
+ * ```
+ */
+export declare class ApcoreCliService {
+    private readonly registry;
+    private readonly options;
+    private configured;
+    constructor(registry: ApcoreRegistry, options?: ApcoreCliOptions);
+    /** Number of modules currently registered. */
+    get moduleCount(): number;
+    /**
+     * Build a Commander program exposing the registered modules.
+     *
+     * Built-in apcore options (`--input`, `--yes`, `--large-input`, `--format`)
+     * are hidden by default; `--help --verbose` at runtime — or `verboseHelp`
+     * in the options — reveals them.
+     *
+     * @param extensionsDir - Overrides the configured extensions directory.
+     */
+    createProgram(extensionsDir?: string): Promise<unknown>;
+    /**
+     * Add `--help --man` support to an existing Commander program, so
+     * `<prog> --help --man` writes a full man page to stdout.
+     */
+    configureManHelp(program: unknown, progName: string, version: string, description?: string, docsUrl?: string): Promise<void>;
+    /** Update the docs URL used by man pages and per-command help output. */
+    setDocsUrl(url: string | null): Promise<void>;
+    /** Toggle verbose help — when on, `--help` lists the built-in apcore options. */
+    setVerboseHelp(verbose: boolean): Promise<void>;
+    /**
+     * Apply the module-level `docsUrl` / `verboseHelp` defaults once, the first
+     * time a program is built.
+     */
+    private applyModuleOptions;
+}
+//# sourceMappingURL=apcore-cli.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-cli.service.d.ts","sourceRoot":"","sources":["../../src/cli/apcore-cli.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,UAAU,CAAS;gBAGR,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,gBAAqB;IAGjD,8CAA8C;IAC9C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;;;;;;OAQG;IACG,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB7D;;;OAGG;IACG,gBAAgB,CACpB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAahB,yEAAyE;IACnE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,iFAAiF;IAC3E,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD;;;OAGG;YACW,kBAAkB;CAWjC"}

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

@@ -0,0 +1,76 @@
+/**
+ * Exposes `apcore-cli` for a Hono app: build a Commander program whose
+ * commands are the app's registered apcore modules.
+ *
+ * `apcore-cli` is an **optional** peer dependency, loaded lazily — importing
+ * `hono-apcore` never pulls in a CLI stack you are not using.
+ *
+ * @example
+ * ```ts
+ * const cli = new ApcoreCliService(apcore.registry, { progName: 'my-app' });
+ * const program = await cli.createProgram();
+ * await cli.configureManHelp(program, 'my-app', '1.0.0', 'My Hono app');
+ * program.parse();
+ * ```
+ */
+export class ApcoreCliService {
+    registry;
+    options;
+    configured = false;
+    constructor(registry, options = {}) {
+        this.registry = registry;
+        this.options = options;
+    }
+    /** Number of modules currently registered. */
+    get moduleCount() {
+        return this.registry.count;
+    }
+    /**
+     * Build a Commander program exposing the registered modules.
+     *
+     * Built-in apcore options (`--input`, `--yes`, `--large-input`, `--format`)
+     * are hidden by default; `--help --verbose` at runtime — or `verboseHelp`
+     * in the options — reveals them.
+     *
+     * @param extensionsDir - Overrides the configured extensions directory.
+     */
+    async createProgram(extensionsDir) {
+        const cli = await import('apcore-cli');
+        await this.applyModuleOptions();
+        return cli.createCli(extensionsDir ?? this.options.extensionsDir, this.options.progName, this.options.verboseHelp ?? false);
+    }
+    /**
+     * Add `--help --man` support to an existing Commander program, so
+     * `<prog> --help --man` writes a full man page to stdout.
+     */
+    async configureManHelp(program, progName, version, description, docsUrl) {
+        const cli = await import('apcore-cli');
+        cli.configureManHelp(program, progName, version, description, docsUrl ?? this.options.docsUrl ?? undefined);
+    }
+    /** Update the docs URL used by man pages and per-command help output. */
+    async setDocsUrl(url) {
+        const cli = await import('apcore-cli');
+        cli.setDocsUrl(url);
+    }
+    /** Toggle verbose help — when on, `--help` lists the built-in apcore options. */
+    async setVerboseHelp(verbose) {
+        const cli = await import('apcore-cli');
+        cli.setVerboseHelp(verbose);
+    }
+    /**
+     * Apply the module-level `docsUrl` / `verboseHelp` defaults once, the first
+     * time a program is built.
+     */
+    async applyModuleOptions() {
+        if (this.configured)
+            return;
+        this.configured = true;
+        if (this.options.docsUrl !== undefined) {
+            await this.setDocsUrl(this.options.docsUrl);
+        }
+        if (this.options.verboseHelp !== undefined) {
+            await this.setVerboseHelp(this.options.verboseHelp);
+        }
+    }
+}
+//# sourceMappingURL=apcore-cli.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apcore-cli.service.js","sourceRoot":"","sources":["../../src/cli/apcore-cli.service.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,gBAAgB;IAIR;IACA;IAJX,UAAU,GAAG,KAAK,CAAC;IAE3B,YACmB,QAAwB,EACxB,UAA4B,EAAE;QAD9B,aAAQ,GAAR,QAAQ,CAAgB;QACxB,YAAO,GAAP,OAAO,CAAuB;IAC9C,CAAC;IAEJ,8CAA8C;IAC9C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CAAC,aAAsB;QACxC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAEhC,OACE,GAAG,CAAC,SAKL,CACC,aAAa,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,EAC3C,IAAI,CAAC,OAAO,CAAC,QAAQ,EACrB,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,KAAK,CAClC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAAgB,EAChB,QAAgB,EAChB,OAAe,EACf,WAAoB,EACpB,OAAgB;QAEhB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAErC,GAAG,CAAC,gBAOL,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;IAC3F,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,UAAU,CAAC,GAAkB;QACjC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACtC,GAAG,CAAC,UAA2C,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,cAAc,CAAC,OAAgB;QACnC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACtC,GAAG,CAAC,cAA6C,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,kBAAkB;QAC9B,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAEvB,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CACF"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export { ApcoreCliService } from './apcore-cli.service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,2 @@
+export { ApcoreCliService } from './apcore-cli.service.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** Parse argv and dispatch. Exported so tests can drive the CLI directly. */
+export declare function main(argv?: string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAuOA,6EAA6E;AAC7E,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDlF"}