@elevasis/sdk 1.52.1 → 1.54.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1528,16 +1528,17 @@ interface FormSchema {
1528
1528
 
1529
1529
  /**
1530
1530
  * Execution interface configuration
1531
- * Defines how a resource is executed via the UI (forms, scheduling, webhooks)
1531
+ * Defines how a resource is executed via the UI (the run form)
1532
1532
  * Applies to both agents and workflows
1533
+ *
1534
+ * It carried two more optional fields, `schedule?: ScheduleConfig` and `webhook?: WebhookConfig`.
1535
+ * Nothing ever set or read either one, in this repo or in any tenant project, and the two config
1536
+ * interfaces behind them had no other reference. Real scheduling is the `task_schedules` system
1537
+ * (`execution/scheduler/`), which is not driven off a resource's run form.
1533
1538
  */
1534
1539
  interface ExecutionInterface {
1535
1540
  /** Form configuration for execution inputs */
1536
1541
  form: ExecutionFormSchema;
1537
- /** Optional: Schedule configuration */
1538
- schedule?: ScheduleConfig;
1539
- /** Optional: Webhook trigger configuration */
1540
- webhook?: WebhookConfig;
1541
1542
  }
1542
1543
  /**
1543
1544
  * Execution form schema
@@ -1560,26 +1561,6 @@ interface ExecutionFormSchema extends FormSchema {
1560
1561
  confirmMessage?: string;
1561
1562
  };
1562
1563
  }
1563
- /**
1564
- * Schedule configuration for automated execution
1565
- */
1566
- interface ScheduleConfig {
1567
- /** Whether scheduling is enabled for this resource */
1568
- enabled: boolean;
1569
- /** Default schedule (cron expression) */
1570
- defaultSchedule?: string;
1571
- /** Allowed schedule patterns (if restricted) */
1572
- allowedPatterns?: string[];
1573
- }
1574
- /**
1575
- * Webhook configuration for external triggers
1576
- */
1577
- interface WebhookConfig {
1578
- /** Whether webhook trigger is enabled */
1579
- enabled: boolean;
1580
- /** Expected payload schema (for documentation) */
1581
- payloadSchema?: unknown;
1582
- }
1583
1564
 
1584
1565
  interface WorkflowConfig extends ResourceDefinition {
1585
1566
  type: 'workflow';
@@ -7016,6 +6997,46 @@ interface UpdateContactStageParams {
7016
6997
  data?: unknown;
7017
6998
  executionId?: string;
7018
6999
  }
7000
+ /** One company's stage update within a `bulkUpdateCompanyStage` batch. */
7001
+ interface BulkCompanyStageUpdate {
7002
+ companyId: string;
7003
+ stage: string;
7004
+ status?: ProcessingStageStatus;
7005
+ data?: unknown;
7006
+ }
7007
+ interface BulkUpdateCompanyStageParams {
7008
+ organizationId: string;
7009
+ listId: string;
7010
+ updates: BulkCompanyStageUpdate[];
7011
+ executionId?: string;
7012
+ }
7013
+ interface BulkUpdateCompanyStageResult {
7014
+ updated: number;
7015
+ errors: Array<{
7016
+ companyId: string;
7017
+ error: string;
7018
+ }>;
7019
+ }
7020
+ /** One contact's stage update within a `bulkUpdateContactStage` batch. */
7021
+ interface BulkContactStageUpdate {
7022
+ contactId: string;
7023
+ stage: string;
7024
+ status?: ProcessingStageStatus;
7025
+ data?: unknown;
7026
+ }
7027
+ interface BulkUpdateContactStageParams {
7028
+ organizationId: string;
7029
+ listId: string;
7030
+ updates: BulkContactStageUpdate[];
7031
+ executionId?: string;
7032
+ }
7033
+ interface BulkUpdateContactStageResult {
7034
+ updated: number;
7035
+ errors: Array<{
7036
+ contactId: string;
7037
+ error: string;
7038
+ }>;
7039
+ }
7019
7040
  interface ClearCompanyStagesParams {
7020
7041
  organizationId: string;
7021
7042
  listId: string;
@@ -11591,9 +11612,9 @@ declare const ProjectSchemas: {
11591
11612
  bug: "bug";
11592
11613
  }>>;
11593
11614
  status: z.ZodOptional<z.ZodEnum<{
11615
+ rejected: "rejected";
11594
11616
  completed: "completed";
11595
11617
  cancelled: "cancelled";
11596
- rejected: "rejected";
11597
11618
  blocked: "blocked";
11598
11619
  in_progress: "in_progress";
11599
11620
  planned: "planned";
@@ -11627,9 +11648,9 @@ declare const ProjectSchemas: {
11627
11648
  bug: "bug";
11628
11649
  }>>;
11629
11650
  status: z.ZodOptional<z.ZodEnum<{
11651
+ rejected: "rejected";
11630
11652
  completed: "completed";
11631
11653
  cancelled: "cancelled";
11632
- rejected: "rejected";
11633
11654
  blocked: "blocked";
11634
11655
  in_progress: "in_progress";
11635
11656
  planned: "planned";
@@ -11654,9 +11675,9 @@ declare const ProjectSchemas: {
11654
11675
  MergeResumeContextRequest: z.ZodRecord<z.ZodString, z.ZodUnknown>;
11655
11676
  GetTasksQuery: z.ZodObject<{
11656
11677
  status: z.ZodOptional<z.ZodEnum<{
11678
+ rejected: "rejected";
11657
11679
  completed: "completed";
11658
11680
  cancelled: "cancelled";
11659
- rejected: "rejected";
11660
11681
  blocked: "blocked";
11661
11682
  in_progress: "in_progress";
11662
11683
  planned: "planned";
@@ -13386,6 +13407,14 @@ type ListToolMap = {
13386
13407
  params: Omit<UpdateContactStageParams, 'organizationId'>;
13387
13408
  result: void;
13388
13409
  };
13410
+ bulkUpdateCompanyStage: {
13411
+ params: Omit<BulkUpdateCompanyStageParams, 'organizationId'>;
13412
+ result: BulkUpdateCompanyStageResult;
13413
+ };
13414
+ bulkUpdateContactStage: {
13415
+ params: Omit<BulkUpdateContactStageParams, 'organizationId'>;
13416
+ result: BulkUpdateContactStageResult;
13417
+ };
13389
13418
  clearCompanyStages: {
13390
13419
  params: Omit<ClearCompanyStagesParams, 'organizationId'>;
13391
13420
  result: void;
@@ -15459,9 +15488,43 @@ interface ElevasConfig {
15459
15488
 
15460
15489
  declare function defineContract<TContract extends Contract>(contract: TContract): TContract;
15461
15490
 
15462
- declare function defineStep<TStep extends WorkflowStep>(step: TStep): TStep;
15463
-
15464
- declare function defineWorkflow<TWorkflow extends WorkflowDefinition>(workflow: TWorkflow): TWorkflow;
15491
+ /**
15492
+ * The single step of a `defineSingleStepWorkflow` workflow. `handler` receives the
15493
+ * already-validated input (per `inputSchema`) rather than `unknown` -- the ceremony of
15494
+ * casting `rawInput as z.infer<typeof input>` inside every handler body is absorbed once
15495
+ * by the factory instead of being repeated at every call site.
15496
+ */
15497
+ interface SingleStepWorkflowStep<TInput, TOutput> {
15498
+ id: string;
15499
+ name: string;
15500
+ description: string;
15501
+ handler: (input: TInput, context: ExecutionContext) => Promise<TOutput>;
15502
+ }
15503
+ interface DefineSingleStepWorkflowOptions<TInput, TOutput> {
15504
+ /** Workflow-level identity and metadata -- same shape as a hand-written `WorkflowDefinition['config']`. */
15505
+ config: WorkflowConfig;
15506
+ /** Shared schema for the workflow contract AND the single step -- a single-step workflow validates the same input/output twice today, and this keeps that byte-identical. */
15507
+ inputSchema: z.ZodType<TInput>;
15508
+ outputSchema: z.ZodType<TOutput>;
15509
+ step: SingleStepWorkflowStep<TInput, TOutput>;
15510
+ /** Optional metrics configuration for ROI calculations. */
15511
+ metricsConfig?: ResourceMetricsConfig;
15512
+ /** Optional execution interface configuration (surfaces the workflow in the Execution Runner UI). */
15513
+ interface?: ExecutionInterface;
15514
+ /** Optional lead-gen processing stage this workflow implements. */
15515
+ stageImplemented?: string;
15516
+ }
15517
+ /**
15518
+ * Builds a `WorkflowDefinition` for a workflow with exactly one step -- the step's
15519
+ * `inputSchema`/`outputSchema` are the workflow contract's schemas, `entryPoint` is the
15520
+ * step's `id`, and `next` is always `null` (there is nowhere else for a single step to go).
15521
+ *
15522
+ * Produces a `WorkflowDefinition` structurally identical to the hand-written
15523
+ * `steps`-plus-`entryPoint` form -- same `resourceId`, `config`, `contract`, `steps` map,
15524
+ * and `entryPoint` -- for the ~18 lines of ceremony that shape pays on every single-step
15525
+ * workflow today.
15526
+ */
15527
+ declare function defineSingleStepWorkflow<TInput, TOutput>(options: DefineSingleStepWorkflowOptions<TInput, TOutput>): WorkflowDefinition;
15465
15528
 
15466
15529
  type ContractRegistry = Record<string, Record<string, unknown>>;
15467
15530
  type ContractRefResolutionErrorCode = 'contract-ref-unknown-module' | 'contract-ref-unknown-export' | 'contract-ref-not-zod-type';
@@ -15630,5 +15693,5 @@ declare function defineWorkflowConfig<const TResourceId extends string>(resource
15630
15693
  declare const ListBuilderStageKeySchema: z.ZodString;
15631
15694
  type ListBuilderStageKey = z.infer<typeof ListBuilderStageKeySchema>;
15632
15695
 
15633
- export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineStep, defineTopology, defineTopologyRelationship, defineWorkflow, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, projectDeploymentSpec, projectTopologyRelationships, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, toSdkResourceDescriptor, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors };
15634
- export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqDealRow, AcqList, Action, ActionDef, ActivityEvent, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, AgentResourceDescriptorResolver, FindCompanyEmailParams as AnymailfinderFindCompanyEmailParams, FindCompanyEmailResult as AnymailfinderFindCompanyEmailResult, FindDecisionMakerEmailParams as AnymailfinderFindDecisionMakerEmailParams, FindDecisionMakerEmailResult as AnymailfinderFindDecisionMakerEmailResult, FindPersonEmailParams as AnymailfinderFindPersonEmailParams, FindPersonEmailResult as AnymailfinderFindPersonEmailResult, AnymailfinderToolMap, VerifyEmailParams as AnymailfinderVerifyEmailParams, VerifyEmailResult as AnymailfinderVerifyEmailResult, ApifyToolMap, ApifyWebhookConfig, AppendRowsParams, AppendRowsResult, ApprovalToolMap, ArtifactsToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BuildPlanSnapshotStep, BulkDeleteLeadsParams, BulkDeleteLeadsResult, BulkImportParams, BulkImportResult, BusinessOntologyValidationIndex, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, ClickUpToolMap, CompanyFilters, ConcurrentPoolOptions, ConcurrentPoolResult, ConditionalNext, ContactFilters, ContentToolMap, Contract, ContractRefResolutionErrorCode, ContractRegistry, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, CrmStageKey, CrmStateKey, CrmToolMap, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DeploymentSpec, DiagnosticOutput, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetDailyCampaignAnalyticsParams, GetDailyCampaignAnalyticsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, HumanCheckpointDefinition, InstagramToolMap, InstantlyToolMap, IntegrationDefinition, IntegrationResourceDescriptorResolver, JsonSchema, LLMAdapterFactory, LLMContentPart, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadGenStageValidators, LeadToolMap, LinearNext, ListAttributesParams, ListAttributesResult, ListBuilderStageKey, ListBuilderStep, ListLeadsParams, ListLeadsResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, ListToolMap, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, MillionVerifierToolMap, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, OrganizationModel, OrganizationModelAgentResourceEntry, OrganizationModelIntegrationResourceEntry, OrganizationModelResourceEntry, OrganizationModelResourceOntologyBinding, OrganizationModelTopology, OrganizationModelTopologyNodeRef, OrganizationModelTopologyRelationship, OrganizationModelWorkflowResourceEntry, PaginatedResult, PaginationParams, PdfToolMap, ProcessingStageStatus, ProjectDeploymentSpecOptions, ProjectsToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, ReadinessProfileEntry, ReadinessProfileKind, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResolvedContractRef, ResourceCategory, ResourceDefinition, ResourceLink, ResourceMetricsConfig, ResourceOntologyBindingResolver, ResourceRelationships, ResourceStatus$1 as ResourceStatus, ResourceType, RunActorParams, RunActorResult, SDKLLMGenerateParams, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SortCriteria, StartActorParams, StartActorResult, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, SystemApiInterfaceReadinessContract, TaskSchedule, TaskScheduleConfig, TombaToolMap, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TransitionItemParams, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, UpdatePaymentLinkParams, UpdatePaymentLinkResult, UpdateProposalDataParams, UpdateRecordParams, UpdateRecordResult, UpdateRowByValueParams, UpdateRowByValueResult, UploadFileParams, UploadFileResult, UpsertCompanyParams, UpsertContactParams, UpsertDealParams, UpsertRowParams, UpsertRowResult, VoidEnvelopeParams, VoidEnvelopeResult, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowConfigActionRegistry, WorkflowDefinition, WorkflowLogger, WorkflowResourceDescriptorMap, WorkflowResourceDescriptorResolver, WorkflowStep, WriteSheetParams, WriteSheetResult };
15696
+ export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineSingleStepWorkflow, defineTopology, defineTopologyRelationship, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, projectDeploymentSpec, projectTopologyRelationships, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, toSdkResourceDescriptor, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors };
15697
+ export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqDealRow, AcqList, Action, ActionDef, ActivityEvent, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, AgentResourceDescriptorResolver, FindCompanyEmailParams as AnymailfinderFindCompanyEmailParams, FindCompanyEmailResult as AnymailfinderFindCompanyEmailResult, FindDecisionMakerEmailParams as AnymailfinderFindDecisionMakerEmailParams, FindDecisionMakerEmailResult as AnymailfinderFindDecisionMakerEmailResult, FindPersonEmailParams as AnymailfinderFindPersonEmailParams, FindPersonEmailResult as AnymailfinderFindPersonEmailResult, AnymailfinderToolMap, VerifyEmailParams as AnymailfinderVerifyEmailParams, VerifyEmailResult as AnymailfinderVerifyEmailResult, ApifyToolMap, ApifyWebhookConfig, AppendRowsParams, AppendRowsResult, ApprovalToolMap, ArtifactsToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BuildPlanSnapshotStep, BulkDeleteLeadsParams, BulkDeleteLeadsResult, BulkImportParams, BulkImportResult, BusinessOntologyValidationIndex, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, ClickUpToolMap, CompanyFilters, ConcurrentPoolOptions, ConcurrentPoolResult, ConditionalNext, ContactFilters, ContentToolMap, Contract, ContractRefResolutionErrorCode, ContractRegistry, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, CrmStageKey, CrmStateKey, CrmToolMap, DefineSingleStepWorkflowOptions, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DeploymentSpec, DiagnosticOutput, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetDailyCampaignAnalyticsParams, GetDailyCampaignAnalyticsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, HumanCheckpointDefinition, InstagramToolMap, InstantlyToolMap, IntegrationDefinition, IntegrationResourceDescriptorResolver, JsonSchema, LLMAdapterFactory, LLMContentPart, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadGenStageValidators, LeadToolMap, LinearNext, ListAttributesParams, ListAttributesResult, ListBuilderStageKey, ListBuilderStep, ListLeadsParams, ListLeadsResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, ListToolMap, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, MillionVerifierToolMap, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, OrganizationModel, OrganizationModelAgentResourceEntry, OrganizationModelIntegrationResourceEntry, OrganizationModelResourceEntry, OrganizationModelResourceOntologyBinding, OrganizationModelTopology, OrganizationModelTopologyNodeRef, OrganizationModelTopologyRelationship, OrganizationModelWorkflowResourceEntry, PaginatedResult, PaginationParams, PdfToolMap, ProcessingStageStatus, ProjectDeploymentSpecOptions, ProjectsToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, ReadinessProfileEntry, ReadinessProfileKind, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResolvedContractRef, ResourceCategory, ResourceDefinition, ResourceLink, ResourceMetricsConfig, ResourceOntologyBindingResolver, ResourceRelationships, ResourceStatus$1 as ResourceStatus, ResourceType, RunActorParams, RunActorResult, SDKLLMGenerateParams, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SingleStepWorkflowStep, SortCriteria, StartActorParams, StartActorResult, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, SystemApiInterfaceReadinessContract, TaskSchedule, TaskScheduleConfig, TombaToolMap, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TransitionItemParams, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, UpdatePaymentLinkParams, UpdatePaymentLinkResult, UpdateProposalDataParams, UpdateRecordParams, UpdateRecordResult, UpdateRowByValueParams, UpdateRowByValueResult, UploadFileParams, UploadFileResult, UpsertCompanyParams, UpsertContactParams, UpsertDealParams, UpsertRowParams, UpsertRowResult, VoidEnvelopeParams, VoidEnvelopeResult, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowConfigActionRegistry, WorkflowDefinition, WorkflowLogger, WorkflowResourceDescriptorMap, WorkflowResourceDescriptorResolver, WorkflowStep, WriteSheetParams, WriteSheetResult };
package/dist/index.js CHANGED
@@ -1,2 +1,2 @@
1
- export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineStep, defineTopology, defineTopologyRelationship, defineWorkflow, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance } from './chunk-XC57JNMA.js';
2
- export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from './chunk-VYWGWJRW.js';
1
+ export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, compileBusinessOntologyValidationIndex, concurrentPool, createLeadGenStageValidators, defineContract, defineResource, defineResourceOntology, defineResources, defineSingleStepWorkflow, defineTopology, defineTopologyRelationship, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance } from './chunk-OT4CHFQJ.js';
2
+ export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from './chunk-QF2RNYYX.js';
@@ -1,4 +1,4 @@
1
- export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from '../chunk-VYWGWJRW.js';
1
+ export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from '../chunk-QF2RNYYX.js';
2
2
  import { readFileSync, mkdirSync, writeFileSync, readdirSync } from 'fs';
3
3
  import { relative, dirname, resolve, join, extname } from 'path';
4
4
  import { compile } from '@mdx-js/mdx';
@@ -1,6 +1,6 @@
1
- import { executeWorkflow } from '../chunk-T6DTAP2U.js';
2
- import { validateDeploymentSpec, validateRelationships } from '../chunk-XC57JNMA.js';
3
- import '../chunk-VYWGWJRW.js';
1
+ import { executeWorkflow } from '../chunk-ZAVFBZHM.js';
2
+ import { validateDeploymentSpec, validateRelationships } from '../chunk-OT4CHFQJ.js';
3
+ import '../chunk-QF2RNYYX.js';
4
4
  import { vi } from 'vitest';
5
5
 
6
6
  // src/test-utils/workflow.ts
@@ -252,6 +252,8 @@ var mockList = (overrides) => createMockAdapter(
252
252
  "recordExecution",
253
253
  "updateCompanyStage",
254
254
  "updateContactStage",
255
+ "bulkUpdateCompanyStage",
256
+ "bulkUpdateContactStage",
255
257
  "clearCompanyStages",
256
258
  "clearContactStages",
257
259
  "listPendingCompanyIds",
@@ -154,7 +154,7 @@ declare function createAttioAdapter(credential: string): TypedAdapter<AttioToolM
154
154
  * Create a typed Apify adapter bound to a specific credential.
155
155
  *
156
156
  * @param credential - Credential name as configured in the command center
157
- * @returns Object with 2 typed methods for Apify actor operations
157
+ * @returns Object with 3 typed methods for Apify actor operations
158
158
  */
159
159
  declare function createApifyAdapter(credential: string): TypedAdapter<ApifyToolMap>;
160
160
 
@@ -208,7 +208,7 @@ declare function createInstagramAdapter(credential: string): TypedAdapter<Instag
208
208
  * Create a typed Instantly adapter bound to a specific credential.
209
209
  *
210
210
  * @param credential - Credential name as configured in the command center
211
- * @returns Object with 16 typed methods for Instantly email outreach operations
211
+ * @returns Object with 21 typed methods for Instantly email outreach operations
212
212
  */
213
213
  declare function createInstantlyAdapter(credential: string): TypedAdapter<InstantlyToolMap>;
214
214
 
@@ -1,3 +1,3 @@
1
- export { ListBuilderResultSchema, ListBuilderResultsSchema, PlatformToolError, acqDb, approval, artifacts, classifyPlatformToolError, content, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createCaptionGenerationWorkflow, createCaptureInstagramMetricsWorkflow, createClickUpAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createImageAnalysisWorkflow, createInstagramAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createPublishInstagramWorkflow, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, crm, email, executeWorkflow, execution, generateHmacToken, list, listBuilderWorkflow, llm, notifications, pdf, platform, projects, scheduler, startWorker, storage, toContentMetrics } from '../chunk-T6DTAP2U.js';
2
- import '../chunk-XC57JNMA.js';
3
- import '../chunk-VYWGWJRW.js';
1
+ export { ListBuilderResultSchema, ListBuilderResultsSchema, PlatformToolError, acqDb, approval, artifacts, classifyPlatformToolError, content, createAdapter, createAnymailfinderAdapter, createApifyAdapter, createAttioAdapter, createCaptionGenerationWorkflow, createCaptureInstagramMetricsWorkflow, createClickUpAdapter, createDropboxAdapter, createGmailAdapter, createGoogleSheetsAdapter, createImageAnalysisWorkflow, createInstagramAdapter, createInstantlyAdapter, createMillionVerifierAdapter, createPublishInstagramWorkflow, createResendAdapter, createSignatureApiAdapter, createStripeAdapter, createTombaAdapter, crm, email, executeWorkflow, execution, generateHmacToken, list, listBuilderWorkflow, llm, notifications, pdf, platform, projects, scheduler, startWorker, storage, toContentMetrics } from '../chunk-ZAVFBZHM.js';
2
+ import '../chunk-OT4CHFQJ.js';
3
+ import '../chunk-QF2RNYYX.js';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@elevasis/sdk",
3
- "version": "1.52.1",
3
+ "version": "1.54.0",
4
4
  "description": "SDK for building Elevasis organization resources",
5
5
  "type": "module",
6
6
  "bin": {
@@ -37,6 +37,7 @@
37
37
  "reference/"
38
38
  ],
39
39
  "dependencies": {
40
+ "@alcyone-labs/zod-to-json-schema": "^4.0.10",
40
41
  "@mdx-js/mdx": "^3.1.1",
41
42
  "esbuild": "^0.25.0",
42
43
  "remark-gfm": "^4.0.1"
@@ -54,8 +55,7 @@
54
55
  "@types/node": "^22.0.0",
55
56
  "chalk": "^5.3.0",
56
57
  "commander": "^11.0.0",
57
- "dotenv": "^16.0.0",
58
- "gray-matter": "^4.0.3",
58
+ "dotenv": "^17.2.3",
59
59
  "ora": "^7.0.1",
60
60
  "rollup": "^4.59.0",
61
61
  "rollup-plugin-dts": "^6.3.0",
@@ -63,15 +63,23 @@
63
63
  "typescript": "5.9.2",
64
64
  "vitest": "^3.2.4",
65
65
  "zod": "^4.1.0",
66
- "@repo/core": "0.69.0",
67
- "@repo/eslint-config": "0.0.0",
68
- "@repo/typescript-config": "0.0.0"
66
+ "@repo/core": "0.70.0",
67
+ "@repo/typescript-config": "0.0.0",
68
+ "@repo/eslint-config": "0.0.0"
69
+ },
70
+ "license": "MIT",
71
+ "engines": {
72
+ "node": ">=22"
73
+ },
74
+ "repository": {
75
+ "type": "git",
76
+ "url": "git+https://github.com/Elevasis/elevasis-monorepo.git",
77
+ "directory": "packages/sdk"
69
78
  },
70
79
  "scripts": {
71
80
  "lint": "eslint src --max-warnings 0",
72
81
  "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.core-dts.json && tsc -p tsconfig.build.json && tsup && rollup -c rollup.dts.config.mjs && esbuild src/cli/index.ts --bundle --platform=node --outfile=dist/cli.cjs --format=cjs --external:esbuild --banner:js=\"#!/usr/bin/env node\" && node scripts/verify-skill-coverage.mjs && node scripts/copy-reference-docs.mjs && node ../../scripts/monorepo/generate-reference-artifacts.js",
73
- "type-check": "tsc --noEmit",
74
- "check-types": "pnpm type-check",
82
+ "check-types": "tsc --noEmit",
75
83
  "test": "pnpm test:bundle",
76
84
  "test:source": "vitest run --config vitest.config.ts",
77
85
  "test:dist": "pnpm build && node ../../scripts/monorepo/validate-reference-artifacts.js && vitest run --config vitest.bundle.config.ts",
@@ -283,7 +283,7 @@ Docs-site pages indexed: 38.
283
283
  | CLI Management Commands | `sdk/cli-management.mdx` | elevasis-sdk management commands -- project, note, acquisition, client, agent, session, queue, schedule, om, ui, skill, content, and grant subcommand families |
284
284
  | CLI Reference | `sdk/cli.mdx` | Core elevasis-sdk CLI commands -- validate, deploy, execute, inspect resources, manage credentials, rename, and enumerate the command catalog |
285
285
  | Concepts Reference | `sdk/concepts.mdx` | Plain-English explanations of Elevasis SDK concepts -- glossary, workflow analogies, Zod schemas, execution model, platform tools, and design decisions |
286
- | When to Reach for the define* Builders | `sdk/define-builders.mdx` | defineWorkflow, defineStep, defineContract, defineResource, and defineTopology exist for two different reasons -- this page teaches which reason applies before you pick a builder over a plain object literal. |
286
+ | When to Reach for the define* Builders | `sdk/define-builders.mdx` | defineSingleStepWorkflow, defineContract, defineResource, and defineTopology exist for three different reasons -- this page teaches which reason applies before you pick a builder over a plain object literal. |
287
287
  | Command Center | `sdk/deployment/command-center.mdx` | Post-deployment UI reference -- what each page does, the resource graph model, relationships, validation, and how SDK concepts map to Command Center actions |
288
288
  | Execution Reference | `sdk/deployment/execution-reference.mdx` | REST endpoints for executing resources, querying execution history, and managing deployments; plus React UI components and hooks for triggering executions from custom pages via @elevasis/ui |
289
289
  | Deploying Resources | `sdk/deployment/index.mdx` | How to deploy your Elevasis SDK resources to the platform using elevasis-sdk deploy, including configuration, validation, and environment setup |
@@ -56,6 +56,18 @@ Deploy accepts `--major`, `--minor`, `--patch` flags to bump the deployment vers
56
56
  1. **Bundle:** esbuild compiles `operations/src/index.ts` + all dependencies into a single self-contained CJS file. No `node_modules` needed at runtime.
57
57
  2. **Metadata:** Resource definitions, OM Resources descriptor bindings, Zod schemas (converted to JSON Schema), relationships, triggers.
58
58
 
59
+ ## The OM Descriptor Owns Display Identity
60
+
61
+ A resource's `name` and `description` in its `operations/src/**` config are **not** what the platform shows. At deploy time the projected spec takes `title` and `description` from that resource's OM descriptor in `core/config/organization-model.ts` and overrides the locally declared strings, because the descriptor is what Command Center's action surfaces render and a config string only ever reached the execution log.
62
+
63
+ Deploy warns per resource when the two disagree:
64
+
65
+ ```text
66
+ [deployment-spec] "<resource-id>" name disagrees with its OM descriptor -- using the OM title.
67
+ ```
68
+
69
+ That warning does not fail the deploy. Fix it by editing the OM descriptor when the descriptor is wrong, or the config when the config is. Editing only the config and redeploying changes nothing a user sees.
70
+
59
71
  ## Environment
60
72
 
61
73
  - `ELEVASIS_PLATFORM_KEY` in `.env` is required for CLI auth (used for every deploy unless `NODE_ENV=development` with no `--prod`)