@hed-hog/core 0.0.350 → 0.0.353

package/src/mcp/tools/core-files.mcp-tools.ts

@@ -0,0 +1,105 @@
+import { Injectable } from '@nestjs/common';
+import { FileService } from '../../file/file.service';
+import { McpTool } from '../decorators/mcp-tool.decorator';
+import { McpContext } from '../types/mcp-context.type';
+
+@Injectable()
+export class CoreFilesMcpTools {
+  constructor(private readonly fileService: FileService) {}
+
+  @McpTool({
+    name: 'core.files.list',
+    description: 'Lists uploaded files with optional pagination. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term' },
+        sortField: { type: 'string', description: 'Field to sort by' },
+        sortOrder: { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction' },
+      },
+    },
+    readOnly: true,
+  })
+  async listFiles(
+    args: { page?: number; pageSize?: number; search?: string; sortField?: string; sortOrder?: string },
+    _context: McpContext,
+  ): Promise<any> {
+    return this.fileService.getFiles({
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: args.search ?? '',
+      sortField: args.sortField ?? 'id',
+      sortOrder: (args.sortOrder as any) ?? 'asc',
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.files.get',
+    description: 'Returns file details by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        fileId: { type: 'number', description: 'File ID' },
+      },
+      required: ['fileId'],
+    },
+    readOnly: true,
+  })
+  async getFile(args: { fileId: number }, _context: McpContext): Promise<any> {
+    return this.fileService.get(args.fileId);
+  }
+
+  @McpTool({
+    name: 'core.files.open-url',
+    description: 'Returns a temporary URL to open/view a file inline. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        fileId: { type: 'number', description: 'File ID' },
+      },
+      required: ['fileId'],
+    },
+    readOnly: true,
+  })
+  async getOpenUrl(args: { fileId: number }, _context: McpContext): Promise<any> {
+    const file = await this.fileService.get(args.fileId);
+    const url = await this.fileService.tempOpenURL(file.path);
+    return { url };
+  }
+
+  @McpTool({
+    name: 'core.files.download-url',
+    description: 'Returns a temporary URL to download a file. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        fileId: { type: 'number', description: 'File ID' },
+      },
+      required: ['fileId'],
+    },
+    readOnly: true,
+  })
+  async getDownloadUrl(args: { fileId: number }, _context: McpContext): Promise<any> {
+    const file = await this.fileService.get(args.fileId);
+    const url = await this.fileService.tempURL(file.path);
+    return { url };
+  }
+
+  @McpTool({
+    name: 'core.files.delete',
+    description: 'Deletes one or more files by their IDs. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'number' }, description: 'File IDs to delete' },
+      },
+      required: ['ids'],
+    },
+  })
+  async deleteFiles(args: { ids: number[] }, context: McpContext): Promise<any> {
+    return this.fileService.delete(context.locale, { ids: args.ids });
+  }
+}

package/src/mcp/tools/core-integration-events.mcp-tools.ts

@@ -0,0 +1,118 @@
+import { Injectable } from '@nestjs/common';
+import { IntegrationEventCatalogService } from '../../webhook-integration/integration-event-catalog.service';
+import { McpTool } from '../decorators/mcp-tool.decorator';
+import { McpContext } from '../types/mcp-context.type';
+
+@Injectable()
+export class CoreIntegrationEventsMcpTools {
+  constructor(private readonly catalogService: IntegrationEventCatalogService) {}
+
+  @McpTool({
+    name: 'core.integration-events.list',
+    description: 'Lists integration event catalog entries with optional pagination. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term' },
+        sortField: { type: 'string', description: 'Field to sort by' },
+        sortOrder: { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction' },
+      },
+    },
+    readOnly: true,
+  })
+  async listIntegrationEvents(
+    args: { page?: number; pageSize?: number; search?: string; sortField?: string; sortOrder?: string },
+    _context: McpContext,
+  ): Promise<any> {
+    return this.catalogService.list({
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: args.search ?? '',
+      sortField: args.sortField ?? 'slug',
+      sortOrder: (args.sortOrder as any) ?? 'asc',
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.integration-events.options',
+    description: 'Returns active integration event options (for dropdown selection). Admin only.',
+    inputSchema: { type: 'object', properties: {} },
+    readOnly: true,
+  })
+  async getIntegrationEventOptions(_args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.catalogService.options();
+  }
+
+  @McpTool({
+    name: 'core.integration-events.get',
+    description: 'Returns a single integration event catalog entry by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Event catalog entry ID' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async getIntegrationEvent(args: { id: number }, _context: McpContext): Promise<any> {
+    return this.catalogService.get(args.id);
+  }
+
+  @McpTool({
+    name: 'core.integration-events.create',
+    description: 'Creates a new integration event catalog entry. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        slug: { type: 'string', description: 'Event slug (unique identifier)' },
+        name: { type: 'string', description: 'Event display name' },
+        module: { type: 'string', description: 'Module this event belongs to' },
+        description: { type: 'string', description: 'Event description' },
+        status: { type: 'string', description: 'Event status (active, inactive)' },
+      },
+      required: ['slug', 'name'],
+    },
+  })
+  async createIntegrationEvent(args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.catalogService.create(args);
+  }
+
+  @McpTool({
+    name: 'core.integration-events.update',
+    description: 'Updates an integration event catalog entry by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Event catalog entry ID' },
+        slug: { type: 'string', description: 'New slug' },
+        name: { type: 'string', description: 'New display name' },
+        description: { type: 'string', description: 'New description' },
+        status: { type: 'string', description: 'New status' },
+      },
+      required: ['id'],
+    },
+  })
+  async updateIntegrationEvent(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...data } = args;
+    return this.catalogService.update(id, data);
+  }
+
+  @McpTool({
+    name: 'core.integration-events.delete',
+    description: 'Deletes one or more integration event catalog entries by their IDs. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'number' }, description: 'Entry IDs to delete' },
+      },
+      required: ['ids'],
+    },
+  })
+  async deleteIntegrationEvents(args: { ids: number[] }, _context: McpContext): Promise<any> {
+    return this.catalogService.delete({ ids: args.ids });
+  }
+}

package/src/mcp/tools/core-mail-profile.mcp-tools.ts

@@ -0,0 +1,128 @@
+import { Injectable } from '@nestjs/common';
+import { MailProfileService } from '../../mail-profile/mail-profile.service';
+import { McpTool } from '../decorators/mcp-tool.decorator';
+import { McpContext } from '../types/mcp-context.type';
+
+@Injectable()
+export class CoreMailProfileMcpTools {
+  constructor(private readonly mailProfileService: MailProfileService) {}
+
+  @McpTool({
+    name: 'core.mail-profile.list',
+    description: 'Lists mail profiles with optional pagination. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term' },
+        sortField: { type: 'string', description: 'Field to sort by' },
+        sortOrder: { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction' },
+      },
+    },
+    readOnly: true,
+  })
+  async listMailProfiles(
+    args: { page?: number; pageSize?: number; search?: string; sortField?: string; sortOrder?: string },
+    _context: McpContext,
+  ): Promise<any> {
+    return this.mailProfileService.list({
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: args.search ?? '',
+      sortField: args.sortField ?? 'id',
+      sortOrder: (args.sortOrder as any) ?? 'asc',
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.mail-profile.get',
+    description: 'Returns a single mail profile by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Mail profile ID' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async getMailProfile(args: { id: number }, _context: McpContext): Promise<any> {
+    return this.mailProfileService.get(args.id);
+  }
+
+  @McpTool({
+    name: 'core.mail-profile.create',
+    description: 'Creates a new mail profile (SMTP configuration). Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Profile name' },
+        host: { type: 'string', description: 'SMTP host' },
+        port: { type: 'number', description: 'SMTP port' },
+        username: { type: 'string', description: 'SMTP username' },
+        password: { type: 'string', description: 'SMTP password' },
+      },
+      required: ['name', 'host', 'port', 'username'],
+    },
+  })
+  async createMailProfile(args: { name: string; host: string; port: number; username: string; password?: string }, _context: McpContext): Promise<any> {
+    return this.mailProfileService.create(args as any);
+  }
+
+  @McpTool({
+    name: 'core.mail-profile.update',
+    description: 'Updates an existing mail profile by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Mail profile ID' },
+        name: { type: 'string', description: 'New profile name' },
+        host: { type: 'string', description: 'New SMTP host' },
+        port: { type: 'number', description: 'New SMTP port' },
+        username: { type: 'string', description: 'New SMTP username' },
+        password: { type: 'string', description: 'New SMTP password' },
+      },
+      required: ['id'],
+    },
+  })
+  async updateMailProfile(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...data } = args;
+    return this.mailProfileService.update({ id, data: data as any });
+  }
+
+  @McpTool({
+    name: 'core.mail-profile.delete',
+    description: 'Deletes one or more mail profiles by their IDs. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'number' }, description: 'Mail profile IDs to delete' },
+      },
+      required: ['ids'],
+    },
+  })
+  async deleteMailProfiles(args: { ids: number[] }, _context: McpContext): Promise<any> {
+    return this.mailProfileService.delete({ ids: args.ids });
+  }
+
+  @McpTool({
+    name: 'core.mail-profile.test',
+    description: 'Tests a mail profile by sending a test message. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Profile name' },
+        host: { type: 'string', description: 'SMTP host' },
+        port: { type: 'number', description: 'SMTP port' },
+        username: { type: 'string', description: 'SMTP username' },
+        password: { type: 'string', description: 'SMTP password' },
+      },
+      required: ['host', 'port', 'username'],
+    },
+  })
+  async testMailProfile(args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.mailProfileService.test(args as any);
+  }
+}

package/src/mcp/tools/core-mail-sent.mcp-tools.ts

@@ -0,0 +1,76 @@
+import { Injectable } from '@nestjs/common';
+import { MailSentService } from '../../mail-sent/mail-sent.service';
+import { McpTool } from '../decorators/mcp-tool.decorator';
+import { McpContext } from '../types/mcp-context.type';
+
+@Injectable()
+export class CoreMailSentMcpTools {
+  constructor(private readonly mailSentService: MailSentService) {}
+
+  @McpTool({
+    name: 'core.mail-sent.list',
+    description: 'Lists sent mail records with optional filters. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term' },
+        sortField: { type: 'string', description: 'Field to sort by' },
+        sortOrder: { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction' },
+        status: { type: 'string', description: 'Filter by status (e.g. sent, failed)' },
+        hasError: { type: 'boolean', description: 'Filter by error presence' },
+        recipientEmail: { type: 'string', description: 'Filter by recipient email' },
+        createdAtFrom: { type: 'string', description: 'Start date filter (ISO 8601)' },
+        createdAtTo: { type: 'string', description: 'End date filter (ISO 8601)' },
+      },
+    },
+    readOnly: true,
+  })
+  async listMailSent(args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.mailSentService.list({
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: args.search ?? '',
+      sortField: args.sortField ?? 'id',
+      sortOrder: args.sortOrder ?? 'asc',
+      fields: '',
+      status: args.status,
+      hasError: args.hasError,
+      recipientEmail: args.recipientEmail,
+      createdAtFrom: args.createdAtFrom,
+      createdAtTo: args.createdAtTo,
+    } as any);
+  }
+
+  @McpTool({
+    name: 'core.mail-sent.get',
+    description: 'Returns a single sent mail record by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Sent mail record ID' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async getMailSent(args: { id: number }, context: McpContext): Promise<any> {
+    return this.mailSentService.get(context.locale, args.id);
+  }
+
+  @McpTool({
+    name: 'core.mail-sent.delete',
+    description: 'Deletes one or more sent mail records by their IDs. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'number' }, description: 'Sent mail record IDs to delete' },
+      },
+      required: ['ids'],
+    },
+  })
+  async deleteMailSent(args: { ids: number[] }, context: McpContext): Promise<any> {
+    return this.mailSentService.delete(context.locale, { ids: args.ids });
+  }
+}

package/src/mcp/tools/core-mail.mcp-tools.ts

@@ -0,0 +1,130 @@
+import { Injectable } from '@nestjs/common';
+import { MailService } from '../../mail/mail.service';
+import { McpTool } from '../decorators/mcp-tool.decorator';
+import { McpContext } from '../types/mcp-context.type';
+
+@Injectable()
+export class CoreMailMcpTools {
+  constructor(private readonly mailService: MailService) {}
+
+  @McpTool({
+    name: 'core.mail.list',
+    description: 'Lists mail templates with optional pagination. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term' },
+        sortField: { type: 'string', description: 'Field to sort by' },
+        sortOrder: { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction' },
+      },
+    },
+    readOnly: true,
+  })
+  async listMails(
+    args: { page?: number; pageSize?: number; search?: string; sortField?: string; sortOrder?: string },
+    context: McpContext,
+  ): Promise<any> {
+    return this.mailService.list(context.locale, {
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: args.search ?? '',
+      sortField: args.sortField ?? 'id',
+      sortOrder: (args.sortOrder as any) ?? 'asc',
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.mail.get',
+    description: 'Returns a single mail template by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Mail template ID' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async getMail(args: { id: number }, context: McpContext): Promise<any> {
+    return this.mailService.get(context.locale, args.id);
+  }
+
+  @McpTool({
+    name: 'core.mail.create',
+    description: 'Creates a new mail template. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        slug: { type: 'string', description: 'Template slug (unique identifier)' },
+        subject: { type: 'string', description: 'Email subject' },
+        body: { type: 'string', description: 'Email body (HTML)' },
+      },
+      required: ['slug'],
+    },
+  })
+  async createMail(args: { slug: string; subject?: string; body?: string }, _context: McpContext): Promise<any> {
+    return this.mailService.create(args as any);
+  }
+
+  @McpTool({
+    name: 'core.mail.update',
+    description: 'Updates an existing mail template by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Mail template ID' },
+        slug: { type: 'string', description: 'New slug' },
+        subject: { type: 'string', description: 'New subject' },
+        body: { type: 'string', description: 'New body (HTML)' },
+      },
+      required: ['id'],
+    },
+  })
+  async updateMail(args: { id: number; slug?: string; subject?: string; body?: string }, _context: McpContext): Promise<any> {
+    const { id, ...data } = args;
+    return this.mailService.update({ id, data: data as any });
+  }
+
+  @McpTool({
+    name: 'core.mail.delete',
+    description: 'Deletes one or more mail templates by their IDs. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'number' }, description: 'Template IDs to delete' },
+      },
+      required: ['ids'],
+    },
+  })
+  async deleteMails(args: { ids: number[] }, _context: McpContext): Promise<any> {
+    return this.mailService.delete({ ids: args.ids });
+  }
+
+  @McpTool({
+    name: 'core.mail.test',
+    description: 'Sends a test email using a specific template. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        to: { type: 'string', description: 'Recipient email address' },
+        templateId: { type: 'number', description: 'Mail template ID' },
+      },
+      required: ['to', 'templateId'],
+    },
+  })
+  async testMail(args: { to: string; templateId: number }, context: McpContext): Promise<any> {
+    return this.mailService.sendTestMail(context.locale, args as any);
+  }
+
+  @McpTool({
+    name: 'core.mail.reload',
+    description: 'Reloads the mail configuration from settings. Admin only.',
+    inputSchema: { type: 'object', properties: {} },
+  })
+  async reloadMailConfig(_args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.mailService.reloadConfig();
+  }
+}

package/src/mcp/tools/core-mcp-chat.mcp-tools.ts

@@ -0,0 +1,81 @@
+import { Injectable } from '@nestjs/common';
+import { McpChatService } from '../../mcp-chat/mcp-chat.service';
+import { McpTool } from '../decorators/mcp-tool.decorator';
+import { McpContext } from '../types/mcp-context.type';
+
+@Injectable()
+export class CoreMcpChatMcpTools {
+  constructor(private readonly mcpChatService: McpChatService) {}
+
+  @McpTool({
+    name: 'core.mcp-chat.conversations.list',
+    description: 'Lists MCP chat conversations for the authenticated user.',
+    inputSchema: { type: 'object', properties: {} },
+    readOnly: true,
+  })
+  async listConversations(_args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.mcpChatService.listConversations(context.userId);
+  }
+
+  @McpTool({
+    name: 'core.mcp-chat.conversations.create',
+    description: 'Creates a new MCP chat conversation.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        title: { type: 'string', description: 'Conversation title' },
+      },
+      required: ['title'],
+    },
+  })
+  async createConversation(args: { title: string }, context: McpContext): Promise<any> {
+    return this.mcpChatService.createConversation(context.userId, { title: args.title });
+  }
+
+  @McpTool({
+    name: 'core.mcp-chat.conversations.delete',
+    description: 'Deletes one or more MCP chat conversations.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'number' }, description: 'Conversation IDs to delete' },
+      },
+      required: ['ids'],
+    },
+  })
+  async deleteConversations(args: { ids: number[] }, context: McpContext): Promise<any> {
+    return this.mcpChatService.deleteConversations(context.userId, args.ids);
+  }
+
+  @McpTool({
+    name: 'core.mcp-chat.messages.list',
+    description: 'Returns messages in a conversation.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        conversationId: { type: 'number', description: 'Conversation ID' },
+      },
+      required: ['conversationId'],
+    },
+    readOnly: true,
+  })
+  async getMessages(args: { conversationId: number }, context: McpContext): Promise<any> {
+    return this.mcpChatService.getMessages(args.conversationId, context.userId);
+  }
+
+  @McpTool({
+    name: 'core.mcp-chat.messages.send',
+    description: 'Sends a message in a conversation and returns the AI response.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        conversationId: { type: 'number', description: 'Conversation ID' },
+        message: { type: 'string', description: 'Message to send' },
+      },
+      required: ['conversationId', 'message'],
+    },
+  })
+  async sendMessage(args: { conversationId: number; message: string }, context: McpContext): Promise<any> {
+    return this.mcpChatService.sendMessage(args.conversationId, context.userId, context.locale, args.message);
+  }
+}