@forumone/throughline 0.0.0-stage → 1.0.0-next.0

package/dist/components/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/components/options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAErE,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAErE,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAOD,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,aAAa,CAAC;IACzF,6DAA6D;IAC7D,QAAQ,EAAE,cAAc,CAAA;IACxB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,cAAc,CAAA;IAEzB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAC5B;AAgBD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASxC,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,uBAAuB,GAAG,uBAAuB,CAOzF"}

package/dist/components/options.js

@@ -0,0 +1,40 @@
+import { formatZodIssues } from '../utils/zod-issues.js';
+import { z } from 'zod';
+const ManifestSourceSchema = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('object'), manifest: z.unknown() }),
+    z.object({
+        type: z.literal('url'),
+        url: z.string().url(),
+        refreshInterval: z.number().int().positive().optional(),
+    }),
+    z.object({
+        type: z.literal('payload-collection'),
+        slug: z.string().min(1),
+        documentId: z.string().optional(),
+    }),
+]);
+export const ComponentsPluginOptionsSchema = z.object({
+    enabled: z.boolean().optional(),
+    manifest: ManifestSourceSchema,
+    matching: z
+        .object({
+        strategy: z.enum(['tfidf']),
+        maxRecommendations: z.number().int().positive().optional(),
+    })
+        .optional(),
+});
+/**
+ * Validates plugin options at load time. Throws with a multi-line message
+ * on schema failure or with a targeted message on cross-field violations.
+ * Plugins that depend on this server must initialize after `componentsPlugin`
+ * because the registry capability check happens during onInit.
+ */
+export function validateOptions(options) {
+    const result = ComponentsPluginOptionsSchema.safeParse(options);
+    if (!result.success) {
+        const issues = formatZodIssues(result.error);
+        throw new Error(`Invalid componentsPlugin options:\n${issues}`);
+    }
+    return options;
+}
+//# sourceMappingURL=options.js.map

package/dist/components/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/components/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA8CvB,MAAM,oBAAoB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACxD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IAC9D,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACtB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QACrB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KACxD,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;QACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;CACH,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,oBAAoB;IAC9B,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;QAC3B,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KAC3D,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgC;IAC9D,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IAC/D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC5C,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/components/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { CorePlugin } from '../plugin-contract/index.js';
+import { type ComponentsPluginOptions } from './options.js';
+export declare const componentsPlugin: CorePlugin<ComponentsPluginOptions>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/components/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/components/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAI7D,OAAO,EAAE,KAAK,uBAAuB,EAAmB,MAAM,cAAc,CAAA;AA6B5E,eAAO,MAAM,gBAAgB,EAAE,UAAU,CAAC,uBAAuB,CAsE9D,CAAA"}

package/dist/components/plugin.js

@@ -0,0 +1,95 @@
+import { getPluginRegistry } from '../plugin-contract/registry.js';
+import { createNamedLogger, defaultLogger } from '../logger/index.js';
+import { getAuditWriter } from '../audit/plugin.js';
+import { validateOptions } from './options.js';
+import { createManifestLoader } from './manifest-source.js';
+import { createTfidfMatcher } from './matching/index.js';
+import { COMPONENTS_TOOL_DESCRIPTORS, createFindAntiPatternTool, createGetContractTool, createGetTokensTool, createGetVariantsTool, createListComponentsTool, createSuggestForIntentTool, createValidateCompositionTool, } from './tools/index.js';
+import { validateComposition, } from './validation/composition.js';
+const PLUGIN_ID = '@forumone/throughline/components';
+const PLUGIN_VERSION = '0.1.0';
+/**
+ * Internal IPC point: peer plugins (publishing, etc.) read this symbol from
+ * the Payload instance to call composition validation directly without
+ * going through MCP. Keep this string in lockstep with the matching constant
+ * in the publishing package.
+ */
+const VALIDATOR_SYMBOL = Symbol.for('@forumone/throughline/components-validator');
+export const componentsPlugin = (rawOptions) => (incomingConfig) => {
+    if (rawOptions.enabled === false)
+        return incomingConfig;
+    const options = validateOptions(rawOptions);
+    const logger = createNamedLogger('components', options.logger ?? defaultLogger);
+    const maxRecommendations = options.matching?.maxRecommendations ?? 5;
+    /*
+    Declared here, bound at `onInit` — `mcpPlugin` generates its per-key
+    checkboxes from these names and descriptions while the config is built, and
+    denies any tool it has no checkbox for. This plugin must therefore come
+    before `mcpPlugin` in the host's array.
+    */
+    options.mcpTools?.declare(COMPONENTS_TOOL_DESCRIPTORS, { serverName: 'components' });
+    return {
+        ...incomingConfig,
+        onInit: async (payload) => {
+            if (incomingConfig.onInit) {
+                await incomingConfig.onInit(payload);
+            }
+            const registry = getPluginRegistry(payload);
+            registry.requireCapability('audit-log', PLUGIN_ID);
+            const auditWriter = getAuditWriter(payload);
+            const loader = createManifestLoader(options.manifest, payload);
+            // Eager load: fail fast if the manifest source is broken at deploy
+            // time rather than on the first request.
+            const manifest = await loader.get();
+            const components = Object.values(manifest.raw.components);
+            logger.info('Manifest loaded', {
+                designSystem: manifest.designSystem.name,
+                version: manifest.designSystem.version,
+                componentCount: components.length,
+            });
+            const matcher = createTfidfMatcher(components);
+            const tools = [
+                createListComponentsTool(loader),
+                createGetContractTool(loader),
+                createGetVariantsTool(loader),
+                createGetTokensTool(loader),
+                createSuggestForIntentTool({ loader, matcher, auditWriter, maxRecommendations }),
+                createValidateCompositionTool({ loader, auditWriter }),
+                createFindAntiPatternTool({ loader, auditWriter }),
+            ];
+            // Payload's own MCP plugin, and the only transport these tools have.
+            // `onInit` is both the earliest they can exist and still early enough
+            // that `mcpPlugin` reads the array populated.
+            options.mcpTools?.add(tools, { serverName: 'components', logger, audit: auditWriter });
+            attachValidator(payload, loader);
+            registry.register({
+                id: PLUGIN_ID,
+                version: PLUGIN_VERSION,
+                capabilities: [
+                    'component-server',
+                    'manifest-loading',
+                    'intent-matching',
+                    'composition-validation',
+                ],
+            });
+        },
+    };
+};
+/**
+ * Attaches a composition-validation function to the Payload instance under
+ * VALIDATOR_SYMBOL so peer plugins (the publishing server) can validate
+ * compositions in-process without going through the MCP transport.
+ */
+function attachValidator(payload, loader) {
+    const validator = async (input) => {
+        const manifest = await loader.get();
+        return validateComposition(input, manifest);
+    };
+    Object.defineProperty(payload, VALIDATOR_SYMBOL, {
+        value: validator,
+        enumerable: false,
+        writable: false,
+        configurable: false,
+    });
+}
+//# sourceMappingURL=plugin.js.map

package/dist/components/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/components/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAgC,eAAe,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,oBAAoB,EAAuB,MAAM,sBAAsB,CAAA;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAGL,mBAAmB,GACpB,MAAM,6BAA6B,CAAA;AAEpC,MAAM,SAAS,GAAG,kCAAkC,CAAA;AACpD,MAAM,cAAc,GAAG,OAAO,CAAA;AAC9B;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAA;AAEjF,MAAM,CAAC,MAAM,gBAAgB,GAC3B,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE;IACjC,IAAI,UAAU,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,cAAc,CAAA;IAEvD,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,CAAA;IAC3C,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,CAAA;IAC/E,MAAM,kBAAkB,GAAG,OAAO,CAAC,QAAQ,EAAE,kBAAkB,IAAI,CAAC,CAAA;IAEpE;;;;;MAKE;IACF,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,2BAA2B,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAA;IAEpF,OAAO;QACL,GAAG,cAAc;QACjB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;gBAC1B,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACtC,CAAC;YAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;YAC3C,QAAQ,CAAC,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;YAElD,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;YAC3C,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAE9D,mEAAmE;YACnE,yCAAyC;YACzC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;YACnC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YACzD,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBAC7B,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,IAAI;gBACxC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,OAAO;gBACtC,cAAc,EAAE,UAAU,CAAC,MAAM;aAClC,CAAC,CAAA;YAEF,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;YAE9C,MAAM,KAAK,GAAG;gBACZ,wBAAwB,CAAC,MAAM,CAAC;gBAChC,qBAAqB,CAAC,MAAM,CAAC;gBAC7B,qBAAqB,CAAC,MAAM,CAAC;gBAC7B,mBAAmB,CAAC,MAAM,CAAC;gBAC3B,0BAA0B,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;gBAChF,6BAA6B,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;gBACtD,yBAAyB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;aACnD,CAAA;YAED,qEAAqE;YACrE,sEAAsE;YACtE,8CAA8C;YAC9C,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;YAEtF,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAEhC,QAAQ,CAAC,QAAQ,CAAC;gBAChB,EAAE,EAAE,SAAS;gBACb,OAAO,EAAE,cAAc;gBACvB,YAAY,EAAE;oBACZ,kBAAkB;oBAClB,kBAAkB;oBAClB,iBAAiB;oBACjB,wBAAwB;iBACzB;aACF,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAEH;;;;GAIG;AACH,SAAS,eAAe,CAAC,OAAe,EAAE,MAAsB;IAC9D,MAAM,SAAS,GAAG,KAAK,EAAE,KAAuB,EAA8B,EAAE;QAC9E,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;QACnC,OAAO,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC7C,CAAC,CAAA;IACD,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE;QAC/C,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;KACpB,CAAC,CAAA;AACJ,CAAC"}

package/dist/components/tools/descriptors.d.ts

@@ -0,0 +1,34 @@
+import type { McpToolDescriptor } from '../../mcp/collector.js';
+export declare const COMPONENTS_TOOLS: {
+    readonly listComponents: {
+        readonly name: "list_components";
+        readonly description: "Returns the list of components available in the design system. Use this to discover what components exist before composing content.";
+    };
+    readonly getContract: {
+        readonly name: "get_contract";
+        readonly description: "Returns the full contract for a named component, including intent, composition rules, content fields, variants, tokens, accessibility requirements, examples, and anti-examples.";
+    };
+    readonly getVariants: {
+        readonly name: "get_variants";
+        readonly description: "Returns the available variants for a component, with descriptions and guidance about when to use each.";
+    };
+    readonly getTokens: {
+        readonly name: "get_tokens";
+        readonly description: "Returns the design tokens a component consumes plus the configurable token-backed props and their allowed values.";
+    };
+    readonly suggestForIntent: {
+        readonly name: "suggest_for_intent";
+        readonly description: "Given a natural-language description of what the author wants to accomplish, returns ranked component recommendations with reasoning. Optionally accepts the existing page context so duplicate Heroes / composition conflicts surface as warnings on the suggestions.";
+    };
+    readonly validateComposition: {
+        readonly name: "validate_composition";
+        readonly description: "Validates a proposed page layout against the design system's composition rules. Returns errors (blocking publish) and warnings (advisory). Call this before recommending a final layout.";
+    };
+    readonly findAntiPattern: {
+        readonly name: "find_anti_pattern";
+        readonly description: "Scans a proposed composition for known design anti-patterns (multiple Heroes, Hero at the bottom of a page, etc.). Returns matches with explanation and suggested alternatives. Use before publishing to surface editorial issues.";
+    };
+};
+/** Every tool this server contributes, for the collector. */
+export declare const COMPONENTS_TOOL_DESCRIPTORS: readonly McpToolDescriptor[];
+//# sourceMappingURL=descriptors.d.ts.map

package/dist/components/tools/descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../../src/components/tools/descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAY/D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCyB,CAAA;AAEtD,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B,EAAE,SAAS,iBAAiB,EACnC,CAAA"}

package/dist/components/tools/descriptors.js

@@ -0,0 +1,43 @@
+/*
+This server's tools, by name and description, knowable without a Payload.
+
+`@payloadcms/plugin-mcp` reads exactly these two fields while the host's config
+is being built, to generate one per-key checkbox per tool, and denies any tool it
+has no checkbox for. The handlers close over the manifest loader and the matcher,
+which are built at `onInit` — the names never needed to wait for them.
+
+The factories below spread these, so the two cannot drift.
+*/
+export const COMPONENTS_TOOLS = {
+    listComponents: {
+        name: 'list_components',
+        description: 'Returns the list of components available in the design system. Use this to discover what components exist before composing content.',
+    },
+    getContract: {
+        name: 'get_contract',
+        description: 'Returns the full contract for a named component, including intent, composition rules, content fields, variants, tokens, accessibility requirements, examples, and anti-examples.',
+    },
+    getVariants: {
+        name: 'get_variants',
+        description: 'Returns the available variants for a component, with descriptions and guidance about when to use each.',
+    },
+    getTokens: {
+        name: 'get_tokens',
+        description: 'Returns the design tokens a component consumes plus the configurable token-backed props and their allowed values.',
+    },
+    suggestForIntent: {
+        name: 'suggest_for_intent',
+        description: 'Given a natural-language description of what the author wants to accomplish, returns ranked component recommendations with reasoning. Optionally accepts the existing page context so duplicate Heroes / composition conflicts surface as warnings on the suggestions.',
+    },
+    validateComposition: {
+        name: 'validate_composition',
+        description: "Validates a proposed page layout against the design system's composition rules. Returns errors (blocking publish) and warnings (advisory). Call this before recommending a final layout.",
+    },
+    findAntiPattern: {
+        name: 'find_anti_pattern',
+        description: 'Scans a proposed composition for known design anti-patterns (multiple Heroes, Hero at the bottom of a page, etc.). Returns matches with explanation and suggested alternatives. Use before publishing to surface editorial issues.',
+    },
+};
+/** Every tool this server contributes, for the collector. */
+export const COMPONENTS_TOOL_DESCRIPTORS = Object.values(COMPONENTS_TOOLS);
+//# sourceMappingURL=descriptors.js.map

package/dist/components/tools/descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.js","sourceRoot":"","sources":["../../../src/components/tools/descriptors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;EASE;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc,EAAE;QACd,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,qIAAqI;KACxI;IACD,WAAW,EAAE;QACX,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,kLAAkL;KACrL;IACD,WAAW,EAAE;QACX,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,wGAAwG;KAC3G;IACD,SAAS,EAAE;QACT,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,mHAAmH;KACtH;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,wQAAwQ;KAC3Q;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,0LAA0L;KAC7L;IACD,eAAe,EAAE;QACf,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,oOAAoO;KACvO;CACmD,CAAA;AAEtD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,2BAA2B,GACtC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA"}

package/dist/components/tools/find-anti-pattern.d.ts

@@ -0,0 +1,9 @@
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import { type AuditWriter } from '../../audit/writer.js';
+import type { ManifestLoader } from '../manifest-source.js';
+export interface FindAntiPatternDeps {
+    loader: ManifestLoader;
+    auditWriter: AuditWriter;
+}
+export declare function createFindAntiPatternTool(deps: FindAntiPatternDeps): McpToolDefinition;
+//# sourceMappingURL=find-anti-pattern.d.ts.map

package/dist/components/tools/find-anti-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-anti-pattern.d.ts","sourceRoot":"","sources":["../../../src/components/tools/find-anti-pattern.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAI3D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,WAAW,CAAA;CACzB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,iBAAiB,CA6BtF"}

package/dist/components/tools/find-anti-pattern.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { auditContext } from '../../mcp/audit-context.js';
+import { withMeta } from '../../mcp/meta.js';
+import { findAntiPatterns } from '../validation/composition.js';
+import { COMPONENTS_TOOLS } from './descriptors.js';
+export function createFindAntiPatternTool(deps) {
+    const inputSchema = withMeta({
+        blocks: z
+            .array(z.object({
+            type: z.string(),
+            variant: z.string().optional(),
+        }))
+            .min(1),
+    });
+    return {
+        ...COMPONENTS_TOOLS.findAntiPattern,
+        inputSchema,
+        handler: async (input, ctx) => {
+            const manifest = await deps.loader.get();
+            const matches = findAntiPatterns({ blocks: input.blocks }, manifest);
+            await deps.auditWriter({
+                ...auditContext(ctx, input._meta),
+                action: 'design.find_anti_pattern',
+                mcpServer: 'component',
+                mcpTool: 'find_anti_pattern',
+            });
+            return { matches };
+        },
+    };
+}
+//# sourceMappingURL=find-anti-pattern.js.map

package/dist/components/tools/find-anti-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-anti-pattern.js","sourceRoot":"","sources":["../../../src/components/tools/find-anti-pattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAOnD,MAAM,UAAU,yBAAyB,CAAC,IAAyB;IACjE,MAAM,WAAW,GAAG,QAAQ,CAAC;QAC3B,MAAM,EAAE,CAAC;aACN,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC,CACH;aACA,GAAG,CAAC,CAAC,CAAC;KACV,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,gBAAgB,CAAC,eAAe;QACnC,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;YACxC,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAA;YAEpE,MAAM,IAAI,CAAC,WAAW,CAAC;gBACrB,GAAG,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC;gBACjC,MAAM,EAAE,0BAA0B;gBAClC,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAE,mBAAmB;aAC7B,CAAC,CAAA;YAEF,OAAO,EAAE,OAAO,EAAE,CAAA;QACpB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/components/tools/get-contract.d.ts

@@ -0,0 +1,4 @@
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { ManifestLoader } from '../manifest-source.js';
+export declare function createGetContractTool(loader: ManifestLoader): McpToolDefinition;
+//# sourceMappingURL=get-contract.d.ts.map

package/dist/components/tools/get-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-contract.d.ts","sourceRoot":"","sources":["../../../src/components/tools/get-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAe/E"}

package/dist/components/tools/get-contract.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { COMPONENTS_TOOLS } from './descriptors.js';
+export function createGetContractTool(loader) {
+    return {
+        ...COMPONENTS_TOOLS.getContract,
+        inputSchema: z.object({
+            name: z.string().describe('The PascalCase name of the component'),
+        }),
+        handler: async (input) => {
+            const manifest = await loader.get();
+            const contract = manifest.getComponent(input.name);
+            if (!contract) {
+                return { error: `Component "${input.name}" not found in the design system` };
+            }
+            return contract;
+        },
+    };
+}
+//# sourceMappingURL=get-contract.js.map

package/dist/components/tools/get-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-contract.js","sourceRoot":"","sources":["../../../src/components/tools/get-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,OAAO;QACL,GAAG,gBAAgB,CAAC,WAAW;QAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SAClE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;YACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,EAAE,KAAK,EAAE,cAAc,KAAK,CAAC,IAAI,kCAAkC,EAAE,CAAA;YAC9E,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/components/tools/get-tokens.d.ts

@@ -0,0 +1,4 @@
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { ManifestLoader } from '../manifest-source.js';
+export declare function createGetTokensTool(loader: ManifestLoader): McpToolDefinition;
+//# sourceMappingURL=get-tokens.d.ts.map

package/dist/components/tools/get-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tokens.d.ts","sourceRoot":"","sources":["../../../src/components/tools/get-tokens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG3D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAe7E"}

package/dist/components/tools/get-tokens.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { COMPONENTS_TOOLS } from './descriptors.js';
+export function createGetTokensTool(loader) {
+    return {
+        ...COMPONENTS_TOOLS.getTokens,
+        inputSchema: z.object({
+            name: z.string().describe('The PascalCase name of the component'),
+        }),
+        handler: async (input) => {
+            const manifest = await loader.get();
+            const contract = manifest.getComponent(input.name);
+            if (!contract) {
+                return { error: `Component "${input.name}" not found` };
+            }
+            return contract.tokens;
+        },
+    };
+}
+//# sourceMappingURL=get-tokens.js.map

package/dist/components/tools/get-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tokens.js","sourceRoot":"","sources":["../../../src/components/tools/get-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,OAAO;QACL,GAAG,gBAAgB,CAAC,SAAS;QAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SAClE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;YACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,EAAE,KAAK,EAAE,cAAc,KAAK,CAAC,IAAI,aAAa,EAAE,CAAA;YACzD,CAAC;YACD,OAAO,QAAQ,CAAC,MAAM,CAAA;QACxB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/components/tools/get-variants.d.ts

@@ -0,0 +1,4 @@
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { ManifestLoader } from '../manifest-source.js';
+export declare function createGetVariantsTool(loader: ManifestLoader): McpToolDefinition;
+//# sourceMappingURL=get-variants.d.ts.map

package/dist/components/tools/get-variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-variants.d.ts","sourceRoot":"","sources":["../../../src/components/tools/get-variants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAe/E"}

package/dist/components/tools/get-variants.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { COMPONENTS_TOOLS } from './descriptors.js';
+export function createGetVariantsTool(loader) {
+    return {
+        ...COMPONENTS_TOOLS.getVariants,
+        inputSchema: z.object({
+            name: z.string().describe('The PascalCase name of the component'),
+        }),
+        handler: async (input) => {
+            const manifest = await loader.get();
+            const contract = manifest.getComponent(input.name);
+            if (!contract) {
+                return { error: `Component "${input.name}" not found` };
+            }
+            return { variants: contract.content.variants ?? [] };
+        },
+    };
+}
+//# sourceMappingURL=get-variants.js.map

package/dist/components/tools/get-variants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-variants.js","sourceRoot":"","sources":["../../../src/components/tools/get-variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,OAAO;QACL,GAAG,gBAAgB,CAAC,WAAW;QAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SAClE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;YACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,EAAE,KAAK,EAAE,cAAc,KAAK,CAAC,IAAI,aAAa,EAAE,CAAA;YACzD,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAA;QACtD,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/components/tools/index.d.ts

@@ -0,0 +1,9 @@
+export { COMPONENTS_TOOLS, COMPONENTS_TOOL_DESCRIPTORS } from './descriptors.js';
+export { createListComponentsTool } from './list-components.js';
+export { createGetContractTool } from './get-contract.js';
+export { createGetVariantsTool } from './get-variants.js';
+export { createGetTokensTool } from './get-tokens.js';
+export { createSuggestForIntentTool, type SuggestForIntentDeps, } from './suggest-for-intent.js';
+export { createValidateCompositionTool, type ValidateCompositionDeps, } from './validate-composition.js';
+export { createFindAntiPatternTool, type FindAntiPatternDeps, } from './find-anti-pattern.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EACL,0BAA0B,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,6BAA6B,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,wBAAwB,CAAA"}

package/dist/components/tools/index.js

@@ -0,0 +1,9 @@
+export { COMPONENTS_TOOLS, COMPONENTS_TOOL_DESCRIPTORS } from './descriptors.js';
+export { createListComponentsTool } from './list-components.js';
+export { createGetContractTool } from './get-contract.js';
+export { createGetVariantsTool } from './get-variants.js';
+export { createGetTokensTool } from './get-tokens.js';
+export { createSuggestForIntentTool, } from './suggest-for-intent.js';
+export { createValidateCompositionTool, } from './validate-composition.js';
+export { createFindAntiPatternTool, } from './find-anti-pattern.js';
+//# sourceMappingURL=index.js.map

package/dist/components/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EACL,0BAA0B,GAE3B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,6BAA6B,GAE9B,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,yBAAyB,GAE1B,MAAM,wBAAwB,CAAA"}

package/dist/components/tools/list-components.d.ts

@@ -0,0 +1,4 @@
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { ManifestLoader } from '../manifest-source.js';
+export declare function createListComponentsTool(loader: ManifestLoader): McpToolDefinition;
+//# sourceMappingURL=list-components.d.ts.map

package/dist/components/tools/list-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.d.ts","sourceRoot":"","sources":["../../../src/components/tools/list-components.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG3D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAqBlF"}

package/dist/components/tools/list-components.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { COMPONENTS_TOOLS } from './descriptors.js';
+export function createListComponentsTool(loader) {
+    return {
+        ...COMPONENTS_TOOLS.listComponents,
+        inputSchema: z.object({
+            category: z
+                .string()
+                .optional()
+                .describe('Optional: filter to a single category (hero, section, card, media, cta, navigation, data, form, utility)'),
+        }),
+        handler: async (input) => {
+            const manifest = await loader.get();
+            const components = input.category
+                ? manifest.listByCategory(input.category)
+                : Object.values(manifest.raw.components);
+            return components.map((c) => ({
+                name: c.name,
+                category: c.category,
+                description: c.description,
+            }));
+        },
+    };
+}
+//# sourceMappingURL=list-components.js.map

package/dist/components/tools/list-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.js","sourceRoot":"","sources":["../../../src/components/tools/list-components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,UAAU,wBAAwB,CAAC,MAAsB;IAC7D,OAAO;QACL,GAAG,gBAAgB,CAAC,cAAc;QAClC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,0GAA0G,CAAC;SACxH,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;YACnC,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ;gBAC/B,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACzC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YAC1C,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC,CAAC,CAAA;QACL,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/components/tools/suggest-for-intent.d.ts

@@ -0,0 +1,12 @@
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import { type AuditWriter } from '../../audit/writer.js';
+import type { ManifestLoader } from '../manifest-source.js';
+import type { Matcher } from '../matching/types.js';
+export interface SuggestForIntentDeps {
+    loader: ManifestLoader;
+    matcher: Matcher;
+    auditWriter: AuditWriter;
+    maxRecommendations: number;
+}
+export declare function createSuggestForIntentTool(deps: SuggestForIntentDeps): McpToolDefinition;
+//# sourceMappingURL=suggest-for-intent.d.ts.map

package/dist/components/tools/suggest-for-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-for-intent.d.ts","sourceRoot":"","sources":["../../../src/components/tools/suggest-for-intent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAIxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,sBAAsB,CAAA;AAIrE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,cAAc,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,WAAW,CAAA;IACxB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,oBAAoB,GAAG,iBAAiB,CA8DxF"}

package/dist/components/tools/suggest-for-intent.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { auditContext } from '../../mcp/audit-context.js';
+import { withMeta } from '../../mcp/meta.js';
+import { validateComposition } from '../validation/composition.js';
+import { COMPONENTS_TOOLS } from './descriptors.js';
+export function createSuggestForIntentTool(deps) {
+    const inputSchema = withMeta({
+        intent: z
+            .string()
+            .min(5)
+            .describe('Natural-language description of what to accomplish (e.g. "introduce a new program")'),
+        context: z
+            .object({
+            existingBlocks: z
+                .array(z.string())
+                .optional()
+                .describe('Component names already on the page, in order'),
+            pageType: z
+                .string()
+                .optional()
+                .describe('Optional page-type hint: landing, article, program, etc.'),
+        })
+            .optional(),
+    });
+    return {
+        ...COMPONENTS_TOOLS.suggestForIntent,
+        inputSchema,
+        handler: async (input, ctx) => {
+            const manifest = await deps.loader.get();
+            const allComponents = Object.values(manifest.raw.components);
+            const ranked = deps.matcher.rank(input.intent);
+            const recommendations = [];
+            for (const { component, score } of ranked) {
+                if (recommendations.length >= deps.maxRecommendations)
+                    break;
+                const warnings = collectWarnings(component, input.context?.existingBlocks, manifest);
+                recommendations.push({
+                    component: component.name,
+                    score,
+                    reasoning: formatReasoning(component, score, warnings),
+                    matchedIntent: component.examples[0]?.intent ?? component.intent,
+                    ...(warnings.length > 0 ? { warnings } : {}),
+                });
+            }
+            // Audit (fire-and-forget; never blocks the response).
+            await deps.auditWriter({
+                ...auditContext(ctx, input._meta),
+                action: 'design.suggest',
+                mcpServer: 'component',
+                mcpTool: 'suggest_for_intent',
+                // The intent *is* the prompt when the client sent no `_meta`, which is
+                // the whole record of why this call was made.
+                prompt: input._meta?.userPrompt ?? input.intent,
+                changesSummary: `Suggested components for: ${input.intent.slice(0, 120)}`,
+            });
+            // Quiet the unused-variable lint when the recommendation set
+            // is smaller than the candidate pool — `allComponents` keeps the
+            // contract method available for future extensions.
+            void allComponents;
+            return { recommendations };
+        },
+    };
+}
+function collectWarnings(component, existingBlocks, manifest) {
+    if (!existingBlocks || existingBlocks.length === 0)
+        return [];
+    const proposed = [
+        ...existingBlocks.map((type) => ({ type })),
+        { type: component.name },
+    ];
+    const result = validateComposition({ blocks: proposed }, manifest);
+    return result.issues
+        .filter((i) => i.severity === 'error' && i.blockIndex === proposed.length - 1)
+        .map((i) => i.message);
+}
+function formatReasoning(component, score, warnings) {
+    const confidence = score > 0.3 ? 'strong match' : score > 0.05 ? 'moderate match' : 'possible match';
+    const base = `${component.name}: ${confidence}. ${component.description}`;
+    if (warnings.length === 0)
+        return base;
+    return `${base} Note: ${warnings.join(' ')}`;
+}
+//# sourceMappingURL=suggest-for-intent.js.map

package/dist/components/tools/suggest-for-intent.js.map

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

package/dist/components/tools/validate-composition.d.ts

@@ -0,0 +1,9 @@
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import { type AuditWriter } from '../../audit/writer.js';
+import type { ManifestLoader } from '../manifest-source.js';
+export interface ValidateCompositionDeps {
+    loader: ManifestLoader;
+    auditWriter: AuditWriter;
+}
+export declare function createValidateCompositionTool(deps: ValidateCompositionDeps): McpToolDefinition;
+//# sourceMappingURL=validate-composition.d.ts.map

package/dist/components/tools/validate-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-composition.d.ts","sourceRoot":"","sources":["../../../src/components/tools/validate-composition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAI3D,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,WAAW,CAAA;CACzB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,uBAAuB,GAAG,iBAAiB,CA6B9F"}