@elevasis/sdk 1.53.0 → 1.55.0

package/dist/index.d.ts

@@ -1528,16 +1528,17 @@ interface FormSchema {
 
 /**
  * Execution interface configuration
- * Defines how a resource is executed via the UI (forms, scheduling, webhooks)
+ * Defines how a resource is executed via the UI (the run form)
  * Applies to both agents and workflows
+ *
+ * It carried two more optional fields, `schedule?: ScheduleConfig` and `webhook?: WebhookConfig`.
+ * Nothing ever set or read either one, in this repo or in any tenant project, and the two config
+ * interfaces behind them had no other reference. Real scheduling is the `task_schedules` system
+ * (`execution/scheduler/`), which is not driven off a resource's run form.
  */
 interface ExecutionInterface {
     /** Form configuration for execution inputs */
     form: ExecutionFormSchema;
-    /** Optional: Schedule configuration */
-    schedule?: ScheduleConfig;
-    /** Optional: Webhook trigger configuration */
-    webhook?: WebhookConfig;
 }
 /**
  * Execution form schema
@@ -1560,26 +1561,6 @@ interface ExecutionFormSchema extends FormSchema {
         confirmMessage?: string;
     };
 }
-/**
- * Schedule configuration for automated execution
- */
-interface ScheduleConfig {
-    /** Whether scheduling is enabled for this resource */
-    enabled: boolean;
-    /** Default schedule (cron expression) */
-    defaultSchedule?: string;
-    /** Allowed schedule patterns (if restricted) */
-    allowedPatterns?: string[];
-}
-/**
- * Webhook configuration for external triggers
- */
-interface WebhookConfig {
-    /** Whether webhook trigger is enabled */
-    enabled: boolean;
-    /** Expected payload schema (for documentation) */
-    payloadSchema?: unknown;
-}
 
 interface WorkflowConfig extends ResourceDefinition {
     type: 'workflow';
@@ -1610,6 +1591,16 @@ interface WorkflowStep extends WorkflowStepDefinition {
     inputSchema: z.ZodSchema;
     outputSchema: z.ZodSchema;
     next: NextConfig;
+    /**
+     * How long this one step may run, in milliseconds. Omitted, the step is bounded only by the
+     * execution ceiling (`DEFAULT_EXECUTION_TIMEOUT`, 2 hours), which is what every step used to get.
+     *
+     * `WorkflowConfig` deliberately still has no `constraints` field: a per-workflow override would
+     * only restate the execution ceiling the caller already sets when it arms the deadline, whereas
+     * "this HTTP step should never take more than 5 seconds" is a property of the step and has no
+     * other place to live.
+     */
+    timeout?: number;
 }
 interface WorkflowDefinition {
     config: WorkflowConfig;
@@ -4406,13 +4397,6 @@ type Database = {
                         referencedRelation: "users";
                         referencedColumns: ["id"];
                     },
-                    {
-                        foreignKeyName: "prj_notes_milestone_id_fkey";
-                        columns: ["milestone_id"];
-                        isOneToOne: false;
-                        referencedRelation: "prj_milestones";
-                        referencedColumns: ["id"];
-                    },
                     {
                         foreignKeyName: "prj_notes_organization_id_fkey";
                         columns: ["organization_id"];
@@ -4426,13 +4410,6 @@ type Database = {
                         isOneToOne: false;
                         referencedRelation: "prj_projects";
                         referencedColumns: ["id"];
-                    },
-                    {
-                        foreignKeyName: "prj_notes_task_id_fkey";
-                        columns: ["task_id"];
-                        isOneToOne: false;
-                        referencedRelation: "prj_tasks";
-                        referencedColumns: ["id"];
                     }
                 ];
             };
@@ -6356,8 +6333,20 @@ interface ProcessingStateEntry {
 type ProcessingState = Partial<Record<LeadGenStageKey, ProcessingStateEntry>>;
 type CompanyProcessingState = ProcessingState;
 type ContactProcessingState = ProcessingState;
-/** @deprecated Use `processingState`. Retained only as a compile-time/read-shape bridge for external tenants. */
-type LegacyPipelineStatus = unknown;
+/**
+ * @deprecated Use `processingState`. Retained only as a compile-time/read-shape bridge for
+ * external tenants.
+ *
+ * `null`, not `unknown`. The DB column is gone and every response returns null, so `unknown` was
+ * describing a value that cannot occur -- it forced a narrow on a field that is always null while
+ * still type-checking a comparison against a stage name that can never match. Narrowing it turns
+ * that dead comparison into a compile error pointing at `processingState`, which is the migration.
+ *
+ * The WRITE path stays permissive on purpose: the update request schemas keep
+ * `pipelineStatus: z.unknown().optional()` so a tenant still sending the old field gets a no-op
+ * rather than a rejected request.
+ */
+type LegacyPipelineStatus = null;
 /**
  * Enrichment data collected for a company from various sources.
  */
@@ -7016,6 +7005,46 @@ interface UpdateContactStageParams {
     data?: unknown;
     executionId?: string;
 }
+/** One company's stage update within a `bulkUpdateCompanyStage` batch. */
+interface BulkCompanyStageUpdate {
+    companyId: string;
+    stage: string;
+    status?: ProcessingStageStatus;
+    data?: unknown;
+}
+interface BulkUpdateCompanyStageParams {
+    organizationId: string;
+    listId: string;
+    updates: BulkCompanyStageUpdate[];
+    executionId?: string;
+}
+interface BulkUpdateCompanyStageResult {
+    updated: number;
+    errors: Array<{
+        companyId: string;
+        error: string;
+    }>;
+}
+/** One contact's stage update within a `bulkUpdateContactStage` batch. */
+interface BulkContactStageUpdate {
+    contactId: string;
+    stage: string;
+    status?: ProcessingStageStatus;
+    data?: unknown;
+}
+interface BulkUpdateContactStageParams {
+    organizationId: string;
+    listId: string;
+    updates: BulkContactStageUpdate[];
+    executionId?: string;
+}
+interface BulkUpdateContactStageResult {
+    updated: number;
+    errors: Array<{
+        contactId: string;
+        error: string;
+    }>;
+}
 interface ClearCompanyStagesParams {
     organizationId: string;
     listId: string;
@@ -11591,9 +11620,9 @@ declare const ProjectSchemas: {
             bug: "bug";
         }>>;
         status: z.ZodOptional<z.ZodEnum<{
+            rejected: "rejected";
             completed: "completed";
             cancelled: "cancelled";
-            rejected: "rejected";
             blocked: "blocked";
             in_progress: "in_progress";
             planned: "planned";
@@ -11627,9 +11656,9 @@ declare const ProjectSchemas: {
             bug: "bug";
         }>>;
         status: z.ZodOptional<z.ZodEnum<{
+            rejected: "rejected";
             completed: "completed";
             cancelled: "cancelled";
-            rejected: "rejected";
             blocked: "blocked";
             in_progress: "in_progress";
             planned: "planned";
@@ -11654,9 +11683,9 @@ declare const ProjectSchemas: {
     MergeResumeContextRequest: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     GetTasksQuery: z.ZodObject<{
         status: z.ZodOptional<z.ZodEnum<{
+            rejected: "rejected";
             completed: "completed";
             cancelled: "cancelled";
-            rejected: "rejected";
             blocked: "blocked";
             in_progress: "in_progress";
             planned: "planned";
@@ -13386,6 +13415,14 @@ type ListToolMap = {
         params: Omit<UpdateContactStageParams, 'organizationId'>;
         result: void;
     };
+    bulkUpdateCompanyStage: {
+        params: Omit<BulkUpdateCompanyStageParams, 'organizationId'>;
+        result: BulkUpdateCompanyStageResult;
+    };
+    bulkUpdateContactStage: {
+        params: Omit<BulkUpdateContactStageParams, 'organizationId'>;
+        result: BulkUpdateContactStageResult;
+    };
     clearCompanyStages: {
         params: Omit<ClearCompanyStagesParams, 'organizationId'>;
         result: void;
@@ -14237,6 +14274,28 @@ interface AgentConstraints {
     timeout?: number;
     maxSessionMemoryKeys?: number;
     maxMemoryTokens?: number;
+    /**
+     * Spend ceilings for the whole turn, checked between iterations against
+     * `ExecutionContext.aiUsageCollector`. Both are unset by default -- `maxIterations` and `timeout`
+     * bound how MANY calls and how LONG, but nothing bounded how much those calls cost, so an agent
+     * that picked an expensive model or a huge context could spend without limit inside a budget it
+     * was technically respecting.
+     *
+     * Enforced only where a collector is injected (every coordinator-run execution). An agent run
+     * without one is unbounded, the same as one that declares no ceiling.
+     *
+     * Note that **sync nested executions share the parent's collector**, so these ceilings cover the
+     * agent and everything it invokes synchronously. That is the behaviour a spend ceiling should
+     * have, but it does mean a parent's ceiling can be reached by a child's spend.
+     */
+    maxCostUsd?: number;
+    maxTotalTokens?: number;
+    /**
+     * How many times the agent may emit a byte-identical plan in a row before the turn is stopped
+     * (default 3, in `processActions`). Raise it for an agent whose job legitimately involves
+     * repeating itself -- polling one endpoint until it reports ready is the case this exists for.
+     */
+    maxIdenticalIterations?: number;
 }
 interface AgentDefinition {
     config: AgentConfig;
@@ -15459,9 +15518,43 @@ interface ElevasConfig {
 
 declare function defineContract<TContract extends Contract>(contract: TContract): TContract;
 
-declare function defineStep<TStep extends WorkflowStep>(step: TStep): TStep;
-
-declare function defineWorkflow<TWorkflow extends WorkflowDefinition>(workflow: TWorkflow): TWorkflow;
+/**
+ * The single step of a `defineSingleStepWorkflow` workflow. `handler` receives the
+ * already-validated input (per `inputSchema`) rather than `unknown` -- the ceremony of
+ * casting `rawInput as z.infer<typeof input>` inside every handler body is absorbed once
+ * by the factory instead of being repeated at every call site.
+ */
+interface SingleStepWorkflowStep<TInput, TOutput> {
+    id: string;
+    name: string;
+    description: string;
+    handler: (input: TInput, context: ExecutionContext) => Promise<TOutput>;
+}
+interface DefineSingleStepWorkflowOptions<TInput, TOutput> {
+    /** Workflow-level identity and metadata -- same shape as a hand-written `WorkflowDefinition['config']`. */
+    config: WorkflowConfig;
+    /** 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. */
+    inputSchema: z.ZodType<TInput>;
+    outputSchema: z.ZodType<TOutput>;
+    step: SingleStepWorkflowStep<TInput, TOutput>;
+    /** Optional metrics configuration for ROI calculations. */
+    metricsConfig?: ResourceMetricsConfig;
+    /** Optional execution interface configuration (surfaces the workflow in the Execution Runner UI). */
+    interface?: ExecutionInterface;
+    /** Optional lead-gen processing stage this workflow implements. */
+    stageImplemented?: string;
+}
+/**
+ * Builds a `WorkflowDefinition` for a workflow with exactly one step -- the step's
+ * `inputSchema`/`outputSchema` are the workflow contract's schemas, `entryPoint` is the
+ * step's `id`, and `next` is always `null` (there is nowhere else for a single step to go).
+ *
+ * Produces a `WorkflowDefinition` structurally identical to the hand-written
+ * `steps`-plus-`entryPoint` form -- same `resourceId`, `config`, `contract`, `steps` map,
+ * and `entryPoint` -- for the ~18 lines of ceremony that shape pays on every single-step
+ * workflow today.
+ */
+declare function defineSingleStepWorkflow<TInput, TOutput>(options: DefineSingleStepWorkflowOptions<TInput, TOutput>): WorkflowDefinition;
 
 type ContractRegistry = Record<string, Record<string, unknown>>;
 type ContractRefResolutionErrorCode = 'contract-ref-unknown-module' | 'contract-ref-unknown-export' | 'contract-ref-not-zod-type';
@@ -15630,5 +15723,5 @@ declare function defineWorkflowConfig<const TResourceId extends string>(resource
 declare const ListBuilderStageKeySchema: z.ZodString;
 type ListBuilderStageKey = z.infer<typeof ListBuilderStageKeySchema>;
 
-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 };
-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 };
+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 };
+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

@@ -1,2 +1,2 @@
-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-B2KAVPNB.js';
-export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from './chunk-HB7DC5LT.js';
+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-R3J6BEPO.js';
+export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from './chunk-QF2RNYYX.js';

package/dist/node/index.js

@@ -1,4 +1,4 @@
-export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from '../chunk-HB7DC5LT.js';
+export { projectDeploymentSpec, projectTopologyRelationships, toSdkResourceDescriptor, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors } from '../chunk-QF2RNYYX.js';
 import { readFileSync, mkdirSync, writeFileSync, readdirSync } from 'fs';
 import { relative, dirname, resolve, join, extname } from 'path';
 import { compile } from '@mdx-js/mdx';

package/dist/test-utils/index.js

@@ -1,6 +1,6 @@
-import { executeWorkflow } from '../chunk-FUOIYRIZ.js';
-import { validateDeploymentSpec, validateRelationships } from '../chunk-B2KAVPNB.js';
-import '../chunk-HB7DC5LT.js';
+import { executeWorkflow } from '../chunk-72ZGICTR.js';
+import { validateDeploymentSpec, validateRelationships } from '../chunk-R3J6BEPO.js';
+import '../chunk-QF2RNYYX.js';
 import { vi } from 'vitest';
 
 // src/test-utils/workflow.ts
@@ -252,6 +252,8 @@ var mockList = (overrides) => createMockAdapter(
     "recordExecution",
     "updateCompanyStage",
     "updateContactStage",
+    "bulkUpdateCompanyStage",
+    "bulkUpdateContactStage",
     "clearCompanyStages",
     "clearContactStages",
     "listPendingCompanyIds",

package/dist/worker/index.d.ts

@@ -14,6 +14,15 @@ interface TokenUsage {
     outputTokens: number;
     cost?: number;
     model?: string;
+    /**
+     * Anthropic excludes cache reads and writes from the wire `input_tokens`, and `AIUsageCollector`
+     * adds them back when it records a call. They are forwarded here so the worker-side collector the
+     * spend ceiling reads folds them in exactly as the parent's does — without them the worker's token
+     * total silently runs below the figure `execution_metrics` persists, and a `maxTotalTokens` ceiling
+     * would be enforced against the smaller number.
+     */
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
 }
 /** Resolved credential returned by platform.getCredential() */
 interface PlatformCredential {
@@ -154,7 +163,7 @@ declare function createAttioAdapter(credential: string): TypedAdapter<AttioToolM
  * Create a typed Apify adapter bound to a specific credential.
  *
  * @param credential - Credential name as configured in the command center
- * @returns Object with 2 typed methods for Apify actor operations
+ * @returns Object with 3 typed methods for Apify actor operations
  */
 declare function createApifyAdapter(credential: string): TypedAdapter<ApifyToolMap>;
 
@@ -208,7 +217,7 @@ declare function createInstagramAdapter(credential: string): TypedAdapter<Instag
  * Create a typed Instantly adapter bound to a specific credential.
  *
  * @param credential - Credential name as configured in the command center
- * @returns Object with 16 typed methods for Instantly email outreach operations
+ * @returns Object with 21 typed methods for Instantly email outreach operations
  */
 declare function createInstantlyAdapter(credential: string): TypedAdapter<InstantlyToolMap>;
 

package/dist/worker/index.js

@@ -1,3 +1,3 @@
-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-FUOIYRIZ.js';
-import '../chunk-B2KAVPNB.js';
-import '../chunk-HB7DC5LT.js';
+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-72ZGICTR.js';
+import '../chunk-R3J6BEPO.js';
+import '../chunk-QF2RNYYX.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "1.53.0",
+  "version": "1.55.0",
   "description": "SDK for building Elevasis organization resources",
   "type": "module",
   "bin": {
@@ -37,6 +37,7 @@
     "reference/"
   ],
   "dependencies": {
+    "@alcyone-labs/zod-to-json-schema": "^4.0.10",
     "@mdx-js/mdx": "^3.1.1",
     "esbuild": "^0.25.0",
     "remark-gfm": "^4.0.1"
@@ -54,8 +55,7 @@
     "@types/node": "^22.0.0",
     "chalk": "^5.3.0",
     "commander": "^11.0.0",
-    "dotenv": "^16.0.0",
-    "gray-matter": "^4.0.3",
+    "dotenv": "^17.2.3",
     "ora": "^7.0.1",
     "rollup": "^4.59.0",
     "rollup-plugin-dts": "^6.3.0",
@@ -63,15 +63,23 @@
     "typescript": "5.9.2",
     "vitest": "^3.2.4",
     "zod": "^4.1.0",
-    "@repo/core": "0.69.0",
+    "@repo/core": "0.71.0",
     "@repo/eslint-config": "0.0.0",
     "@repo/typescript-config": "0.0.0"
   },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Elevasis/elevasis-monorepo.git",
+    "directory": "packages/sdk"
+  },
   "scripts": {
     "lint": "eslint src --max-warnings 0",
     "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",
-    "type-check": "tsc --noEmit",
-    "check-types": "pnpm type-check",
+    "check-types": "tsc --noEmit",
     "test": "pnpm test:bundle",
     "test:source": "vitest run --config vitest.config.ts",
     "test:dist": "pnpm build && node ../../scripts/monorepo/validate-reference-artifacts.js && vitest run --config vitest.bundle.config.ts",

package/reference/_navigation.md

@@ -283,7 +283,7 @@ Docs-site pages indexed: 38.
 | 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 |
 | CLI Reference | `sdk/cli.mdx` | Core elevasis-sdk CLI commands -- validate, deploy, execute, inspect resources, manage credentials, rename, and enumerate the command catalog |
 | Concepts Reference | `sdk/concepts.mdx` | Plain-English explanations of Elevasis SDK concepts -- glossary, workflow analogies, Zod schemas, execution model, platform tools, and design decisions |
-| 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. |
+| 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. |
 | 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 |
 | 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 |
 | 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 |

package/reference/packages/core/src/knowledge/README.md

@@ -27,7 +27,7 @@ Pure query layer over the organization graph. Browser-safe (no Node APIs); share
 
 ## JSON envelope
 
-`formatJson` returns `{ path, mount, args, results }` — the same wrapped envelope used by `pnpm exec elevasis knowledge:ls --json` and `pnpm exec elevasis-sdk knowledge:ls --json`.
+`formatJson` returns `{ path, mount, args, results }` — the same wrapped envelope used by `pnpm exec elevasis knowledge:ls --json` and `pnpm exec elevasis-sdk knowledge:ls --json`.
 
 `governs` and `governedBy` accept either bare or graph-namespaced ids (`knowledge.foo` or `knowledge:knowledge.foo`).
 

package/reference/scaffold/core/organization-model.mdx

@@ -51,7 +51,7 @@ Resource identity is authored inside `OrganizationModel.resources`. Runtime work
 
 ## System Shape
 
-`OrganizationModel.systems` is the canonical semantic domain map. Hierarchy is authored with recursive `systems`; dotted paths such as `sales.crm` are derived from position in that tree. `subsystems` is a deprecated compatibility alias — it is still accepted and kept in sync with `systems` during parse, but new authoring should use `systems`. `parentSystemId` and `id` remain accepted compatibility fields during the migration.
+`OrganizationModel.systems` is the canonical semantic domain map. Hierarchy is authored with recursive `systems`; dotted paths such as `sales.crm` are derived from position in that tree. `subsystems` is a deprecated compatibility alias — it is still accepted on input, but new authoring should use `systems`. Parsing does **not** copy `systems` into it: children come back under whichever key the author wrote, so read `system.systems ?? system.subsystems` rather than assuming either key is populated. `parentSystemId` and `id` remain accepted compatibility fields during the migration.
 
 {/* doc-snippet:skip: illustrative excerpt, not a standalone compilable file */}
 

package/reference/scaffold/recipes/extend-lead-gen.md

@@ -51,6 +51,7 @@ Lead gen is a layered platform surface, not one component. Shared packages own s
 | `useLeadGenConfig`, `LeadGenBuildConfig`, build-state helpers                                                                                                | `@elevasis/ui/features/lead-gen`            | Provider-backed derivation of stage catalog, build templates, default build steps, default template id, and export workflow id          |
 | `ListActionsProvider`, `useListActions`, `ListBuilderWorkflow`, `ListBuilderRegistry`, `LeadGenActionKey`                                                    | `@elevasis/ui/features/lead-gen`            | List Builder workflow registry, slot-based field contracts, and project-owned action wiring                                             |
 | `LeadGenRouteShell`                                                                                                                                          | `@elevasis/ui/features/lead-gen`            | Route shell helper (contact/company detail surfaces are now `ContactDetailPage` / `CompanyDetailPage` from `@elevasis/ui/features/crm`) |
+| `EMPLOYEE_RANGES`, `EmployeeRange`                                                                                                                           | `@elevasis/ui/features/lead-gen`            | Apollo's own employee-count brackets for an Apollo import form. Wire values are Apollo's; relabel by mapping, never by redeclaring      |
 | `useLists`, `useList`, `useListsTelemetry`, `useListProgress`, `useListExecutions`, `useCreateList`, `useUpdateList`, `useUpdateListConfig`, `useDeleteList` | `@elevasis/ui/hooks`                        | Headless list and telemetry data access                                                                                                 |
 | `useWorkflowExecution`, `useExecutionSSE`, `useAddCompaniesToList`, `useRemoveCompaniesFromList`, `useAddContactsToList`                                     | `@elevasis/ui/hooks`                        | List Builder workflow triggering, live execution tailing, and list membership mutations                                                 |
 | `useCompanies`, `useCompany`, `useContacts`, `useContact`                                                                                                    | `@elevasis/ui/hooks`                        | Acquisition company/contact data access                                                                                                 |
@@ -208,7 +209,7 @@ function RootLayoutComponent() {
 
 Data sourcing mode is list-wide. Read `list.pipelineConfig.dataMode` or the workflow-side `list.getConfig()` result when a workflow must choose mock versus live sourcing. Do not add per-action `mock` / `live` controls for Apollo, crawl, enrichment, or scoring steps. Export mode is separate: `preview` versus `export` controls whether a destination write happens.
 
-Each registry entry declares a Zod `schema` and a `layout` of declarative field hints (`StepConfigLayout<Input>`). The shared `StepConfigForm` renders the layout, validates against the schema, and wires `value`/`onChange` for you — no per-action React components. The List Builder right column renders the form as `Configuration | Advanced | Runs` tabs with a sticky action footer. Omit the `advanced:` section when a step has none.
+Each registry entry declares a Zod `schema` and a `layout` of declarative field hints (`StepConfigLayout<Input>`). The shared `StepConfigForm` renders the layout, validates against the schema, and wires `value`/`onChange` for you — no per-action React components. The List Builder right column renders the form as `Configuration | Advanced | Runs` tabs with a sticky action footer. Omit the `advanced:` section when a step has none.
 
 Available field component variants: `textinput`, `textarea`, `numberinput`, `switch`, `segmented`, `select`, `multiselect`, `tags`, `json`. Field hints support `label`, `description`, `placeholder`, `min`/`max`/`step` (numbers), `options` (selects), and `when: (values) => boolean` for conditional visibility.