@get-technology-inc/jamf-docs-mcp-server 0.0.1 → 1.1.0

package/dist/schemas/index.js.map

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

package/dist/services/cache.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Caching service for Jamf documentation
+ *
+ * Provides file-based caching with TTL support
+ */
+/**
+ * File-based cache implementation
+ */
+declare class FileCache {
+    private readonly cacheDir;
+    private readonly memoryCache;
+    constructor(cacheDir?: string);
+    private static getCacheKey;
+    private getCachePath;
+    private ensureCacheDir;
+    /**
+     * Get a value from cache
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value in cache
+     */
+    set(key: string, data: unknown, ttl?: number): Promise<void>;
+    /**
+     * Delete a cache entry
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all cache entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    stats(): Promise<{
+        memoryEntries: number;
+        fileEntries: number;
+        totalSize: number;
+    }>;
+    /**
+     * Prune expired entries
+     */
+    prune(): Promise<number>;
+}
+export declare const cache: FileCache;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/services/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;GAEG;AACH,cAAM,SAAS;IACb,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;gBAE1D,QAAQ,GAAE,MAAkB;IAIxC,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B,OAAO,CAAC,YAAY;YAIN,cAAc;IAI5B;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAiC5C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAE,MAAkC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7F;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBzF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAmC/B;AAGD,eAAO,MAAM,KAAK,WAAkB,CAAC"}

package/dist/services/cache.js

@@ -0,0 +1,165 @@
+/**
+ * Caching service for Jamf documentation
+ *
+ * Provides file-based caching with TTL support
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { CACHE_TTL, CACHE_DIR } from '../constants.js';
+/**
+ * File-based cache implementation
+ */
+class FileCache {
+    cacheDir;
+    memoryCache = new Map();
+    constructor(cacheDir = CACHE_DIR) {
+        this.cacheDir = cacheDir;
+    }
+    static getCacheKey(key) {
+        return crypto.createHash('md5').update(key).digest('hex');
+    }
+    getCachePath(key) {
+        return path.join(this.cacheDir, `${FileCache.getCacheKey(key)}.json`);
+    }
+    async ensureCacheDir() {
+        await fs.mkdir(this.cacheDir, { recursive: true }).catch(() => { });
+    }
+    /**
+     * Get a value from cache
+     */
+    async get(key) {
+        // Check memory cache first
+        const memCached = this.memoryCache.get(key);
+        if (memCached !== undefined) {
+            if (Date.now() - memCached.timestamp < memCached.ttl) {
+                return memCached.data;
+            }
+            // Expired, remove from memory
+            this.memoryCache.delete(key);
+        }
+        // Check file cache
+        try {
+            const cachePath = this.getCachePath(key);
+            const content = await fs.readFile(cachePath, 'utf-8');
+            const entry = JSON.parse(content);
+            // Check if expired
+            if (Date.now() - entry.timestamp > entry.ttl) {
+                await this.delete(key);
+                return null;
+            }
+            // Store in memory cache for faster access
+            this.memoryCache.set(key, entry);
+            return entry.data;
+        }
+        catch {
+            // File doesn't exist or is invalid
+            return null;
+        }
+    }
+    /**
+     * Set a value in cache
+     */
+    async set(key, data, ttl = CACHE_TTL.ARTICLE_CONTENT) {
+        await this.ensureCacheDir();
+        const entry = {
+            data,
+            timestamp: Date.now(),
+            ttl
+        };
+        // Store in memory
+        this.memoryCache.set(key, entry);
+        // Store in file
+        try {
+            const cachePath = this.getCachePath(key);
+            await fs.writeFile(cachePath, JSON.stringify(entry), 'utf-8');
+        }
+        catch (error) {
+            // Log but don't fail
+            console.error(`[CACHE] Failed to write cache: ${String(error)}`);
+        }
+    }
+    /**
+     * Delete a cache entry
+     */
+    async delete(key) {
+        this.memoryCache.delete(key);
+        await fs.unlink(this.getCachePath(key)).catch(() => { });
+    }
+    /**
+     * Clear all cache entries
+     */
+    async clear() {
+        this.memoryCache.clear();
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            const jsonFiles = files.filter(f => f.endsWith('.json'));
+            await Promise.all(jsonFiles.map(async (f) => { await fs.unlink(path.join(this.cacheDir, f)); }));
+        }
+        catch {
+            // Directory may not exist
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    async stats() {
+        let fileEntries = 0;
+        let totalSize = 0;
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            const jsonFiles = files.filter(f => f.endsWith('.json'));
+            fileEntries = jsonFiles.length;
+            for (const file of jsonFiles) {
+                const stat = await fs.stat(path.join(this.cacheDir, file));
+                totalSize += stat.size;
+            }
+        }
+        catch {
+            // Directory may not exist
+        }
+        return {
+            memoryEntries: this.memoryCache.size,
+            fileEntries,
+            totalSize
+        };
+    }
+    /**
+     * Prune expired entries
+     */
+    async prune() {
+        let pruned = 0;
+        // Prune memory cache
+        for (const [key, entry] of this.memoryCache.entries()) {
+            if (Date.now() - entry.timestamp > entry.ttl) {
+                this.memoryCache.delete(key);
+                pruned++;
+            }
+        }
+        // Prune file cache
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            for (const file of files.filter(f => f.endsWith('.json'))) {
+                try {
+                    const filePath = path.join(this.cacheDir, file);
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    const entry = JSON.parse(content);
+                    if (Date.now() - entry.timestamp > entry.ttl) {
+                        await fs.unlink(filePath);
+                        pruned++;
+                    }
+                }
+                catch {
+                    // Skip invalid files
+                }
+            }
+        }
+        catch {
+            // Directory may not exist
+        }
+        return pruned;
+    }
+}
+// Export singleton instance
+export const cache = new FileCache();
+//# sourceMappingURL=cache.js.map

package/dist/services/cache.js.map

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

package/dist/services/metadata.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Metadata service for Jamf documentation
+ *
+ * Dynamically fetches product versions and topic categories from the API
+ * with fallback to static constants.
+ */
+import { type ProductId } from '../constants.js';
+export interface ProductMetadata {
+    id: string;
+    name: string;
+    description: string;
+    bundleId: string;
+    latestVersion: string;
+    availableVersions: string[];
+    labelKey: string;
+}
+export interface TopicMetadata {
+    id: string;
+    name: string;
+    source: 'toc' | 'manual';
+    articleCount?: number;
+}
+export interface TocCategory {
+    navId: string;
+    title: string;
+    articleCount: number;
+    children: string[];
+}
+/**
+ * Get all products with their latest metadata
+ * Uses cache with fallback to static constants
+ */
+export declare function getProductsMetadata(): Promise<ProductMetadata[]>;
+/**
+ * Get the bundle ID for a specific product and version
+ * Returns the latest bundle ID if version is undefined or 'current'
+ */
+export declare function getBundleIdForVersion(productId: ProductId, version?: string): Promise<string | null>;
+/**
+ * Get available versions for a product
+ */
+export declare function getAvailableVersions(productId: ProductId): Promise<string[]>;
+/**
+ * Get all topics, combining TOC-derived from all products and manual topics
+ */
+export declare function getTopicsMetadata(): Promise<TopicMetadata[]>;
+/**
+ * Get products data formatted for resource response
+ */
+export declare function getProductsResourceData(): Promise<{
+    description: string;
+    products: {
+        id: string;
+        name: string;
+        description: string;
+        latestVersion: string;
+        availableVersions: string[];
+        bundleId: string;
+    }[];
+    lastUpdated: string;
+    usage: string;
+}>;
+/**
+ * Get topics data formatted for resource response
+ */
+export declare function getTopicsResourceData(): Promise<{
+    description: string;
+    totalTopics: number;
+    topics: {
+        id: string;
+        name: string;
+        source: string;
+        articleCount?: number;
+    }[];
+    lastUpdated: string;
+    usage: string;
+}>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/services/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/services/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AAOzB,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAmID;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAoCtE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsBxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAIlF;AAmHD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAyClE;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAgBD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAeD"}

package/dist/services/metadata.js

@@ -0,0 +1,349 @@
+/**
+ * Metadata service for Jamf documentation
+ *
+ * Dynamically fetches product versions and topic categories from the API
+ * with fallback to static constants.
+ */
+import axios from 'axios';
+import * as cheerio from 'cheerio';
+import { DOCS_API_URL, JAMF_PRODUCTS, JAMF_TOPICS, REQUEST_CONFIG, CACHE_TTL } from '../constants.js';
+import { cache } from './cache.js';
+// ============================================================================
+// API Helpers
+// ============================================================================
+async function fetchJson(url) {
+    const response = await axios.get(url, {
+        timeout: REQUEST_CONFIG.TIMEOUT,
+        headers: {
+            'User-Agent': REQUEST_CONFIG.USER_AGENT,
+            'Accept': 'application/json'
+        }
+    });
+    return response.data;
+}
+/**
+ * Discover all available versions for a product
+ */
+async function discoverProductVersions(productId) {
+    const product = JAMF_PRODUCTS[productId];
+    const versions = new Set();
+    try {
+        // Search with a broad query to find all bundle versions
+        const apiUrl = `${DOCS_API_URL}/api/search?q=${encodeURIComponent(product.name)}&rpp=100`;
+        const response = await fetchJson(apiUrl);
+        const versionRegex = /-(\d+\.\d+\.\d+)$/;
+        const bundlePrefix = `${product.bundleId}-`;
+        for (const wrapper of response.Results) {
+            const bundleId = wrapper.leading_result?.bundle_id;
+            // Skip if no bundle_id (null or undefined)
+            if (bundleId === null || bundleId === undefined) {
+                continue;
+            }
+            // Check if this is a versioned documentation bundle for our product
+            if (bundleId.startsWith(bundlePrefix) || bundleId === product.bundleId) {
+                const match = versionRegex.exec(bundleId);
+                if (match?.[1] !== undefined) {
+                    versions.add(match[1]);
+                }
+            }
+        }
+    }
+    catch (error) {
+        console.error(`[METADATA] Error discovering versions for ${productId}:`, error);
+    }
+    // Sort versions in descending order (newest first)
+    return Array.from(versions).sort((a, b) => {
+        const partsA = a.split('.').map(Number);
+        const partsB = b.split('.').map(Number);
+        for (let i = 0; i < 3; i++) {
+            const diff = (partsB[i] ?? 0) - (partsA[i] ?? 0);
+            if (diff !== 0) {
+                return diff;
+            }
+        }
+        return 0;
+    });
+}
+/**
+ * Fetch latest version and metadata for a product from the API
+ */
+async function fetchProductMetadata(productId) {
+    const product = JAMF_PRODUCTS[productId];
+    try {
+        // Discover all available versions
+        const availableVersions = await discoverProductVersions(productId);
+        // Search for a doc from this product to get the bundle ID and labels
+        const apiUrl = `${DOCS_API_URL}/api/search?q=${encodeURIComponent(product.name)}&rpp=5`;
+        const response = await fetchJson(apiUrl);
+        for (const wrapper of response.Results) {
+            const result = wrapper.leading_result;
+            const bundleId = result?.bundle_id;
+            // Skip if no bundle_id or doesn't match our product
+            if (bundleId?.startsWith(product.bundleId) !== true) {
+                continue;
+            }
+            // Extract version from bundle_id (e.g., "jamf-pro-documentation-11.24.0" → "11.24.0")
+            const versionRegex = /-(\d+\.\d+\.\d+)$/;
+            const versionMatch = versionRegex.exec(bundleId);
+            const latestVersion = versionMatch?.[1] ?? 'current';
+            // Find product label key
+            const productLabel = result?.labels?.find(l => l.key.startsWith('product-') && !l.key.includes('-'));
+            const labelKey = productLabel?.key ?? product.searchLabel;
+            return {
+                id: productId,
+                name: product.name,
+                description: product.description,
+                bundleId,
+                latestVersion,
+                availableVersions: availableVersions.length > 0 ? availableVersions : [latestVersion],
+                labelKey
+            };
+        }
+    }
+    catch (error) {
+        console.error(`[METADATA] Error fetching metadata for ${productId}:`, error);
+    }
+    return null;
+}
+/**
+ * Get all products with their latest metadata
+ * Uses cache with fallback to static constants
+ */
+export async function getProductsMetadata() {
+    const cacheKey = 'metadata:products';
+    // Check cache
+    const cached = await cache.get(cacheKey);
+    if (cached !== null) {
+        return cached;
+    }
+    const products = [];
+    // Fetch metadata for each product
+    for (const productId of Object.keys(JAMF_PRODUCTS)) {
+        const metadata = await fetchProductMetadata(productId);
+        if (metadata !== null) {
+            products.push(metadata);
+        }
+        else {
+            // Fallback to static data
+            const product = JAMF_PRODUCTS[productId];
+            products.push({
+                id: productId,
+                name: product.name,
+                description: product.description,
+                bundleId: product.bundleId,
+                latestVersion: product.latestVersion,
+                availableVersions: [product.latestVersion],
+                labelKey: product.searchLabel
+            });
+        }
+    }
+    // Cache for 24 hours
+    await cache.set(cacheKey, products, CACHE_TTL.ARTICLE_CONTENT);
+    return products;
+}
+/**
+ * Get the bundle ID for a specific product and version
+ * Returns the latest bundle ID if version is undefined or 'current'
+ */
+export async function getBundleIdForVersion(productId, version) {
+    const products = await getProductsMetadata();
+    const product = products.find(p => p.id === productId);
+    if (product === undefined) {
+        return null;
+    }
+    // If no version specified or 'current', return latest
+    if (version === undefined || version === 'current' || version === 'latest') {
+        return product.bundleId;
+    }
+    // Check if requested version is available
+    if (!product.availableVersions.includes(version)) {
+        console.error(`[METADATA] Version ${version} not available for ${productId}. Available: ${product.availableVersions.join(', ')}`);
+        return null;
+    }
+    // Construct versioned bundle ID
+    const baseBundle = JAMF_PRODUCTS[productId].bundleId;
+    return `${baseBundle}-${version}`;
+}
+/**
+ * Get available versions for a product
+ */
+export async function getAvailableVersions(productId) {
+    const products = await getProductsMetadata();
+    const product = products.find(p => p.id === productId);
+    return product?.availableVersions ?? [];
+}
+// ============================================================================
+// Topic Categories from TOC
+// ============================================================================
+/**
+ * Parse TOC HTML to extract categories
+ */
+function parseTocCategories(tocData) {
+    const categories = [];
+    // Sort by nav ID number
+    const sortedEntries = Object.entries(tocData)
+        .filter(([key]) => key.startsWith('nav-'))
+        .sort((a, b) => {
+        const numA = parseInt(a[0].replace('nav-', ''), 10);
+        const numB = parseInt(b[0].replace('nav-', ''), 10);
+        return numA - numB;
+    });
+    for (const [navId, html] of sortedEntries) {
+        if (typeof html !== 'string' || !html.includes('<ul')) {
+            continue;
+        }
+        const $ = cheerio.load(html);
+        const children = [];
+        // Get all article titles in this section
+        $('a').each((_, el) => {
+            const title = $(el).text().trim();
+            if (title !== '') {
+                children.push(title);
+            }
+        });
+        if (children.length > 0) {
+            // First child is usually the section title
+            const title = children[0] ?? 'Untitled';
+            categories.push({
+                navId,
+                title,
+                articleCount: children.length,
+                children: children.slice(1) // Exclude the title itself
+            });
+        }
+    }
+    return categories;
+}
+/**
+ * Convert TOC category to topic ID (slug)
+ */
+function categoryToTopicId(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 30); // Limit length
+}
+/**
+ * Fetch topic categories from TOC for a product
+ */
+async function fetchTopicCategories(productId) {
+    try {
+        // First get the latest bundle ID
+        const products = await getProductsMetadata();
+        const product = products.find(p => p.id === productId);
+        if (product === undefined) {
+            return [];
+        }
+        const tocUrl = `${DOCS_API_URL}/bundle/${product.bundleId}/toc`;
+        const tocData = await fetchJson(tocUrl);
+        return parseTocCategories(tocData);
+    }
+    catch (error) {
+        console.error(`[METADATA] Error fetching TOC categories for ${productId}:`, error);
+        return [];
+    }
+}
+/**
+ * Add or update a topic in the map
+ */
+function upsertTopic(topicsMap, category) {
+    const topicId = categoryToTopicId(category.title);
+    if (!topicsMap.has(topicId)) {
+        // Add new topic from TOC
+        topicsMap.set(topicId, {
+            id: topicId,
+            name: category.title,
+            source: 'toc',
+            articleCount: category.articleCount
+        });
+    }
+    else {
+        // Update existing topic with article count (accumulate across products)
+        const existing = topicsMap.get(topicId);
+        if (existing !== undefined) {
+            existing.articleCount = (existing.articleCount ?? 0) + category.articleCount;
+        }
+    }
+}
+/**
+ * Get all topics, combining TOC-derived from all products and manual topics
+ */
+export async function getTopicsMetadata() {
+    const cacheKey = 'metadata:topics';
+    // Check cache
+    const cached = await cache.get(cacheKey);
+    if (cached !== null) {
+        return cached;
+    }
+    const topicsMap = new Map();
+    // Start with manual topics as fallback
+    for (const [id, topic] of Object.entries(JAMF_TOPICS)) {
+        topicsMap.set(id, {
+            id,
+            name: topic.name,
+            source: 'manual'
+        });
+    }
+    // Fetch TOC categories from ALL products
+    const productIds = Object.keys(JAMF_PRODUCTS);
+    for (const productId of productIds) {
+        try {
+            const categories = await fetchTopicCategories(productId);
+            for (const category of categories) {
+                upsertTopic(topicsMap, category);
+            }
+        }
+        catch (error) {
+            console.error(`[METADATA] Error fetching TOC for ${productId}:`, error);
+            // Continue with other products
+        }
+    }
+    const topics = Array.from(topicsMap.values());
+    // Cache for 24 hours
+    await cache.set(cacheKey, topics, CACHE_TTL.ARTICLE_CONTENT);
+    return topics;
+}
+// ============================================================================
+// Convenience functions for Resources
+// ============================================================================
+/**
+ * Get products data formatted for resource response
+ */
+export async function getProductsResourceData() {
+    const products = await getProductsMetadata();
+    return {
+        description: 'Available Jamf products for documentation search',
+        products: products.map(p => ({
+            id: p.id,
+            name: p.name,
+            description: p.description,
+            latestVersion: p.latestVersion,
+            availableVersions: p.availableVersions,
+            bundleId: p.bundleId
+        })),
+        lastUpdated: new Date().toISOString(),
+        usage: 'Use product ID (e.g., "jamf-pro") with jamf_docs_search or jamf_docs_get_toc tools. Use version parameter to query specific versions.'
+    };
+}
+/**
+ * Get topics data formatted for resource response
+ */
+export async function getTopicsResourceData() {
+    const topics = await getTopicsMetadata();
+    return {
+        description: 'Topic categories for filtering Jamf documentation searches',
+        totalTopics: topics.length,
+        topics: topics.map(t => ({
+            id: t.id,
+            name: t.name,
+            source: t.source,
+            ...(t.articleCount !== undefined ? { articleCount: t.articleCount } : {})
+        })),
+        lastUpdated: new Date().toISOString(),
+        usage: 'Use topic ID (e.g., "enrollment") with jamf_docs_search tool to filter results'
+    };
+}
+//# sourceMappingURL=metadata.js.map