@goxtechnologies/connectwise-psa-mcp 1.1.0

package/dist/services/fast-memory.js.map

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

package/dist/services/load-env.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Zero-dependency .env file loader.
+ * Reads KEY=VALUE pairs from the plugin root's .env file and populates
+ * process.env as a fallback — existing environment variables take precedence.
+ */
+/** Resolve the plugin root directory. */
+export declare function getPluginRoot(): string;
+/**
+ * Load .env file into process.env (existing vars take precedence).
+ * Search order:
+ *   1. ~/.config/connectwise-psa/.env  (user config — always writable, works in Cowork)
+ *   2. <plugin_root>/.env              (legacy — may be read-only in Cowork sandbox)
+ */
+export declare function loadEnv(): void;
+//# sourceMappingURL=load-env.d.ts.map

package/dist/services/load-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../src/services/load-env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,yCAAyC;AACzC,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAyC9B"}

package/dist/services/load-env.js

@@ -0,0 +1,59 @@
+/**
+ * Zero-dependency .env file loader.
+ * Reads KEY=VALUE pairs from the plugin root's .env file and populates
+ * process.env as a fallback — existing environment variables take precedence.
+ */
+import { readFileSync, existsSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/** Resolve the plugin root directory. */
+export function getPluginRoot() {
+    // When built, __dirname is dist/services/ — 2 levels up to package root
+    return process.env['CLAUDE_PLUGIN_ROOT'] ?? resolve(__dirname, '../..');
+}
+/**
+ * Load .env file into process.env (existing vars take precedence).
+ * Search order:
+ *   1. ~/.config/connectwise-psa/.env  (user config — always writable, works in Cowork)
+ *   2. <plugin_root>/.env              (legacy — may be read-only in Cowork sandbox)
+ */
+export function loadEnv() {
+    const homeDir = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '';
+    const candidates = [
+        join(homeDir, '.config', 'connectwise-psa', '.env'), // primary (always writable)
+        join(getPluginRoot(), '.env'), // legacy fallback
+    ];
+    const envPath = candidates.find(p => existsSync(p));
+    if (!envPath)
+        return;
+    let content;
+    try {
+        content = readFileSync(envPath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIndex = trimmed.indexOf('=');
+        if (eqIndex <= 0)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        let value = trimmed.slice(eqIndex + 1).trim();
+        // Strip surrounding quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        // Set if not already in environment, or if current value is empty/unresolved placeholder
+        const current = process.env[key];
+        if (!current || current.startsWith('${')) {
+            process.env[key] = value;
+        }
+    }
+}
+//# sourceMappingURL=load-env.js.map

package/dist/services/load-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.js","sourceRoot":"","sources":["../../src/services/load-env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,yCAAyC;AACzC,MAAM,UAAU,aAAa;IAC3B,wEAAwE;IACxE,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IACxE,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAI,4BAA4B;QACnF,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,EAA2B,kBAAkB;KAC3E,CAAC;IAEF,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAElD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,OAAO,IAAI,CAAC;YAAE,SAAS;QAE3B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9C,2BAA2B;QAC3B,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,yFAAyF;QACzF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tools/batch.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const batchTools: Tool[];
+export declare function handleBatchTool(toolName: string, args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=batch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/tools/batch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AA+B1D,eAAO,MAAM,UAAU,EAAE,IAAI,EA2C5B,CAAC;AAMF,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA0G7D"}

package/dist/tools/batch.js

@@ -0,0 +1,159 @@
+// ConnectWise PSA MCP Server — Batch Update Tool
+import { getAPI } from '../services/connectwise-api.js';
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+function text(t) {
+    return { content: [{ type: 'text', text: t }] };
+}
+/** Narrow an unknown value to a BatchOperation, returning null on invalid input. */
+function parseBatchOperation(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const obj = raw;
+    const path = typeof obj['path'] === 'string' ? obj['path'] : null;
+    const method = obj['method'];
+    if (!path)
+        return null;
+    if (method !== 'PATCH' && method !== 'POST' && method !== 'DELETE')
+        return null;
+    return {
+        path,
+        method,
+        body: obj['body'],
+    };
+}
+// ---------------------------------------------------------------------------
+// Tool definition
+// ---------------------------------------------------------------------------
+export const batchTools = [
+    {
+        name: 'cw_batch_update',
+        description: 'Execute one or more PATCH / POST / DELETE operations against the ConnectWise API. ' +
+            'When confirm is false (the default) the tool performs a DRY RUN and shows exactly what would be sent without touching any data. ' +
+            'Set confirm to true to execute the operations sequentially and receive a pass/fail summary.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                operations: {
+                    type: 'array',
+                    description: 'Ordered list of operations to execute',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            path: {
+                                type: 'string',
+                                description: 'API path (e.g. /service/tickets/12345)',
+                            },
+                            method: {
+                                type: 'string',
+                                enum: ['PATCH', 'POST', 'DELETE'],
+                                description: 'HTTP method',
+                            },
+                            body: {
+                                type: 'object',
+                                description: 'Optional request body (for PATCH / POST)',
+                            },
+                        },
+                        required: ['path', 'method'],
+                    },
+                    minItems: 1,
+                },
+                confirm: {
+                    type: 'boolean',
+                    description: 'Set to true to actually execute the operations. Defaults to false (dry run).',
+                },
+            },
+            required: ['operations'],
+        },
+    },
+];
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export async function handleBatchTool(toolName, args) {
+    if (toolName !== 'cw_batch_update') {
+        return text(`Unknown batch tool: ${toolName}`);
+    }
+    // ------------------------------------------------------------------
+    // Parse and validate operations
+    // ------------------------------------------------------------------
+    const rawOps = args['operations'];
+    if (!Array.isArray(rawOps) || rawOps.length === 0) {
+        return text('Error: operations must be a non-empty array.');
+    }
+    const ops = [];
+    const parseErrors = [];
+    for (let i = 0; i < rawOps.length; i++) {
+        const op = parseBatchOperation(rawOps[i]);
+        if (!op) {
+            parseErrors.push(`Operation[${i}] is invalid — must have a string path and method of PATCH | POST | DELETE`);
+        }
+        else {
+            ops.push(op);
+        }
+    }
+    if (parseErrors.length > 0) {
+        return text(`Validation errors:\n${parseErrors.map((e) => `  - ${e}`).join('\n')}`);
+    }
+    // ------------------------------------------------------------------
+    // Dry run (confirm === false or omitted)
+    // ------------------------------------------------------------------
+    const confirm = args['confirm'] === true;
+    if (!confirm) {
+        const preview = ops
+            .map((op, i) => {
+            const bodyStr = op.body !== undefined ? `\n   body: ${JSON.stringify(op.body, null, 2)}` : '';
+            return `  [${i + 1}] ${op.method} ${op.path}${bodyStr}`;
+        })
+            .join('\n\n');
+        return text(`DRY RUN — ${ops.length} operation${ops.length !== 1 ? 's' : ''} would be executed:\n\n${preview}\n\n` +
+            'Set confirm=true to execute.');
+    }
+    // ------------------------------------------------------------------
+    // Live execution — sequential to avoid race conditions on related records
+    // ------------------------------------------------------------------
+    const api = getAPI();
+    const result = {
+        total: ops.length,
+        succeeded: 0,
+        failed: 0,
+        results: [],
+    };
+    for (const op of ops) {
+        try {
+            await api.requestWithRetry({
+                path: op.path,
+                method: op.method,
+                body: op.body,
+            });
+            result.succeeded++;
+            result.results.push({
+                path: op.path,
+                status: 'success',
+                message: `${op.method} ${op.path} — OK`,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            result.failed++;
+            result.results.push({
+                path: op.path,
+                status: 'error',
+                message: `${op.method} ${op.path} — ${message}`,
+            });
+        }
+    }
+    // ------------------------------------------------------------------
+    // Format summary
+    // ------------------------------------------------------------------
+    const statusIcon = (s) => (s === 'success' ? 'OK' : 'FAIL');
+    const rows = result.results
+        .map((r) => `  [${statusIcon(r.status)}] ${r.message}`)
+        .join('\n');
+    const summary = `Batch complete — ${result.total} operation${result.total !== 1 ? 's' : ''}: ` +
+        `${result.succeeded} succeeded, ${result.failed} failed.\n\n` +
+        rows;
+    return text(summary);
+}
+//# sourceMappingURL=batch.js.map

package/dist/tools/batch.js.map

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

package/dist/tools/composite.d.ts

@@ -0,0 +1,9 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const compositeTools: Tool[];
+export declare function handleCompositeTool(toolName: string, args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=composite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composite.d.ts","sourceRoot":"","sources":["../../src/tools/composite.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AA8B1D,eAAO,MAAM,cAAc,EAAE,IAAI,EAwEhC,CAAC;AAMF,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAiT7D"}

package/dist/tools/composite.js

@@ -0,0 +1,353 @@
+// ConnectWise PSA MCP Server — Composite Query Tools
+//
+// Each tool fans out multiple API calls in parallel via Promise.allSettled so
+// partial failures are handled gracefully — the caller always gets whatever
+// data was successfully retrieved.
+import { getAPI } from '../services/connectwise-api.js';
+import { formatTicketContext, formatMemberDashboard, formatAgreementHealth } from '../utils/formatters.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function text(t) {
+    return { content: [{ type: 'text', text: t }] };
+}
+/**
+ * Settle a named parallel fetch.  Returns the resolved value on success or
+ * an object containing an `_error` key describing the failure on rejection.
+ */
+async function settle(label, promise) {
+    const [result] = await Promise.allSettled([promise]);
+    if (result.status === 'fulfilled')
+        return result.value;
+    const reason = result.reason instanceof Error ? result.reason.message : String(result.reason);
+    return { _error: `${label} failed: ${reason}` };
+}
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+export const compositeTools = [
+    {
+        name: 'cw_ticket_context',
+        description: 'Fetch the complete context for a single ticket in one call: the ticket record, internal notes, time entries, tasks, attached documents, and schedule entries. ' +
+            'Partial failures are surfaced inline — you still receive whatever succeeded.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ticket_id: {
+                    type: 'number',
+                    description: 'Numeric ConnectWise ticket ID',
+                },
+            },
+            required: ['ticket_id'],
+        },
+    },
+    {
+        name: 'cw_member_dashboard',
+        description: 'Return a workload snapshot for a single member: their profile, open tickets, scheduled hours, and time-entry hours — all in one call.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                identifier: {
+                    type: 'string',
+                    description: 'ConnectWise member identifier (login name)',
+                },
+                days_back: {
+                    type: 'number',
+                    description: 'How many calendar days to look back for schedule and time entries (default 30)',
+                },
+            },
+            required: ['identifier'],
+        },
+    },
+    {
+        name: 'cw_agreement_health',
+        description: 'Return the full health picture for a single agreement: the agreement record, all additions, configured work roles, and configured work types — in one call.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agreement_id: {
+                    type: 'number',
+                    description: 'Numeric ConnectWise agreement ID',
+                },
+            },
+            required: ['agreement_id'],
+        },
+    },
+    {
+        name: 'cw_audit_ticket',
+        description: 'Audit a ticket for completeness, compliance, and quality. Checks: missing fields, ' +
+            'incomplete tasks, missing resolution note, time entries without notes, SLA compliance, ' +
+            'customer notification status, excessive time vs ticket complexity, and billing coherence. ' +
+            'Returns a compliance score with detailed findings.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ticket_id: {
+                    type: 'number',
+                    description: 'Numeric ConnectWise ticket ID to audit',
+                },
+            },
+            required: ['ticket_id'],
+        },
+    },
+];
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export async function handleCompositeTool(toolName, args) {
+    const api = getAPI();
+    // -------------------------------------------------------------------------
+    switch (toolName) {
+        case 'cw_ticket_context': {
+            const ticketId = Number(args['ticket_id']);
+            if (!Number.isInteger(ticketId) || ticketId <= 0) {
+                return text('Error: ticket_id must be a positive integer.');
+            }
+            const base = `/service/tickets/${ticketId}`;
+            const [ticket, notes, timeEntries, tasks, documents, scheduleEntries] = await Promise.all([
+                settle('ticket', api.request({ path: base, method: 'GET' })),
+                settle('notes', api.request({ path: `${base}/notes`, method: 'GET', params: { pageSize: 250, orderBy: 'dateCreated asc' } })),
+                settle('timeEntries', api.request({ path: `${base}/timeentries`, method: 'GET', params: { pageSize: 250 } })),
+                settle('tasks', api.request({ path: `${base}/tasks`, method: 'GET', params: { pageSize: 250 } })),
+                settle('documents', api.request({ path: `${base}/documents`, method: 'GET', params: { pageSize: 250 } })),
+                settle('scheduleEntries', api.request({ path: `${base}/scheduleentries`, method: 'GET', params: { pageSize: 250 } })),
+            ]);
+            const result = { ticket, notes, timeEntries, tasks, documents, scheduleEntries };
+            return text(formatTicketContext(result));
+        }
+        // -------------------------------------------------------------------------
+        case 'cw_member_dashboard': {
+            const identifier = String(args['identifier'] ?? '').trim();
+            if (!identifier) {
+                return text('Error: identifier is required.');
+            }
+            const daysBack = Number(args['days_back'] ?? 30);
+            const startDate = new Date();
+            startDate.setDate(startDate.getDate() - (Number.isFinite(daysBack) && daysBack > 0 ? daysBack : 30));
+            const startIso = startDate.toISOString().split('T')[0]; // YYYY-MM-DD
+            const [memberResult, openTicketsResult, scheduleResult, timeResult] = await Promise.all([
+                settle('member', api.request({
+                    path: '/system/members',
+                    method: 'GET',
+                    params: { conditions: `identifier='${identifier}'` },
+                })),
+                settle('openTickets', api.request({
+                    path: '/service/tickets',
+                    method: 'GET',
+                    params: {
+                        conditions: `resources like '%${identifier}%' AND closedFlag=false`,
+                        pageSize: 50,
+                        fields: 'id,summary,status,company,priority,dateEntered',
+                    },
+                })),
+                settle('scheduleEntries', api.request({
+                    path: '/schedule/entries',
+                    method: 'GET',
+                    params: {
+                        conditions: `member/identifier='${identifier}' AND dateStart>=[${startIso}]`,
+                        pageSize: 250,
+                    },
+                })),
+                settle('timeEntries', api.request({
+                    path: '/time/entries',
+                    method: 'GET',
+                    params: {
+                        conditions: `member/identifier='${identifier}' AND dateEntered>=[${startIso}]`,
+                        pageSize: 250,
+                    },
+                })),
+            ]);
+            // Derive summary metrics from successfully fetched data
+            const openTicketCount = Array.isArray(openTicketsResult) ? openTicketsResult.length : null;
+            let totalTimeHours = null;
+            if (Array.isArray(timeResult)) {
+                totalTimeHours = timeResult.reduce((sum, e) => sum + (e.actualHours ?? 0), 0);
+            }
+            let scheduledHours = null;
+            if (Array.isArray(scheduleResult)) {
+                scheduledHours = scheduleResult.reduce((sum, e) => sum + (e.hours ?? 0), 0);
+            }
+            const summary = {
+                member: memberResult,
+                openTickets: openTicketsResult,
+                scheduleEntries: scheduleResult,
+                timeEntries: timeResult,
+                _computed: {
+                    periodStart: startIso,
+                    daysBack,
+                    openTicketCount,
+                    totalTimeHours: totalTimeHours !== null ? Math.round(totalTimeHours * 100) / 100 : null,
+                    scheduledHours: scheduledHours !== null ? Math.round(scheduledHours * 100) / 100 : null,
+                },
+            };
+            return text(formatMemberDashboard(summary));
+        }
+        // -------------------------------------------------------------------------
+        case 'cw_agreement_health': {
+            const agreementId = Number(args['agreement_id']);
+            if (!Number.isInteger(agreementId) || agreementId <= 0) {
+                return text('Error: agreement_id must be a positive integer.');
+            }
+            const base = `/finance/agreements/${agreementId}`;
+            const [agreement, additions, workRoles, workTypes] = await Promise.all([
+                settle('agreement', api.request({ path: base, method: 'GET' })),
+                settle('additions', api.request({ path: `${base}/additions`, method: 'GET', params: { pageSize: 250 } })),
+                settle('workRoles', api.request({ path: `${base}/workRoles`, method: 'GET', params: { pageSize: 250 } })),
+                settle('workTypes', api.request({ path: `${base}/workTypes`, method: 'GET', params: { pageSize: 250 } })),
+            ]);
+            const result = { agreement, additions, workRoles, workTypes };
+            return text(formatAgreementHealth(result));
+        }
+        // -------------------------------------------------------------------------
+        case 'cw_audit_ticket': {
+            const ticketId = Number(args['ticket_id']);
+            if (!Number.isInteger(ticketId) || ticketId <= 0) {
+                return text('Error: ticket_id must be a positive integer.');
+            }
+            const base = `/service/tickets/${ticketId}`;
+            // Parallel fetch all ticket data
+            const [ticket, notes, timeEntries, tasks, documents] = await Promise.all([
+                settle('ticket', api.request({ path: base, method: 'GET' })),
+                settle('notes', api.request({ path: `${base}/notes`, method: 'GET', params: { pageSize: 250, orderBy: 'dateCreated asc' } })),
+                settle('timeEntries', api.request({ path: `${base}/timeentries`, method: 'GET', params: { pageSize: 250 } })),
+                settle('tasks', api.request({ path: `${base}/tasks`, method: 'GET', params: { pageSize: 250 } })),
+                settle('documents', api.request({ path: `${base}/documents`, method: 'GET', params: { pageSize: 250 } })),
+            ]);
+            const findings = [];
+            let score = 100;
+            const t = ticket;
+            const noteArr = Array.isArray(notes) ? notes : [];
+            const timeArr = Array.isArray(timeEntries) ? timeEntries : [];
+            const taskArr = Array.isArray(tasks) ? tasks : [];
+            if ('_error' in t) {
+                return text(`Error fetching ticket #${ticketId}: ${t._error}`);
+            }
+            // 1. Required fields
+            const requiredFields = [
+                { field: 'company', label: 'Company' },
+                { field: 'contact', label: 'Contact' },
+                { field: 'type', label: 'Type' },
+                { field: 'subType', label: 'SubType' },
+                { field: 'priority', label: 'Priority' },
+            ];
+            for (const { field, label } of requiredFields) {
+                if (!t[field] || (typeof t[field] === 'object' && !t[field]?.id)) {
+                    findings.push({ check: `Missing ${label}`, status: 'fail', detail: `${label} is not set on this ticket` });
+                    score -= 10;
+                }
+                else {
+                    findings.push({ check: `${label} set`, status: 'pass', detail: `${label}: ${t[field]?.name ?? 'set'}` });
+                }
+            }
+            // 2. Tasks completeness
+            if (taskArr.length > 0) {
+                const incomplete = taskArr.filter(task => !task.closedFlag);
+                if (incomplete.length > 0) {
+                    findings.push({ check: 'Incomplete tasks', status: 'fail', detail: `${incomplete.length} of ${taskArr.length} tasks are not complete` });
+                    score -= 15;
+                }
+                else {
+                    findings.push({ check: 'All tasks complete', status: 'pass', detail: `${taskArr.length} tasks all done` });
+                }
+            }
+            // 3. Resolution note
+            const hasResolution = noteArr.some(n => n.internalAnalysisFlag === false && n.resolutionFlag === true) ||
+                noteArr.some(n => n.resolutionFlag === true);
+            const isClosed = (t.closedFlag === true);
+            if (isClosed && !hasResolution) {
+                findings.push({ check: 'Missing resolution note', status: 'fail', detail: 'Ticket is closed but has no resolution note' });
+                score -= 15;
+            }
+            else if (hasResolution) {
+                findings.push({ check: 'Resolution note present', status: 'pass', detail: 'Resolution documented' });
+            }
+            // 4. Time entries with notes
+            if (timeArr.length > 0) {
+                const noNotes = timeArr.filter(e => {
+                    const hours = Number(e.actualHours ?? 0);
+                    const notes = String(e.notes ?? '').trim();
+                    return hours > 0 && notes.length === 0;
+                });
+                if (noNotes.length > 0) {
+                    findings.push({ check: 'Time entries missing notes', status: 'fail', detail: `${noNotes.length} of ${timeArr.length} entries have hours but no description` });
+                    score -= 10;
+                }
+                else {
+                    findings.push({ check: 'All time entries have notes', status: 'pass', detail: `${timeArr.length} entries documented` });
+                }
+            }
+            else if (isClosed) {
+                findings.push({ check: 'No time logged', status: 'warn', detail: 'Ticket is closed but has no time entries' });
+                score -= 5;
+            }
+            // 5. Customer notification
+            const hasExternalNote = noteArr.some(n => n.detailDescriptionFlag === true || n.externalFlag === true);
+            if (!hasExternalNote) {
+                findings.push({ check: 'No customer communication', status: 'warn', detail: 'No external notes found — customer may not have been notified' });
+                score -= 5;
+            }
+            else {
+                findings.push({ check: 'Customer notified', status: 'pass', detail: 'External notes present' });
+            }
+            // 6. Excessive time check
+            const totalHours = timeArr.reduce((s, e) => s + (Number(e.actualHours) || 0), 0);
+            const budgetHours = Number(t.budgetHours ?? 0);
+            if (budgetHours > 0 && totalHours > budgetHours * 1.5) {
+                findings.push({ check: 'Excessive time', status: 'warn', detail: `${Math.round(totalHours * 100) / 100}h logged vs ${budgetHours}h budget (${Math.round(totalHours / budgetHours * 100)}%)` });
+                score -= 10;
+            }
+            else if (budgetHours > 0) {
+                findings.push({ check: 'Time within budget', status: 'pass', detail: `${Math.round(totalHours * 100) / 100}h of ${budgetHours}h budget (${Math.round(totalHours / budgetHours * 100)}%)` });
+            }
+            // 7. SLA check (basic — response time)
+            const dateEntered = t.dateEntered;
+            const firstNote = noteArr.find(n => n.internalAnalysisFlag === true || n.detailDescriptionFlag === true);
+            if (dateEntered && firstNote) {
+                const created = new Date(dateEntered).getTime();
+                const responded = new Date(firstNote.dateCreated).getTime();
+                const responseMinutes = Math.round((responded - created) / 60000);
+                if (responseMinutes > 240) {
+                    findings.push({ check: 'Slow first response', status: 'warn', detail: `First response after ${responseMinutes} minutes (${Math.round(responseMinutes / 60)}h)` });
+                    score -= 5;
+                }
+                else {
+                    findings.push({ check: 'First response time OK', status: 'pass', detail: `Responded in ${responseMinutes} minutes` });
+                }
+            }
+            // 8. Agreement/billing coherence
+            const agreement = t.agreement;
+            const billableEntries = timeArr.filter(e => String(e.billableOption ?? '').toLowerCase().includes('billable'));
+            if (!agreement && billableEntries.length > 0) {
+                findings.push({ check: 'Billing without agreement', status: 'warn', detail: `${billableEntries.length} billable entries but no agreement on ticket` });
+            }
+            // Build report
+            score = Math.max(0, score);
+            const passCount = findings.filter(f => f.status === 'pass').length;
+            const failCount = findings.filter(f => f.status === 'fail').length;
+            const warnCount = findings.filter(f => f.status === 'warn').length;
+            const lines = [];
+            lines.push(`## Ticket Audit: #${ticketId} — ${t.summary ?? 'N/A'}`);
+            lines.push('');
+            lines.push(`**Compliance Score: ${score}/100** | ${passCount} pass | ${failCount} fail | ${warnCount} warn`);
+            lines.push('');
+            lines.push('| Check | Status | Detail |');
+            lines.push('|-------|--------|--------|');
+            for (const f of findings) {
+                const icon = f.status === 'pass' ? 'PASS' : f.status === 'fail' ? 'FAIL' : 'WARN';
+                lines.push(`| ${f.check} | ${icon} | ${f.detail} |`);
+            }
+            if (failCount > 0) {
+                lines.push('');
+                lines.push('### Action Required');
+                for (const f of findings.filter(f => f.status === 'fail')) {
+                    lines.push(`- **${f.check}**: ${f.detail}`);
+                }
+            }
+            return text(lines.join('\n'));
+        }
+        // -------------------------------------------------------------------------
+        default:
+            return text(`Unknown composite tool: ${toolName}`);
+    }
+}
+//# sourceMappingURL=composite.js.map