auxiliar-mcp 0.9.1 → 0.11.0

package/dist/data/capabilities.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Runtime query layer over the unified Capability index (N1 Phase 3).
+ *
+ * Loads the build-time snapshot at `./capabilities.generated.json` (built by
+ * `mcp/scripts/build-capabilities.mjs` from `data/capabilities/*.yml`) and
+ * exposes a small functional API for the MCP server tools.
+ *
+ * The snapshot is validated through the Zod Capability schema **once at
+ * module import**. Per-call validation would burn CPU on every tool
+ * invocation; one-shot validation at startup catches schema/data drift
+ * before the server handles its first request.
+ *
+ * The MCP server runs on the user's machine, not on AWS. Bundling the
+ * snapshot keeps that path AWS-credentialless. DynamoDB is the runtime
+ * backing store for the FastAPI side (Hugo build, web visitors, future
+ * Costco gateway) — both consumers read from `data/capabilities/*.yml`
+ * as the canonical source.
+ */
+import { Capability } from "../types/capability.js";
+/** Return every Capability in the index. Order is YAML filename ascending. */
+export declare function listAllCapabilities(): readonly Capability[];
+/** Fetch one Capability by stable slug, or undefined if absent. */
+export declare function getCapability(id: string): Capability | undefined;
+/** All Capabilities of a single element_type. */
+export declare function listCapabilitiesByElementType(elementType: Capability["element_type"]): readonly Capability[];
+/** Capabilities matching any of the given jtbd_tags (OR semantics). Used by
+ *  the find_capability tool's task-first query path. */
+export declare function findCapabilitiesByJtbd(tags: readonly string[]): Capability[];
+/** Capabilities matching any of the given category strings. /service/<cat>/
+ *  list views and the legacy `list_services` tool route through here. */
+export declare function listCapabilitiesByCategory(category: string): Capability[];
+/** Total count — exposed for diagnostics + the homepage's dynamic
+ *  service-count display. */
+export declare function capabilityCount(): number;