@get-technology-inc/jamf-docs-mcp-server 3.0.6 → 3.0.7

package/dist/core/services/article-service.js

@@ -0,0 +1,118 @@
+/**
+ * Shared article-fetch service
+ *
+ * Consolidates the duplicated fetch-parse-tokenize pipeline that was in
+ * both get-article.ts and batch-get-articles.ts into a single function.
+ *
+ * Key optimization: metadata and content are fetched in parallel via
+ * Promise.all when the cache misses.
+ */
+import { TOKEN_CONFIG } from '../constants.js';
+import { buildDisplayUrl } from './topic-resolver.js';
+import { fetchTopicContent, fetchTopicMetadata } from './ft-client.js';
+import { parseArticle } from './content-parser.js';
+import { getMetaValue, bundleStemToDisplayName, FT_META } from '../utils/ft-metadata.js';
+import { extractSections, extractSummary, extractSection, truncateToTokenLimit, createTokenInfo, } from './tokenizer.js';
+export async function fetchArticleFromFt(cache, mapId, contentId, articleUrl, options, cacheTtl) {
+    const maxTokens = options.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS;
+    const cacheKey = `ft:article:v2:${mapId}:${contentId}`;
+    let cached = await cache.get(cacheKey);
+    if (cached === null) {
+        // Cache miss — fetch metadata AND content in parallel
+        const [topicMeta, html] = await Promise.all([
+            fetchTopicMetadata(mapId, contentId),
+            fetchTopicContent(mapId, contentId),
+        ]);
+        const displayUrl = deriveDisplayUrl(topicMeta.readerUrl, articleUrl);
+        const { product, version } = extractProductVersion(topicMeta.metadata);
+        const rawContent = parseArticle(html, displayUrl, { includeRelated: true });
+        cached = { content: rawContent, displayUrl, product, version };
+        await cache.set(cacheKey, cached, cacheTtl);
+    }
+    const { content: rawContent, displayUrl, product, version } = cached;
+    // Build base result (shared across all code paths)
+    const allSections = extractSections(rawContent.content);
+    const base = {
+        title: rawContent.title,
+        url: displayUrl,
+        product,
+        version,
+        breadcrumb: rawContent.breadcrumb.length > 0 ? rawContent.breadcrumb : undefined,
+        relatedArticles: options.includeRelated === true && rawContent.relatedArticles.length > 0
+            ? rawContent.relatedArticles : undefined,
+        mapId,
+        contentId,
+        sections: allSections,
+    };
+    // ── summaryOnly mode ──
+    if (options.summaryOnly === true) {
+        const summaryResult = extractSummary(rawContent.content, rawContent.title, maxTokens);
+        let summaryContent = `## Summary\n\n${summaryResult.summary}\n\n`;
+        summaryContent += `## Article Outline (${summaryResult.outline.length} sections)\n\n`;
+        for (const section of summaryResult.outline) {
+            const indent = '  '.repeat(Math.max(0, section.level - 1));
+            summaryContent += `${indent}- ${section.title} (~${section.tokenCount} tokens)\n`;
+        }
+        summaryContent += `\n*Estimated read time: ${summaryResult.estimatedReadTime} min`
+            + ` (${summaryResult.totalTokens.toLocaleString()} tokens)*\n`;
+        return { ...base, content: summaryContent, tokenInfo: summaryResult.tokenInfo };
+    }
+    // ── Section extraction ──
+    if (options.section !== undefined && options.section !== '') {
+        const sectionResult = extractSection(rawContent.content, options.section, maxTokens);
+        if (sectionResult.section !== null) {
+            return { ...base, content: sectionResult.content, tokenInfo: sectionResult.tokenInfo };
+        }
+        const sectionsList = allSections.map(s => `- ${s.title}`).join('\n');
+        const notFoundMsg = `*Section "${options.section}" not found.*\n\n**Available sections:**\n${sectionsList}`;
+        return { ...base, content: notFoundMsg, tokenInfo: createTokenInfo(notFoundMsg, maxTokens) };
+    }
+    // ── Full content with truncation ──
+    const truncateResult = truncateToTokenLimit(rawContent.content, maxTokens, allSections);
+    return { ...base, content: truncateResult.content, tokenInfo: truncateResult.tokenInfo };
+}
+// ─── Resolve + fetch (shared by get-article & batch-get-articles) ──
+/**
+ * Full article retrieval pipeline:
+ *   1. Resolve mapId + contentId (skip if already provided)
+ *   2. Try provider shortcuts (articleProvider)
+ *   3. Fall back to FT API via fetchArticleFromFt
+ *
+ * Both get-article and batch-get-articles delegate here.
+ */
+export async function resolveAndFetchArticle(ctx, input, options) {
+    const { topicResolver, cache, articleProvider } = ctx;
+    const articleUrl = input.url ?? '';
+    // Step 1: Resolve mapId + contentId
+    let mapId = input.mapId;
+    let contentId = input.contentId;
+    if (mapId === undefined || contentId === undefined) {
+        const resolved = await topicResolver.resolve({ url: articleUrl });
+        ({ mapId, contentId } = resolved);
+    }
+    // Step 2: Try provider shortcuts (ID-based is primary, URL-based is fallback)
+    let article = null;
+    if (articleProvider !== undefined) {
+        article = await articleProvider.getArticleByIds(mapId, contentId, options);
+    }
+    if (article === null && articleProvider?.getArticle !== undefined && articleUrl !== '') {
+        article = await articleProvider.getArticle(articleUrl, options);
+    }
+    if (article !== null) {
+        return { ...article, mapId, contentId };
+    }
+    // Step 3: Default — fetch from FT API + parse
+    return await fetchArticleFromFt(cache, mapId, contentId, articleUrl, options, ctx.config.cacheTtl.article);
+}
+// ─── Helpers ───────────────────────────────────────────────────
+function deriveDisplayUrl(readerUrl, fallbackUrl) {
+    const prettyUrl = readerUrl ?? '';
+    return prettyUrl !== '' ? buildDisplayUrl(prettyUrl) : fallbackUrl;
+}
+function extractProductVersion(metadata) {
+    const stem = getMetaValue(metadata, FT_META.VERSION_BUNDLE_STEM);
+    const product = stem !== '' ? bundleStemToDisplayName(stem) : undefined;
+    const version = getMetaValue(metadata, FT_META.VERSION);
+    return { product, version: version !== '' ? version : 'current' };
+}
+//# sourceMappingURL=article-service.js.map

package/dist/core/services/article-service.js.map

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

package/dist/core/services/content-parser.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Content Parser — HTML → Markdown article structure
+ *
+ * Handles:
+ * - HTML cleaning (remove scripts, fix relative URLs)
+ * - HTML → Markdown conversion (Turndown)
+ * - Article structure extraction (title, breadcrumb, related articles)
+ * - Search snippet cleaning
+ */
+import * as cheerio from 'cheerio';
+/**
+ * Clean HTML content: remove unwanted elements, fix relative URLs.
+ */
+export declare function cleanHtml($: cheerio.CheerioAPI): void;
+export interface ParsedArticleContent {
+    title: string;
+    content: string;
+    breadcrumb: string[];
+    relatedArticles: {
+        title: string;
+        url: string;
+    }[];
+}
+/**
+ * Parse HTML into article structure (title, markdown content, breadcrumb).
+ */
+export declare function parseArticle(html: string, displayUrl: string, options?: {
+    includeRelated?: boolean;
+}): ParsedArticleContent;
+/**
+ * Clean an HTML search snippet: strip tags, clean breadcrumb prefixes.
+ */
+export declare function cleanSnippet(snippet: string, title: string, product: string | null): string;
+/**
+ * Convert raw HTML to Markdown using the shared Turndown instance.
+ */
+export declare function htmlToMarkdown(html: string): string;
+//# sourceMappingURL=content-parser.d.ts.map

package/dist/core/services/content-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-parser.d.ts","sourceRoot":"","sources":["../../../src/core/services/content-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAiCnC;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAgBrD;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,oBAAoB,CAgEtB;AAUD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/core/services/content-parser.js

@@ -0,0 +1,146 @@
+/**
+ * Content Parser — HTML → Markdown article structure
+ *
+ * Handles:
+ * - HTML cleaning (remove scripts, fix relative URLs)
+ * - HTML → Markdown conversion (Turndown)
+ * - Article structure extraction (title, breadcrumb, related articles)
+ * - Search snippet cleaning
+ */
+import * as cheerio from 'cheerio';
+import TurndownService from 'turndown';
+import { DOCS_BASE_URL, SELECTORS } from '../constants.js';
+// ─── Turndown instance ──────────────────────────────────────────
+const turndown = new TurndownService({
+    headingStyle: 'atx',
+    codeBlockStyle: 'fenced',
+    bulletListMarker: '-',
+    emDelimiter: '*',
+    strongDelimiter: '**',
+});
+turndown.addRule('codeBlocks', {
+    filter: 'pre',
+    replacement: (content, node) => {
+        const nodeElement = node;
+        const codeElement = nodeElement.querySelector?.('code');
+        const language = codeElement?.className?.replace('language-', '') ?? '';
+        return `\n\`\`\`${language}\n${content.trim()}\n\`\`\`\n`;
+    },
+});
+turndown.addRule('stripScripts', {
+    filter: ['script', 'style', 'noscript'],
+    replacement: () => '',
+});
+// ─── HTML cleaning ──────────────────────────────────────────────
+/**
+ * Clean HTML content: remove unwanted elements, fix relative URLs.
+ */
+export function cleanHtml($) {
+    $(SELECTORS.REMOVE).remove();
+    $('a[href^="/"]').each((_, el) => {
+        const href = $(el).attr('href');
+        if (href !== undefined && href !== '') {
+            $(el).attr('href', `${DOCS_BASE_URL}${href}`);
+        }
+    });
+    $('img[src^="/"]').each((_, el) => {
+        const src = $(el).attr('src');
+        if (src !== undefined && src !== '') {
+            $(el).attr('src', `${DOCS_BASE_URL}${src}`);
+        }
+    });
+}
+/**
+ * Parse HTML into article structure (title, markdown content, breadcrumb).
+ */
+export function parseArticle(html, displayUrl, options) {
+    const $ = cheerio.load(html);
+    cleanHtml($);
+    // Extract content — try FT API selectors first (most common path),
+    // then fall back to generic page selectors.
+    // 1. FT API returns HTML fragments wrapped in <div class="content-locale-...">
+    let contentHtml = $('div[class*="content-locale"]').first().html() ?? '';
+    // 2. Common FT body wrappers (taskbody, conbody, refbody, etc.)
+    if (contentHtml === '') {
+        contentHtml = $('[class*="body"]').first().html() ?? '';
+    }
+    // 3. Standard selectors for full HTML pages (article, .article-content, etc.)
+    if (contentHtml === '') {
+        contentHtml = $(SELECTORS.CONTENT).html() ?? '';
+    }
+    // 4. Fallback: inner HTML of <body> (cheerio wraps fragments in <html><body>)
+    if (contentHtml === '') {
+        contentHtml = $('body').html() ?? '';
+    }
+    // 5. Last resort: use raw HTML as-is
+    if (contentHtml === '') {
+        contentHtml = html;
+    }
+    const extractedTitle = $(SELECTORS.TITLE).first().text().trim();
+    const title = extractedTitle !== '' ? extractedTitle : 'Untitled';
+    // Convert to Markdown and strip Turndown anchor artifacts from headings
+    const content = turndown.turndown(contentHtml)
+        .replace(/^(#{1,6}\s+)\[([^\]]*)\]\(#[^)]*\)/gm, '$1$2');
+    // Extract breadcrumb
+    const breadcrumb = $(SELECTORS.BREADCRUMB)
+        .map((_, el) => $(el).text().trim())
+        .get()
+        .filter(Boolean);
+    // Extract related articles
+    const relatedArticles = options?.includeRelated === true
+        ? $(SELECTORS.RELATED).map((_, el) => {
+            const rawHref = $(el).attr('href') ?? '';
+            if (rawHref === '' || rawHref.startsWith('#')) {
+                return { title: '', url: '' };
+            }
+            let resolvedUrl;
+            try {
+                resolvedUrl = new URL(rawHref, displayUrl).toString();
+            }
+            catch {
+                resolvedUrl = rawHref;
+            }
+            return {
+                title: $(el).text().trim(),
+                url: resolvedUrl,
+            };
+        }).get().filter(r => r.title !== '' && r.url !== '')
+        : [];
+    return { title, content, breadcrumb, relatedArticles };
+}
+// ─── Snippet cleaning ───────────────────────────────────────────
+const MIN_SNIPPET_LENGTH = 50;
+const NAV_PATTERNS = [
+    /^Home\s*>/i,
+    /^[\w\s]+>\s*[\w\s]+>\s*[\w\s]+/,
+];
+/**
+ * Clean an HTML search snippet: strip tags, clean breadcrumb prefixes.
+ */
+export function cleanSnippet(snippet, title, product) {
+    // Strip HTML tags — loop until stable to handle nested/malformed fragments
+    let cleaned = snippet;
+    let prev;
+    do {
+        prev = cleaned;
+        cleaned = cleaned.replace(/<[^>]*>?/g, '').trim();
+    } while (cleaned !== prev);
+    for (const pattern of NAV_PATTERNS) {
+        cleaned = cleaned.replace(pattern, '').trim();
+    }
+    // As an extra safety step, strip any remaining angle brackets to avoid
+    // residual fragments like "<script" from being interpreted as HTML.
+    cleaned = cleaned.replace(/[<>]/g, '').trim();
+    if (cleaned.length < MIN_SNIPPET_LENGTH) {
+        const productSuffix = product !== null && product !== '' ? ` \u2014 ${product}` : '';
+        return `${title}${productSuffix}`;
+    }
+    return cleaned;
+}
+/**
+ * Convert raw HTML to Markdown using the shared Turndown instance.
+ */
+export function htmlToMarkdown(html) {
+    return turndown.turndown(html);
+}
+//# sourceMappingURL=content-parser.js.map

package/dist/core/services/content-parser.js.map

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

package/dist/core/services/ft-client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Fluid Topics API client
+ *
+ * Pure HTTP client for the Fluid Topics platform on learn.jamf.com.
+ * Stateless — no caching, no business logic, no provider fallback.
+ * All functions map 1:1 to FT REST API endpoints.
+ */
+import type { FtClusteredSearchResponse, FtSearchRequest, FtMapInfo, FtTocNode, FtTopicInfo } from '../types.js';
+/**
+ * POST /api/khub/clustered-search
+ *
+ * Primary search endpoint. Returns clusters of results grouped by topic,
+ * each cluster may contain multiple version entries.
+ */
+export declare function search(request: FtSearchRequest): Promise<FtClusteredSearchResponse>;
+/**
+ * GET /api/khub/maps
+ *
+ * Returns all publications (~577 maps across all locales and versions).
+ * Each map includes metadata with version_bundle_stem, version,
+ * latestVersion, ft:locale, etc.
+ */
+export declare function fetchMaps(): Promise<FtMapInfo[]>;
+/**
+ * GET /api/khub/maps/{mapId}/toc
+ *
+ * Returns the full table of contents as a JSON tree.
+ * The response is either a single root node or an array of root nodes.
+ */
+export declare function fetchMapToc(mapId: string): Promise<FtTocNode[]>;
+/**
+ * GET /api/khub/maps/{mapId}/topics
+ *
+ * Returns a flat list of all topics in a map.
+ * Richer than TOC: includes readerUrl, breadcrumb, and full metadata.
+ */
+export declare function fetchMapTopics(mapId: string): Promise<FtTopicInfo[]>;
+/**
+ * GET /api/khub/maps/{mapId}/topics/{contentId}/content
+ *
+ * Returns the HTML content of a single topic.
+ * Always returns text/html regardless of Accept header.
+ */
+export declare function fetchTopicContent(mapId: string, contentId: string): Promise<string>;
+/**
+ * GET /api/khub/maps/{mapId}/topics/{contentId}
+ *
+ * Returns topic metadata including title, contentApiEndpoint,
+ * and all metadata key-value pairs.
+ */
+export declare function fetchTopicMetadata(mapId: string, contentId: string): Promise<FtTopicInfo>;
+//# sourceMappingURL=ft-client.d.ts.map

package/dist/core/services/ft-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-client.d.ts","sourceRoot":"","sources":["../../../src/core/services/ft-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,SAAS,EACT,SAAS,EACT,WAAW,EACZ,MAAM,aAAa,CAAC;AAgBrB;;;;;GAKG;AACH,wBAAsB,MAAM,CAC1B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,yBAAyB,CAAC,CAGpC;AAID;;;;;;GAMG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAGtD;AAID;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,EAAE,CAAC,CAItB;AAID;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,CAAC,CAGxB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAGtB"}

package/dist/core/services/ft-client.js

@@ -0,0 +1,87 @@
+/**
+ * Fluid Topics API client
+ *
+ * Pure HTTP client for the Fluid Topics platform on learn.jamf.com.
+ * Stateless — no caching, no business logic, no provider fallback.
+ * All functions map 1:1 to FT REST API endpoints.
+ */
+import { httpGetJson, httpGetText, httpPostJson } from '../http-client.js';
+import { FT_API_BASE } from '../constants.js';
+// ─── URL helpers ───────────────────────────────────────────────
+/**
+ * Build a /api/khub/maps/{mapId}/... URL with proper encoding.
+ * All path segments are encoded via encodeURIComponent.
+ */
+function mapsUrl(mapId, ...segments) {
+    const base = `${FT_API_BASE}/api/khub/maps/${encodeURIComponent(mapId)}`;
+    if (segments.length === 0)
+        return base;
+    return `${base}/${segments.map(encodeURIComponent).join('/')}`;
+}
+// ─── Search ─────────────────────────────────────────────────────
+/**
+ * POST /api/khub/clustered-search
+ *
+ * Primary search endpoint. Returns clusters of results grouped by topic,
+ * each cluster may contain multiple version entries.
+ */
+export async function search(request) {
+    const url = `${FT_API_BASE}/api/khub/clustered-search`;
+    return await httpPostJson(url, request);
+}
+// ─── Maps (Publications) ────────────────────────────────────────
+/**
+ * GET /api/khub/maps
+ *
+ * Returns all publications (~577 maps across all locales and versions).
+ * Each map includes metadata with version_bundle_stem, version,
+ * latestVersion, ft:locale, etc.
+ */
+export async function fetchMaps() {
+    const url = `${FT_API_BASE}/api/khub/maps`;
+    return await httpGetJson(url);
+}
+// ─── TOC ────────────────────────────────────────────────────────
+/**
+ * GET /api/khub/maps/{mapId}/toc
+ *
+ * Returns the full table of contents as a JSON tree.
+ * The response is either a single root node or an array of root nodes.
+ */
+export async function fetchMapToc(mapId) {
+    const url = mapsUrl(mapId, 'toc');
+    const raw = await httpGetJson(url);
+    return Array.isArray(raw) ? raw : [raw];
+}
+// ─── Topics ─────────────────────────────────────────────────────
+/**
+ * GET /api/khub/maps/{mapId}/topics
+ *
+ * Returns a flat list of all topics in a map.
+ * Richer than TOC: includes readerUrl, breadcrumb, and full metadata.
+ */
+export async function fetchMapTopics(mapId) {
+    const url = mapsUrl(mapId, 'topics');
+    return await httpGetJson(url);
+}
+/**
+ * GET /api/khub/maps/{mapId}/topics/{contentId}/content
+ *
+ * Returns the HTML content of a single topic.
+ * Always returns text/html regardless of Accept header.
+ */
+export async function fetchTopicContent(mapId, contentId) {
+    const url = mapsUrl(mapId, 'topics', contentId, 'content');
+    return await httpGetText(url);
+}
+/**
+ * GET /api/khub/maps/{mapId}/topics/{contentId}
+ *
+ * Returns topic metadata including title, contentApiEndpoint,
+ * and all metadata key-value pairs.
+ */
+export async function fetchTopicMetadata(mapId, contentId) {
+    const url = mapsUrl(mapId, 'topics', contentId);
+    return await httpGetJson(url);
+}
+//# sourceMappingURL=ft-client.js.map

package/dist/core/services/ft-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ft-client.js","sourceRoot":"","sources":["../../../src/core/services/ft-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAS9C,kEAAkE;AAElE;;;GAGG;AACH,SAAS,OAAO,CAAC,KAAa,EAAE,GAAG,QAAkB;IACnD,MAAM,IAAI,GAAG,GAAG,WAAW,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;IACzE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,mEAAmE;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAwB;IAExB,MAAM,GAAG,GAAG,GAAG,WAAW,4BAA4B,CAAC;IACvD,OAAO,MAAM,YAAY,CAA4B,GAAG,EAAE,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,mEAAmE;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,GAAG,GAAG,GAAG,WAAW,gBAAgB,CAAC;IAC3C,OAAO,MAAM,WAAW,CAAc,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,mEAAmE;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa;IAEb,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,WAAW,CAA0B,GAAG,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,mEAAmE;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa;IAEb,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,OAAO,MAAM,WAAW,CAAgB,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,SAAiB;IAEjB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,OAAO,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAa,EACb,SAAiB;IAEjB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChD,OAAO,MAAM,WAAW,CAAc,GAAG,CAAC,CAAC;AAC7C,CAAC"}

package/dist/core/services/glossary.d.ts

@@ -1,8 +1,11 @@
 /**
  * Glossary service for parsing and looking up Jamf documentation glossary terms
  *
- * Jamf's glossary uses DITA glossentry format where each term is a separate page:
- *   <h1 class="glossterm">Term Name</h1>
+ * Uses Fluid Topics API on learn.jamf.com:
+ * - GET /api/khub/maps/{mapId}/toc — list all glossary terms
+ * - GET /api/khub/maps/{mapId}/topics/{contentId}/content — term HTML
+ *
+ * Jamf's glossary uses DITA glossentry format where each term is a separate topic:
  *   <div class="glossdef"><p>Definition text</p></div>
  *
  * Also supports fallback formats:
@@ -33,9 +36,10 @@ export declare function searchGlossaryEntries(entries: GlossaryEntry[], term: st
  * Look up a glossary term across Jamf documentation.
  *
  * Strategy:
- * 1. Search via Zoomin API with docType=glossary to find glossary pages
- * 2. Fetch and parse each glossary page (with caching)
- * 3. Use fuse.js to rank matching terms
+ * 1. Fetch glossary TOC from Fluid Topics API (cached)
+ * 2. Fuzzy-match term against TOC titles
+ * 3. Fetch and parse matching glossary topics
+ * 4. Rank results with fuse.js and apply token limit
  */
 export declare function lookupGlossaryTerm(ctx: ServerContext, params: {
     term: string;

package/dist/core/services/glossary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../../src/core/services/glossary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAGrB,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUzD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CA0BvG;AAsID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAuB7F;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,GACA,OAAO,CAAC,oBAAoB,CAAC,CAgG/B"}
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../../src/core/services/glossary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAErB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA4EzD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,EAAE,CAyBjB;AAiND;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EAAE,EACxB,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CAsBjB;AAID;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,GACA,OAAO,CAAC,oBAAoB,CAAC,CAqI/B"}