@tuteliq/mcp 2.2.0 → 3.1.0

package/dist/src/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const sdk_1 = require("@tuteliq/sdk");
+const detection_js_1 = require("./tools/detection.js");
+const fraud_js_1 = require("./tools/fraud.js");
+const media_js_1 = require("./tools/media.js");
+const analysis_js_1 = require("./tools/analysis.js");
+const admin_js_1 = require("./tools/admin.js");
+const transport_js_1 = require("./transport.js");
+function createServer() {
+    const apiKey = process.env.TUTELIQ_API_KEY;
+    if (!apiKey) {
+        console.error('Error: TUTELIQ_API_KEY environment variable is required');
+        process.exit(1);
+    }
+    const client = new sdk_1.Tuteliq(apiKey);
+    const server = new mcp_js_1.McpServer({
+        name: 'tuteliq-mcp',
+        version: '3.0.0',
+    });
+    // Register all tool groups
+    (0, detection_js_1.registerDetectionTools)(server, client);
+    (0, fraud_js_1.registerFraudTools)(server, client);
+    (0, media_js_1.registerMediaTools)(server, client);
+    (0, analysis_js_1.registerAnalysisTools)(server, client);
+    (0, admin_js_1.registerAdminTools)(server, client);
+    return server;
+}
+// Direct execution: stdio mode
+if ((0, transport_js_1.getTransportMode)() === 'stdio') {
+    const server = createServer();
+    (0, transport_js_1.startStdio)(server).catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}

package/dist/src/tools/admin.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Tuteliq } from '@tuteliq/sdk';
+export declare function registerAdminTools(server: McpServer, client: Tuteliq): void;
+//# sourceMappingURL=admin.d.ts.map

package/dist/src/tools/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../src/tools/admin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAsG,MAAM,cAAc,CAAC;AAGhJ,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAmU3E"}

package/dist/src/tools/admin.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAdminTools = registerAdminTools;
+const zod_1 = require("zod");
+const formatters_js_1 = require("../formatters.js");
+function registerAdminTools(server, client) {
+    // =========================================================================
+    // Webhook Management
+    // =========================================================================
+    server.tool('list_webhooks', 'List all webhooks configured for your account.', {}, async () => {
+        const result = await client.listWebhooks();
+        if (result.webhooks.length === 0) {
+            return { content: [{ type: 'text', text: 'No webhooks configured.' }] };
+        }
+        const lines = result.webhooks.map(w => `- ${w.is_active ? '\u{1F7E2}' : '\u26AA'} **${w.name}** \u2014 \`${w.url}\`\n  Events: ${w.events.join(', ')} _(${w.id})_`).join('\n');
+        return { content: [{ type: 'text', text: `## Webhooks\n\n${lines}` }] };
+    });
+    server.tool('create_webhook', 'Create a new webhook endpoint.', {
+        name: zod_1.z.string().describe('Display name for the webhook'),
+        url: zod_1.z.string().describe('HTTPS URL to receive webhook payloads'),
+        events: zod_1.z.array(zod_1.z.string()).describe('Event types to subscribe to'),
+    }, async ({ name, url, events }) => {
+        const result = await client.createWebhook({
+            name,
+            url,
+            events: events,
+        });
+        return { content: [{ type: 'text', text: `## \u2705 Webhook Created\n\n**ID:** ${result.id}\n**Name:** ${result.name}\n**URL:** ${result.url}\n**Events:** ${result.events.join(', ')}\n\n\u26A0\uFE0F **Secret (save this \u2014 shown only once):**\n\`${result.secret}\`` }] };
+    });
+    server.tool('update_webhook', 'Update an existing webhook configuration.', {
+        id: zod_1.z.string().describe('Webhook ID'),
+        name: zod_1.z.string().optional().describe('New display name'),
+        url: zod_1.z.string().optional().describe('New HTTPS URL'),
+        events: zod_1.z.array(zod_1.z.string()).optional().describe('New event subscriptions'),
+        is_active: zod_1.z.boolean().optional().describe('Enable or disable the webhook'),
+    }, async ({ id, name, url, events, is_active }) => {
+        const result = await client.updateWebhook(id, {
+            name,
+            url,
+            events: events,
+            isActive: is_active,
+        });
+        return { content: [{ type: 'text', text: `## \u2705 Webhook Updated\n\n**ID:** ${result.id}\n**Name:** ${result.name}\n**Active:** ${result.is_active ? '\u{1F7E2} Yes' : '\u26AA No'}` }] };
+    });
+    server.tool('delete_webhook', 'Permanently delete a webhook.', { id: zod_1.z.string().describe('Webhook ID to delete') }, async ({ id }) => {
+        await client.deleteWebhook(id);
+        return { content: [{ type: 'text', text: `## \u2705 Webhook Deleted\n\nWebhook \`${id}\` has been permanently deleted.` }] };
+    });
+    server.tool('test_webhook', 'Send a test payload to a webhook to verify it is working correctly.', { id: zod_1.z.string().describe('Webhook ID to test') }, async ({ id }) => {
+        const result = await client.testWebhook(id);
+        return { content: [{ type: 'text', text: `## ${result.success ? '\u2705' : '\u274C'} Webhook Test\n\n**Success:** ${result.success}\n**Status Code:** ${result.status_code}\n**Latency:** ${result.latency_ms}ms${result.error ? `\n**Error:** ${result.error}` : ''}` }] };
+    });
+    server.tool('regenerate_webhook_secret', 'Regenerate a webhook signing secret.', { id: zod_1.z.string().describe('Webhook ID') }, async ({ id }) => {
+        const result = await client.regenerateWebhookSecret(id);
+        return { content: [{ type: 'text', text: `## \u2705 Secret Regenerated\n\nThe old secret has been invalidated.\n\n\u26A0\uFE0F **New Secret (save this \u2014 shown only once):**\n\`${result.secret}\`` }] };
+    });
+    // =========================================================================
+    // Pricing
+    // =========================================================================
+    server.tool('get_pricing', 'Get available pricing plans for Tuteliq.', {}, async () => {
+        const result = await client.getPricing();
+        const lines = result.plans.map(p => `### ${p.name}\n**Price:** ${p.price}\n${p.features.map(f => `- ${f}`).join('\n')}`).join('\n\n');
+        return { content: [{ type: 'text', text: `## Tuteliq Pricing\n\n${lines}` }] };
+    });
+    server.tool('get_pricing_details', 'Get detailed pricing plans.', {}, async () => {
+        const result = await client.getPricingDetails();
+        const lines = result.plans.map(p => `### ${p.name}\n**Monthly:** ${p.price_monthly}/mo | **Yearly:** ${p.price_yearly}/mo\n**API Calls:** ${p.api_calls_per_month}/mo | **Rate Limit:** ${p.rate_limit}/min\n${p.features.map(f => `- ${f}`).join('\n')}`).join('\n\n');
+        return { content: [{ type: 'text', text: `## Tuteliq Pricing Details\n\n${lines}` }] };
+    });
+    // =========================================================================
+    // Usage & Billing
+    // =========================================================================
+    server.tool('get_usage_history', 'Get daily usage history for the past N days.', { days: zod_1.z.number().optional().describe('Number of days to retrieve (1-30, default: 7)') }, async ({ days }) => {
+        const result = await client.getUsageHistory(days);
+        if (result.days.length === 0) {
+            return { content: [{ type: 'text', text: 'No usage data available.' }] };
+        }
+        const lines = result.days.map(d => `| ${d.date} | ${d.total_requests} | ${d.success_requests} | ${d.error_requests} |`).join('\n');
+        return { content: [{ type: 'text', text: `## Usage History\n\n| Date | Total | Success | Errors |\n|------|-------|---------|--------|\n${lines}` }] };
+    });
+    server.tool('get_usage_by_tool', 'Get usage broken down by tool/endpoint for a specific date.', { date: zod_1.z.string().optional().describe('Date in YYYY-MM-DD format (default: today)') }, async ({ date }) => {
+        const result = await client.getUsageByTool(date);
+        const toolLines = Object.entries(result.tools).map(([tool, count]) => `- **${tool}:** ${count}`).join('\n');
+        const endpointLines = Object.entries(result.endpoints).map(([ep, count]) => `- **${ep}:** ${count}`).join('\n');
+        return { content: [{ type: 'text', text: `## Usage by Tool \u2014 ${result.date}\n\n### By Tool\n${toolLines || '_No data_'}\n\n### By Endpoint\n${endpointLines || '_No data_'}` }] };
+    });
+    server.tool('get_usage_monthly', 'Get monthly usage summary.', {}, async () => {
+        const result = await client.getUsageMonthly();
+        const text = `## Monthly Usage
+
+**Tier:** ${result.tier_display_name}
+**Billing Period:** ${result.billing.current_period_start} \u2192 ${result.billing.current_period_end} (${result.billing.days_remaining} days left)
+
+### Usage
+**Used:** ${result.usage.used} / ${result.usage.limit} (${result.usage.percent_used.toFixed(1)}%)
+**Remaining:** ${result.usage.remaining}
+**Rate Limit:** ${result.rate_limit.requests_per_minute}/min
+
+${result.recommendations ? `### Recommendation\n${result.recommendations.reason}\n**Suggested Tier:** ${result.recommendations.suggested_tier}\n[Upgrade](${result.recommendations.upgrade_url})` : ''}`;
+        return { content: [{ type: 'text', text }] };
+    });
+    // =========================================================================
+    // GDPR Account
+    // =========================================================================
+    server.tool('delete_account_data', 'Delete all account data (GDPR Right to Erasure).', {}, async () => {
+        const result = await client.deleteAccountData();
+        return { content: [{ type: 'text', text: `## \u2705 Account Data Deleted\n\n**Message:** ${result.message}\n**Records Deleted:** ${result.deleted_count}` }] };
+    });
+    server.tool('export_account_data', 'Export all account data as JSON (GDPR Data Portability).', {}, async () => {
+        const result = await client.exportAccountData();
+        const collections = Object.keys(result.data).join(', ');
+        return { content: [{ type: 'text', text: `## \u{1F4E6} Account Data Export\n\n**User ID:** ${result.userId}\n**Exported At:** ${result.exportedAt}\n**Collections:** ${collections}\n\n\`\`\`json\n${JSON.stringify(result.data, null, 2).slice(0, 5000)}\n\`\`\`` }] };
+    });
+    const consentTypeEnum = zod_1.z.enum(['data_processing', 'analytics', 'marketing', 'third_party_sharing', 'child_safety_monitoring']);
+    server.tool('record_consent', 'Record user consent for data processing (GDPR Article 7).', {
+        consent_type: consentTypeEnum.describe('Type of consent to record'),
+        version: zod_1.z.string().describe('Policy version the user is consenting to'),
+    }, async ({ consent_type, version }) => {
+        const result = await client.recordConsent({ consent_type: consent_type, version });
+        return { content: [{ type: 'text', text: `## \u2705 Consent Recorded\n\n**Type:** ${result.consent.consent_type}\n**Status:** ${result.consent.status}\n**Version:** ${result.consent.version}` }] };
+    });
+    server.tool('get_consent_status', 'Get current consent status.', { type: consentTypeEnum.optional().describe('Optional: filter by consent type') }, async ({ type }) => {
+        const result = await client.getConsentStatus(type);
+        if (result.consents.length === 0) {
+            return { content: [{ type: 'text', text: 'No consent records found.' }] };
+        }
+        const lines = result.consents.map(c => `- **${c.consent_type}**: ${c.status === 'granted' ? '\u2705' : '\u274C'} ${c.status} (v${c.version})`).join('\n');
+        return { content: [{ type: 'text', text: `## Consent Status\n\n${lines}` }] };
+    });
+    server.tool('withdraw_consent', 'Withdraw a previously granted consent.', { type: consentTypeEnum.describe('Type of consent to withdraw') }, async ({ type }) => {
+        const result = await client.withdrawConsent(type);
+        return { content: [{ type: 'text', text: `## \u26A0\uFE0F Consent Withdrawn\n\n**Type:** ${result.consent.consent_type}\n**Status:** ${result.consent.status}` }] };
+    });
+    server.tool('rectify_data', 'Rectify (correct) user data (GDPR Right to Rectification).', {
+        collection: zod_1.z.string().describe('Firestore collection name'),
+        document_id: zod_1.z.string().describe('Document ID to rectify'),
+        fields: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).describe('Fields to update'),
+    }, async ({ collection, document_id, fields }) => {
+        const result = await client.rectifyData({ collection, document_id, fields: fields });
+        return { content: [{ type: 'text', text: `## \u2705 Data Rectified\n\n**Message:** ${result.message}\n**Updated Fields:** ${result.updated_fields.join(', ')}` }] };
+    });
+    server.tool('get_audit_logs', 'Get audit trail of data operations.', {
+        action: zod_1.z.enum(['data_access', 'data_export', 'data_deletion', 'data_rectification', 'consent_granted', 'consent_withdrawn', 'breach_notification']).optional().describe('Filter by action type'),
+        limit: zod_1.z.number().optional().describe('Maximum number of results'),
+    }, async ({ action, limit }) => {
+        const result = await client.getAuditLogs({ action: action, limit });
+        if (result.audit_logs.length === 0) {
+            return { content: [{ type: 'text', text: 'No audit logs found.' }] };
+        }
+        const logLines = result.audit_logs.map(l => `- \`${l.created_at}\` **${l.action}** _(${l.id})_`).join('\n');
+        return { content: [{ type: 'text', text: `## \u{1F4CB} Audit Logs\n\n${logLines}` }] };
+    });
+    // =========================================================================
+    // Breach Management
+    // =========================================================================
+    server.tool('log_breach', 'Log a new data breach (GDPR Article 33/34).', {
+        title: zod_1.z.string().describe('Brief title of the breach'),
+        description: zod_1.z.string().describe('Detailed description'),
+        severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']).describe('Breach severity'),
+        affected_user_ids: zod_1.z.array(zod_1.z.string()).describe('List of affected user IDs'),
+        data_categories: zod_1.z.array(zod_1.z.string()).describe('Categories of data affected'),
+        reported_by: zod_1.z.string().describe('Who reported the breach'),
+    }, async ({ title, description, severity, affected_user_ids, data_categories, reported_by }) => {
+        const result = await client.logBreach({
+            title,
+            description,
+            severity: severity,
+            affected_user_ids,
+            data_categories,
+            reported_by,
+        });
+        const b = result.breach;
+        return { content: [{ type: 'text', text: `## \u26A0\uFE0F Breach Logged\n\n**ID:** ${b.id}\n**Title:** ${b.title}\n**Severity:** ${formatters_js_1.severityEmoji[b.severity] || '\u26AA'} ${b.severity}\n**Status:** ${b.status}\n**Notification Deadline:** ${b.notification_deadline}\n**Affected Users:** ${b.affected_user_ids.length}\n**Data Categories:** ${b.data_categories.join(', ')}` }] };
+    });
+    const breachStatusEnum = zod_1.z.enum(['detected', 'investigating', 'contained', 'reported', 'resolved']);
+    server.tool('list_breaches', 'List all data breaches.', {
+        status: breachStatusEnum.optional().describe('Filter by status'),
+        limit: zod_1.z.number().optional().describe('Maximum number of results'),
+    }, async ({ status, limit }) => {
+        const result = await client.listBreaches({ status: status, limit });
+        if (result.breaches.length === 0) {
+            return { content: [{ type: 'text', text: 'No breaches found.' }] };
+        }
+        const breachLines = result.breaches.map(b => `- ${formatters_js_1.severityEmoji[b.severity] || '\u26AA'} **${b.title}** \u2014 ${b.status} _(${b.id})_`).join('\n');
+        return { content: [{ type: 'text', text: `## Data Breaches\n\n${breachLines}` }] };
+    });
+    server.tool('get_breach', 'Get details of a specific data breach.', { id: zod_1.z.string().describe('Breach ID') }, async ({ id }) => {
+        const result = await client.getBreach(id);
+        const b = result.breach;
+        return { content: [{ type: 'text', text: `## Breach Details\n\n**ID:** ${b.id}\n**Title:** ${b.title}\n**Severity:** ${formatters_js_1.severityEmoji[b.severity] || '\u26AA'} ${b.severity}\n**Status:** ${b.status}\n**Notification:** ${b.notification_status}\n**Reported By:** ${b.reported_by}\n**Deadline:** ${b.notification_deadline}\n**Created:** ${b.created_at}\n**Updated:** ${b.updated_at}\n\n### Description\n${b.description}\n\n**Affected Users:** ${b.affected_user_ids.join(', ')}\n**Data Categories:** ${b.data_categories.join(', ')}` }] };
+    });
+    server.tool('update_breach_status', 'Update a breach status and notification progress.', {
+        id: zod_1.z.string().describe('Breach ID'),
+        status: breachStatusEnum.describe('New breach status'),
+        notification_status: zod_1.z.enum(['pending', 'users_notified', 'dpa_notified', 'completed']).optional().describe('Notification progress'),
+        notes: zod_1.z.string().optional().describe('Additional notes'),
+    }, async ({ id, status, notification_status, notes }) => {
+        const result = await client.updateBreachStatus(id, {
+            status: status,
+            notification_status: notification_status,
+            notes,
+        });
+        const b = result.breach;
+        return { content: [{ type: 'text', text: `## \u2705 Breach Updated\n\n**ID:** ${b.id}\n**Status:** ${b.status}\n**Notification:** ${b.notification_status}` }] };
+    });
+}

package/dist/src/tools/analysis.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Tuteliq } from '@tuteliq/sdk';
+export declare function registerAnalysisTools(server: McpServer, client: Tuteliq): void;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/src/tools/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../../src/tools/analysis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AAc1D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CA0M9E"}

package/dist/src/tools/analysis.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAnalysisTools = registerAnalysisTools;
+const zod_1 = require("zod");
+const server_1 = require("@modelcontextprotocol/ext-apps/server");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const formatters_js_1 = require("../formatters.js");
+const EMOTIONS_WIDGET_URI = 'ui://tuteliq/emotions-result.html';
+const ACTION_PLAN_WIDGET_URI = 'ui://tuteliq/action-plan.html';
+const REPORT_WIDGET_URI = 'ui://tuteliq/report-result.html';
+const MULTI_WIDGET_URI = 'ui://tuteliq/multi-result.html';
+function loadWidget(name) {
+    return (0, fs_1.readFileSync)((0, path_1.resolve)(__dirname, '../../dist-ui', name), 'utf-8');
+}
+function registerAnalysisTools(server, client) {
+    const resources = [
+        { uri: EMOTIONS_WIDGET_URI, file: 'emotions-result.html' },
+        { uri: ACTION_PLAN_WIDGET_URI, file: 'action-plan.html' },
+        { uri: REPORT_WIDGET_URI, file: 'report-result.html' },
+        { uri: MULTI_WIDGET_URI, file: 'multi-result.html' },
+    ];
+    for (const r of resources) {
+        (0, server_1.registerAppResource)(server, r.uri, r.uri, { mimeType: server_1.RESOURCE_MIME_TYPE }, async () => ({
+            contents: [{
+                    uri: r.uri,
+                    mimeType: server_1.RESOURCE_MIME_TYPE,
+                    text: loadWidget(r.file),
+                }],
+        }));
+    }
+    // ── analyze_emotions ───────────────────────────────────────────────────────
+    (0, server_1.registerAppTool)(server, 'analyze_emotions', {
+        title: 'Analyze Emotions',
+        description: 'Analyze emotional content and mental state indicators. Identifies dominant emotions, trends, and provides follow-up recommendations.',
+        annotations: { readOnlyHint: true, openWorldHint: true, destructiveHint: false },
+        inputSchema: {
+            content: zod_1.z.string().describe('The text content to analyze for emotions'),
+        },
+        _meta: {
+            ui: { resourceUri: EMOTIONS_WIDGET_URI },
+            'openai/widgetDescription': 'Shows emotion analysis results with charts and trends',
+            'openai/toolInvocation/invoking': 'Analyzing emotional content...',
+            'openai/toolInvocation/invoked': 'Emotion analysis complete.',
+        },
+    }, async ({ content }) => {
+        const result = await client.analyzeEmotions({ content });
+        const emoji = formatters_js_1.trendEmoji[result.trend] || '\u27A1\uFE0F';
+        const emotionScoresList = Object.entries(result.emotion_scores)
+            .sort((a, b) => b[1] - a[1])
+            .map(([emotion, score]) => `- ${emotion}: ${(score * 100).toFixed(0)}%`)
+            .join('\n');
+        const text = `## Emotion Analysis
+
+**Dominant Emotions:** ${result.dominant_emotions.join(', ')}
+**Trend:** ${emoji} ${result.trend.charAt(0).toUpperCase() + result.trend.slice(1)}
+
+### Emotion Scores
+${emotionScoresList}
+
+### Summary
+${result.summary}
+
+### Recommended Follow-up
+${result.recommended_followup}`;
+        return {
+            structuredContent: { toolName: 'analyze_emotions', result, branding: { appName: 'Tuteliq' } },
+            content: [{ type: 'text', text }],
+        };
+    });
+    // ── get_action_plan ────────────────────────────────────────────────────────
+    (0, server_1.registerAppTool)(server, 'get_action_plan', {
+        title: 'Get Action Plan',
+        description: 'Generate age-appropriate guidance and action steps for handling a safety situation.',
+        annotations: { readOnlyHint: true, openWorldHint: true, destructiveHint: false },
+        inputSchema: {
+            situation: zod_1.z.string().describe('Description of the situation needing guidance'),
+            childAge: zod_1.z.number().optional().describe('Age of the child involved'),
+            audience: zod_1.z.enum(['child', 'parent', 'educator', 'platform']).optional().describe('Who the guidance is for (default: parent)'),
+            severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Severity of the situation'),
+        },
+        _meta: {
+            ui: { resourceUri: ACTION_PLAN_WIDGET_URI },
+            'openai/widgetDescription': 'Shows age-appropriate action plan with step-by-step guidance',
+            'openai/toolInvocation/invoking': 'Generating action plan...',
+            'openai/toolInvocation/invoked': 'Action plan ready.',
+        },
+    }, async ({ situation, childAge, audience, severity }) => {
+        const result = await client.getActionPlan({ situation, childAge, audience, severity });
+        const text = `## Action Plan
+
+**Audience:** ${result.audience}
+**Tone:** ${result.tone}
+${result.reading_level ? `**Reading Level:** ${result.reading_level}` : ''}
+
+### Steps
+${result.steps.map((step, i) => `${i + 1}. ${step}`).join('\n')}`;
+        return {
+            structuredContent: { toolName: 'get_action_plan', result, branding: { appName: 'Tuteliq' } },
+            content: [{ type: 'text', text }],
+        };
+    });
+    // ── generate_report ────────────────────────────────────────────────────────
+    (0, server_1.registerAppTool)(server, 'generate_report', {
+        title: 'Generate Report',
+        description: 'Generate a comprehensive incident report from a conversation.',
+        annotations: { readOnlyHint: true, openWorldHint: true, destructiveHint: false },
+        inputSchema: {
+            messages: zod_1.z.array(zod_1.z.object({
+                sender: zod_1.z.string().describe('Name/ID of sender'),
+                content: zod_1.z.string().describe('Message content'),
+            })).describe('Array of messages in the incident'),
+            childAge: zod_1.z.number().optional().describe('Age of the child involved'),
+            incidentType: zod_1.z.string().optional().describe('Type of incident (e.g., bullying, grooming)'),
+        },
+        _meta: {
+            ui: { resourceUri: REPORT_WIDGET_URI },
+            'openai/widgetDescription': 'Shows comprehensive incident report with risk assessment',
+            'openai/toolInvocation/invoking': 'Generating incident report...',
+            'openai/toolInvocation/invoked': 'Incident report ready.',
+        },
+    }, async ({ messages, childAge, incidentType }) => {
+        const result = await client.generateReport({
+            messages,
+            childAge,
+            incident: incidentType ? { type: incidentType } : undefined,
+        });
+        const emoji = formatters_js_1.riskEmoji[result.risk_level] || '\u26AA';
+        const text = `## \u{1F4CB} Incident Report
+
+**Risk Level:** ${emoji} ${result.risk_level.charAt(0).toUpperCase() + result.risk_level.slice(1)}
+
+### Summary
+${result.summary}
+
+### Categories
+${result.categories.map(c => `- ${c}`).join('\n')}
+
+### Recommended Next Steps
+${result.recommended_next_steps.map((step, i) => `${i + 1}. ${step}`).join('\n')}`;
+        return {
+            structuredContent: { toolName: 'generate_report', result, branding: { appName: 'Tuteliq' } },
+            content: [{ type: 'text', text }],
+        };
+    });
+    // ── analyse_multi ──────────────────────────────────────────────────────────
+    (0, server_1.registerAppTool)(server, 'analyse_multi', {
+        title: 'Multi-Endpoint Analysis',
+        description: 'Run multiple detection endpoints on a single piece of text.',
+        annotations: { readOnlyHint: true, openWorldHint: true, destructiveHint: false },
+        inputSchema: {
+            content: zod_1.z.string().describe('Text content to analyze'),
+            endpoints: zod_1.z.array(zod_1.z.string()).describe('Detection endpoints to run'),
+            context: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional().describe('Optional analysis context'),
+            include_evidence: zod_1.z.boolean().optional().describe('Include supporting evidence'),
+            external_id: zod_1.z.string().optional().describe('External tracking ID'),
+            customer_id: zod_1.z.string().optional().describe('Customer identifier'),
+        },
+        _meta: {
+            ui: { resourceUri: MULTI_WIDGET_URI },
+            'openai/widgetDescription': 'Shows multi-endpoint analysis with aggregated risk assessment',
+            'openai/toolInvocation/invoking': 'Running multi-endpoint analysis...',
+            'openai/toolInvocation/invoked': 'Multi-endpoint analysis complete.',
+        },
+    }, async ({ content, endpoints, context, include_evidence, external_id, customer_id }) => {
+        const result = await client.analyseMulti({
+            content,
+            detections: endpoints,
+            context: context,
+            includeEvidence: include_evidence,
+            external_id,
+            customer_id,
+        });
+        return {
+            structuredContent: { toolName: 'analyse_multi', result, branding: { appName: 'Tuteliq' } },
+            content: [{ type: 'text', text: (0, formatters_js_1.formatMultiResult)(result) }],
+        };
+    });
+}

package/dist/src/tools/detection.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Tuteliq } from '@tuteliq/sdk';
+export declare function registerDetectionTools(server: McpServer, client: Tuteliq): void;
+//# sourceMappingURL=detection.d.ts.map

package/dist/src/tools/detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../../src/tools/detection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAyB5C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAuL/E"}

package/dist/src/tools/detection.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDetectionTools = registerDetectionTools;
+const zod_1 = require("zod");
+const server_1 = require("@modelcontextprotocol/ext-apps/server");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const formatters_js_1 = require("../formatters.js");
+const DETECTION_WIDGET_URI = 'ui://tuteliq/detection-result.html';
+function loadWidget(name) {
+    return (0, fs_1.readFileSync)((0, path_1.resolve)(__dirname, '../../dist-ui', name), 'utf-8');
+}
+const contextSchema = zod_1.z.object({
+    language: zod_1.z.string().optional(),
+    ageGroup: zod_1.z.string().optional(),
+    relationship: zod_1.z.string().optional(),
+    platform: zod_1.z.string().optional(),
+}).optional();
+const uiMeta = (desc, invoking, invoked) => ({
+    ui: { resourceUri: DETECTION_WIDGET_URI },
+    'openai/widgetDescription': desc,
+    'openai/toolInvocation/invoking': invoking,
+    'openai/toolInvocation/invoked': invoked,
+});
+function registerDetectionTools(server, client) {
+    // Cast needed due to CJS/ESM dual-module type mismatch between MCP SDK and ext-apps
+    (0, server_1.registerAppResource)(server, DETECTION_WIDGET_URI, DETECTION_WIDGET_URI, { mimeType: server_1.RESOURCE_MIME_TYPE }, async () => ({
+        contents: [{
+                uri: DETECTION_WIDGET_URI,
+                mimeType: server_1.RESOURCE_MIME_TYPE,
+                text: loadWidget('detection-result.html'),
+            }],
+    }));
+    // ── detect_bullying ────────────────────────────────────────────────────────
+    (0, server_1.registerAppTool)(server, 'detect_bullying', {
+        title: 'Detect Bullying',
+        description: 'Analyze text content to detect bullying, harassment, or harmful language.',
+        annotations: { readOnlyHint: true, openWorldHint: true, destructiveHint: false },
+        inputSchema: {
+            content: zod_1.z.string().describe('The text content to analyze for bullying'),
+            context: contextSchema,
+        },
+        _meta: uiMeta('Shows bullying detection results with risk indicators', 'Analyzing content for bullying...', 'Bullying analysis complete.'),
+    }, async ({ content, context }) => {
+        const result = await client.detectBullying({
+            content,
+            context: context,
+        });
+        const emoji = formatters_js_1.severityEmoji[result.severity] || '\u26AA';
+        const text = `## ${result.is_bullying ? '\u26A0\uFE0F Bullying Detected' : '\u2705 No Bullying Detected'}
+
+**Severity:** ${emoji} ${result.severity.charAt(0).toUpperCase() + result.severity.slice(1)}
+**Confidence:** ${(result.confidence * 100).toFixed(0)}%
+**Risk Score:** ${(result.risk_score * 100).toFixed(0)}%
+
+${result.is_bullying ? `**Types:** ${result.bullying_type.join(', ')}` : ''}
+
+### Rationale
+${result.rationale}
+
+### Recommended Action
+\`${result.recommended_action}\``;
+        return {
+            structuredContent: { toolName: 'detect_bullying', result, branding: { appName: 'Tuteliq' } },
+            content: [{ type: 'text', text }],
+        };
+    });
+    // ── detect_grooming ────────────────────────────────────────────────────────
+    (0, server_1.registerAppTool)(server, 'detect_grooming', {
+        title: 'Detect Grooming',
+        description: 'Analyze a conversation for grooming patterns and predatory behavior.',
+        annotations: { readOnlyHint: true, openWorldHint: true, destructiveHint: false },
+        inputSchema: {
+            messages: zod_1.z.array(zod_1.z.object({
+                role: zod_1.z.enum(['adult', 'child', 'unknown']),
+                content: zod_1.z.string(),
+            })).describe('Array of messages in the conversation'),
+            childAge: zod_1.z.number().optional().describe('Age of the child in the conversation'),
+        },
+        _meta: uiMeta('Shows grooming detection results with risk indicators', 'Analyzing conversation for grooming patterns...', 'Grooming analysis complete.'),
+    }, async ({ messages, childAge }) => {
+        const result = await client.detectGrooming({
+            messages,
+            childAge,
+        });
+        const emoji = formatters_js_1.riskEmoji[result.grooming_risk] || '\u26AA';
+        const text = `## ${result.grooming_risk === 'none' ? '\u2705 No Grooming Detected' : '\u26A0\uFE0F Grooming Risk Detected'}
+
+**Risk Level:** ${emoji} ${result.grooming_risk.charAt(0).toUpperCase() + result.grooming_risk.slice(1)}
+**Confidence:** ${(result.confidence * 100).toFixed(0)}%
+**Risk Score:** ${(result.risk_score * 100).toFixed(0)}%
+
+${result.flags.length > 0 ? `**Warning Flags:**\n${result.flags.map(f => `- \u{1F6A9} ${f}`).join('\n')}` : ''}
+
+### Rationale
+${result.rationale}
+
+### Recommended Action
+\`${result.recommended_action}\``;
+        return {
+            structuredContent: { toolName: 'detect_grooming', result, branding: { appName: 'Tuteliq' } },
+            content: [{ type: 'text', text }],
+        };
+    });
+    // ── detect_unsafe ──────────────────────────────────────────────────────────
+    (0, server_1.registerAppTool)(server, 'detect_unsafe', {
+        title: 'Detect Unsafe Content',
+        description: 'Detect unsafe content including self-harm, violence, drugs, explicit material.',
+        annotations: { readOnlyHint: true, openWorldHint: true, destructiveHint: false },
+        inputSchema: {
+            content: zod_1.z.string().describe('The text content to analyze for unsafe content'),
+            context: contextSchema,
+        },
+        _meta: uiMeta('Shows unsafe content detection results', 'Analyzing content for safety concerns...', 'Safety analysis complete.'),
+    }, async ({ content, context }) => {
+        const result = await client.detectUnsafe({
+            content,
+            context: context,
+        });
+        const emoji = formatters_js_1.severityEmoji[result.severity] || '\u26AA';
+        const text = `## ${result.unsafe ? '\u26A0\uFE0F Unsafe Content Detected' : '\u2705 Content is Safe'}
+
+**Severity:** ${emoji} ${result.severity.charAt(0).toUpperCase() + result.severity.slice(1)}
+**Confidence:** ${(result.confidence * 100).toFixed(0)}%
+**Risk Score:** ${(result.risk_score * 100).toFixed(0)}%
+
+${result.unsafe ? `**Categories:**\n${result.categories.map(c => `- \u26A0\uFE0F ${c}`).join('\n')}` : ''}
+
+### Rationale
+${result.rationale}
+
+### Recommended Action
+\`${result.recommended_action}\``;
+        return {
+            structuredContent: { toolName: 'detect_unsafe', result, branding: { appName: 'Tuteliq' } },
+            content: [{ type: 'text', text }],
+        };
+    });
+    // ── analyze (quick combined) ───────────────────────────────────────────────
+    (0, server_1.registerAppTool)(server, 'analyze', {
+        title: 'Quick Safety Analysis',
+        description: 'Quick comprehensive safety analysis that checks for both bullying and unsafe content.',
+        annotations: { readOnlyHint: true, openWorldHint: true, destructiveHint: false },
+        inputSchema: {
+            content: zod_1.z.string().describe('The text content to analyze'),
+            include: zod_1.z.array(zod_1.z.enum(['bullying', 'unsafe'])).optional().describe('Which checks to run (default: both)'),
+        },
+        _meta: uiMeta('Shows combined safety analysis results', 'Running safety analysis...', 'Safety analysis complete.'),
+    }, async ({ content, include }) => {
+        const result = await client.analyze({ content, include });
+        const emoji = formatters_js_1.riskEmoji[result.risk_level] || '\u26AA';
+        const text = `## Safety Analysis Results
+
+**Overall Risk:** ${emoji} ${result.risk_level.charAt(0).toUpperCase() + result.risk_level.slice(1)}
+**Risk Score:** ${(result.risk_score * 100).toFixed(0)}%
+
+### Summary
+${result.summary}
+
+### Recommended Action
+\`${result.recommended_action}\`
+
+---
+${result.bullying ? `\n**Bullying Check:** ${result.bullying.is_bullying ? '\u26A0\uFE0F Detected' : '\u2705 Clear'}\n` : ''}${result.unsafe ? `\n**Unsafe Content:** ${result.unsafe.unsafe ? '\u26A0\uFE0F Detected' : '\u2705 Clear'}\n` : ''}`;
+        return {
+            structuredContent: { toolName: 'analyze', result, branding: { appName: 'Tuteliq' } },
+            content: [{ type: 'text', text }],
+        };
+    });
+}

package/dist/src/tools/fraud.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Tuteliq } from '@tuteliq/sdk';
+export declare function registerFraudTools(server: McpServer, client: Tuteliq): void;
+//# sourceMappingURL=fraud.d.ts.map

package/dist/src/tools/fraud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fraud.d.ts","sourceRoot":"","sources":["../../../src/tools/fraud.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AAyF1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAkC3E"}