@forumone/throughline 0.0.0 → 1.0.0-next.0

package/dist/audit/writer.js

@@ -0,0 +1,101 @@
+/**
+ * Returns a fire-and-forget audit writer. The writer never throws — failures
+ * log via `options.logger` (or `console`). Audit failures must not break
+ * the originating action.
+ *
+ * If `inngest` is provided the writer also fires an `audit/event.recorded`
+ * event so subscribers (email, integrations, healthchecks) can react.
+ */
+export function createAuditWriter(options) {
+    const { payload, inngest, collectionSlug = 'audit-events', logger } = options;
+    return async function recordAuditEvent(event) {
+        try {
+            const summary = event.summary ?? generateSummary(event);
+            const created = await payload.create({
+                collection: collectionSlug,
+                data: stripUndefined({
+                    createdAt: new Date().toISOString(),
+                    actor: stripUndefined({ ...event.actor }),
+                    action: event.action,
+                    mcpServer: event.mcpServer,
+                    mcpTool: event.mcpTool,
+                    targetCollection: event.targetCollection,
+                    targetId: event.targetId,
+                    targetTitle: event.targetTitle,
+                    prompt: event.prompt,
+                    reasoning: event.reasoning,
+                    changesSummary: event.changesSummary,
+                    summary,
+                    diff: event.diff ?? null,
+                    success: event.success ?? true,
+                    errorMessage: event.errorMessage,
+                    approvalRequestId: event.approvalRequestId,
+                    integrationId: event.integrationId,
+                }),
+            });
+            if (inngest) {
+                try {
+                    await inngest.send({
+                        name: 'audit/event.recorded',
+                        data: stripUndefined({
+                            auditEventId: String(created.id),
+                            action: event.action,
+                            actorId: event.actor.userId,
+                            targetCollection: event.targetCollection,
+                            targetId: event.targetId,
+                            approvalRequestId: event.approvalRequestId,
+                            integrationId: event.integrationId,
+                        }),
+                    });
+                }
+                catch (eventError) {
+                    logger?.warn('Audit Inngest event send failed', { error: String(eventError) });
+                }
+            }
+        }
+        catch (writeError) {
+            logger?.error('Audit event write failed', {
+                error: String(writeError),
+                action: event.action,
+                targetCollection: event.targetCollection,
+                targetId: event.targetId,
+            });
+            // Intentionally swallowed: never let audit failures break the original action.
+        }
+    };
+}
+const SUMMARY_TEMPLATES = {
+    'content.update': (e) => `Updated ${e.targetTitle ?? e.targetId ?? '(unknown)'} in ${e.targetCollection ?? '(unknown)'}`,
+    'content.create': (e) => `Created ${e.targetTitle ?? e.targetId ?? '(unknown)'} in ${e.targetCollection ?? '(unknown)'}`,
+    'content.delete': (e) => `Deleted ${e.targetTitle ?? e.targetId ?? '(unknown)'} from ${e.targetCollection ?? '(unknown)'}`,
+    'content.find': (e) => `Queried ${e.targetCollection ?? '(unknown)'}`,
+    'design.suggest': (e) => `Searched for components matching: ${e.prompt?.slice(0, 80) ?? 'an intent'}`,
+    'design.validate': () => 'Validated a composition',
+    'design.get_contract': (e) => `Fetched contract for ${e.targetTitle ?? '(a component)'}`,
+    'publishing.publish': (e) => `Published ${e.targetTitle ?? e.targetId ?? '(unknown)'}`,
+    'publishing.unpublish': (e) => `Unpublished ${e.targetTitle ?? e.targetId ?? '(unknown)'}`,
+    'publishing.schedule': (e) => `Scheduled publish for ${e.targetTitle ?? e.targetId ?? '(unknown)'}`,
+    'publishing.rollback': (e) => `Rolled back ${e.targetTitle ?? e.targetId ?? '(unknown)'}`,
+    'approval.requested': (e) => `Requested approval for ${e.targetTitle ?? e.targetId ?? '(unknown)'}`,
+    'approval.granted': (e) => `Granted approval for ${e.targetTitle ?? e.targetId ?? '(unknown)'}`,
+    'approval.declined': (e) => `Declined approval for ${e.targetTitle ?? e.targetId ?? '(unknown)'}`,
+    'approval.expired': (e) => `Approval expired for ${e.targetTitle ?? e.targetId ?? '(unknown)'}`,
+    'form.submission_received': (e) => `Form submission received for ${e.targetTitle ?? e.targetId ?? '(unknown)'}`,
+    'integration.synced': (e) => `Synced ${e.integrationId ?? '(unknown integration)'}`,
+    'integration.failed': (e) => `Integration failed: ${e.integrationId ?? '(unknown integration)'}`,
+};
+function generateSummary(event) {
+    const template = SUMMARY_TEMPLATES[event.action];
+    if (template)
+        return template(event);
+    return `${event.action} (${event.mcpServer}:${event.mcpTool})`;
+}
+function stripUndefined(obj) {
+    const out = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=writer.js.map

package/dist/audit/writer.js.map

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

package/dist/cache-tags.d.ts

@@ -0,0 +1,31 @@
+/** How a site names its tags. Each builder is optional; omitted ones use the default. */
+export interface CacheTagScheme {
+    /**
+     * The tag for cached reads derived from a collection's documents.
+     * Default: the bare slug (`pages`), which is also what
+     * `revalidateOnPublishJob` has always fired.
+     */
+    collection?: (slug: string) => string;
+    /** The tag for a cached global. Default: `global_<slug>`. */
+    global?: (slug: string) => string;
+}
+/** The built scheme. Pass the same instance to writers and readers. */
+export interface CacheTags {
+    collection(slug: string): string;
+    global(slug: string): string;
+}
+/**
+ * Builds the tag scheme both ends of the cache use.
+ *
+ * ```ts
+ * // src/lib/cache-tags.ts — imported by payload.config.ts and by readers
+ * export const cacheTags = createCacheTags()
+ *
+ * // a reader
+ * unstable_cache(load, ['navigation'], { tags: [cacheTags.global('navigation')] })
+ * ```
+ */
+export declare function createCacheTags(scheme?: CacheTagScheme): CacheTags;
+/** The scheme every writer uses when it is given none. */
+export declare const defaultCacheTags: CacheTags;
+//# sourceMappingURL=cache-tags.d.ts.map

package/dist/cache-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tags.d.ts","sourceRoot":"","sources":["../src/cache-tags.ts"],"names":[],"mappings":"AAqBA,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACrC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAClC;AAED,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,cAAmB,GAAG,SAAS,CAOtE;AAED,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,EAAE,SAA6B,CAAA"}

package/dist/cache-tags.js

@@ -0,0 +1,53 @@
+/*
+Next cache tags, named in one place.
+
+A tag is one string with two ends: the reader that caches under it
+(`unstable_cache(..., { tags })`, `cacheTag()`, `fetch(..., { next: { tags } })`)
+and the writer that drops it (the hooks in `revalidate-tag-hooks.ts`, and
+`revalidateOnPublishJob`). Nothing in the type system connects the two
+ends. Name them differently and everything compiles, every test passes, the hook
+runs, and the page never refreshes — the first site on this suite shipped a hook
+that had never invalidated anything for exactly that reason.
+
+So both ends build tags from one object. A site makes it once, in a module its
+`payload.config.ts` and its frontend both import, and hands it to the hooks and
+the readers alike.
+
+Deliberately dependency-free, and published on its own subpath
+(`@forumone/throughline/cache-tags`): one of its importers is
+`payload.config.ts` and the other is frontend code, and neither should pull in
+the other's world to name a string.
+*/
+/**
+ * Builds the tag scheme both ends of the cache use.
+ *
+ * ```ts
+ * // src/lib/cache-tags.ts — imported by payload.config.ts and by readers
+ * export const cacheTags = createCacheTags()
+ *
+ * // a reader
+ * unstable_cache(load, ['navigation'], { tags: [cacheTags.global('navigation')] })
+ * ```
+ */
+export function createCacheTags(scheme = {}) {
+    const collection = scheme.collection ?? ((slug) => slug);
+    const global = scheme.global ?? ((slug) => `global_${slug}`);
+    return {
+        collection: (slug) => nonEmpty(collection(slug), 'collection', slug),
+        global: (slug) => nonEmpty(global(slug), 'global', slug),
+    };
+}
+/** The scheme every writer uses when it is given none. */
+export const defaultCacheTags = createCacheTags();
+/*
+An empty tag is the silent version of the mismatch above: `revalidateTag('')`
+does nothing and says nothing. A builder that produces one is a bug in the
+site's configuration, and the place to hear about it is the first call.
+*/
+function nonEmpty(tag, kind, slug) {
+    if (typeof tag !== 'string' || tag.length === 0) {
+        throw new Error(`The cache tag scheme built an empty ${kind} tag for "${slug}".`);
+    }
+    return tag;
+}
+//# sourceMappingURL=cache-tags.js.map

package/dist/cache-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tags.js","sourceRoot":"","sources":["../src/cache-tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;EAmBE;AAoBF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,SAAyB,EAAE;IACzD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,CAAA;IACpE,OAAO;QACL,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC;QACpE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC;KACzD,CAAA;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAc,eAAe,EAAE,CAAA;AAE5D;;;;EAIE;AACF,SAAS,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,IAAY;IACvD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,aAAa,IAAI,IAAI,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/components/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `@forumone/throughline/components`: the design system's component manifest,
+ * served to an MCP client: what exists, how it may be composed, and which
+ * component fits an intent. Was `@forumone/throughline-components` in 0.x.
+ */
+export { componentsPlugin } from './plugin.js';
+export type { ComponentsPluginOptions, ManifestSource, MatchingConfig } from './options.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,YAAY,EAAE,uBAAuB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/dist/components/index.js

@@ -0,0 +1,7 @@
+/**
+ * `@forumone/throughline/components`: the design system's component manifest,
+ * served to an MCP client: what exists, how it may be composed, and which
+ * component fits an intent. Was `@forumone/throughline-components` in 0.x.
+ */
+export { componentsPlugin } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/components/manifest-source.d.ts

@@ -0,0 +1,17 @@
+import type { Payload } from 'payload';
+import { type LoadedManifest } from '@forumone/throughline-design-contract';
+import type { ManifestSource } from './options.js';
+export interface ManifestLoader {
+    /** Returns the cached manifest, refreshing if the URL TTL has expired. */
+    get(): Promise<LoadedManifest>;
+    /** Forces a re-fetch from the source. */
+    refresh(): Promise<LoadedManifest>;
+}
+/**
+ * Builds a manifest loader from a source descriptor. The loader caches the
+ * parsed manifest indefinitely for `object` and `payload-collection` sources;
+ * for `url` sources it honors `refreshInterval` (seconds) and re-fetches when
+ * the cached copy is older than that.
+ */
+export declare function createManifestLoader(source: ManifestSource, payload: Payload): ManifestLoader;
+//# sourceMappingURL=manifest-source.d.ts.map

package/dist/components/manifest-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-source.d.ts","sourceRoot":"","sources":["../../src/components/manifest-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;IAC9B,yCAAyC;IACzC,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAuD7F"}

package/dist/components/manifest-source.js

@@ -0,0 +1,60 @@
+import { loadManifest, loadManifestFromUrl, } from '@forumone/throughline-design-contract';
+/**
+ * Builds a manifest loader from a source descriptor. The loader caches the
+ * parsed manifest indefinitely for `object` and `payload-collection` sources;
+ * for `url` sources it honors `refreshInterval` (seconds) and re-fetches when
+ * the cached copy is older than that.
+ */
+export function createManifestLoader(source, payload) {
+    let cached = null;
+    let lastLoadedAt = 0;
+    async function load() {
+        switch (source.type) {
+            case 'object':
+                return loadManifest(source.manifest);
+            case 'url':
+                return loadManifestFromUrl(source.url);
+            case 'payload-collection': {
+                const where = source.documentId
+                    ? { id: { equals: source.documentId } }
+                    : undefined;
+                const result = await payload.find({
+                    collection: source.slug,
+                    ...(where ? { where } : {}),
+                    limit: 1,
+                    sort: '-updatedAt',
+                });
+                const doc = result.docs[0];
+                if (!doc) {
+                    const idClause = source.documentId ? ` with id "${source.documentId}"` : '';
+                    throw new Error(`No manifest document found in collection "${source.slug}"${idClause}`);
+                }
+                const candidate = (doc['data'] ?? doc);
+                return loadManifest(candidate);
+            }
+        }
+    }
+    return {
+        async get() {
+            if (cached) {
+                if (source.type === 'url' && source.refreshInterval !== undefined) {
+                    const ageMs = Date.now() - lastLoadedAt;
+                    if (ageMs > source.refreshInterval * 1000) {
+                        cached = await load();
+                        lastLoadedAt = Date.now();
+                    }
+                }
+                return cached;
+            }
+            cached = await load();
+            lastLoadedAt = Date.now();
+            return cached;
+        },
+        async refresh() {
+            cached = await load();
+            lastLoadedAt = Date.now();
+            return cached;
+        },
+    };
+}
+//# sourceMappingURL=manifest-source.js.map

package/dist/components/manifest-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-source.js","sourceRoot":"","sources":["../../src/components/manifest-source.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,YAAY,EACZ,mBAAmB,GACpB,MAAM,uCAAuC,CAAA;AAU9C;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAsB,EAAE,OAAgB;IAC3E,IAAI,MAAM,GAA0B,IAAI,CAAA;IACxC,IAAI,YAAY,GAAG,CAAC,CAAA;IAEpB,KAAK,UAAU,IAAI;QACjB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,QAAQ;gBACX,OAAO,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YACtC,KAAK,KAAK;gBACR,OAAO,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACxC,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU;oBAC7B,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE;oBACvC,CAAC,CAAC,SAAS,CAAA;gBACb,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBAChC,UAAU,EAAE,MAAM,CAAC,IAAI;oBACvB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3B,KAAK,EAAE,CAAC;oBACR,IAAI,EAAE,YAAY;iBACnB,CAAC,CAAA;gBACF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAwC,CAAA;gBACjE,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;oBAC3E,MAAM,IAAI,KAAK,CACb,6CAA6C,MAAM,CAAC,IAAI,IAAI,QAAQ,EAAE,CACvE,CAAA;gBACH,CAAC;gBACD,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAY,CAAA;gBACjD,OAAO,YAAY,CAAC,SAAS,CAAC,CAAA;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,GAAG;YACP,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;oBAClE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAA;oBACvC,IAAI,KAAK,GAAG,MAAM,CAAC,eAAe,GAAG,IAAI,EAAE,CAAC;wBAC1C,MAAM,GAAG,MAAM,IAAI,EAAE,CAAA;wBACrB,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;oBAC3B,CAAC;gBACH,CAAC;gBACD,OAAO,MAAM,CAAA;YACf,CAAC;YACD,MAAM,GAAG,MAAM,IAAI,EAAE,CAAA;YACrB,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACzB,OAAO,MAAM,CAAA;QACf,CAAC;QACD,KAAK,CAAC,OAAO;YACX,MAAM,GAAG,MAAM,IAAI,EAAE,CAAA;YACrB,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACzB,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,3 @@
+export { createTfidfMatcher } from './tfidf.js';
+export type { Matcher, RankedComponent, RankedSuggestion } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/matching/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}

package/dist/components/matching/index.js

@@ -0,0 +1,2 @@
+export { createTfidfMatcher } from './tfidf.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/matching/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

package/dist/components/matching/tfidf.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentContract } from '@forumone/throughline-design-contract';
+import type { Matcher } from './types.js';
+/**
+ * Simple TF-IDF matcher over component search documents. Indexed once at
+ * factory time; subsequent `rank()` calls scan the precomputed index.
+ *
+ * The search document weights `intent` more than `description`, and includes
+ * variant `whenToUse` text + example intents. Editorial language often shows
+ * up in those fields, so weighting them helps real intents like "introduce
+ * a new program" find the Hero's `intent` rather than its name.
+ */
+export declare function createTfidfMatcher(components: ComponentContract[]): Matcher;
+//# sourceMappingURL=tfidf.d.ts.map

package/dist/components/matching/tfidf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tfidf.d.ts","sourceRoot":"","sources":["../../../src/components/matching/tfidf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAmB,MAAM,YAAY,CAAA;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CA8C3E"}

package/dist/components/matching/tfidf.js

@@ -0,0 +1,118 @@
+/**
+ * Simple TF-IDF matcher over component search documents. Indexed once at
+ * factory time; subsequent `rank()` calls scan the precomputed index.
+ *
+ * The search document weights `intent` more than `description`, and includes
+ * variant `whenToUse` text + example intents. Editorial language often shows
+ * up in those fields, so weighting them helps real intents like "introduce
+ * a new program" find the Hero's `intent` rather than its name.
+ */
+export function createTfidfMatcher(components) {
+    const index = components.map((component) => {
+        const document = makeSearchDocument(component);
+        const tokens = tokenize(document);
+        const termFreq = new Map();
+        for (const token of tokens) {
+            termFreq.set(token, (termFreq.get(token) ?? 0) + 1);
+        }
+        return { component, terms: termFreq, length: Math.max(tokens.length, 1) };
+    });
+    const docCount = index.length;
+    const docFreq = new Map();
+    for (const entry of index) {
+        for (const term of entry.terms.keys()) {
+            docFreq.set(term, (docFreq.get(term) ?? 0) + 1);
+        }
+    }
+    const idf = new Map();
+    for (const [term, df] of docFreq) {
+        idf.set(term, Math.log((docCount + 1) / (df + 1)) + 1);
+    }
+    return {
+        rank(query) {
+            const queryCounts = new Map();
+            for (const token of tokenize(query)) {
+                queryCounts.set(token, (queryCounts.get(token) ?? 0) + 1);
+            }
+            const scored = index.map((entry) => {
+                let score = 0;
+                for (const [term, queryCount] of queryCounts) {
+                    const docCountForTerm = entry.terms.get(term) ?? 0;
+                    if (docCountForTerm === 0)
+                        continue;
+                    const tf = docCountForTerm / entry.length;
+                    const termIdf = idf.get(term) ?? 0;
+                    score += tf * termIdf * queryCount;
+                }
+                return { component: entry.component, score };
+            });
+            scored.sort((a, b) => b.score - a.score);
+            return scored;
+        },
+    };
+}
+function makeSearchDocument(component) {
+    const parts = [
+        // Intent and description are the most-weighted fields. Repeat the intent
+        // twice so it dominates rankings when its terms match.
+        component.intent,
+        component.intent,
+        component.description,
+        component.name,
+        ...(component.content.variants ?? []).flatMap((v) => [v.name, v.whenToUse]),
+        ...component.examples.map((e) => e.intent),
+    ];
+    return parts.join(' ');
+}
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s]/g, ' ')
+        .split(/\s+/)
+        .filter((t) => t.length > 2 && !STOP_WORDS.has(t));
+}
+const STOP_WORDS = new Set([
+    'the',
+    'and',
+    'for',
+    'with',
+    'that',
+    'this',
+    'have',
+    'has',
+    'had',
+    'are',
+    'was',
+    'were',
+    'been',
+    'being',
+    'will',
+    'would',
+    'should',
+    'could',
+    'may',
+    'might',
+    'must',
+    'shall',
+    'can',
+    'these',
+    'those',
+    'its',
+    'use',
+    'used',
+    'using',
+    'when',
+    'where',
+    'how',
+    'what',
+    'which',
+    'into',
+    'onto',
+    'than',
+    'then',
+    'them',
+    'they',
+    'their',
+    'there',
+]);
+//# sourceMappingURL=tfidf.js.map

package/dist/components/matching/tfidf.js.map

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

package/dist/components/matching/types.d.ts

@@ -0,0 +1,22 @@
+import type { ComponentContract } from '@forumone/throughline-design-contract';
+export interface RankedComponent {
+    component: ComponentContract;
+    score: number;
+}
+export interface Matcher {
+    /** Returns the indexed components ranked best-first against the query. */
+    rank(query: string): RankedComponent[];
+}
+/**
+ * Surface returned by {@link suggest_for_intent}. Same shape regardless of the
+ * underlying matcher.
+ */
+export interface RankedSuggestion {
+    component: string;
+    score: number;
+    reasoning: string;
+    matchedIntent: string;
+    variant?: string;
+    warnings?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/matching/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/matching/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAE9E,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,iBAAiB,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,OAAO;IACtB,0EAA0E;IAC1E,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAAA;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB"}

package/dist/components/matching/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/matching/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/components/matching/types.ts"],"names":[],"mappings":""}

package/dist/components/options.d.ts

@@ -0,0 +1,136 @@
+import type { McpToolCollector } from '../mcp/collector.js';
+import { z } from 'zod';
+import type { BaseCorePluginOptions } from '../plugin-contract/index.js';
+import type { Manifest } from '@forumone/throughline-design-contract';
+export type ManifestSource = {
+    type: 'object';
+    manifest: Manifest;
+} | {
+    type: 'url';
+    url: string;
+    refreshInterval?: number;
+} | {
+    type: 'payload-collection';
+    slug: string;
+    documentId?: string;
+};
+export interface MatchingConfig {
+    /**
+     * Strategy for ranking components against a natural-language intent.
+     * `tfidf` ships now and requires no external dependencies; `embeddings`
+     * is reserved for a follow-up.
+     */
+    strategy: 'tfidf';
+    /** Maximum number of recommendations from `suggest_for_intent`. Default: 5. */
+    maxRecommendations?: number;
+}
+export interface ComponentsPluginOptions extends Omit<BaseCorePluginOptions, 'routePrefix'> {
+    /** Required: where the design system manifest comes from. */
+    manifest: ManifestSource;
+    /** Optional: how the plugin matches intents to components. Defaults to TF-IDF. */
+    matching?: MatchingConfig;
+    /**
+     * Where to put this server's MCP tools so Payload's own MCP plugin can serve
+     * them.
+     *
+     * `createMcpToolCollector()` from `@forumone/throughline`. The host hands
+     * its array to `@payloadcms/plugin-mcp` at config time and this plugin fills
+     * it at `onInit` — which is the first moment the tools can exist, since they
+     * close over `payload`, and still before any request reads the array.
+     *
+     * Omit it and nothing changes: this server keeps its own `/mcp` endpoint,
+     * which is what lets a host move one server at a time.
+     */
+    mcpTools?: McpToolCollector;
+}
+export declare const ComponentsPluginOptionsSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    manifest: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"object">;
+        manifest: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        type: "object";
+        manifest?: unknown;
+    }, {
+        type: "object";
+        manifest?: unknown;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        refreshInterval: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "url";
+        url: string;
+        refreshInterval?: number | undefined;
+    }, {
+        type: "url";
+        url: string;
+        refreshInterval?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"payload-collection">;
+        slug: z.ZodString;
+        documentId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "payload-collection";
+        slug: string;
+        documentId?: string | undefined;
+    }, {
+        type: "payload-collection";
+        slug: string;
+        documentId?: string | undefined;
+    }>]>;
+    matching: z.ZodOptional<z.ZodObject<{
+        strategy: z.ZodEnum<["tfidf"]>;
+        maxRecommendations: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        strategy: "tfidf";
+        maxRecommendations?: number | undefined;
+    }, {
+        strategy: "tfidf";
+        maxRecommendations?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    manifest: {
+        type: "object";
+        manifest?: unknown;
+    } | {
+        type: "url";
+        url: string;
+        refreshInterval?: number | undefined;
+    } | {
+        type: "payload-collection";
+        slug: string;
+        documentId?: string | undefined;
+    };
+    enabled?: boolean | undefined;
+    matching?: {
+        strategy: "tfidf";
+        maxRecommendations?: number | undefined;
+    } | undefined;
+}, {
+    manifest: {
+        type: "object";
+        manifest?: unknown;
+    } | {
+        type: "url";
+        url: string;
+        refreshInterval?: number | undefined;
+    } | {
+        type: "payload-collection";
+        slug: string;
+        documentId?: string | undefined;
+    };
+    enabled?: boolean | undefined;
+    matching?: {
+        strategy: "tfidf";
+        maxRecommendations?: number | undefined;
+    } | undefined;
+}>;
+/**
+ * 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 declare function validateOptions(options: ComponentsPluginOptions): ComponentsPluginOptions;
+//# sourceMappingURL=options.d.ts.map