@elevasis/core 0.7.1 → 0.8.0

package/src/execution/engine/tools/platform/email/index.ts

@@ -1,122 +1,122 @@
-/**
- * Platform Email Tool
- *
- * Factory function for creating a platform email tool that sends
- * transactional emails from notifications@elevasis.io using platform Resend credentials.
- *
- * Usage:
- * ```typescript
- * const emailTool = createPlatformEmailTool({
- *   name: 'send_platform_email',
- *   description: 'Send platform notification emails to users'
- * })
- * ```
- */
-
-import type { Tool, ToolExecutionOptions } from '../../types'
-import { serviceUnavailable } from '../../types'
-import { getToolServices } from '../../registry'
-import type { SendPlatformEmailParams } from '../../registry'
-import {
-  SendPlatformEmailInputSchema,
-  SendPlatformEmailOutputSchema,
-  type SendPlatformEmailInput,
-  type SendPlatformEmailOutput,
-  type PlatformEmailToolConfig
-} from './types'
-
-/**
- * Create a platform email tool that sends emails to targeted users
- *
- * Platform email tools enable agents and workflows to send transactional emails
- * from the platform email address (notifications@elevasis.io). Emails can target
- * specific users, users with a role, or all organization members.
- *
- * @param config - Configuration for the email tool
- * @returns Tool that sends platform emails
- *
- * @example
- * const emailTool = createPlatformEmailTool({
- *   name: 'notify_admins',
- *   description: 'Send email notification to all admin users'
- * })
- *
- * // Execute with explicit user targeting
- * await emailTool.execute({
- *   input: {
- *     userIds: ['user-id-1', 'user-id-2'],
- *     subject: 'Workflow completed',
- *     html: '<p>Your workflow has completed successfully.</p>'
- *   },
- *   executionContext: context
- * })
- *
- * // Execute with role-based targeting
- * await emailTool.execute({
- *   input: {
- *     targetRole: 'admin',
- *     subject: 'System alert',
- *     text: 'A critical error occurred.'
- *   },
- *   executionContext: context
- * })
- */
-export function createPlatformEmailTool(config: PlatformEmailToolConfig): Tool {
-  return {
-    name: config.name,
-    description: config.description,
-    inputSchema: SendPlatformEmailInputSchema,
-    outputSchema: SendPlatformEmailOutputSchema,
-
-    async execute(options: ToolExecutionOptions): Promise<SendPlatformEmailOutput> {
-      // ExecutionContext is required for platform tools
-      if (!options.executionContext) {
-        throw serviceUnavailable('ExecutionContext', { tool: config.name, reason: 'organizationId required for multi-tenant isolation' })
-      }
-
-      // Get email service from global registry
-      const { emailService } = getToolServices()
-      if (!emailService) {
-        throw serviceUnavailable('EmailService', {
-          message: 'Ensure toolServicesRegistry.initialize() was called in apps/api/src/main.ts',
-          tool: config.name
-        })
-      }
-
-      // Build email parameters from input + context
-      const inputData = options.input as SendPlatformEmailInput
-
-      const params: SendPlatformEmailParams = {
-        organizationId: options.executionContext.organizationId,
-
-        // Targeting (exactly one will be set, validated by schema)
-        userIds: inputData.userIds,
-        targetRole: inputData.targetRole,
-        targetAll: inputData.targetAll,
-
-        // Content
-        subject: inputData.subject,
-        html: inputData.html,
-        text: inputData.text,
-
-        // Optional
-        replyTo: inputData.replyTo,
-        tags: inputData.tags
-      }
-
-      // Send email via service
-      const result = await emailService.send(params)
-
-      return result
-    }
-  }
-}
-
-// Re-export types for consumers
-export {
-  SendPlatformEmailInputSchema,
-  SendPlatformEmailOutputSchema,
-  type SendPlatformEmailInput,
-  type SendPlatformEmailOutput,
-  type PlatformEmailToolConfig
-} from './types'
+/**
+ * Platform Email Tool
+ *
+ * Factory function for creating a platform email tool that sends
+ * transactional emails from notifications@elevasis.io using platform Resend credentials.
+ *
+ * Usage:
+ * ```typescript
+ * const emailTool = createPlatformEmailTool({
+ *   name: 'send_platform_email',
+ *   description: 'Send platform notification emails to users'
+ * })
+ * ```
+ */
+
+import type { Tool, ToolExecutionOptions } from '../../types'
+import { serviceUnavailable } from '../../types'
+import { getToolServices } from '../../registry'
+import type { SendPlatformEmailParams } from '../../registry'
+import {
+  SendPlatformEmailInputSchema,
+  SendPlatformEmailOutputSchema,
+  type SendPlatformEmailInput,
+  type SendPlatformEmailOutput,
+  type PlatformEmailToolConfig
+} from './types'
+
+/**
+ * Create a platform email tool that sends emails to targeted users
+ *
+ * Platform email tools enable agents and workflows to send transactional emails
+ * from the platform email address (notifications@elevasis.io). Emails can target
+ * specific users, users with a role, or all organization members.
+ *
+ * @param config - Configuration for the email tool
+ * @returns Tool that sends platform emails
+ *
+ * @example
+ * const emailTool = createPlatformEmailTool({
+ *   name: 'notify_admins',
+ *   description: 'Send email notification to all admin users'
+ * })
+ *
+ * // Execute with explicit user targeting
+ * await emailTool.execute({
+ *   input: {
+ *     userIds: ['user-id-1', 'user-id-2'],
+ *     subject: 'Workflow completed',
+ *     html: '<p>Your workflow has completed successfully.</p>'
+ *   },
+ *   executionContext: context
+ * })
+ *
+ * // Execute with role-based targeting
+ * await emailTool.execute({
+ *   input: {
+ *     targetRole: 'admin',
+ *     subject: 'System alert',
+ *     text: 'A critical error occurred.'
+ *   },
+ *   executionContext: context
+ * })
+ */
+export function createPlatformEmailTool(config: PlatformEmailToolConfig): Tool {
+  return {
+    name: config.name,
+    description: config.description,
+    inputSchema: SendPlatformEmailInputSchema,
+    outputSchema: SendPlatformEmailOutputSchema,
+
+    async execute(options: ToolExecutionOptions): Promise<SendPlatformEmailOutput> {
+      // ExecutionContext is required for platform tools
+      if (!options.executionContext) {
+        throw serviceUnavailable('ExecutionContext', { tool: config.name, reason: 'organizationId required for multi-tenant isolation' })
+      }
+
+      // Get email service from global registry
+      const { emailService } = getToolServices()
+      if (!emailService) {
+        throw serviceUnavailable('EmailService', {
+          message: 'Ensure toolServicesRegistry.initialize() was called in apps/api/src/main.ts',
+          tool: config.name
+        })
+      }
+
+      // Build email parameters from input + context
+      const inputData = options.input as SendPlatformEmailInput
+
+      const params: SendPlatformEmailParams = {
+        organizationId: options.executionContext.organizationId,
+
+        // Targeting (exactly one will be set, validated by schema)
+        userIds: inputData.userIds,
+        targetRole: inputData.targetRole,
+        targetAll: inputData.targetAll,
+
+        // Content
+        subject: inputData.subject,
+        html: inputData.html,
+        text: inputData.text,
+
+        // Optional
+        replyTo: inputData.replyTo,
+        tags: inputData.tags
+      }
+
+      // Send email via service
+      const result = await emailService.send(params)
+
+      return result
+    }
+  }
+}
+
+// Re-export types for consumers
+export {
+  SendPlatformEmailInputSchema,
+  SendPlatformEmailOutputSchema,
+  type SendPlatformEmailInput,
+  type SendPlatformEmailOutput,
+  type PlatformEmailToolConfig
+} from './types'

package/src/execution/engine/tools/platform/email/types.ts

@@ -1,96 +1,96 @@
-/**
- * Platform Email Tool Types
- *
- * Zod schemas and inferred types for platform email sending.
- * Supports three targeting modes: explicit userIds, role-based, or broadcast.
- */
-
-import { z } from 'zod'
-
-// =============================================================================
-// INPUT SCHEMA
-// =============================================================================
-
-/**
- * Input schema for sending platform emails
- *
- * Targeting modes (exactly one required):
- * - userIds: Explicit list of user IDs to email
- * - targetRole: Role to target (e.g., "admin")
- * - targetAll: Send to all org members
- *
- * Content (at least one required):
- * - html: HTML email body
- * - text: Plain text email body
- */
-export const SendPlatformEmailInputSchema = z
-  .object({
-    // Targeting (exactly one required)
-    userIds: z.array(z.string().uuid()).optional().describe('Explicit list of user IDs to email'),
-    targetRole: z.string().optional().describe('Role to target (e.g., "admin")'),
-    targetAll: z.boolean().optional().describe('Send to all org members'),
-
-    // Content
-    subject: z.string().min(1).max(200),
-    html: z.string().optional(),
-    text: z.string().optional(),
-
-    // Optional
-    replyTo: z.string().email().optional(),
-    tags: z
-      .array(
-        z.object({
-          name: z.string(),
-          value: z.string()
-        })
-      )
-      .optional()
-  })
-  .refine(
-    (data) => {
-      const modes = [data.userIds?.length, data.targetRole, data.targetAll].filter(Boolean)
-      return modes.length === 1
-    },
-    { message: 'Exactly one targeting mode required: userIds, targetRole, or targetAll' }
-  )
-  .refine((data) => data.html || data.text, { message: 'Must provide either html or text body' })
-
-export type SendPlatformEmailInput = z.infer<typeof SendPlatformEmailInputSchema>
-
-// =============================================================================
-// OUTPUT SCHEMA
-// =============================================================================
-
-/**
- * Output schema for platform email send result
- * Follows partial success pattern (similar to BatchProcessResult)
- */
-export const SendPlatformEmailOutputSchema = z.object({
-  sent: z.number().int(),
-  failed: z.number().int(),
-  errors: z
-    .array(
-      z.object({
-        userId: z.string().uuid(),
-        email: z.string().email(),
-        error: z.string()
-      })
-    )
-    .optional()
-})
-
-export type SendPlatformEmailOutput = z.infer<typeof SendPlatformEmailOutputSchema>
-
-// =============================================================================
-// TOOL CONFIG
-// =============================================================================
-
-/**
- * Configuration for creating a platform email tool
- */
-export interface PlatformEmailToolConfig {
-  /** Unique name for the tool */
-  name: string
-  /** Description of what the tool does (shown to LLM) */
-  description: string
-}
+/**
+ * Platform Email Tool Types
+ *
+ * Zod schemas and inferred types for platform email sending.
+ * Supports three targeting modes: explicit userIds, role-based, or broadcast.
+ */
+
+import { z } from 'zod'
+
+// =============================================================================
+// INPUT SCHEMA
+// =============================================================================
+
+/**
+ * Input schema for sending platform emails
+ *
+ * Targeting modes (exactly one required):
+ * - userIds: Explicit list of user IDs to email
+ * - targetRole: Role to target (e.g., "admin")
+ * - targetAll: Send to all org members
+ *
+ * Content (at least one required):
+ * - html: HTML email body
+ * - text: Plain text email body
+ */
+export const SendPlatformEmailInputSchema = z
+  .object({
+    // Targeting (exactly one required)
+    userIds: z.array(z.string().uuid()).optional().describe('Explicit list of user IDs to email'),
+    targetRole: z.string().optional().describe('Role to target (e.g., "admin")'),
+    targetAll: z.boolean().optional().describe('Send to all org members'),
+
+    // Content
+    subject: z.string().min(1).max(200),
+    html: z.string().optional(),
+    text: z.string().optional(),
+
+    // Optional
+    replyTo: z.string().email().optional(),
+    tags: z
+      .array(
+        z.object({
+          name: z.string(),
+          value: z.string()
+        })
+      )
+      .optional()
+  })
+  .refine(
+    (data) => {
+      const modes = [data.userIds?.length, data.targetRole, data.targetAll].filter(Boolean)
+      return modes.length === 1
+    },
+    { message: 'Exactly one targeting mode required: userIds, targetRole, or targetAll' }
+  )
+  .refine((data) => data.html || data.text, { message: 'Must provide either html or text body' })
+
+export type SendPlatformEmailInput = z.infer<typeof SendPlatformEmailInputSchema>
+
+// =============================================================================
+// OUTPUT SCHEMA
+// =============================================================================
+
+/**
+ * Output schema for platform email send result
+ * Follows partial success pattern (similar to BatchProcessResult)
+ */
+export const SendPlatformEmailOutputSchema = z.object({
+  sent: z.number().int(),
+  failed: z.number().int(),
+  errors: z
+    .array(
+      z.object({
+        userId: z.string().uuid(),
+        email: z.string().email(),
+        error: z.string()
+      })
+    )
+    .optional()
+})
+
+export type SendPlatformEmailOutput = z.infer<typeof SendPlatformEmailOutputSchema>
+
+// =============================================================================
+// TOOL CONFIG
+// =============================================================================
+
+/**
+ * Configuration for creating a platform email tool
+ */
+export interface PlatformEmailToolConfig {
+  /** Unique name for the tool */
+  name: string
+  /** Description of what the tool does (shown to LLM) */
+  description: string
+}