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

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

@@ -0,0 +1,462 @@
+/**
+ * Search service — Fluid Topics powered search
+ */
+import { JAMF_PRODUCTS, JAMF_TOPICS, DOC_TYPE_CONTENT_TYPE_MAP, DOC_TYPE_LABEL_MAP, CONTENT_LIMITS, TOKEN_CONFIG, PAGINATION_CONFIG, DEFAULT_LOCALE, } from '../constants.js';
+import { search as ftSearch } from './ft-client.js';
+import { buildDisplayUrl } from './topic-resolver.js';
+import { cleanSnippet } from './content-parser.js';
+import { getMetaValues, FT_META } from '../utils/ft-metadata.js';
+import { estimateTokens, calculatePagination, truncateListByTokens, buildPaginationNote, } from './tokenizer.js';
+// ─── Helpers ───────────────────────────────────────────────────
+/** Pre-computed lowercase keywords per topic */
+const TOPIC_KEYWORDS_LOWER = Object.fromEntries(Object.keys(JAMF_TOPICS).map(id => [
+    id,
+    JAMF_TOPICS[id].keywords.map(k => k.toLowerCase()),
+]));
+const ALL_TOPIC_IDS = Object.keys(JAMF_TOPICS);
+function matchTopics(title, snippet) {
+    const searchText = `${title} ${snippet}`.toLowerCase();
+    return ALL_TOPIC_IDS.filter(topicId => TOPIC_KEYWORDS_LOWER[topicId].some(kw => searchText.includes(kw)));
+}
+/** Pre-computed reverse lookup: product display name → ProductId */
+const PRODUCT_NAME_TO_ID = Object.fromEntries(Object.keys(JAMF_PRODUCTS).map(id => [JAMF_PRODUCTS[id].name, id]));
+/**
+ * Resolve a product display name (e.g. 'Jamf Pro') to its ProductId
+ * (e.g. 'jamf-pro'). Returns null when the name is unknown.
+ */
+function productNameToId(name) {
+    if (name === null) {
+        return null;
+    }
+    return PRODUCT_NAME_TO_ID[name] ?? null;
+}
+/**
+ * Extract product ID (e.g. 'jamf-pro') from a legacy metadata value
+ * like 'product-pro'. Falls back to scanning known searchLabel values.
+ */
+function extractProductFromZoominMeta(metadata) {
+    const values = getMetaValues(metadata, FT_META.ZOOMIN_METADATA);
+    for (const val of values) {
+        // Match against known searchLabels in JAMF_PRODUCTS
+        const matched = Object.entries(JAMF_PRODUCTS).find(([, product]) => product.searchLabel === val);
+        if (matched !== undefined) {
+            return matched[1].name;
+        }
+    }
+    return null;
+}
+/**
+ * Derive docType from FT metadata `jamf:contentType`.
+ * Falls back to 'documentation'.
+ *
+ * Note: The FT API uses 'Technical Documentation' for multiple doc types
+ * (documentation, training, solution-guide, getting-started). Because
+ * DOC_TYPE_CONTENT_TYPE_MAP is iterated in insertion order, this reverse
+ * lookup always returns 'documentation' for any of those types. This is
+ * a known FT API limitation — there is no metadata to distinguish them.
+ */
+function docTypeFromFtMetadata(metadata) {
+    const values = getMetaValues(metadata, FT_META.CONTENT_TYPE);
+    if (values.length > 0) {
+        // Reverse-lookup DOC_TYPE_CONTENT_TYPE_MAP
+        for (const [docType, contentType] of Object.entries(DOC_TYPE_CONTENT_TYPE_MAP)) {
+            if (values.includes(contentType)) {
+                return docType;
+            }
+        }
+    }
+    return 'documentation';
+}
+// ─── Filter Construction ───────────────────────────────────────
+/**
+ * Build Fluid Topics search filters from search params.
+ *
+ * - product → `zoominmetadata` filter using searchLabel
+ * - docType → `jamf:contentType` filter using DOC_TYPE_CONTENT_TYPE_MAP
+ * - version → `version` filter
+ * - auto-adds `latestVersion=yes` when no version specified
+ */
+export function buildSearchFilters(params) {
+    const filters = [];
+    // Product filter
+    if (params.product !== undefined) {
+        const productDef = JAMF_PRODUCTS[params.product];
+        filters.push({
+            key: FT_META.ZOOMIN_METADATA,
+            values: [productDef.searchLabel],
+        });
+    }
+    // Document type filter
+    if (params.docType !== undefined) {
+        const contentType = DOC_TYPE_CONTENT_TYPE_MAP[params.docType];
+        if (contentType !== undefined) {
+            filters.push({
+                key: FT_META.CONTENT_TYPE,
+                values: [contentType],
+            });
+        }
+    }
+    // Version handling
+    if (params.version !== undefined && params.version !== '' && params.version !== 'current') {
+        filters.push({
+            key: FT_META.VERSION,
+            values: [params.version],
+        });
+    }
+    else {
+        // Auto-add latestVersion filter when no specific version requested
+        filters.push({
+            key: FT_META.LATEST_VERSION,
+            values: ['yes'],
+        });
+    }
+    return filters;
+}
+// ─── Result Transformation ─────────────────────────────────────
+/**
+ * Transform a Fluid Topics search entry into an enriched SearchResult.
+ */
+export function transformFtSearchResult(entry) {
+    if (entry.type === 'TOPIC' && entry.topic !== undefined) {
+        return transformTopicEntry(entry);
+    }
+    if (entry.type === 'MAP' && entry.map !== undefined) {
+        return transformMapEntry(entry);
+    }
+    // Fallback for unexpected entry shapes
+    return {
+        title: 'Untitled',
+        url: '',
+        snippet: '',
+        product: null,
+    };
+}
+/**
+ * Shared builder: turns the common fields of a TOPIC or MAP entry
+ * into a fully-populated SearchResult.
+ */
+function buildSearchResult(fields) {
+    const { metadata } = fields;
+    const title = fields.title !== '' ? fields.title : 'Untitled';
+    const product = extractProductFromZoominMeta(metadata);
+    const snippet = cleanSnippet(fields.htmlExcerpt, title, product);
+    const versionValues = getMetaValues(metadata, FT_META.VERSION);
+    const docType = docTypeFromFtMetadata(metadata);
+    const result = {
+        title,
+        url: fields.url,
+        snippet,
+        product,
+        docType,
+        mapId: fields.mapId,
+    };
+    if (fields.contentId !== undefined) {
+        result.contentId = fields.contentId;
+    }
+    const firstVersion = versionValues[0];
+    if (firstVersion !== undefined) {
+        result.version = firstVersion;
+    }
+    if (fields.breadcrumb !== undefined && fields.breadcrumb.length > 0) {
+        result.breadcrumb = fields.breadcrumb;
+    }
+    if (fields.mapTitle !== undefined && fields.mapTitle !== '') {
+        result.mapTitle = fields.mapTitle;
+    }
+    return result;
+}
+function resolveTopicUrl(topic) {
+    const prettyUrls = getMetaValues(topic.metadata, FT_META.PRETTY_URL);
+    const rawPrettyUrl = prettyUrls[0];
+    if (rawPrettyUrl !== undefined) {
+        const normalizedPath = rawPrettyUrl.startsWith('/')
+            ? rawPrettyUrl
+            : `/r/${rawPrettyUrl}`;
+        return buildDisplayUrl(normalizedPath);
+    }
+    return buildDisplayUrl(`/r/en-US/${topic.mapId}/${topic.contentId}`);
+}
+function resolveMapUrl(map) {
+    if (map.readerUrl !== '') {
+        return buildDisplayUrl(map.readerUrl);
+    }
+    if (map.mapUrl !== '') {
+        return buildDisplayUrl(map.mapUrl);
+    }
+    return '';
+}
+function transformTopicEntry(entry) {
+    const { topic } = entry;
+    if (topic === undefined) {
+        return { title: 'Untitled', url: '', snippet: '', product: null };
+    }
+    return buildSearchResult({
+        title: topic.title,
+        url: resolveTopicUrl(topic),
+        htmlExcerpt: topic.htmlExcerpt,
+        metadata: topic.metadata,
+        mapId: topic.mapId,
+        contentId: topic.contentId,
+        breadcrumb: topic.breadcrumb,
+        mapTitle: topic.mapTitle,
+    });
+}
+function transformMapEntry(entry) {
+    const { map } = entry;
+    if (map === undefined) {
+        return { title: 'Untitled', url: '', snippet: '', product: null };
+    }
+    return buildSearchResult({
+        title: map.title,
+        url: resolveMapUrl(map),
+        htmlExcerpt: map.htmlExcerpt,
+        metadata: map.metadata,
+        mapId: map.mapId,
+        mapTitle: map.title,
+    });
+}
+// ─── Filter Relaxation ─────────────────────────────────────────
+/**
+ * Build active filters from search params for progressive relaxation.
+ * These are client-side post-filters for topic matching (which FT
+ * doesn't support server-side).
+ */
+function buildActiveFilters(params) {
+    const activeFilters = [];
+    if (params.product !== undefined) {
+        const productId = params.product;
+        activeFilters.push({
+            name: 'product',
+            value: productId,
+            apply: (results) => results.filter(r => r.bundleSlug === productId),
+        });
+    }
+    if (params.topic !== undefined) {
+        const topicFilter = params.topic;
+        activeFilters.push({
+            name: 'topic',
+            value: topicFilter,
+            apply: (results) => results.filter(r => r.matchedTopics.includes(topicFilter)),
+        });
+    }
+    if (params.docType !== undefined) {
+        const docTypeFilter = params.docType;
+        const targetLabelKey = DOC_TYPE_LABEL_MAP[docTypeFilter];
+        if (targetLabelKey !== undefined) {
+            activeFilters.push({
+                name: 'docType',
+                value: docTypeFilter,
+                apply: (results) => results.filter(r => {
+                    if (r.labelKeys.length === 0) {
+                        return true;
+                    }
+                    return r.labelKeys.includes(targetLabelKey);
+                }),
+            });
+        }
+    }
+    return activeFilters;
+}
+/**
+ * Apply filters with progressive relaxation when results are zero.
+ * Relaxation order: docType -> topic -> product
+ */
+function applyFiltersWithFallback(allResults, activeFilters) {
+    let filtered = allResults;
+    for (const filter of activeFilters) {
+        filtered = filter.apply(filtered);
+    }
+    if (filtered.length > 0 || activeFilters.length === 0) {
+        return { filtered };
+    }
+    // Progressive relaxation
+    const relaxOrder = ['docType', 'topic', 'product'];
+    const removed = [];
+    const original = {};
+    for (const filterName of relaxOrder) {
+        if (filtered.length > 0) {
+            break;
+        }
+        const filterIndex = activeFilters.findIndex(f => f.name === filterName);
+        if (filterIndex === -1) {
+            continue;
+        }
+        const removedFilter = activeFilters[filterIndex];
+        if (removedFilter === undefined) {
+            continue;
+        }
+        removed.push(removedFilter.name);
+        original[removedFilter.name] = removedFilter.value;
+        activeFilters.splice(filterIndex, 1);
+        // Re-apply remaining filters
+        filtered = allResults;
+        for (const filter of activeFilters) {
+            filtered = filter.apply(filtered);
+        }
+    }
+    if (removed.length > 0) {
+        return {
+            filtered,
+            relaxation: {
+                removed,
+                original,
+                message: `No results with all filters applied. Removed filter(s): ${removed.join(', ')}. Try broader search terms or fewer filters.`,
+            },
+        };
+    }
+    return { filtered };
+}
+// ─── Token Truncation ──────────────────────────────────────────
+function resultToString(r) {
+    return `${r.title}\n${r.snippet}\n${r.url}`;
+}
+function truncateSearchResults(paginatedResults, maxTokens) {
+    const { items: finalResults, tokenCount: finalTokenCount, truncated } = truncateListByTokens(paginatedResults, maxTokens, resultToString);
+    if (!truncated) {
+        return { finalResults, finalTokenCount, truncated: false };
+    }
+    const omittedResults = paginatedResults.slice(finalResults.length);
+    const truncatedContent = {
+        omittedCount: omittedResults.length,
+        omittedItems: omittedResults.map(r => ({
+            title: r.title,
+            estimatedTokens: estimateTokens(resultToString(r)),
+        })),
+    };
+    return { finalResults, finalTokenCount, truncated: true, truncatedContent };
+}
+// ─── Convert flat SearchResult to SearchResultWithMeta ─────────
+function toSearchResultWithMeta(result, needsTopicMatching) {
+    // Derive bundleSlug from the product display name (extracted from
+    // zoominmetadata). Do NOT use result.mapId — FT API mapIds are
+    // opaque hashes (e.g. 'uRhiWJWbjHyL1vegaHmj8g'), not readable
+    // bundle stems.
+    const bundleSlug = productNameToId(result.product);
+    const labelKeys = result.docType !== undefined
+        ? [DOC_TYPE_LABEL_MAP[result.docType]]
+        : [];
+    return {
+        result,
+        bundleSlug,
+        matchedTopics: needsTopicMatching
+            ? matchTopics(result.title, result.snippet)
+            : [],
+        labelKeys,
+    };
+}
+// ─── Main Search Function ──────────────────────────────────────
+/**
+ * Search Jamf documentation using the Fluid Topics clustered-search API.
+ *
+ * 1. Checks SearchProvider first (custom backend injection).
+ * 2. Calls ft-client.search() with constructed filters.
+ * 3. Transforms results and applies post-processing pipeline:
+ *    - Client-side topic/docType filtering with progressive relaxation
+ *    - Pagination
+ *    - Token truncation
+ */
+export async function searchDocumentation(ctx, params) {
+    const log = ctx.logger.createLogger('search-service');
+    const page = params.page ?? PAGINATION_CONFIG.DEFAULT_PAGE;
+    const pageSize = params.limit ?? CONTENT_LIMITS.DEFAULT_SEARCH_RESULTS;
+    const maxTokens = params.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS;
+    let allResults;
+    let searchError;
+    try {
+        allResults = await resolveSearchResults(ctx, params, log);
+    }
+    catch (error) {
+        const message = String(error);
+        log.error(`Search error: ${message}`);
+        allResults = [];
+        searchError = message;
+    }
+    // Build and apply filters with progressive relaxation
+    const activeFilters = buildActiveFilters(params);
+    const { filtered: filteredResults, relaxation: filterRelaxation } = applyFiltersWithFallback(allResults, activeFilters);
+    // Calculate pagination
+    const paginationInfo = calculatePagination(filteredResults.length, page, pageSize);
+    const paginatedResults = filteredResults
+        .slice(paginationInfo.startIndex, paginationInfo.endIndex)
+        .map(r => r.result);
+    const { finalResults, finalTokenCount, truncated, truncatedContent } = truncateSearchResults(paginatedResults, maxTokens);
+    const paginationNote = buildPaginationNote(paginationInfo);
+    return {
+        results: finalResults,
+        pagination: {
+            page: paginationInfo.page,
+            pageSize: paginationInfo.pageSize,
+            totalPages: paginationInfo.totalPages,
+            totalItems: filteredResults.length,
+            hasNext: paginationInfo.hasNext,
+            hasPrev: paginationInfo.hasPrev,
+        },
+        tokenInfo: {
+            tokenCount: finalTokenCount,
+            truncated,
+            maxTokens,
+        },
+        ...(paginationNote !== undefined ? { paginationNote } : {}),
+        ...(filterRelaxation !== undefined ? { filterRelaxation } : {}),
+        ...(truncatedContent !== undefined ? { truncatedContent } : {}),
+        ...(searchError !== undefined ? { searchError } : {}),
+    };
+}
+// ─── Internal: Resolve results from provider or FT API ─────────
+/**
+ * Build a deterministic cache key for FT search results.
+ *
+ * Derived from query + filters + locale (NOT page/limit, since
+ * pagination is applied client-side after caching).
+ */
+function buildSearchCacheKey(query, filters, locale) {
+    const sortedFilters = [...filters]
+        .sort((a, b) => a.key.localeCompare(b.key))
+        .map(f => `${f.key}=${f.values.sort().join(',')}`)
+        .join('|');
+    return `ft-search:${locale}:${query}:${sortedFilters}`;
+}
+async function resolveSearchResults(ctx, params, log) {
+    const needsTopicMatching = params.topic !== undefined;
+    // 1. Try SearchProvider first (custom backend injection — no caching)
+    if (ctx.searchProvider !== undefined) {
+        const provided = await ctx.searchProvider.search(params);
+        if (provided !== null) {
+            return provided.map(r => toSearchResultWithMeta(r, needsTopicMatching));
+        }
+    }
+    // 2. Build FT search request
+    const locale = params.language ?? DEFAULT_LOCALE;
+    const filters = buildSearchFilters(params);
+    const cacheKey = buildSearchCacheKey(params.query, filters, locale);
+    // 3. Check cache before hitting the FT API
+    const cached = await ctx.cache.get(cacheKey);
+    if (cached !== null) {
+        log.debug(`Search cache hit: key="${cacheKey}", ${cached.length} results`);
+        return cached;
+    }
+    const perPage = Math.min(CONTENT_LIMITS.MAX_SEARCH_RESULTS, CONTENT_LIMITS.FILTER_OVERFETCH_CAP);
+    log.debug(`FT search: query="${params.query}", product=${params.product ?? 'all'}, ` +
+        `locale=${locale}, filters=${JSON.stringify(filters)}`);
+    const ftResponse = await ftSearch({
+        query: params.query,
+        contentLocale: locale,
+        paging: { perPage, page: 1 },
+        filters,
+    });
+    // 4. Flatten clusters and transform entries
+    const results = [];
+    for (const cluster of ftResponse.results) {
+        for (const entry of cluster.entries) {
+            const searchResult = transformFtSearchResult(entry);
+            if (searchResult.url !== '') {
+                results.push(toSearchResultWithMeta(searchResult, needsTopicMatching));
+            }
+        }
+    }
+    // 5. Cache the raw results (before client-side filtering)
+    await ctx.cache.set(cacheKey, results, ctx.config.cacheTtl.search);
+    log.debug(`FT search returned ${results.length} results (cached)`);
+    return results;
+}
+//# sourceMappingURL=search-service.js.map

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

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

package/dist/core/services/toc-service.d.ts

@@ -0,0 +1,30 @@
+/**
+ * TOC Service — fetch and transform Fluid Topics TOC into TocEntry[]
+ *
+ * Replaces the scraper-based TOC fetching with the FT API
+ * via ft-client + MapsRegistry.
+ */
+import type { ProductId } from '../constants.js';
+import type { ServerContext } from '../types/context.js';
+import type { FtTocNode, TocEntry, FetchTocOptions, FetchTocResult } from '../types.js';
+/**
+ * Recursively convert FtTocNode[] → TocEntry[]
+ *
+ * Enriches each entry with:
+ * - url: buildDisplayUrl(prettyUrl)
+ * - contentId / tocId from the FT node
+ * - recursively transformed children
+ */
+export declare function transformFtTocToTocEntries(nodes: FtTocNode[]): TocEntry[];
+/**
+ * Fetch table of contents for a product via the Fluid Topics API.
+ *
+ * Resolution order:
+ *   1. ctx.tocProvider (if configured)
+ *   2. MapsRegistry → mapId → ft-client.fetchMapToc
+ *   3. Transform FtTocNode[] → TocEntry[]
+ *
+ * Results are cached under `ft-toc:{locale}:{product}:{version}`.
+ */
+export declare function fetchTableOfContents(ctx: ServerContext, product: ProductId, version?: string, options?: FetchTocOptions): Promise<FetchTocResult>;
+//# sourceMappingURL=toc-service.d.ts.map

package/dist/core/services/toc-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/toc-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAkB,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKxG;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,CAezE;AA0BD;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,SAAS,EAClB,OAAO,SAAY,EACnB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAkEzB"}

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

@@ -0,0 +1,107 @@
+/**
+ * TOC Service — fetch and transform Fluid Topics TOC into TocEntry[]
+ *
+ * Replaces the scraper-based TOC fetching with the FT API
+ * via ft-client + MapsRegistry.
+ */
+import { fetchMapToc } from './ft-client.js';
+import { buildDisplayUrl } from './topic-resolver.js';
+import { calculatePagination, truncateListByTokens, buildPaginationNote, } from './tokenizer.js';
+import { JAMF_PRODUCTS, DEFAULT_LOCALE, PAGINATION_CONFIG, TOKEN_CONFIG, } from '../constants.js';
+import { JamfDocsError, JamfDocsErrorCode } from '../types.js';
+// ─── Transform helpers ─────────────────────────────────────────
+/**
+ * Recursively convert FtTocNode[] → TocEntry[]
+ *
+ * Enriches each entry with:
+ * - url: buildDisplayUrl(prettyUrl)
+ * - contentId / tocId from the FT node
+ * - recursively transformed children
+ */
+export function transformFtTocToTocEntries(nodes) {
+    return nodes.map((node) => {
+        const entry = {
+            title: node.title,
+            url: buildDisplayUrl(node.prettyUrl),
+            contentId: node.contentId,
+            tocId: node.tocId,
+        };
+        if (node.children.length > 0) {
+            entry.children = transformFtTocToTocEntries(node.children);
+        }
+        return entry;
+    });
+}
+// ─── Counting / serialisation helpers ──────────────────────────
+/**
+ * Count total TOC entries including nested children
+ */
+function countTocEntries(entries) {
+    return entries.reduce((count, entry) => count + 1 + (entry.children !== undefined ? countTocEntries(entry.children) : 0), 0);
+}
+/**
+ * Serialise a single TOC entry for token estimation
+ */
+function tocEntryToString(entry, depth = 0) {
+    const indent = '  '.repeat(depth);
+    const childrenStr = entry.children?.map(c => tocEntryToString(c, depth + 1)).join('') ?? '';
+    return `${indent}- ${entry.title}\n${childrenStr}`;
+}
+// ─── Main fetch function ───────────────────────────────────────
+/**
+ * Fetch table of contents for a product via the Fluid Topics API.
+ *
+ * Resolution order:
+ *   1. ctx.tocProvider (if configured)
+ *   2. MapsRegistry → mapId → ft-client.fetchMapToc
+ *   3. Transform FtTocNode[] → TocEntry[]
+ *
+ * Results are cached under `ft-toc:{locale}:{product}:{version}`.
+ */
+export async function fetchTableOfContents(ctx, product, version = 'current', options = {}) {
+    if (ctx.tocProvider !== undefined) {
+        const provided = await ctx.tocProvider.getTableOfContents(product, version, options);
+        if (provided !== null) {
+            return provided;
+        }
+    }
+    const page = options.page ?? PAGINATION_CONFIG.DEFAULT_PAGE;
+    const maxTokens = options.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS;
+    const locale = options.locale ?? DEFAULT_LOCALE;
+    const cacheKey = `ft-toc:${locale}:${product}:${version}`;
+    let allToc = await ctx.cache.get(cacheKey);
+    if (allToc === null) {
+        const productInfo = JAMF_PRODUCTS[product];
+        const mapId = await ctx.mapsRegistry.resolveMapId(productInfo.bundleId, version !== 'current' ? version : undefined, locale);
+        if (mapId === null) {
+            throw new JamfDocsError(`Could not resolve map for ${product} version ${version} locale ${locale}`, JamfDocsErrorCode.NOT_FOUND);
+        }
+        const ftNodes = await fetchMapToc(mapId);
+        allToc = transformFtTocToTocEntries(ftNodes);
+        await ctx.cache.set(cacheKey, allToc, ctx.config.cacheTtl.article);
+    }
+    // ─── Pagination & token truncation ───────────────────────────
+    const totalItems = countTocEntries(allToc);
+    const topLevelCount = allToc.length;
+    const pageSize = PAGINATION_CONFIG.DEFAULT_PAGE_SIZE;
+    const paginationCalc = calculatePagination(topLevelCount, page, pageSize);
+    const paginatedToc = allToc.slice(paginationCalc.startIndex, paginationCalc.endIndex);
+    const { items: finalToc, tokenCount, truncated } = truncateListByTokens(paginatedToc, maxTokens, tocEntryToString);
+    const tokenInfo = { tokenCount, truncated, maxTokens };
+    const pagination = {
+        page: paginationCalc.page,
+        pageSize: paginationCalc.pageSize,
+        totalPages: paginationCalc.totalPages,
+        totalItems,
+        hasNext: paginationCalc.hasNext,
+        hasPrev: paginationCalc.hasPrev,
+    };
+    const paginationNote = buildPaginationNote(paginationCalc);
+    return {
+        toc: finalToc,
+        pagination,
+        tokenInfo,
+        ...(paginationNote !== undefined ? { paginationNote } : {}),
+    };
+}
+//# sourceMappingURL=toc-service.js.map

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

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

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

@@ -65,7 +65,7 @@ export declare function extractSection(content: string, sectionIdentifier: strin
  * - Correctly closes code blocks
  * - Lists remaining sections when truncated
  */
-export declare function truncateToTokenLimit(content: string, maxTokens?: number): TruncateResult;
+export declare function truncateToTokenLimit(content: string, maxTokens?: number, preExtractedSections?: ArticleSection[]): TruncateResult;
 /**
  * Extract summary from Markdown content
  * Returns the first paragraph and an outline of sections with token estimates
@@ -83,7 +83,26 @@ export declare function calculatePagination(totalItems: number, page: number, pa
     hasPrev: boolean;
     startIndex: number;
     endIndex: number;
+    requestedPage: number;
+    pageWasClamped: boolean;
 };
+/**
+ * Truncate an already-paginated list to fit within a token budget.
+ * Items are dropped from the end once cumulative tokens exceed maxTokens.
+ */
+export declare function truncateListByTokens<T>(items: T[], maxTokens: number, toString: (item: T) => string): {
+    items: T[];
+    tokenCount: number;
+    truncated: boolean;
+};
+/**
+ * Build a human-readable note when the requested page was clamped.
+ */
+export declare function buildPaginationNote(pagination: {
+    pageWasClamped: boolean;
+    requestedPage: number;
+    totalPages: number;
+}): string | undefined;
 /**
  * Truncate an array of items to fit within token limit
  * Returns items that fit and pagination info