@forumone/throughline-components 0.0.1 → 0.2.0

package/dist/options.js

@@ -0,0 +1,42 @@
+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(),
+    routePrefix: z.string().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 = result.error.issues
+            .map((i) => `  - ${i.path.join('.') || '(root)'}: ${i.message}`)
+            .join('\n');
+        throw new Error(`Invalid componentsPlugin options:\n${issues}`);
+    }
+    return options;
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA2BvB,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,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,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,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/D,IAAI,CAAC,IAAI,CAAC,CAAA;QACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/plugin.d.ts

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

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAA;AAQvE,OAAO,EAAE,KAAK,uBAAuB,EAAmB,MAAM,cAAc,CAAA;AAmB5E,eAAO,MAAM,gBAAgB,EAAE,UAAU,CAAC,uBAAuB,CA+E9D,CAAA"}

package/dist/plugin.js

@@ -0,0 +1,83 @@
+import { getPluginRegistry } from '@forumone/throughline-plugin-contract';
+import { createMcpHandler, createNamedLogger, defaultLogger, getAuditWriter, } from '@forumone/throughline-core';
+import { validateOptions } from './options.js';
+import { createManifestLoader } from './manifest-source.js';
+import { createTfidfMatcher } from './matching/index.js';
+import { createFindAntiPatternTool, createGetContractTool, createGetTokensTool, createGetVariantsTool, createListComponentsTool, createSuggestForIntentTool, createValidateCompositionTool, } from './tools/index.js';
+const PLUGIN_ID = '@forumone/throughline-components';
+const PLUGIN_VERSION = '0.1.0';
+const MCP_HANDLER_SYMBOL = Symbol.for('@forumone/throughline/components-mcp-handler');
+export const componentsPlugin = (rawOptions) => (incomingConfig) => {
+    if (rawOptions.enabled === false)
+        return incomingConfig;
+    const options = validateOptions(rawOptions);
+    const routePrefix = options.routePrefix ?? '/api/components';
+    const logger = createNamedLogger('components', options.logger ?? defaultLogger);
+    const maxRecommendations = options.matching?.maxRecommendations ?? 5;
+    return {
+        ...incomingConfig,
+        endpoints: [
+            ...(incomingConfig.endpoints ?? []),
+            {
+                path: `${routePrefix}/mcp`,
+                method: 'post',
+                handler: async (req) => {
+                    const handler = req.payload[MCP_HANDLER_SYMBOL];
+                    if (!handler) {
+                        return new Response(JSON.stringify({ error: 'Components MCP not initialized' }), { status: 503, headers: { 'content-type': 'application/json' } });
+                    }
+                    return handler(req);
+                },
+            },
+        ],
+        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 }),
+            ];
+            const handler = createMcpHandler({
+                payload,
+                serverName: 'components',
+                tools,
+                logger,
+            });
+            attachMcpHandler(payload, handler);
+            registry.register({
+                id: PLUGIN_ID,
+                version: PLUGIN_VERSION,
+                capabilities: ['component-server', 'manifest-loading', 'intent-matching'],
+            });
+        },
+    };
+};
+function attachMcpHandler(payload, handler) {
+    Object.defineProperty(payload, MCP_HANDLER_SYMBOL, {
+        value: handler,
+        enumerable: false,
+        writable: false,
+        configurable: false,
+    });
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

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

@@ -0,0 +1,9 @@
+import type { McpToolDefinition } from '@forumone/throughline-plugin-contract';
+import { type AuditWriter } from '@forumone/throughline-core';
+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/tools/find-anti-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-anti-pattern.d.ts","sourceRoot":"","sources":["../../src/tools/find-anti-pattern.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,EAAE,KAAK,WAAW,EAAY,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG3D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,WAAW,CAAA;CACzB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,iBAAiB,CAsCtF"}

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

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { withMeta } from '@forumone/throughline-core';
+import { findAntiPatterns } from '../validation/composition.js';
+export function createFindAntiPatternTool(deps) {
+    const inputSchema = withMeta({
+        blocks: z
+            .array(z.object({
+            type: z.string(),
+            variant: z.string().optional(),
+        }))
+            .min(1),
+    });
+    return {
+        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.",
+        inputSchema,
+        handler: async (input, ctx) => {
+            const manifest = await deps.loader.get();
+            const matches = findAntiPatterns({ blocks: input.blocks }, manifest);
+            await deps.auditWriter({
+                actor: {
+                    type: 'user',
+                    userId: ctx.user?.id,
+                    userName: ctx.user?.name,
+                    apiKeyName: ctx.apiKeyName,
+                },
+                action: 'design.find_anti_pattern',
+                mcpServer: 'component',
+                mcpTool: 'find_anti_pattern',
+                prompt: input._meta?.userPrompt,
+                reasoning: input._meta?.reasoning,
+            });
+            return { matches };
+        },
+    };
+}
+//# sourceMappingURL=find-anti-pattern.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-anti-pattern.js","sourceRoot":"","sources":["../../src/tools/find-anti-pattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAoB,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAO/D,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,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,oOAAoO;QACtO,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,KAAK,EAAE;oBACL,IAAI,EAAE,MAAM;oBACZ,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE;oBACpB,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI;oBACxB,UAAU,EAAE,GAAG,CAAC,UAAU;iBAC3B;gBACD,MAAM,EAAE,0BAA0B;gBAClC,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAE,mBAAmB;gBAC5B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU;gBAC/B,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS;aAClC,CAAC,CAAA;YAEF,OAAO,EAAE,OAAO,EAAE,CAAA;QACpB,CAAC;KACF,CAAA;AACH,CAAC"}

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

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

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

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

package/dist/tools/get-contract.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export function createGetContractTool(loader) {
+    return {
+        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.',
+        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/tools/get-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-contract.js","sourceRoot":"","sources":["../../src/tools/get-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,kLAAkL;QACpL,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/tools/get-tokens.d.ts

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

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

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

package/dist/tools/get-tokens.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export function createGetTokensTool(loader) {
+    return {
+        name: 'get_tokens',
+        description: 'Returns the design tokens a component consumes plus the configurable token-backed props and their allowed values.',
+        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/tools/get-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tokens.js","sourceRoot":"","sources":["../../src/tools/get-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,mHAAmH;QACrH,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/tools/get-variants.d.ts

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

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

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

package/dist/tools/get-variants.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export function createGetVariantsTool(loader) {
+    return {
+        name: 'get_variants',
+        description: 'Returns the available variants for a component, with descriptions and guidance about when to use each.',
+        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/tools/get-variants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-variants.js","sourceRoot":"","sources":["../../src/tools/get-variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,wGAAwG;QAC1G,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/tools/index.d.ts

@@ -0,0 +1,8 @@
+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/tools/index.d.ts.map

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

@@ -0,0 +1,8 @@
+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/tools/index.js.map

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

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

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

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

package/dist/tools/list-components.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export function createListComponentsTool(loader) {
+    return {
+        name: 'list_components',
+        description: 'Returns the list of components available in the design system. Use this to discover what components exist before composing content.',
+        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/tools/list-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.js","sourceRoot":"","sources":["../../src/tools/list-components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,UAAU,wBAAwB,CAAC,MAAsB;IAC7D,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,qIAAqI;QACvI,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/tools/suggest-for-intent.d.ts

@@ -0,0 +1,12 @@
+import type { McpToolDefinition } from '@forumone/throughline-plugin-contract';
+import { type AuditWriter } from '@forumone/throughline-core';
+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/tools/suggest-for-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-for-intent.d.ts","sourceRoot":"","sources":["../../src/tools/suggest-for-intent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,EAAE,KAAK,WAAW,EAAY,MAAM,4BAA4B,CAAA;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,sBAAsB,CAAA;AAGrE,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,CAoExF"}

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

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { withMeta } from '@forumone/throughline-core';
+import { validateComposition } from '../validation/composition.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 {
+        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.",
+        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({
+                actor: {
+                    type: 'user',
+                    userId: ctx.user?.id,
+                    userName: ctx.user?.name,
+                    apiKeyName: ctx.apiKeyName,
+                },
+                action: 'design.suggest',
+                mcpServer: 'component',
+                mcpTool: 'suggest_for_intent',
+                prompt: input._meta?.userPrompt ?? input.intent,
+                reasoning: input._meta?.reasoning,
+                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/tools/suggest-for-intent.js.map

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

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

@@ -0,0 +1,9 @@
+import type { McpToolDefinition } from '@forumone/throughline-plugin-contract';
+import { type AuditWriter } from '@forumone/throughline-core';
+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/tools/validate-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-composition.d.ts","sourceRoot":"","sources":["../../src/tools/validate-composition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,EAAE,KAAK,WAAW,EAAY,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG3D,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,WAAW,CAAA;CACzB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,uBAAuB,GAAG,iBAAiB,CAsC9F"}

package/dist/tools/validate-composition.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { withMeta } from '@forumone/throughline-core';
+import { validateComposition } from '../validation/composition.js';
+export function createValidateCompositionTool(deps) {
+    const inputSchema = withMeta({
+        blocks: z
+            .array(z.object({
+            type: z.string(),
+            variant: z.string().optional(),
+        }))
+            .min(1),
+    });
+    return {
+        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.",
+        inputSchema,
+        handler: async (input, ctx) => {
+            const manifest = await deps.loader.get();
+            const result = validateComposition({ blocks: input.blocks }, manifest);
+            await deps.auditWriter({
+                actor: {
+                    type: 'user',
+                    userId: ctx.user?.id,
+                    userName: ctx.user?.name,
+                    apiKeyName: ctx.apiKeyName,
+                },
+                action: 'design.validate',
+                mcpServer: 'component',
+                mcpTool: 'validate_composition',
+                prompt: input._meta?.userPrompt,
+                reasoning: input._meta?.reasoning,
+            });
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=validate-composition.js.map

package/dist/tools/validate-composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-composition.js","sourceRoot":"","sources":["../../src/tools/validate-composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAoB,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAOlE,MAAM,UAAU,6BAA6B,CAAC,IAA6B;IACzE,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,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,0LAA0L;QAC5L,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,MAAM,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAA;YAEtE,MAAM,IAAI,CAAC,WAAW,CAAC;gBACrB,KAAK,EAAE;oBACL,IAAI,EAAE,MAAM;oBACZ,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE;oBACpB,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI;oBACxB,UAAU,EAAE,GAAG,CAAC,UAAU;iBAC3B;gBACD,MAAM,EAAE,iBAAiB;gBACzB,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAE,sBAAsB;gBAC/B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU;gBAC/B,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS;aAClC,CAAC,CAAA;YAEF,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/validation/composition.d.ts

@@ -0,0 +1,38 @@
+import type { LoadedManifest } from '@forumone/throughline-design-contract';
+export interface CompositionBlock {
+    type: string;
+    variant?: string;
+}
+export interface CompositionInput {
+    blocks: CompositionBlock[];
+}
+export interface CompositionIssue {
+    severity: 'error' | 'warning';
+    rule: string;
+    message: string;
+    blockIndex?: number;
+}
+export interface CompositionResult {
+    valid: boolean;
+    issues: CompositionIssue[];
+}
+export interface AntiPatternMatch {
+    pattern: string;
+    why: string;
+    useInstead?: string | undefined;
+    blockIndex: number;
+}
+/**
+ * Validates a proposed page layout against the design system's composition
+ * rules: forbiddenAdjacent, maxPerPage, requiredSiblings, unknown components,
+ * unknown variants. Errors block; warnings advise.
+ */
+export declare function validateComposition(input: CompositionInput, manifest: LoadedManifest): CompositionResult;
+/**
+ * Surfaces structural anti-patterns inferred from each component's
+ * `antiExamples` plus position-aware heuristics. The current rule set is
+ * intentionally small and explicit; new rules should be added with care
+ * since false positives are worse than missed detections here.
+ */
+export declare function findAntiPatterns(input: CompositionInput, manifest: LoadedManifest): AntiPatternMatch[];
+//# sourceMappingURL=composition.d.ts.map

package/dist/validation/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/validation/composition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAA;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,cAAc,GACvB,iBAAiB,CA+EnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,cAAc,GACvB,gBAAgB,EAAE,CAmDpB"}