@elevasis/core 0.15.0 → 0.16.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/list-tools.ts

@@ -38,13 +38,14 @@ export function createAcqListCreateTool(): Tool {
       if (!leadService) throw serviceUnavailable('LeadService')
       if (!executionContext?.organizationId) throw serviceUnavailable('ExecutionContext', { reason: 'organizationId required for multi-tenant isolation' })
 
-      const typedInput = input as { name: string; description?: string }
+      const typedInput = input as { name: string; description?: string; buildTemplateId?: string }
 
       const result = await leadService.createList({
-        organizationId: executionContext.organizationId,
-        name: typedInput.name,
-        description: typedInput.description
-      })
+        organizationId: executionContext.organizationId,
+        name: typedInput.name,
+        description: typedInput.description,
+        buildTemplateId: typedInput.buildTemplateId
+      })
 
       return {
         id: result.id,

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

@@ -1,4 +1,6 @@
 import { z } from 'zod'
+import { isProspectingBuildTemplateId } from '../../../../../business/acquisition/build-templates'
+import { EmailSchema } from '../../../../../platform/utils/validation'
 
 // ============================================
 // LIST SCHEMAS
@@ -6,7 +8,8 @@ import { z } from 'zod'
 
 export const CreateListInputSchema = z.object({
   name: z.string().min(1),
-  description: z.string().optional()
+  description: z.string().optional(),
+  buildTemplateId: z.string().refine(isProspectingBuildTemplateId).optional()
 })
 
 export const UpdateListInputSchema = z.object({
@@ -132,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
+}

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

@@ -557,9 +557,10 @@ export {
   type UpdateProposalDataParams,
   type MarkProposalSentParams,
   type MarkProposalReviewedParams,
-  type UpdateCloseLostReasonParams,
-  type UpdateFeesParams,
-  type TransitionItemParams,
+  type UpdateCloseLostReasonParams,
+  type UpdateFeesParams,
+  type CacheInstantlyThreadIdsParams,
+  type TransitionItemParams,
   type SetContactNurtureParams,
   type CancelSchedulesAndHitlByEmailParams,
   type CancelHitlByDealIdParams,

package/src/execution/engine/tools/tool-maps.ts

@@ -243,6 +243,7 @@ import type {
   MarkProposalReviewedParams,
   UpdateCloseLostReasonParams,
   UpdateFeesParams,
+  CacheInstantlyThreadIdsParams,
   TransitionItemParams,
   SetContactNurtureParams,
   CancelSchedulesAndHitlByEmailParams,
@@ -567,7 +568,7 @@ export type MillionVerifierToolMap = {
 }
 
 // ---------------------------------------------------------------------------
-// Lead (platform tool, 46 methods)
+// Lead (platform tool, 56 methods)
 // ---------------------------------------------------------------------------
 
 export type LeadToolMap = {
@@ -628,6 +629,7 @@ export type LeadToolMap = {
   markProposalReviewed: { params: Omit<MarkProposalReviewedParams, 'organizationId'>; result: void }
   updateCloseLostReason: { params: Omit<UpdateCloseLostReasonParams, 'organizationId'>; result: void }
   updateFees: { params: Omit<UpdateFeesParams, 'organizationId'>; result: void }
+  cacheInstantlyThreadIds: { params: Omit<CacheInstantlyThreadIdsParams, 'organizationId'>; result: void }
   transitionItem: { params: Omit<TransitionItemParams, 'organizationId'>; result: void }
   setContactNurture: { params: Omit<SetContactNurtureParams, 'organizationId'>; result: void }
   cancelSchedulesAndHitlByEmail: {