@get-technology-inc/jamf-docs-mcp-server 1.0.0 → 1.2.0

package/dist/resources/index.js

@@ -0,0 +1,121 @@
+/**
+ * MCP Resources registration
+ *
+ * Exposes dynamic reference data for AI clients to read directly
+ * without needing to call tools. Data is fetched from the API
+ * with fallback to static constants.
+ */
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { JAMF_PRODUCTS } from '../constants.js';
+import { getProductsResourceData, getTopicsResourceData, getAvailableVersions } from '../services/metadata.js';
+import { fetchTableOfContents } from '../services/scraper.js';
+import { completeProduct } from '../completions.js';
+function validateProductId(productId, uri) {
+    const productIdStr = String(productId);
+    if (productIdStr in JAMF_PRODUCTS) {
+        return { valid: true, id: productIdStr };
+    }
+    const validIds = Object.keys(JAMF_PRODUCTS).join(', ');
+    return {
+        valid: false,
+        errorResponse: {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'text/plain',
+                    text: `Invalid product ID: "${productIdStr}". Valid products: ${validIds}`,
+                }],
+        },
+    };
+}
+/**
+ * Register all MCP resources
+ */
+export function registerResources(server) {
+    // Products resource - dynamic with fallback
+    server.registerResource('products', 'jamf://products', {
+        title: 'Jamf Products List',
+        description: 'List of all available Jamf products (Jamf Pro, Jamf School, Jamf Connect, Jamf Protect) with their IDs and latest versions. Data is fetched dynamically from the API.',
+        mimeType: 'application/json'
+    }, async () => {
+        const data = await getProductsResourceData();
+        return {
+            contents: [{
+                    uri: 'jamf://products',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(data, null, 2)
+                }]
+        };
+    });
+    // Topics resource - dynamic with fallback
+    server.registerResource('topics', 'jamf://topics', {
+        title: 'Jamf Documentation Topics',
+        description: 'Topic categories for filtering documentation searches. Combines official TOC structure with curated categories.',
+        mimeType: 'application/json'
+    }, async () => {
+        const data = await getTopicsResourceData();
+        return {
+            contents: [{
+                    uri: 'jamf://topics',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(data, null, 2)
+                }]
+        };
+    });
+    // Resource template: Product-specific TOC
+    server.registerResource('product-toc', new ResourceTemplate('jamf://products/{productId}/toc', {
+        list: undefined,
+        complete: { productId: completeProduct },
+    }), {
+        title: 'Product Table of Contents',
+        description: 'Table of contents for a specific Jamf product documentation',
+        mimeType: 'application/json',
+    }, async (uri, { productId }) => {
+        const validation = validateProductId(productId, uri);
+        if (!validation.valid) {
+            return validation.errorResponse;
+        }
+        const tocResult = await fetchTableOfContents(validation.id, 'current', {
+            maxTokens: 20000,
+        });
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify({
+                        product: JAMF_PRODUCTS[validation.id].name,
+                        totalEntries: tocResult.pagination.totalItems,
+                        toc: tocResult.toc,
+                    }, null, 2),
+                }],
+        };
+    });
+    // Resource template: Product-specific versions
+    server.registerResource('product-versions', new ResourceTemplate('jamf://products/{productId}/versions', {
+        list: undefined,
+        complete: { productId: completeProduct },
+    }), {
+        title: 'Product Documentation Versions',
+        description: 'Available documentation versions for a specific Jamf product',
+        mimeType: 'application/json',
+    }, async (uri, { productId }) => {
+        const validation = validateProductId(productId, uri);
+        if (!validation.valid) {
+            return validation.errorResponse;
+        }
+        const versions = await getAvailableVersions(validation.id);
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify({
+                        product: JAMF_PRODUCTS[validation.id].name,
+                        productId: validation.id,
+                        versions,
+                        latestVersion: JAMF_PRODUCTS[validation.id].latestVersion,
+                    }, null, 2),
+                }],
+        };
+    });
+    console.error('Registered resources: jamf://products, jamf://topics,', 'jamf://products/{productId}/toc, jamf://products/{productId}/versions');
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

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

package/dist/schemas/index.d.ts

@@ -2,97 +2,63 @@
  * Zod schemas for input validation
  */
 import { z } from 'zod';
-import { ResponseFormat } from '../constants.js';
+import { ResponseFormat, OutputMode } from '../constants.js';
 /**
  * Schema for jamf_docs_list_products
  */
 export declare const ListProductsInputSchema: z.ZodObject<{
     maxTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-    responseFormat: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
-}, "strict", z.ZodTypeAny, {
-    responseFormat: ResponseFormat;
-    maxTokens?: number | undefined;
-}, {
-    maxTokens?: number | undefined;
-    responseFormat?: ResponseFormat | undefined;
-}>;
+    outputMode: z.ZodDefault<z.ZodEnum<typeof OutputMode>>;
+    responseFormat: z.ZodDefault<z.ZodEnum<typeof ResponseFormat>>;
+}, z.core.$strict>;
 export type ListProductsInput = z.infer<typeof ListProductsInputSchema>;
 /**
  * Schema for jamf_docs_search
  */
 export declare const SearchInputSchema: z.ZodObject<{
     query: z.ZodString;
-    product: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
-    topic: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
-    version: z.ZodOptional<z.ZodString>;
+    product: import("@modelcontextprotocol/sdk/server/completable.js").CompletableSchema<z.ZodOptional<z.ZodEnum<{
+        [x: string]: string;
+    }>>>;
+    topic: import("@modelcontextprotocol/sdk/server/completable.js").CompletableSchema<z.ZodOptional<z.ZodEnum<{
+        [x: string]: string;
+    }>>>;
+    version: import("@modelcontextprotocol/sdk/server/completable.js").CompletableSchema<z.ZodOptional<z.ZodString>>;
+    docType: z.ZodOptional<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
     limit: z.ZodDefault<z.ZodNumber>;
     page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     maxTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-    responseFormat: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
-}, "strict", z.ZodTypeAny, {
-    query: string;
-    responseFormat: ResponseFormat;
-    limit: number;
-    version?: string | undefined;
-    maxTokens?: number | undefined;
-    product?: string | undefined;
-    topic?: string | undefined;
-    page?: number | undefined;
-}, {
-    query: string;
-    version?: string | undefined;
-    maxTokens?: number | undefined;
-    responseFormat?: ResponseFormat | undefined;
-    product?: string | undefined;
-    topic?: string | undefined;
-    limit?: number | undefined;
-    page?: number | undefined;
-}>;
+    outputMode: z.ZodDefault<z.ZodEnum<typeof OutputMode>>;
+    responseFormat: z.ZodDefault<z.ZodEnum<typeof ResponseFormat>>;
+}, z.core.$strict>;
 export type SearchInput = z.infer<typeof SearchInputSchema>;
 /**
  * Schema for jamf_docs_get_article
  */
 export declare const GetArticleInputSchema: z.ZodObject<{
-    url: z.ZodEffects<z.ZodString, string, string>;
+    url: z.ZodString;
     section: z.ZodOptional<z.ZodString>;
+    summaryOnly: z.ZodDefault<z.ZodBoolean>;
     includeRelated: z.ZodDefault<z.ZodBoolean>;
     maxTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-    responseFormat: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
-}, "strict", z.ZodTypeAny, {
-    url: string;
-    responseFormat: ResponseFormat;
-    includeRelated: boolean;
-    maxTokens?: number | undefined;
-    section?: string | undefined;
-}, {
-    url: string;
-    maxTokens?: number | undefined;
-    responseFormat?: ResponseFormat | undefined;
-    section?: string | undefined;
-    includeRelated?: boolean | undefined;
-}>;
+    outputMode: z.ZodDefault<z.ZodEnum<typeof OutputMode>>;
+    responseFormat: z.ZodDefault<z.ZodEnum<typeof ResponseFormat>>;
+}, z.core.$strict>;
 export type GetArticleInput = z.infer<typeof GetArticleInputSchema>;
 /**
  * Schema for jamf_docs_get_toc
  */
 export declare const GetTocInputSchema: z.ZodObject<{
-    product: z.ZodEnum<[string, ...string[]]>;
-    version: z.ZodOptional<z.ZodString>;
+    product: import("@modelcontextprotocol/sdk/server/completable.js").CompletableSchema<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+    version: import("@modelcontextprotocol/sdk/server/completable.js").CompletableSchema<z.ZodOptional<z.ZodString>>;
     page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     maxTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-    responseFormat: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
-}, "strict", z.ZodTypeAny, {
-    responseFormat: ResponseFormat;
-    product: string;
-    version?: string | undefined;
-    maxTokens?: number | undefined;
-    page?: number | undefined;
-}, {
-    product: string;
-    version?: string | undefined;
-    maxTokens?: number | undefined;
-    responseFormat?: ResponseFormat | undefined;
-    page?: number | undefined;
-}>;
+    outputMode: z.ZodDefault<z.ZodEnum<typeof OutputMode>>;
+    responseFormat: z.ZodDefault<z.ZodEnum<typeof ResponseFormat>>;
+}, z.core.$strict>;
 export type GetTocInput = z.infer<typeof GetTocInputSchema>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EAMf,MAAM,iBAAiB,CAAC;AA2BzB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;EAQzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAwBvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAmBnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,cAAc,EACd,UAAU,EAOX,MAAM,iBAAiB,CAAC;AA0BzB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;kBAYzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;kBAqDnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;kBAgCvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;kBA6BnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schemas/index.js

@@ -2,13 +2,14 @@
  * Zod schemas for input validation
  */
 import { z } from 'zod';
-import { ResponseFormat, JAMF_PRODUCTS, CONTENT_LIMITS, TOKEN_CONFIG, PAGINATION_CONFIG, JAMF_TOPICS } from '../constants.js';
-// Valid product IDs
-const productIds = Object.keys(JAMF_PRODUCTS);
-// Valid topic IDs
-const topicIds = Object.keys(JAMF_TOPICS);
+import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
+import { ResponseFormat, OutputMode, CONTENT_LIMITS, TOKEN_CONFIG, PAGINATION_CONFIG, PRODUCT_IDS, TOPIC_IDS, DOC_TYPE_IDS } from '../constants.js';
+import { completeProduct, completeTopic, completeVersion } from '../completions.js';
+import { isAllowedHostname } from '../utils/url.js';
 // Response format enum
 const ResponseFormatSchema = z.nativeEnum(ResponseFormat);
+// Output mode enum
+const OutputModeSchema = z.nativeEnum(OutputMode);
 // Common maxTokens parameter schema
 const MaxTokensSchema = z.number()
     .int()
@@ -30,6 +31,9 @@ export const ListProductsInputSchema = z.object({
     maxTokens: MaxTokensSchema
         .optional()
         .describe(`Maximum tokens in response (${TOKEN_CONFIG.MIN_TOKENS}-${TOKEN_CONFIG.MAX_TOKENS_LIMIT}, default: ${TOKEN_CONFIG.DEFAULT_MAX_TOKENS})`),
+    outputMode: OutputModeSchema
+        .default(OutputMode.FULL)
+        .describe('Output detail level: "full" for detailed output or "compact" for brief output'),
     responseFormat: ResponseFormatSchema
         .default(ResponseFormat.MARKDOWN)
         .describe('Output format: "markdown" for human-readable or "json" for machine-readable')
@@ -42,15 +46,18 @@ export const SearchInputSchema = z.object({
         .min(2, 'Query must be at least 2 characters')
         .max(200, 'Query must not exceed 200 characters')
         .describe('Search keywords to find in Jamf documentation'),
-    product: z.enum(productIds)
+    product: completable(z.enum(PRODUCT_IDS)
         .optional()
-        .describe('Filter by product: jamf-pro, jamf-school, jamf-connect, jamf-protect'),
-    topic: z.enum(topicIds)
+        .describe('Filter by product: jamf-pro, jamf-school, jamf-connect, jamf-protect'), completeProduct),
+    topic: completable(z.enum(TOPIC_IDS)
         .optional()
-        .describe('Filter by topic: enrollment, profiles, security, inventory, policies, smart-groups, apps, identity, api, network'),
-    version: z.string()
+        .describe('Filter by topic: enrollment, profiles, security, inventory, policies, smart-groups, apps, identity, api, network'), completeTopic),
+    version: completable(z.string()
         .optional()
-        .describe('Filter by version (e.g., "11.5.0", "10.x")'),
+        .describe('Filter by version (e.g., "11.5.0", "10.x")'), completeVersion),
+    docType: z.enum(DOC_TYPE_IDS)
+        .optional()
+        .describe('Filter by document type: documentation, release-notes, install-guide, technical-paper, configuration-guide, training'),
     limit: z.number()
         .int()
         .min(1)
@@ -63,6 +70,9 @@ export const SearchInputSchema = z.object({
     maxTokens: MaxTokensSchema
         .optional()
         .describe(`Maximum tokens in response (${TOKEN_CONFIG.MIN_TOKENS}-${TOKEN_CONFIG.MAX_TOKENS_LIMIT}, default: ${TOKEN_CONFIG.DEFAULT_MAX_TOKENS})`),
+    outputMode: OutputModeSchema
+        .default(OutputMode.FULL)
+        .describe('Output detail level: "full" for detailed output or "compact" for brief output'),
     responseFormat: ResponseFormatSchema
         .default(ResponseFormat.MARKDOWN)
         .describe('Output format: "markdown" for human-readable or "json" for machine-readable')
@@ -73,17 +83,23 @@ export const SearchInputSchema = z.object({
 export const GetArticleInputSchema = z.object({
     url: z.string()
         .url('Must be a valid URL')
-        .refine((url) => url.includes('docs.jamf.com') || url.includes('learn.jamf.com'), 'URL must be from docs.jamf.com or learn.jamf.com')
+        .refine((url) => isAllowedHostname(url), 'URL must be from docs.jamf.com or learn.jamf.com')
         .describe('Full URL of the Jamf documentation article'),
     section: z.string()
         .optional()
         .describe('Extract only a specific section by title or ID (e.g., "Prerequisites", "Configuration")'),
+    summaryOnly: z.boolean()
+        .default(false)
+        .describe('Return only article summary and outline instead of full content (token-efficient)'),
     includeRelated: z.boolean()
         .default(false)
         .describe('Include related article links in the response'),
     maxTokens: MaxTokensSchema
         .optional()
         .describe(`Maximum tokens in response (${TOKEN_CONFIG.MIN_TOKENS}-${TOKEN_CONFIG.MAX_TOKENS_LIMIT}, default: ${TOKEN_CONFIG.DEFAULT_MAX_TOKENS})`),
+    outputMode: OutputModeSchema
+        .default(OutputMode.FULL)
+        .describe('Output detail level: "full" for detailed output or "compact" for brief output'),
     responseFormat: ResponseFormatSchema
         .default(ResponseFormat.MARKDOWN)
         .describe('Output format: "markdown" for human-readable or "json" for machine-readable')
@@ -92,17 +108,20 @@ export const GetArticleInputSchema = z.object({
  * Schema for jamf_docs_get_toc
  */
 export const GetTocInputSchema = z.object({
-    product: z.enum(productIds)
-        .describe('Product ID: jamf-pro, jamf-school, jamf-connect, jamf-protect'),
-    version: z.string()
+    product: completable(z.enum(PRODUCT_IDS)
+        .describe('Product ID: jamf-pro, jamf-school, jamf-connect, jamf-protect'), completeProduct),
+    version: completable(z.string()
         .optional()
-        .describe('Specific version (defaults to latest)'),
+        .describe('Specific version (defaults to latest)'), completeVersion),
     page: PageSchema
         .optional()
         .describe(`Page number for pagination (1-${PAGINATION_CONFIG.MAX_PAGE}, default: 1)`),
     maxTokens: MaxTokensSchema
         .optional()
         .describe(`Maximum tokens in response (${TOKEN_CONFIG.MIN_TOKENS}-${TOKEN_CONFIG.MAX_TOKENS_LIMIT}, default: ${TOKEN_CONFIG.DEFAULT_MAX_TOKENS})`),
+    outputMode: OutputModeSchema
+        .default(OutputMode.FULL)
+        .describe('Output detail level: "full" for detailed output or "compact" for brief output'),
     responseFormat: ResponseFormatSchema
         .default(ResponseFormat.MARKDOWN)
         .describe('Output format: "markdown" for human-readable or "json" for machine-readable')

package/dist/schemas/index.js.map

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

package/dist/schemas/output.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Zod output schemas for structured tool output (outputSchema + structuredContent)
+ */
+import { z } from 'zod';
+export declare const ProductListOutputSchema: z.ZodObject<{
+    products: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        currentVersion: z.ZodString;
+        availableVersions: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    topics: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        keywords: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SearchOutputSchema: z.ZodObject<{
+    query: z.ZodString;
+    totalResults: z.ZodNumber;
+    page: z.ZodNumber;
+    totalPages: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    results: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodString;
+        snippet: z.ZodString;
+        product: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        docType: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const ArticleOutputSchema: z.ZodObject<{
+    title: z.ZodString;
+    url: z.ZodString;
+    content: z.ZodString;
+    product: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    lastUpdated: z.ZodOptional<z.ZodString>;
+    breadcrumb: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        level: z.ZodNumber;
+        tokenCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const TocOutputSchema: z.ZodObject<{
+    product: z.ZodString;
+    version: z.ZodString;
+    totalEntries: z.ZodNumber;
+    page: z.ZodNumber;
+    totalPages: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    entries: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=output.d.ts.map

package/dist/schemas/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/schemas/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAalC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;iBAe7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;iBAe9B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;iBAW1B,CAAC"}

package/dist/schemas/output.js

@@ -0,0 +1,63 @@
+/**
+ * Zod output schemas for structured tool output (outputSchema + structuredContent)
+ */
+import { z } from 'zod';
+export const ProductListOutputSchema = z.object({
+    products: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        description: z.string(),
+        currentVersion: z.string(),
+        availableVersions: z.array(z.string()),
+    })),
+    topics: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        keywords: z.array(z.string()),
+    })),
+});
+export const SearchOutputSchema = z.object({
+    query: z.string(),
+    totalResults: z.number(),
+    page: z.number(),
+    totalPages: z.number(),
+    hasMore: z.boolean(),
+    results: z.array(z.object({
+        title: z.string(),
+        url: z.string(),
+        snippet: z.string(),
+        product: z.string(),
+        version: z.string().optional(),
+        docType: z.string().optional(),
+    })),
+    suggestions: z.array(z.string()).optional(),
+});
+export const ArticleOutputSchema = z.object({
+    title: z.string(),
+    url: z.string(),
+    content: z.string(),
+    product: z.string().optional(),
+    version: z.string().optional(),
+    lastUpdated: z.string().optional(),
+    breadcrumb: z.array(z.string()).optional(),
+    sections: z.array(z.object({
+        id: z.string(),
+        title: z.string(),
+        level: z.number(),
+        tokenCount: z.number(),
+    })),
+    truncated: z.boolean(),
+});
+export const TocOutputSchema = z.object({
+    product: z.string(),
+    version: z.string(),
+    totalEntries: z.number(),
+    page: z.number(),
+    totalPages: z.number(),
+    hasMore: z.boolean(),
+    entries: z.array(z.object({
+        title: z.string(),
+        url: z.string(),
+    })),
+});
+//# sourceMappingURL=output.js.map

package/dist/schemas/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/schemas/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACzB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACvC,CAAC,CAAC;IACH,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC9B,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC,CAAC;IACH,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACzB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC,CAAC;IACH,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KAChB,CAAC,CAAC;CACJ,CAAC,CAAC"}

package/dist/services/cache.d.ts

@@ -1,35 +1,60 @@
 /**
  * Caching service for Jamf documentation
  *
- * Provides file-based caching with TTL support
+ * Provides file-based caching with TTL support and LRU memory eviction
  */
+import { z } from 'zod';
 /**
- * File-based cache implementation
+ * Zod schema for validating cache entries read from disk
+ */
+export declare const CacheEntrySchema: z.ZodObject<{
+    data: z.ZodUnknown;
+    timestamp: z.ZodNumber;
+    ttl: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * File-based cache implementation with LRU-bounded memory cache
  */
 declare class FileCache {
-    private cacheDir;
-    private memoryCache;
-    constructor(cacheDir?: string);
+    private readonly cacheDir;
+    private readonly maxEntries;
+    private readonly memoryCache;
+    private readonly lruMap;
+    private readonly lruHead;
+    private readonly lruTail;
+    private dirCreated;
+    constructor(cacheDir?: string, maxEntries?: number);
+    private static getCacheKey;
+    private getCachePath;
+    private ensureCacheDir;
     /**
-     * Generate a cache key hash
+     * Move a node to the front of the LRU list (most recently used)
      */
-    private getCacheKey;
+    private lruMoveToFront;
     /**
-     * Get the file path for a cache key
+     * Add a key to the LRU list (at front)
      */
-    private getCachePath;
+    private lruAdd;
     /**
-     * Ensure cache directory exists
+     * Remove a key from the LRU list
      */
-    private ensureCacheDir;
+    private lruRemove;
+    /**
+     * Evict the least recently used entry from memory cache
+     */
+    private lruEvictLeast;
     /**
      * Get a value from cache
      */
     get<T>(key: string): Promise<T | null>;
+    /**
+     * Store in memory cache, evicting LRU entry if at capacity
+     */
+    private memoryCacheSet;
     /**
      * Set a value in cache
      */
-    set<T>(key: string, data: T, ttl?: number): Promise<void>;
+    set(key: string, data: unknown, ttl?: number): Promise<void>;
     /**
      * Delete a cache entry
      */

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

@@ -1 +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,CAAS;IACzB,OAAO,CAAC,WAAW,CAA+C;gBAEtD,QAAQ,GAAE,MAAkB;IAIxC;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;YACW,cAAc;IAQ5B;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAiC5C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,GAAE,MAAkC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1F;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;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"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAWH;;GAEG;AACH,cAAM,SAAS;IACb,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwD;IAChF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwD;IAChF,OAAO,CAAC,UAAU,CAAS;gBAEf,QAAQ,GAAE,MAAkB,EAAE,UAAU,GAAE,MAA0B;IAOhF,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B,OAAO,CAAC,YAAY;YAIN,cAAc;IAM5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,MAAM;IAWd;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA4C5C;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAE,MAAkC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB7F;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B;;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;CAoD/B;AAGD,eAAO,MAAM,KAAK,WAAkB,CAAC"}