@elevasis/core 0.1.0

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

@@ -0,0 +1,694 @@
+/**
+ * Tool Method Maps
+ *
+ * Single source of truth for tool -> method -> params -> result type mappings.
+ * Used by SDK adapters (compile-time typed wrappers) and optionally by the
+ * server-side dispatcher for type checking.
+ *
+ * Browser-safe: no Node.js imports, pure type definitions.
+ */
+
+import type {
+  CreateRecordParams,
+  CreateRecordResult,
+  UpdateRecordParams,
+  UpdateRecordResult,
+  QueryRecordsParams,
+  QueryRecordsResult,
+  GetRecordParams,
+  GetRecordResult,
+  DeleteRecordParams,
+  DeleteRecordResult,
+  ListObjectsResult,
+  ListAttributesParams,
+  ListAttributesResult,
+  CreateAttributeParams,
+  CreateAttributeResult,
+  UpdateAttributeParams,
+  UpdateAttributeResult,
+  CreateNoteParams,
+  CreateNoteResult,
+  ListNotesParams,
+  ListNotesResult,
+  DeleteNoteParams,
+  DeleteNoteResult
+} from './integration/types/attio'
+
+import type {
+  RunActorParams,
+  RunActorResult,
+  GetDatasetItemsParams,
+  GetDatasetItemsResult,
+  StartActorParams,
+  StartActorResult
+} from './integration/types/apify'
+
+import type {
+  UploadFileParams,
+  UploadFileResult,
+  CreateFolderParams,
+  CreateFolderResult
+} from './integration/types/dropbox'
+
+import type { GmailSendEmailParams, GmailSendEmailResult } from './integration/types/gmail'
+
+import type {
+  ReadSheetParams,
+  ReadSheetResult,
+  WriteSheetParams,
+  WriteSheetResult,
+  AppendRowsParams,
+  AppendRowsResult,
+  ClearRangeParams,
+  ClearRangeResult,
+  GetSpreadsheetMetadataParams,
+  GetSpreadsheetMetadataResult,
+  BatchUpdateParams,
+  BatchUpdateResult,
+  GetHeadersParams,
+  GetHeadersResult,
+  GetLastRowParams,
+  GetLastRowResult,
+  GetRowByValueParams,
+  GetRowByValueResult,
+  UpdateRowByValueParams,
+  UpdateRowByValueResult,
+  UpsertRowParams,
+  UpsertRowResult,
+  FilterRowsParams,
+  FilterRowsResult,
+  DeleteRowByValueParams,
+  DeleteRowByValueResult
+} from './integration/types/google-sheets'
+
+import type {
+  SendReplyParams,
+  SendReplyResult,
+  RemoveFromSubsequenceParams,
+  RemoveFromSubsequenceResult,
+  GetEmailsParams,
+  GetEmailsResult,
+  UpdateInterestStatusParams,
+  UpdateInterestStatusResult,
+  AddToCampaignParams,
+  AddToCampaignResult,
+  ListCampaignsParams,
+  ListCampaignsResult,
+  GetCampaignParams,
+  GetCampaignResult,
+  UpdateCampaignParams,
+  UpdateCampaignResult,
+  PauseCampaignParams,
+  PauseCampaignResult,
+  ActivateCampaignParams,
+  ActivateCampaignResult,
+  GetCampaignAnalyticsParams,
+  GetCampaignAnalyticsResult,
+  GetStepAnalyticsParams,
+  GetStepAnalyticsResult,
+  BulkAddLeadsParams,
+  BulkAddLeadsResult,
+  GetAccountHealthParams,
+  GetAccountHealthResult,
+  CreateInboxTestParams,
+  CreateInboxTestResult,
+  CreateCampaignParams,
+  CreateCampaignResult,
+  GetDailyCampaignAnalyticsParams,
+  GetDailyCampaignAnalyticsResult,
+  ListLeadsParams,
+  ListLeadsResult,
+  BulkDeleteLeadsParams,
+  BulkDeleteLeadsResult,
+  DeleteCampaignParams,
+  DeleteCampaignResult,
+  PatchLeadParams,
+  PatchLeadResult
+} from './integration/types/instantly'
+
+import type {
+  MillionVerifierVerifyEmailParams,
+  MillionVerifierVerifyEmailResult,
+  MillionVerifierCheckCreditsParams,
+  MillionVerifierCheckCreditsResult
+} from './integration/types/millionverifier'
+
+import type {
+  FindCompanyEmailParams,
+  FindCompanyEmailResult,
+  FindPersonEmailParams,
+  FindPersonEmailResult,
+  FindDecisionMakerEmailParams,
+  FindDecisionMakerEmailResult,
+  VerifyEmailParams,
+  VerifyEmailResult
+} from './integration/types/anymailfinder'
+
+import type {
+  EmailFinderParams,
+  EmailFinderResult,
+  DomainSearchParams,
+  DomainSearchResult,
+  EmailVerifierParams,
+  EmailVerifierResult
+} from './integration/types/tomba'
+
+import type {
+  ResendSendEmailParams,
+  ResendSendEmailResult,
+  ResendGetEmailParams,
+  ResendGetEmailResult
+} from './integration/types/resend'
+
+import type {
+  CreateEnvelopeParams,
+  CreateEnvelopeResult,
+  VoidEnvelopeParams,
+  VoidEnvelopeResult,
+  DownloadDocumentParams,
+  DownloadDocumentResult,
+  GetEnvelopeParams,
+  GetEnvelopeResult
+} from './integration/types/signature-api'
+
+import type {
+  CreatePaymentLinkParams,
+  CreatePaymentLinkResult,
+  GetPaymentLinkParams,
+  GetPaymentLinkResult,
+  UpdatePaymentLinkParams,
+  UpdatePaymentLinkResult,
+  ListPaymentLinksParams,
+  ListPaymentLinksResult,
+  CreateAutoPaymentLinkParams,
+  CreateAutoPaymentLinkResult,
+  CreateCheckoutSessionParams,
+  CreateCheckoutSessionResult
+} from './integration/types/stripe'
+
+import type {
+  StorageUploadInput,
+  StorageUploadOutput,
+  StorageDownloadInput,
+  StorageDownloadOutput,
+  StorageSignedUrlInput,
+  StorageSignedUrlOutput,
+  StorageDeleteInput,
+  StorageDeleteOutput,
+  StorageListInput,
+  StorageListOutput
+} from './platform/storage/types'
+
+import type { CreateScheduleInput, TaskSchedule } from '../../scheduler/types'
+
+import type { CreateNotificationParams } from '../../../operations/notifications/types'
+
+import type {
+  AcqList,
+  AcqCompany,
+  AcqContact,
+  PaginatedResult,
+  CreateListParams,
+  UpdateListParams,
+  CreateCompanyParams,
+  UpdateCompanyParams,
+  UpsertCompanyParams,
+  CompanyFilters,
+  CreateContactParams,
+  UpdateContactParams,
+  UpsertContactParams,
+  ContactFilters,
+  UpsertDealParams,
+  AcqDeal,
+  AcqDealNote,
+  AcqDealTask,
+  CreateDealNoteParams,
+  ListDealNotesParams,
+  CreateDealTaskParams,
+  ListDealTasksParams,
+  ListDealTasksDueParams,
+  CompleteDealTaskParams,
+  RecordDealActivityParams,
+  AddContactsToListParams,
+  AddContactsToListResult,
+  BulkImportParams,
+  BulkImportResult,
+  BulkImportCompaniesParams,
+  BulkImportCompaniesResult,
+  UpdateDiscoveryDataParams,
+  UpdateProposalDataParams,
+  MarkProposalSentParams,
+  MarkProposalReviewedParams,
+  UpdateCloseLostReasonParams,
+  UpdateFeesParams,
+  SyncDealStageParams,
+  SetContactNurtureParams,
+  CancelSchedulesAndHitlByEmailParams,
+  CancelHitlByDealIdParams,
+  ClearDealFieldsParams,
+  DeleteDealParams,
+  DealFilters,
+  DealPipelineAnalytics,
+  ListConfig,
+  RecordListExecutionParams,
+  UpdateCompanyStageParams,
+  UpdateContactStageParams,
+  UpsertSocialPostParams,
+  UpsertSocialPostsResult,
+  GetDealByIdParams,
+  GetContactByIdParams,
+  GetCompanyByIdParams
+} from './lead-service-types'
+
+// ---------------------------------------------------------------------------
+// Generic constraint types
+// ---------------------------------------------------------------------------
+
+/** A single method entry: what params go in, what result comes out */
+export interface MethodEntry {
+  params: unknown
+  result: unknown
+}
+
+/** A tool's complete method map: method name -> MethodEntry */
+export type ToolMethodMap = Record<string, MethodEntry>
+
+// ---------------------------------------------------------------------------
+// Attio (integration adapter, 12 methods)
+// ---------------------------------------------------------------------------
+
+export type AttioToolMap = {
+  createRecord: { params: CreateRecordParams; result: CreateRecordResult }
+  updateRecord: { params: UpdateRecordParams; result: UpdateRecordResult }
+  listRecords: { params: QueryRecordsParams; result: QueryRecordsResult }
+  getRecord: { params: GetRecordParams; result: GetRecordResult }
+  deleteRecord: { params: DeleteRecordParams; result: DeleteRecordResult }
+  listObjects: { params: Record<string, never>; result: ListObjectsResult }
+  listAttributes: { params: ListAttributesParams; result: ListAttributesResult }
+  createAttribute: { params: CreateAttributeParams; result: CreateAttributeResult }
+  updateAttribute: { params: UpdateAttributeParams; result: UpdateAttributeResult }
+  createNote: { params: CreateNoteParams; result: CreateNoteResult }
+  listNotes: { params: ListNotesParams; result: ListNotesResult }
+  deleteNote: { params: DeleteNoteParams; result: DeleteNoteResult }
+}
+
+// ---------------------------------------------------------------------------
+// Scheduler (platform tool, 9 methods)
+// ---------------------------------------------------------------------------
+
+export type SchedulerToolMap = {
+  createSchedule: { params: CreateScheduleInput; result: TaskSchedule }
+  updateAnchor: { params: { scheduleId: string; anchorAt: string }; result: TaskSchedule }
+  deleteSchedule: { params: { scheduleId: string }; result: void }
+  findByIdempotencyKey: { params: { idempotencyKey: string }; result: TaskSchedule | null }
+  deleteScheduleByIdempotencyKey: { params: { idempotencyKey: string }; result: void }
+  listSchedules: { params: { status?: string; limit?: number; offset?: number }; result: TaskSchedule[] }
+  getSchedule: { params: { scheduleId: string }; result: TaskSchedule }
+  cancelSchedule: { params: { scheduleId: string }; result: void }
+  cancelSchedulesByMetadata: { params: { metadata: Record<string, unknown> }; result: { cancelledCount: number } }
+  cancelScheduleByIdempotencyKey: { params: { idempotencyKey: string }; result: { cancelled: boolean } }
+}
+
+// ---------------------------------------------------------------------------
+// Storage (platform tool, 5 methods)
+// ---------------------------------------------------------------------------
+
+export type StorageToolMap = {
+  upload: { params: StorageUploadInput; result: StorageUploadOutput }
+  download: { params: StorageDownloadInput; result: StorageDownloadOutput }
+  createSignedUrl: { params: StorageSignedUrlInput; result: StorageSignedUrlOutput }
+  delete: { params: StorageDeleteInput; result: StorageDeleteOutput }
+  list: { params: StorageListInput; result: StorageListOutput }
+}
+
+// ---------------------------------------------------------------------------
+// Notification (platform tool, 1 method)
+// ---------------------------------------------------------------------------
+
+/**
+ * SDK-side notification input.
+ * Omits userId and organizationId which are injected server-side from execution context.
+ */
+export type NotificationSDKInput = Omit<CreateNotificationParams, 'userId' | 'organizationId'>
+
+export type NotificationToolMap = {
+  create: { params: NotificationSDKInput; result: void }
+}
+
+// ---------------------------------------------------------------------------
+// Stripe (integration adapter, 6 methods)
+// ---------------------------------------------------------------------------
+
+export type StripeToolMap = {
+  createPaymentLink: { params: CreatePaymentLinkParams; result: CreatePaymentLinkResult }
+  getPaymentLink: { params: GetPaymentLinkParams; result: GetPaymentLinkResult }
+  updatePaymentLink: { params: UpdatePaymentLinkParams; result: UpdatePaymentLinkResult }
+  listPaymentLinks: { params: ListPaymentLinksParams; result: ListPaymentLinksResult }
+  createAutoPaymentLink: { params: CreateAutoPaymentLinkParams; result: CreateAutoPaymentLinkResult }
+  createCheckoutSession: { params: CreateCheckoutSessionParams; result: CreateCheckoutSessionResult }
+}
+
+// ---------------------------------------------------------------------------
+// Google Sheets (integration adapter, 13 methods)
+// ---------------------------------------------------------------------------
+
+export type GoogleSheetsToolMap = {
+  readSheet: { params: ReadSheetParams; result: ReadSheetResult }
+  writeSheet: { params: WriteSheetParams; result: WriteSheetResult }
+  appendRows: { params: AppendRowsParams; result: AppendRowsResult }
+  clearRange: { params: ClearRangeParams; result: ClearRangeResult }
+  getSpreadsheetMetadata: { params: GetSpreadsheetMetadataParams; result: GetSpreadsheetMetadataResult }
+  batchUpdate: { params: BatchUpdateParams; result: BatchUpdateResult }
+  getHeaders: { params: GetHeadersParams; result: GetHeadersResult }
+  getLastRow: { params: GetLastRowParams; result: GetLastRowResult }
+  getRowByValue: { params: GetRowByValueParams; result: GetRowByValueResult }
+  updateRowByValue: { params: UpdateRowByValueParams; result: UpdateRowByValueResult }
+  upsertRow: { params: UpsertRowParams; result: UpsertRowResult }
+  filterRows: { params: FilterRowsParams; result: FilterRowsResult }
+  deleteRowByValue: { params: DeleteRowByValueParams; result: DeleteRowByValueResult }
+}
+
+// ---------------------------------------------------------------------------
+// Resend (integration adapter, 2 methods)
+// ---------------------------------------------------------------------------
+
+export type ResendToolMap = {
+  sendEmail: { params: ResendSendEmailParams; result: ResendSendEmailResult }
+  getEmail: { params: ResendGetEmailParams; result: ResendGetEmailResult }
+}
+
+// ---------------------------------------------------------------------------
+// Apify (integration adapter, 2 methods)
+// ---------------------------------------------------------------------------
+
+export type ApifyToolMap = {
+  runActor: { params: RunActorParams; result: RunActorResult }
+  getDatasetItems: { params: GetDatasetItemsParams; result: GetDatasetItemsResult }
+  startActor: { params: StartActorParams; result: StartActorResult }
+}
+
+// ---------------------------------------------------------------------------
+// Gmail (integration adapter, 1 method)
+// ---------------------------------------------------------------------------
+
+export type GmailToolMap = {
+  sendEmail: { params: GmailSendEmailParams; result: GmailSendEmailResult }
+}
+
+// ---------------------------------------------------------------------------
+// Dropbox (integration adapter, 2 methods)
+// ---------------------------------------------------------------------------
+
+export type DropboxToolMap = {
+  uploadFile: { params: UploadFileParams; result: UploadFileResult }
+  createFolder: { params: CreateFolderParams; result: CreateFolderResult }
+}
+
+// ---------------------------------------------------------------------------
+// SignatureAPI (integration adapter, 4 methods)
+// ---------------------------------------------------------------------------
+
+export type SignatureApiToolMap = {
+  createEnvelope: { params: CreateEnvelopeParams; result: CreateEnvelopeResult }
+  voidEnvelope: { params: VoidEnvelopeParams; result: VoidEnvelopeResult }
+  downloadDocument: { params: DownloadDocumentParams; result: DownloadDocumentResult }
+  getEnvelope: { params: GetEnvelopeParams; result: GetEnvelopeResult }
+}
+
+// ---------------------------------------------------------------------------
+// Instantly (integration adapter, 21 methods)
+// ---------------------------------------------------------------------------
+
+export type InstantlyToolMap = {
+  sendReply: { params: SendReplyParams; result: SendReplyResult }
+  removeFromSubsequence: { params: RemoveFromSubsequenceParams; result: RemoveFromSubsequenceResult }
+  getEmails: { params: GetEmailsParams; result: GetEmailsResult }
+  updateInterestStatus: { params: UpdateInterestStatusParams; result: UpdateInterestStatusResult }
+  addToCampaign: { params: AddToCampaignParams; result: AddToCampaignResult }
+  listCampaigns: { params: ListCampaignsParams; result: ListCampaignsResult }
+  getCampaign: { params: GetCampaignParams; result: GetCampaignResult }
+  updateCampaign: { params: UpdateCampaignParams; result: UpdateCampaignResult }
+  pauseCampaign: { params: PauseCampaignParams; result: PauseCampaignResult }
+  activateCampaign: { params: ActivateCampaignParams; result: ActivateCampaignResult }
+  getCampaignAnalytics: { params: GetCampaignAnalyticsParams; result: GetCampaignAnalyticsResult }
+  getStepAnalytics: { params: GetStepAnalyticsParams; result: GetStepAnalyticsResult }
+  bulkAddLeads: { params: BulkAddLeadsParams; result: BulkAddLeadsResult }
+  getAccountHealth: { params: GetAccountHealthParams; result: GetAccountHealthResult }
+  createInboxTest: { params: CreateInboxTestParams; result: CreateInboxTestResult }
+  createCampaign: { params: CreateCampaignParams; result: CreateCampaignResult }
+  getDailyCampaignAnalytics: { params: GetDailyCampaignAnalyticsParams; result: GetDailyCampaignAnalyticsResult }
+  listLeads: { params: ListLeadsParams; result: ListLeadsResult }
+  bulkDeleteLeads: { params: BulkDeleteLeadsParams; result: BulkDeleteLeadsResult }
+  deleteCampaign: { params: DeleteCampaignParams; result: DeleteCampaignResult }
+  patchLead: { params: PatchLeadParams; result: PatchLeadResult }
+}
+
+// ---------------------------------------------------------------------------
+// Anymailfinder (integration adapter, 4 methods)
+// ---------------------------------------------------------------------------
+
+export type AnymailfinderToolMap = {
+  findCompanyEmail: { params: FindCompanyEmailParams; result: FindCompanyEmailResult }
+  findPersonEmail: { params: FindPersonEmailParams; result: FindPersonEmailResult }
+  findDecisionMakerEmail: { params: FindDecisionMakerEmailParams; result: FindDecisionMakerEmailResult }
+  verifyEmail: { params: VerifyEmailParams; result: VerifyEmailResult }
+}
+
+// ---------------------------------------------------------------------------
+// Tomba (integration adapter, 3 methods)
+// ---------------------------------------------------------------------------
+
+export type TombaToolMap = {
+  emailFinder: { params: EmailFinderParams; result: EmailFinderResult }
+  domainSearch: { params: DomainSearchParams; result: DomainSearchResult }
+  emailVerifier: { params: EmailVerifierParams; result: EmailVerifierResult }
+}
+
+// ---------------------------------------------------------------------------
+// MillionVerifier (integration adapter, 2 methods)
+// ---------------------------------------------------------------------------
+
+export type MillionVerifierToolMap = {
+  verifyEmail: { params: MillionVerifierVerifyEmailParams; result: MillionVerifierVerifyEmailResult }
+  checkCredits: { params: MillionVerifierCheckCreditsParams; result: MillionVerifierCheckCreditsResult }
+}
+
+// ---------------------------------------------------------------------------
+// Lead (platform tool, 46 methods)
+// ---------------------------------------------------------------------------
+
+export type LeadToolMap = {
+  // List operations
+  listLists: { params: Record<string, never>; result: AcqList[] }
+  createList: { params: Omit<CreateListParams, 'organizationId'>; result: AcqList }
+  updateList: { params: { id: string } & UpdateListParams; result: AcqList }
+  deleteList: { params: { id: string }; result: void }
+  addContactsToList: { params: Omit<AddContactsToListParams, 'organizationId'>; result: AddContactsToListResult }
+  // Company operations
+  createCompany: { params: Omit<CreateCompanyParams, 'organizationId'>; result: AcqCompany }
+  upsertCompany: { params: Omit<UpsertCompanyParams, 'organizationId'>; result: AcqCompany }
+  updateCompany: { params: { id: string } & UpdateCompanyParams; result: AcqCompany }
+  getCompany: { params: { id: string }; result: AcqCompany | null }
+  listCompanies: { params: CompanyFilters; result: AcqCompany[] }
+  deleteCompany: { params: { id: string }; result: void }
+  // Contact operations
+  createContact: { params: Omit<CreateContactParams, 'organizationId'>; result: AcqContact }
+  upsertContact: { params: Omit<UpsertContactParams, 'organizationId'>; result: AcqContact }
+  updateContact: { params: { id: string } & UpdateContactParams; result: AcqContact }
+  getContact: { params: { id: string }; result: AcqContact | null }
+  getContactByEmail: { params: { email: string }; result: AcqContact | null }
+  listContacts: {
+    params: ContactFilters & { limit?: number; offset?: number }
+    result: PaginatedResult<AcqContact>
+  }
+  deleteContact: { params: { id: string }; result: void }
+  bulkImportContacts: { params: Omit<BulkImportParams, 'organizationId'>; result: BulkImportResult }
+  bulkImportCompanies: {
+    params: Omit<BulkImportCompaniesParams, 'organizationId'>
+    result: BulkImportCompaniesResult
+  }
+  deactivateContactsByCompany: {
+    params: { companyId: string }
+    result: { deactivated: number }
+  }
+  // Deal operations
+  upsertDeal: { params: Omit<UpsertDealParams, 'organizationId'>; result: AcqDeal }
+  getDealByEmail: { params: { email: string }; result: AcqDeal | null }
+  getDealByEnvelopeId: { params: { envelopeId: string }; result: AcqDeal | null }
+  updateDealEnvelopeId: { params: { dealId: string; envelopeId: string }; result: AcqDeal | null }
+  getDealById: { params: Omit<GetDealByIdParams, 'organizationId'>; result: AcqDeal | null }
+  getContactById: { params: Omit<GetContactByIdParams, 'organizationId'>; result: AcqContact | null }
+  getCompanyById: { params: Omit<GetCompanyByIdParams, 'organizationId'>; result: AcqCompany | null }
+  // Deal-sync operations
+  updateDiscoveryData: { params: Omit<UpdateDiscoveryDataParams, 'organizationId'>; result: void }
+  updateProposalData: { params: Omit<UpdateProposalDataParams, 'organizationId'>; result: void }
+  markProposalSent: { params: Omit<MarkProposalSentParams, 'organizationId'>; result: void }
+  markProposalReviewed: { params: Omit<MarkProposalReviewedParams, 'organizationId'>; result: void }
+  updateCloseLostReason: { params: Omit<UpdateCloseLostReasonParams, 'organizationId'>; result: void }
+  updateFees: { params: Omit<UpdateFeesParams, 'organizationId'>; result: void }
+  syncDealStage: { params: Omit<SyncDealStageParams, 'organizationId'>; result: void }
+  setContactNurture: { params: Omit<SetContactNurtureParams, 'organizationId'>; result: void }
+  cancelSchedulesAndHitlByEmail: {
+    params: Omit<CancelSchedulesAndHitlByEmailParams, 'organizationId'>
+    result: { schedulesCancelled: number; hitlDeleted: number }
+  }
+  cancelHitlByDealId: { params: Omit<CancelHitlByDealIdParams, 'organizationId'>; result: { hitlDeleted: number } }
+  clearDealFields: { params: Omit<ClearDealFieldsParams, 'organizationId'>; result: void }
+  deleteDeal: { params: Omit<DeleteDealParams, 'organizationId'>; result: void }
+  recordDealActivity: {
+    params: Omit<RecordDealActivityParams, 'organizationId'>
+    result: void
+  }
+  // Deal note operations
+  createDealNote: {
+    params: Omit<CreateDealNoteParams, 'organizationId'>
+    result: AcqDealNote
+  }
+  listDealNotes: {
+    params: Omit<ListDealNotesParams, 'organizationId'>
+    result: AcqDealNote[]
+  }
+  // Deal task operations
+  createDealTask: {
+    params: Omit<CreateDealTaskParams, 'organizationId'>
+    result: AcqDealTask
+  }
+  listDealTasks: {
+    params: Omit<ListDealTasksParams, 'organizationId'>
+    result: AcqDealTask[]
+  }
+  listDealTasksDue: {
+    params: Omit<ListDealTasksDueParams, 'organizationId'>
+    result: AcqDealTask[]
+  }
+  completeDealTask: {
+    params: Omit<CompleteDealTaskParams, 'organizationId'>
+    result: AcqDealTask
+  }
+  // Deal query & analytics operations
+  listDeals: { params: DealFilters; result: AcqDeal[] }
+  getDealPipelineAnalytics: { params: { recentLimit?: number }; result: DealPipelineAnalytics }
+  // Enrichment data operations
+  mergeEnrichmentData: {
+    params: { id: string; table: 'acq_companies' | 'acq_contacts'; data: Record<string, unknown> }
+    result: void
+  }
+  // Social monitoring operations
+  upsertSocialPosts: {
+    params: { posts: Omit<UpsertSocialPostParams, 'organizationId'>[] }
+    result: UpsertSocialPostsResult
+  }
+}
+
+// ---------------------------------------------------------------------------
+// List (platform tool, 4 methods)
+// ---------------------------------------------------------------------------
+
+export type ListToolMap = {
+  getConfig: { params: { listId: string }; result: ListConfig }
+  recordExecution: {
+    params: Omit<RecordListExecutionParams, 'organizationId'>
+    result: void
+  }
+  updateCompanyStage: {
+    params: Omit<UpdateCompanyStageParams, 'organizationId'>
+    result: void
+  }
+  updateContactStage: {
+    params: Omit<UpdateContactStageParams, 'organizationId'>
+    result: void
+  }
+}
+
+// ---------------------------------------------------------------------------
+// PDF (platform tool, 2 methods)
+// ---------------------------------------------------------------------------
+
+export type PdfToolMap = {
+  render: {
+    params: {
+      document: Record<string, unknown>
+      theme?: Record<string, unknown>
+      storage: { bucket: string; path: string }
+    }
+    result: { success: boolean; pdfUrl: string; size: number }
+  }
+  renderToBuffer: {
+    params: {
+      document: Record<string, unknown>
+      theme?: Record<string, unknown>
+    }
+    result: { buffer: string }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Approval (platform tool, 2 methods)
+// ---------------------------------------------------------------------------
+
+export type ApprovalToolMap = {
+  create: {
+    params: {
+      actions: Array<{
+        id: string
+        label: string
+        type: 'primary' | 'secondary' | 'danger' | 'outline'
+        icon?: string
+        color?: string
+        target?: { resourceType: 'agent' | 'workflow'; resourceId: string; sessionId?: string }
+        form?: Record<string, unknown>
+        requiresConfirmation?: boolean
+        confirmationMessage?: string
+        description?: string
+      }>
+      context: Record<string, unknown>
+      description?: string
+      priority?: number
+      humanCheckpoint?: string
+      metadata?: Record<string, unknown>
+      expiresAt?: string
+      idempotencyKey?: string
+    }
+    result: { id: string }
+  }
+  deleteByMetadata: {
+    params: { metadata: Record<string, unknown>; status?: string }
+    result: { deleted: number }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Execution (platform tool, 1 method)
+// ---------------------------------------------------------------------------
+
+export type ExecutionToolMap = {
+  trigger: {
+    params: { resourceId: string; input?: unknown }
+    result: { success: boolean; executionId: string; output: unknown; error?: string }
+  }
+  triggerAsync: {
+    params: { resourceId: string; input?: unknown }
+    result: { executionId: string }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Email (platform tool, 1 method)
+// ---------------------------------------------------------------------------
+
+export type EmailToolMap = {
+  send: {
+    params: {
+      subject: string
+      html?: string
+      text?: string
+      replyTo?: string
+      tags?: Array<{ name: string; value: string }>
+    } & (
+      | { userIds: string[]; targetRole?: never; targetAll?: never }
+      | { targetRole: string; userIds?: never; targetAll?: never }
+      | { targetAll: true; userIds?: never; targetRole?: never }
+    )
+    result: { sent: number; failed: number; errors?: Array<{ userId: string; email: string; error: string }> }
+  }
+}