dalvon-mcp 3.0.0

package/dist/tools/organizations.js

@@ -0,0 +1,234 @@
+/**
+ * Organization Management Tools for dalvon-mcp
+ * Phase 4: 6 Tools for organization management (Admin)
+ */
+import { z } from 'zod';
+import { formatApiError, createError, createSuccess, isApiError } from '../utils/errors.js';
+import { validateUUID } from '../utils/validation.js';
+// ==================== SCHEMAS ====================
+const ListOrganizationsSchema = z.object({
+    status: z.enum(['active', 'inactive', 'suspended']).optional(),
+    whitelabel_id: z.string().uuid().optional(),
+    limit: z.number().min(1).max(100).optional().default(30),
+    offset: z.number().min(0).optional().default(0),
+});
+const CreateOrganizationSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().optional(),
+    whitelabel_id: z.string().uuid().optional(),
+    settings: z.record(z.unknown()).optional(),
+});
+const VoiceBackendConfigSchema = z.object({
+    type: z.enum(['pipecat', 'elevenlabs_convai', 'PC', 'EL']).optional(),
+    pipecat_url: z.string().nullable().optional(),
+    stt_provider: z.enum(['deepgram', 'elevenlabs', 'DG', 'EL']).nullable().optional(),
+    allow_voice2voice: z.boolean().optional(),
+}).optional();
+const UpdateOrganizationSchema = z.object({
+    organization_id: z.string().uuid(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    status: z.enum(['active', 'inactive', 'suspended']).optional(),
+    voice_backend_config: VoiceBackendConfigSchema,
+    business_hours: z.record(z.unknown()).optional(),
+});
+// ==================== TOOLS ====================
+export function createOrganizationTools(client) {
+    return [
+        // Tool 1: list_organizations
+        {
+            name: 'list_organizations',
+            description: `List all organizations.
+
+**Admin Only:** Requires admin permissions.
+
+Filter by status or whitelabel.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    status: { type: 'string', enum: ['active', 'inactive', 'suspended'], description: 'Filter by status' },
+                    whitelabel_id: { type: 'string', description: 'Filter by whitelabel UUID' },
+                    limit: { type: 'number', description: 'Number of results (default: 30)' },
+                    offset: { type: 'number', description: 'Offset for pagination' },
+                },
+            },
+            handler: async (args) => {
+                const parsed = ListOrganizationsSchema.safeParse(args);
+                if (!parsed.success) {
+                    return createError(`Invalid arguments: ${parsed.error.message}`);
+                }
+                const result = await client.listOrganizations(parsed.data);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'list_organizations', 'Requires admin permissions');
+                }
+                const organizations = result.data || [];
+                return createSuccess({ count: organizations.length, organizations });
+            },
+        },
+        // Tool 2: get_organization
+        {
+            name: 'get_organization',
+            description: `Get details of a specific organization.
+
+**Admin Only:** Requires admin permissions.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    organization_id: { type: 'string', description: 'Organization UUID' },
+                },
+                required: ['organization_id'],
+            },
+            handler: async (args) => {
+                const { organization_id } = args;
+                const validationError = validateUUID(organization_id, 'organization_id');
+                if (validationError)
+                    return validationError;
+                const result = await client.getOrganization(organization_id);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'get_organization', 'Requires admin permissions');
+                }
+                return result;
+            },
+        },
+        // Tool 3: create_organization
+        {
+            name: 'create_organization',
+            description: `Create a new organization.
+
+**Admin Only:** Requires admin permissions.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Organization name' },
+                    description: { type: 'string', description: 'Organization description' },
+                    whitelabel_id: { type: 'string', description: 'Parent whitelabel UUID' },
+                    settings: { type: 'object', description: 'Organization settings' },
+                },
+                required: ['name'],
+            },
+            handler: async (args) => {
+                const parsed = CreateOrganizationSchema.safeParse(args);
+                if (!parsed.success) {
+                    return createError(`Invalid arguments: ${parsed.error.message}`);
+                }
+                const result = await client.createOrganization(parsed.data);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'create_organization', 'Requires admin permissions');
+                }
+                const org = result.data;
+                return createSuccess({
+                    message: 'Organization created',
+                    organization_id: org.id,
+                    name: org.name,
+                });
+            },
+        },
+        // Tool 4: update_organization
+        {
+            name: 'update_organization',
+            description: `Update an organization.
+
+**Admin Only:** Requires admin permissions.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    organization_id: { type: 'string', description: 'Organization UUID' },
+                    name: { type: 'string', description: 'Updated name' },
+                    description: { type: 'string', description: 'Updated description' },
+                    status: { type: 'string', enum: ['active', 'inactive', 'suspended'], description: 'Status' },
+                    voice_backend_config: {
+                        type: 'object',
+                        description: 'Voice backend config: {type, pipecat_url, stt_provider, allow_voice2voice}',
+                        properties: {
+                            type: { type: 'string', enum: ['pipecat', 'elevenlabs_convai', 'PC', 'EL'], description: 'Voice backend type' },
+                            pipecat_url: { type: 'string', description: 'Pipecat WebSocket URL (null for default)' },
+                            stt_provider: { type: 'string', enum: ['deepgram', 'elevenlabs', 'DG', 'EL'], description: 'STT provider' },
+                            allow_voice2voice: { type: 'boolean', description: 'Allow Voice2Voice (Deepslate) mode for agents' },
+                        },
+                    },
+                    business_hours: { type: 'object', description: 'Business hours config' },
+                },
+                required: ['organization_id'],
+            },
+            handler: async (args) => {
+                const parsed = UpdateOrganizationSchema.safeParse(args);
+                if (!parsed.success) {
+                    return createError(`Invalid arguments: ${parsed.error.message}`);
+                }
+                const { organization_id, ...orgData } = parsed.data;
+                const validationError = validateUUID(organization_id, 'organization_id');
+                if (validationError)
+                    return validationError;
+                if (Object.keys(orgData).length === 0) {
+                    return createError('No fields to update');
+                }
+                const result = await client.updateOrganization(organization_id, orgData);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'update_organization', 'Requires admin permissions');
+                }
+                return createSuccess({
+                    message: 'Organization updated',
+                    organization_id,
+                    updated_fields: Object.keys(orgData),
+                });
+            },
+        },
+        // Tool 5: delete_organization
+        {
+            name: 'delete_organization',
+            description: `Delete an organization.
+
+**Admin Only:** Requires admin permissions.
+**Warning:** This deletes all organization data!`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    organization_id: { type: 'string', description: 'Organization UUID' },
+                },
+                required: ['organization_id'],
+            },
+            handler: async (args) => {
+                const { organization_id } = args;
+                const validationError = validateUUID(organization_id, 'organization_id');
+                if (validationError)
+                    return validationError;
+                const result = await client.deleteOrganization(organization_id);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'delete_organization', 'Requires admin permissions');
+                }
+                return createSuccess({
+                    message: 'Organization deleted',
+                    organization_id,
+                    deleted: true,
+                    warning: 'All organization data has been removed',
+                });
+            },
+        },
+        // Tool 6: get_organization_settings
+        {
+            name: 'get_organization_settings',
+            description: `Get settings for an organization.
+
+**Admin Only:** Requires admin permissions.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    organization_id: { type: 'string', description: 'Organization UUID' },
+                },
+                required: ['organization_id'],
+            },
+            handler: async (args) => {
+                const { organization_id } = args;
+                const validationError = validateUUID(organization_id, 'organization_id');
+                if (validationError)
+                    return validationError;
+                const result = await client.getOrganizationSettings(organization_id);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'get_organization_settings', 'Requires admin permissions');
+                }
+                return result;
+            },
+        },
+    ];
+}
+//# sourceMappingURL=organizations.js.map

package/dist/tools/organizations.js.map

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

package/dist/tools/postprocessing.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Postprocessing Tools for dalvon-mcp
+ * Phase 3: 7 Tools for managing call postprocessing results
+ */
+import type { DalvonClient } from '../clients/dalvon.js';
+import type { McpTool } from '../types/index.js';
+export declare function createPostprocessingTools(client: DalvonClient): McpTool[];
+//# sourceMappingURL=postprocessing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postprocessing.d.ts","sourceRoot":"","sources":["../../src/tools/postprocessing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,mBAAmB,CAAC;AA+C/D,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,EAAE,CA4WzE"}

package/dist/tools/postprocessing.js

@@ -0,0 +1,383 @@
+/**
+ * Postprocessing Tools for dalvon-mcp
+ * Phase 3: 7 Tools for managing call postprocessing results
+ */
+import { z } from 'zod';
+import { formatApiError, createError, createSuccess, isApiError } from '../utils/errors.js';
+import { validateUUID } from '../utils/validation.js';
+// ==================== SCHEMAS ====================
+const ListPostprocessingSchema = z.object({
+    target_user_id: z.string().uuid().optional().describe('Impersonate user to see their postprocessing (requires admin/platform permissions)'),
+    scope: z.enum(['user', 'organization', 'whitelabel', 'platform']).optional().describe('Expand view scope (admin only)'),
+    visibility: z.array(z.enum(['user', 'organization', 'whitelabel', 'platform'])).optional().describe('Filter by visibility levels'),
+    name: z.string().optional().describe('Filter by name'),
+    type: z.array(z.string()).optional().describe('Filter by type'),
+    limit: z.number().min(1).max(100).optional().default(30).describe('Number of results'),
+    skip: z.number().min(0).optional().default(0).describe('Offset for pagination'),
+});
+const TriggerPostprocessingSchema = z.object({
+    call_id: z.string().uuid().describe('Call ID to process'),
+    force: z.boolean().optional().default(false).describe('Force reprocessing even if already done'),
+    processors: z.array(z.string()).optional().describe('Specific processors to run (e.g., ["transcription", "summary", "sentiment"])'),
+});
+const UpdatePostprocessingSchema = z.object({
+    result_id: z.string().uuid().describe('Postprocessing result ID'),
+    summary: z.string().optional().describe('Updated summary'),
+    categories: z.array(z.string()).optional().describe('Updated categories'),
+    tags: z.array(z.string()).optional().describe('Updated tags'),
+    custom_data: z.record(z.unknown()).optional().describe('Custom data to add'),
+});
+const UpdateCallFromPostprocessingSchema = z.object({
+    call_id: z.string().uuid().describe('Call ID to update'),
+    apply_summary: z.boolean().optional().default(true).describe('Apply generated summary to call'),
+    apply_categories: z.boolean().optional().default(true).describe('Apply detected categories'),
+    apply_sentiment: z.boolean().optional().default(true).describe('Apply sentiment analysis'),
+    apply_action_items: z.boolean().optional().default(true).describe('Apply extracted action items'),
+});
+const TransferPostprocessingSchema = z.object({
+    source_call_id: z.string().uuid().describe('Source call ID'),
+    target_call_id: z.string().uuid().describe('Target call ID'),
+    data_types: z.array(z.enum(['transcription', 'summary', 'categories', 'sentiment', 'action_items'])).optional()
+        .describe('Which data types to transfer (default: all)'),
+});
+// ==================== TOOLS ====================
+export function createPostprocessingTools(client) {
+    return [
+        // Tool 1: list_postprocessing_results
+        {
+            name: 'list_postprocessing_results',
+            description: `List postprocessing results for calls with optional filtering.
+
+Postprocessing includes:
+- **Transcription**: Full call transcript
+- **Summary**: AI-generated call summary
+- **Sentiment**: Sentiment analysis of the conversation
+- **Categories**: Auto-detected call categories
+- **Action Items**: Extracted follow-up actions
+
+Filter by call, agent, status, or date range.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    target_user_id: { type: 'string', description: 'Impersonate user to see their postprocessing (requires admin/platform permissions)' },
+                    scope: { type: 'string', enum: ['user', 'organization', 'whitelabel', 'platform'], description: 'Expand view scope (admin only)' },
+                    visibility: { type: 'array', items: { type: 'string', enum: ['user', 'organization', 'whitelabel', 'platform'] }, description: 'Filter by visibility levels' },
+                    call_id: { type: 'string', description: 'Filter by specific call ID' },
+                    agent_id: { type: 'string', description: 'Filter by agent ID' },
+                    status: {
+                        type: 'string',
+                        enum: ['pending', 'processing', 'completed', 'failed'],
+                        description: 'Filter by processing status',
+                    },
+                    from_date: { type: 'string', description: 'From date (ISO 8601)' },
+                    to_date: { type: 'string', description: 'To date (ISO 8601)' },
+                    limit: { type: 'number', description: 'Number of results (default: 30)' },
+                    offset: { type: 'number', description: 'Offset for pagination' },
+                },
+            },
+            handler: async (args) => {
+                const parsed = ListPostprocessingSchema.safeParse(args);
+                if (!parsed.success) {
+                    return createError(`Invalid arguments: ${parsed.error.message}`);
+                }
+                const result = await client.listPostprocessingResults(parsed.data);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'list_postprocessing_results');
+                }
+                const results = result.data || [];
+                return createSuccess({
+                    count: results.length,
+                    results,
+                });
+            },
+        },
+        // Tool 2: get_postprocessing_result
+        {
+            name: 'get_postprocessing_result',
+            description: `Get detailed postprocessing result for a specific call or result ID.
+
+Returns:
+- Full transcription
+- Generated summary
+- Sentiment scores
+- Detected categories and topics
+- Extracted action items
+- Processing metadata`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    result_id: { type: 'string', description: 'Postprocessing result ID (UUID)' },
+                    target_user_id: { type: 'string', description: 'Impersonate user (requires admin/platform permissions)' },
+                },
+                required: ['result_id'],
+            },
+            handler: async (args) => {
+                const { result_id, target_user_id } = args;
+                const validationError = validateUUID(result_id, 'result_id');
+                if (validationError)
+                    return validationError;
+                const result = await client.getPostprocessingResult(result_id, target_user_id);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'get_postprocessing_result', 'Check if the result_id is correct using list_postprocessing_results');
+                }
+                return result;
+            },
+        },
+        // Tool 3: trigger_postprocessing
+        {
+            name: 'trigger_postprocessing',
+            description: `Manually trigger postprocessing for a call.
+
+Use this when:
+- Automatic postprocessing failed
+- You want to reprocess with updated settings
+- You want to run specific processors only
+
+**Available Processors:**
+- transcription: Generate call transcript
+- summary: Create AI summary
+- sentiment: Analyze sentiment
+- categories: Detect categories
+- action_items: Extract action items`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    call_id: { type: 'string', description: 'Call ID to process' },
+                    force: { type: 'boolean', description: 'Force reprocessing even if already done' },
+                    processors: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Specific processors to run (default: all)',
+                    },
+                },
+                required: ['call_id'],
+            },
+            handler: async (args) => {
+                const parsed = TriggerPostprocessingSchema.safeParse(args);
+                if (!parsed.success) {
+                    return createError(`Invalid arguments: ${parsed.error.message}`);
+                }
+                const validationError = validateUUID(parsed.data.call_id, 'call_id');
+                if (validationError)
+                    return validationError;
+                const result = await client.triggerPostprocessing(parsed.data.call_id, {
+                    force: parsed.data.force,
+                    processors: parsed.data.processors,
+                });
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'trigger_postprocessing');
+                }
+                const data = result.data;
+                return createSuccess({
+                    message: 'Postprocessing triggered successfully',
+                    call_id: parsed.data.call_id,
+                    job_id: data.job_id || data.id,
+                    status: data.status || 'pending',
+                    processors: parsed.data.processors || 'all',
+                });
+            },
+        },
+        // Tool 4: update_postprocessing_result
+        {
+            name: 'update_postprocessing_result',
+            description: `Update a postprocessing result with corrections or additional data.
+
+Use this to:
+- Correct auto-generated summaries
+- Add or modify categories
+- Add custom tags
+- Attach additional metadata`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    result_id: { type: 'string', description: 'Postprocessing result ID' },
+                    summary: { type: 'string', description: 'Corrected or updated summary' },
+                    categories: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Updated categories',
+                    },
+                    tags: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Tags to add',
+                    },
+                    custom_data: {
+                        type: 'object',
+                        description: 'Custom metadata to attach',
+                    },
+                },
+                required: ['result_id'],
+            },
+            handler: async (args) => {
+                const parsed = UpdatePostprocessingSchema.safeParse(args);
+                if (!parsed.success) {
+                    return createError(`Invalid arguments: ${parsed.error.message}`);
+                }
+                const { result_id, ...updateData } = parsed.data;
+                const validationError = validateUUID(result_id, 'result_id');
+                if (validationError)
+                    return validationError;
+                if (Object.keys(updateData).length === 0) {
+                    return createError('No update data provided', 'Provide at least one field to update');
+                }
+                const result = await client.updatePostprocessingResult(result_id, updateData);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'update_postprocessing_result');
+                }
+                return createSuccess({
+                    message: 'Postprocessing result updated successfully',
+                    result_id,
+                    updated_fields: Object.keys(updateData),
+                });
+            },
+        },
+        // Tool 5: delete_postprocessing_result
+        {
+            name: 'delete_postprocessing_result',
+            description: `Delete a postprocessing result.
+
+**Warning:** This permanently removes the postprocessing data including:
+- Transcription
+- Summary
+- Sentiment analysis
+- Categories and tags
+
+The original call recording is NOT affected.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    result_id: { type: 'string', description: 'Postprocessing result ID to delete' },
+                },
+                required: ['result_id'],
+            },
+            handler: async (args) => {
+                const { result_id } = args;
+                const validationError = validateUUID(result_id, 'result_id');
+                if (validationError)
+                    return validationError;
+                const result = await client.deletePostprocessingResult(result_id);
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'delete_postprocessing_result');
+                }
+                return createSuccess({
+                    message: 'Postprocessing result deleted successfully',
+                    result_id,
+                    deleted: true,
+                });
+            },
+        },
+        // Tool 6: update_call_from_postprocessing
+        {
+            name: 'update_call_from_postprocessing',
+            description: `Apply postprocessing results to the original call record.
+
+This syncs processed data back to the call, including:
+- AI-generated summary → Call summary field
+- Detected categories → Call categories
+- Sentiment scores → Call metadata
+- Action items → Call follow-up tasks
+
+Useful when postprocessing was done separately and needs to be merged.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    call_id: { type: 'string', description: 'Call ID to update' },
+                    apply_summary: { type: 'boolean', description: 'Apply generated summary (default: true)' },
+                    apply_categories: { type: 'boolean', description: 'Apply detected categories (default: true)' },
+                    apply_sentiment: { type: 'boolean', description: 'Apply sentiment analysis (default: true)' },
+                    apply_action_items: { type: 'boolean', description: 'Apply action items (default: true)' },
+                },
+                required: ['call_id'],
+            },
+            handler: async (args) => {
+                const parsed = UpdateCallFromPostprocessingSchema.safeParse(args);
+                if (!parsed.success) {
+                    return createError(`Invalid arguments: ${parsed.error.message}`);
+                }
+                const validationError = validateUUID(parsed.data.call_id, 'call_id');
+                if (validationError)
+                    return validationError;
+                const result = await client.updateCallFromPostprocessing(parsed.data.call_id, {
+                    apply_summary: parsed.data.apply_summary,
+                    apply_categories: parsed.data.apply_categories,
+                    apply_sentiment: parsed.data.apply_sentiment,
+                    apply_action_items: parsed.data.apply_action_items,
+                });
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'update_call_from_postprocessing');
+                }
+                const data = result.data;
+                return createSuccess({
+                    message: 'Call updated from postprocessing successfully',
+                    call_id: parsed.data.call_id,
+                    applied: {
+                        summary: parsed.data.apply_summary,
+                        categories: parsed.data.apply_categories,
+                        sentiment: parsed.data.apply_sentiment,
+                        action_items: parsed.data.apply_action_items,
+                    },
+                    result: data,
+                });
+            },
+        },
+        // Tool 7: transfer_postprocessing_data
+        {
+            name: 'transfer_postprocessing_data',
+            description: `Transfer postprocessing data from one call to another.
+
+Useful when:
+- A call was split and data needs to be merged
+- Testing with sample data
+- Migrating data between environments
+
+You can choose which data types to transfer.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    source_call_id: { type: 'string', description: 'Source call ID to copy from' },
+                    target_call_id: { type: 'string', description: 'Target call ID to copy to' },
+                    data_types: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['transcription', 'summary', 'categories', 'sentiment', 'action_items'],
+                        },
+                        description: 'Which data types to transfer (default: all)',
+                    },
+                },
+                required: ['source_call_id', 'target_call_id'],
+            },
+            handler: async (args) => {
+                const parsed = TransferPostprocessingSchema.safeParse(args);
+                if (!parsed.success) {
+                    return createError(`Invalid arguments: ${parsed.error.message}`);
+                }
+                const sourceValidation = validateUUID(parsed.data.source_call_id, 'source_call_id');
+                if (sourceValidation)
+                    return sourceValidation;
+                const targetValidation = validateUUID(parsed.data.target_call_id, 'target_call_id');
+                if (targetValidation)
+                    return targetValidation;
+                if (parsed.data.source_call_id === parsed.data.target_call_id) {
+                    return createError('Source and target call IDs must be different');
+                }
+                const result = await client.transferPostprocessingData({
+                    source_call_id: parsed.data.source_call_id,
+                    target_call_id: parsed.data.target_call_id,
+                    data_types: parsed.data.data_types,
+                });
+                if (!result.success || isApiError(result)) {
+                    return formatApiError(result, 'transfer_postprocessing_data');
+                }
+                return createSuccess({
+                    message: 'Postprocessing data transferred successfully',
+                    source_call_id: parsed.data.source_call_id,
+                    target_call_id: parsed.data.target_call_id,
+                    transferred: parsed.data.data_types || 'all',
+                });
+            },
+        },
+    ];
+}
+//# sourceMappingURL=postprocessing.js.map