nowaikit 3.1.0 → 4.0.1

package/dist/tools/orchestration.js

@@ -0,0 +1,320 @@
+import { ServiceNowError } from '../utils/errors.js';
+import { requireNowAssist, requireWrite } from '../utils/permissions.js';
+export function getOrchestrationToolDefinitions() {
+    return [
+        {
+            name: 'create_playbook',
+            description: 'Create a playbook definition with ordered steps that chain tool calls (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Playbook name' },
+                    description: { type: 'string', description: 'Playbook description' },
+                    steps: {
+                        type: 'array',
+                        description: 'Ordered list of playbook steps',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                tool_name: { type: 'string', description: 'Name of the tool to invoke' },
+                                args_template: { type: 'object', description: 'Arguments template — can reference {{context.key}} or {{steps[N].result.key}}' },
+                                condition: { type: 'string', description: 'Optional JS-like condition expression. Step runs only when truthy.' },
+                                on_error: { type: 'string', enum: ['stop', 'skip', 'continue'], description: 'Error handling: stop (default), skip this step, or continue to next' },
+                            },
+                            required: ['tool_name', 'args_template'],
+                        },
+                    },
+                },
+                required: ['name', 'description', 'steps'],
+            },
+        },
+        {
+            name: 'execute_playbook',
+            description: 'Execute a playbook step by step, passing results forward through context (requires NOW_ASSIST_ENABLED). Supports dry_run.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    playbook: {
+                        type: 'object',
+                        description: 'Playbook object with name, description, and steps array',
+                        properties: {
+                            name: { type: 'string' },
+                            description: { type: 'string' },
+                            steps: {
+                                type: 'array',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        tool_name: { type: 'string' },
+                                        args_template: { type: 'object' },
+                                        condition: { type: 'string' },
+                                        on_error: { type: 'string', enum: ['stop', 'skip', 'continue'] },
+                                    },
+                                    required: ['tool_name', 'args_template'],
+                                },
+                            },
+                        },
+                        required: ['steps'],
+                    },
+                    context: { type: 'object', description: 'Initial context key-value pairs available to all steps' },
+                    dry_run: { type: 'boolean', description: 'Preview execution plan without invoking tools (default true)' },
+                },
+                required: ['playbook'],
+            },
+        },
+        {
+            name: 'list_playbooks',
+            description: 'List stored playbook definitions from sys_hub_action_type_definition',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    limit: { type: 'number', description: 'Max records to return (default 25)' },
+                },
+                required: [],
+            },
+        },
+    ];
+}
+const ORCHESTRATION_TOOL_NAMES = new Set([
+    'create_playbook', 'execute_playbook', 'list_playbooks',
+]);
+/**
+ * Resolve template references like {{context.foo}} and {{steps[0].result.bar}}
+ * in argument values against the current execution state.
+ */
+function resolveTemplate(value, context, stepResults) {
+    if (typeof value === 'string') {
+        return value.replace(/\{\{(.*?)\}\}/g, (_match, expr) => {
+            const trimmed = expr.trim();
+            // Handle context.key references
+            if (trimmed.startsWith('context.')) {
+                const path = trimmed.slice('context.'.length);
+                return resolvePathValue(context, path) ?? '';
+            }
+            // Handle steps[N].result.key references
+            const stepMatch = trimmed.match(/^steps\[(\d+)\]\.result\.(.+)$/);
+            if (stepMatch) {
+                const stepIdx = parseInt(stepMatch[1], 10);
+                const path = stepMatch[2];
+                const stepResult = stepResults[stepIdx];
+                if (stepResult?.result) {
+                    return resolvePathValue(stepResult.result, path) ?? '';
+                }
+                return '';
+            }
+            return '';
+        });
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => resolveTemplate(item, context, stepResults));
+    }
+    if (value !== null && typeof value === 'object') {
+        const resolved = {};
+        for (const [k, v] of Object.entries(value)) {
+            resolved[k] = resolveTemplate(v, context, stepResults);
+        }
+        return resolved;
+    }
+    return value;
+}
+/** Resolve a dot-separated path against an object */
+function resolvePathValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Evaluate a simple condition string against context and step results.
+ * Supports basic expressions like "context.count > 0" or "steps[0].result.success == true".
+ */
+function evaluateCondition(condition, context, stepResults) {
+    if (!condition || condition.trim() === '')
+        return true;
+    // Resolve all template references in the condition first
+    const resolved = resolveTemplate(condition, context, stepResults);
+    // Simple truthy evaluation after template resolution
+    // Support basic comparisons: ==, !=, >, <, >=, <=
+    const comparisonMatch = String(resolved).match(/^(.+?)\s*(==|!=|>=|<=|>|<)\s*(.+)$/);
+    if (comparisonMatch) {
+        const [, leftStr, op, rightStr] = comparisonMatch;
+        const left = parseConditionValue(leftStr.trim());
+        const right = parseConditionValue(rightStr.trim());
+        switch (op) {
+            case '==': return left == right;
+            case '!=': return left != right;
+            case '>': return Number(left) > Number(right);
+            case '<': return Number(left) < Number(right);
+            case '>=': return Number(left) >= Number(right);
+            case '<=': return Number(left) <= Number(right);
+        }
+    }
+    // Default: truthy check on the resolved string
+    const val = String(resolved).trim().toLowerCase();
+    return val !== '' && val !== 'false' && val !== '0' && val !== 'null' && val !== 'undefined';
+}
+function parseConditionValue(val) {
+    if (val === 'true')
+        return true;
+    if (val === 'false')
+        return false;
+    if (val === 'null' || val === 'undefined')
+        return '';
+    // Remove surrounding quotes
+    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+        return val.slice(1, -1);
+    }
+    const num = Number(val);
+    if (!isNaN(num) && val !== '')
+        return num;
+    return val;
+}
+export async function executeOrchestrationToolCall(client, name, args) {
+    if (!ORCHESTRATION_TOOL_NAMES.has(name))
+        return null;
+    switch (name) {
+        case 'create_playbook': {
+            requireNowAssist();
+            requireWrite();
+            if (!args.name)
+                throw new ServiceNowError('name is required', 'INVALID_REQUEST');
+            if (!args.description)
+                throw new ServiceNowError('description is required', 'INVALID_REQUEST');
+            if (!args.steps || !Array.isArray(args.steps) || args.steps.length === 0) {
+                throw new ServiceNowError('steps must be a non-empty array', 'INVALID_REQUEST');
+            }
+            // Validate each step has required fields
+            for (let i = 0; i < args.steps.length; i++) {
+                const step = args.steps[i];
+                if (!step.tool_name)
+                    throw new ServiceNowError(`steps[${i}].tool_name is required`, 'INVALID_REQUEST');
+                if (!step.args_template || typeof step.args_template !== 'object') {
+                    throw new ServiceNowError(`steps[${i}].args_template must be an object`, 'INVALID_REQUEST');
+                }
+            }
+            // Attempt to store as a record; fall back to returning the definition
+            try {
+                const record = await client.createRecord('sys_hub_action_type_definition', {
+                    name: args.name,
+                    description: args.description,
+                    definition: JSON.stringify({
+                        steps: args.steps,
+                        version: '1.0',
+                        created_by: 'nowaikit',
+                    }),
+                    active: true,
+                });
+                return { message: 'Playbook created', playbook: record };
+            }
+            catch {
+                // Table may not exist — return the definition for manual creation
+                return {
+                    message: 'Playbook definition generated (table sys_hub_action_type_definition may not be available). Use this definition for manual creation.',
+                    definition: {
+                        name: args.name,
+                        description: args.description,
+                        steps: args.steps,
+                        version: '1.0',
+                    },
+                };
+            }
+        }
+        case 'execute_playbook': {
+            requireNowAssist();
+            if (!args.playbook || !args.playbook.steps || !Array.isArray(args.playbook.steps)) {
+                throw new ServiceNowError('playbook with steps array is required', 'INVALID_REQUEST');
+            }
+            const steps = args.playbook.steps;
+            const context = args.context || {};
+            const dryRun = args.dry_run !== false;
+            const stepResults = [];
+            // Dynamically import executeTool for live execution
+            let executeTool;
+            if (!dryRun) {
+                const toolIndex = await import('./index.js');
+                executeTool = toolIndex.executeTool;
+            }
+            for (let i = 0; i < steps.length; i++) {
+                const step = steps[i];
+                const onError = step.on_error || 'stop';
+                // Evaluate condition
+                if (step.condition) {
+                    const conditionMet = evaluateCondition(step.condition, context, stepResults);
+                    if (!conditionMet) {
+                        stepResults.push({
+                            step_index: i,
+                            tool_name: step.tool_name,
+                            status: 'skipped',
+                            result: null,
+                            error: `Condition not met: ${step.condition}`,
+                        });
+                        continue;
+                    }
+                }
+                // Resolve args template
+                const resolvedArgs = resolveTemplate(step.args_template, context, stepResults);
+                if (dryRun) {
+                    stepResults.push({
+                        step_index: i,
+                        tool_name: step.tool_name,
+                        status: 'dry_run',
+                        result: { resolved_args: resolvedArgs },
+                    });
+                    continue;
+                }
+                // Execute the step
+                const startTime = Date.now();
+                try {
+                    const result = await executeTool(client, step.tool_name, resolvedArgs);
+                    stepResults.push({
+                        step_index: i,
+                        tool_name: step.tool_name,
+                        status: 'executed',
+                        result,
+                        duration_ms: Date.now() - startTime,
+                    });
+                }
+                catch (err) {
+                    const errorMsg = err instanceof ServiceNowError ? err.message : String(err);
+                    stepResults.push({
+                        step_index: i,
+                        tool_name: step.tool_name,
+                        status: 'error',
+                        error: errorMsg,
+                        duration_ms: Date.now() - startTime,
+                    });
+                    if (onError === 'stop') {
+                        break;
+                    }
+                    // 'skip' and 'continue' both move to the next step
+                }
+            }
+            return {
+                playbook_name: args.playbook.name || 'unnamed',
+                dry_run: dryRun,
+                total_steps: steps.length,
+                executed: stepResults.filter(s => s.status === 'executed').length,
+                skipped: stepResults.filter(s => s.status === 'skipped').length,
+                errors: stepResults.filter(s => s.status === 'error').length,
+                steps: stepResults,
+            };
+        }
+        case 'list_playbooks': {
+            const limit = args.limit || 25;
+            const resp = await client.queryRecords({
+                table: 'sys_hub_action_type_definition',
+                query: 'active=true',
+                limit,
+                fields: 'sys_id,name,description,active,sys_updated_on',
+            });
+            return { count: resp.count, playbooks: resp.records };
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=orchestration.js.map

package/dist/tools/orchestration.js.map

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

package/dist/tools/reporting.d.ts

@@ -1,5 +1,5 @@
 /**
- * Reporting & Analytics tools — ServiceNow Reporting API.
+ * Reporting & Analytics tools — ServiceNow Reporting API + branded report generation.
  * All tools are Tier 0 (read-only) unless noted.
  * ServiceNow API: GET /api/now/reporting, /api/now/stats/{table}, /api/now/pa/widget/{sys_id}
  */
@@ -53,6 +53,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: never[];
     };
@@ -99,6 +102,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -157,6 +163,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -215,6 +224,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -264,6 +276,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -319,6 +334,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -368,6 +386,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: never[];
     };
@@ -420,6 +441,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: never[];
     };
@@ -481,6 +505,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -530,6 +557,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -576,6 +606,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -643,6 +676,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -695,6 +731,9 @@ export declare function getReportingToolDefinitions(): ({
             format?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: never[];
     };
@@ -727,6 +766,7 @@ export declare function getReportingToolDefinitions(): ({
             format: {
                 type: string;
                 description: string;
+                enum?: undefined;
             };
             search?: undefined;
             category?: undefined;
@@ -756,6 +796,9 @@ export declare function getReportingToolDefinitions(): ({
             status?: undefined;
             conditions?: undefined;
             unit?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
         };
         required: string[];
     };
@@ -817,6 +860,89 @@ export declare function getReportingToolDefinitions(): ({
             day_of_week?: undefined;
             day_of_month?: undefined;
             format?: undefined;
+            content?: undefined;
+            sections?: undefined;
+            capability?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            content: {
+                type: string;
+                description: string;
+            };
+            sections: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        content: {
+                            type: string;
+                            description: string;
+                        };
+                        title: {
+                            type: string;
+                            description: string;
+                        };
+                        capability: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            capability: {
+                type: string;
+                description: string;
+            };
+            search?: undefined;
+            category?: undefined;
+            limit?: undefined;
+            sys_id_or_name?: undefined;
+            table?: undefined;
+            group_by?: undefined;
+            aggregate?: undefined;
+            query?: undefined;
+            date_field?: undefined;
+            periods?: undefined;
+            widget_sys_id?: undefined;
+            time_range?: undefined;
+            fields?: undefined;
+            active?: undefined;
+            name?: undefined;
+            script?: undefined;
+            run_type?: undefined;
+            run_time?: undefined;
+            run_period?: undefined;
+            sys_id?: undefined;
+            type?: undefined;
+            field?: undefined;
+            roles?: undefined;
+            job_sys_id?: undefined;
+            status?: undefined;
+            report_id?: undefined;
+            frequency?: undefined;
+            recipients?: undefined;
+            day_of_week?: undefined;
+            day_of_month?: undefined;
+            conditions?: undefined;
+            unit?: undefined;
         };
         required: string[];
     };

package/dist/tools/reporting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporting.d.ts","sourceRoot":"","sources":["../../src/tools/reporting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA+P1C;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CAmLd"}
+{"version":3,"file":"reporting.d.ts","sourceRoot":"","sources":["../../src/tools/reporting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA0R1C;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,GAAG,CAAC,CA0Nd"}

package/dist/tools/reporting.js

@@ -253,6 +253,33 @@ export function getReportingToolDefinitions() {
                 required: ['name', 'table', 'aggregate'],
             },
         },
+        {
+            name: 'generate_report',
+            description: 'Generate a branded PDF or PPTX report from capability analysis results. Call this after completing a scan, review, or audit to create a management-ready document with charts, tables, and ServiceNow links. Supports single capability (content) or multiple capabilities (sections) in one combined report.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    content: { type: 'string', description: 'Full markdown analysis to convert into a branded report (for single capability)' },
+                    sections: {
+                        type: 'array',
+                        description: 'Multiple capability analyses to combine into one report. Each section becomes a chapter. Use this instead of content for multi-capability reports.',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                content: { type: 'string', description: 'Markdown analysis for this capability' },
+                                title: { type: 'string', description: 'Section title (e.g. "Instance Health Scan")' },
+                                capability: { type: 'string', description: 'Capability name (e.g. "scan-health")' },
+                            },
+                            required: ['content', 'title'],
+                        },
+                    },
+                    format: { type: 'string', enum: ['pdf', 'pptx'], description: 'Output format: pdf (branded document) or pptx (slide deck)' },
+                    title: { type: 'string', description: 'Report title (e.g. "Instance Health Scan", "Comprehensive Instance Audit")' },
+                    capability: { type: 'string', description: 'Capability name that produced the analysis (e.g. "scan-health", "review-code", "combined-audit")' },
+                },
+                required: ['format', 'title'],
+            },
+        },
     ];
 }
 export async function executeReportingToolCall(client, name, args) {
@@ -453,6 +480,43 @@ export async function executeReportingToolCall(client, name, args) {
             });
             return { ...result, summary: `Created KPI "${args.name}" (${args.aggregate} on ${args.table})` };
         }
+        case 'generate_report': {
+            if (!args.format || !args.title)
+                throw new ServiceNowError('format and title are required', 'INVALID_REQUEST');
+            if (!args.content && !args.sections)
+                throw new ServiceNowError('Either content (single capability) or sections (multiple capabilities) is required', 'INVALID_REQUEST');
+            if (args.format !== 'pdf' && args.format !== 'pptx')
+                throw new ServiceNowError('format must be "pdf" or "pptx"', 'INVALID_REQUEST');
+            // Combine sections into a single markdown document if multiple capabilities provided
+            let combinedContent;
+            let capabilityName;
+            if (args.sections && Array.isArray(args.sections) && args.sections.length > 0) {
+                combinedContent = args.sections
+                    .map((s) => `\n\n---\n\n# ${s.title}\n\n${s.content}`)
+                    .join('\n');
+                capabilityName = args.capability || (args.sections.length > 1 ? 'combined-audit' : args.sections[0].capability || 'report');
+            }
+            else {
+                combinedContent = args.content;
+                capabilityName = args.capability || 'report';
+            }
+            const { generateReport } = await import('../reports/index.js');
+            const reportResult = await generateReport(combinedContent, args.format, {
+                title: args.title,
+                instanceUrl: client.baseUrl || '',
+                instanceName: capabilityName,
+                capability: capabilityName,
+            });
+            const sectionCount = args.sections ? args.sections.length : 1;
+            return {
+                success: true,
+                file_path: reportResult.filePath,
+                size_bytes: reportResult.sizeBytes,
+                format: args.format,
+                sections: sectionCount,
+                message: `Report saved to ${reportResult.filePath} (${Math.round(reportResult.sizeBytes / 1024)} KB, ${sectionCount} capability${sectionCount > 1 ? 'ies' : ''})`,
+            };
+        }
         default:
             return null;
     }