@elevasis/core 0.15.1 → 0.17.0

package/src/execution/engine/tools/messages.ts

@@ -0,0 +1,43 @@
+/**
+ * Tool message protocol types (SSOT)
+ *
+ * Shared by worker-side (packages/sdk) and parent-side (apps/api) to
+ * describe the postMessage() messages that cross the worker thread boundary.
+ *
+ * ToolCallMessage  — worker → parent (outbound request)
+ * ToolCallResponse — parent → worker (inbound response)
+ */
+
+import type { ToolingErrorType } from './types'
+
+/**
+ * Token usage metadata optionally attached to a ToolCallResponse.
+ * Populated for LLM tool calls where cost accounting is available.
+ */
+export interface TokenUsage {
+  inputTokens: number
+  outputTokens: number
+  cost?: number
+}
+
+/** Outbound tool-call from worker to parent */
+export interface ToolCallMessage {
+  type: 'tool-call'
+  id: string
+  tool: string
+  method: string
+  params: unknown
+  credential?: string
+}
+
+/** Inbound tool-result from parent to worker */
+export interface ToolCallResponse {
+  type: 'tool-result'
+  id: string
+  result?: unknown
+  error?: string
+  /** Structured error code from platform (ToolingErrorType) */
+  code?: ToolingErrorType
+  /** Token usage metadata (LLM tool calls only) */
+  usage?: TokenUsage
+}

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

@@ -1,5 +1,6 @@
 import { z } from 'zod'
 import { isProspectingBuildTemplateId } from '../../../../../business/acquisition/build-templates'
+import { EmailSchema } from '../../../../../platform/utils/validation'
 
 // ============================================
 // LIST SCHEMAS
@@ -134,7 +135,7 @@ export const CompanyArrayOutputSchema = z.array(CompanyOutputSchema)
 // ============================================
 
 export const CreateContactInputSchema = z.object({
-  email: z.string().email(),
+  email: EmailSchema,
   companyId: z.string().uuid().optional(),
   firstName: z.string().optional(),
   lastName: z.string().optional(),

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

@@ -1,96 +1,97 @@
-/**
- * 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'
+import { EmailSchema } from '../../../../../platform/utils/validation'
+
+// =============================================================================
+// 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: EmailSchema.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: EmailSchema,
+        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
+}