@elevasis/sdk 1.27.1 → 1.28.0

package/dist/index.d.ts

@@ -6656,6 +6656,17 @@ type ResolvedOntologyRecord<TRecord> = TRecord & {
     origin: OntologyRecordOrigin;
 };
 
+declare const SystemApiInterfaceSchema: z.ZodObject<{
+    lifecycle: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        deprecated: "deprecated";
+        draft: "draft";
+        archived: "archived";
+        disabled: "disabled";
+    }>>;
+    readinessProfile: z.ZodOptional<z.ZodString>;
+    resourceIds: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+}, z.core.$strict>;
 type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonValue[] | {
     [key: string]: JsonValue;
@@ -6684,6 +6695,7 @@ interface SystemEntry {
     }[];
     policies?: string[];
     drivesGoals?: string[];
+    apiInterface?: z.infer<typeof SystemApiInterfaceSchema>;
     /** @deprecated Use lifecycle. Accepted for one publish cycle. */
     status?: 'active' | 'deprecated' | 'archived';
     path?: string;
@@ -7680,12 +7692,26 @@ declare const OrganizationModelSchema$1: z.ZodObject<{
 
 type OrganizationModel$1 = z.infer<typeof OrganizationModelSchema$1>;
 
-type BusinessOntologyValidationIndex = {
+type BusinessOntologyValidationIndexBase = {
     ontology: ResolvedOntologyIndex;
-    crmPipelineCatalog: OntologyCatalogType;
-    leadGenStageCatalog: OntologyCatalogType;
     actionTypesByLegacyId: Record<string, OntologyActionType>;
 };
+type LeadGenApiOntologyValidationIndex = BusinessOntologyValidationIndexBase & {
+    leadGenStageCatalog: OntologyCatalogType;
+};
+type CrmApiOntologyValidationIndex = BusinessOntologyValidationIndexBase & {
+    crmPipelineCatalog: OntologyCatalogType;
+};
+type BusinessOntologyValidationIndex = LeadGenApiOntologyValidationIndex & CrmApiOntologyValidationIndex;
+type SystemInterfaceReadinessIssueFamily = 'SYSTEM_INTERFACE_MISSING' | 'SYSTEM_INTERFACE_DISABLED' | 'SYSTEM_INTERFACE_INVALID' | 'SYSTEM_INTERFACE_NOT_READY' | 'SYSTEM_BRIDGE_NOT_READY';
+/**
+ * Legacy mixed acquisition index.
+ *
+ * Kept for existing API consumers until Wave 3 wires explicit route/service
+ * contract requirements. New base lead-gen paths should call
+ * `compileLeadGenApiOntologyValidationIndex()`; CRM-aware paths should call the
+ * CRM or bridge helpers above.
+ */
 declare function compileBusinessOntologyValidationIndex(model: OrganizationModel$1): BusinessOntologyValidationIndex;
 /**
  * Lead-gen stage validators bound to a specific resolved validation index.
@@ -7693,7 +7719,7 @@ declare function compileBusinessOntologyValidationIndex(model: OrganizationModel
  * The lead-gen stage catalog is tenant-model-dependent (it derives from the
  * organization model's `sales.lead-gen` stage records). Hosts that own a
  * populated tenant model (e.g. `apps/api` with the Elevasis canonical model)
- * MUST build their own index via `compileBusinessOntologyValidationIndex(model)`
+ * MUST build their own index via `compileLeadGenApiOntologyValidationIndex(model)`
  * and call `createLeadGenStageValidators(index)`. The core package stays generic;
  * it must never import a tenant model.
  */
@@ -7705,7 +7731,7 @@ type LeadGenStageValidators = {
     isLeadGenRecordStageValidForEntity(stageKey: string, entity: 'company' | 'contact'): boolean;
     resolveLeadGenRecordStageKey(stageKey: string, entity: 'company' | 'contact'): string;
 };
-declare function createLeadGenStageValidators(index: BusinessOntologyValidationIndex): LeadGenStageValidators;
+declare function createLeadGenStageValidators(index: LeadGenApiOntologyValidationIndex): LeadGenStageValidators;
 
 /**
  * A single CRM activity entry (note, stage change, or deal creation).
@@ -11804,7 +11830,7 @@ declare class RegistryValidationError extends Error {
     constructor(orgName: string, resourceId: string | null, field: string | null, message: string);
 }
 type ResourceValidatorMode = 'strict' | 'warn-only';
-type ResourceGovernanceValidationIssueType = 'missing-code-resource' | 'missing-om-resource' | 'type-mismatch' | 'system-mismatch' | 'missing-om-system' | 'raw-resource-id' | 'descriptor-mismatch' | 'missing-ontology-actions' | 'ontology-reference-missing' | 'primary-action-mismatch' | 'topology-reference-missing';
+type ResourceGovernanceValidationIssueType = 'missing-code-resource' | 'missing-om-resource' | 'type-mismatch' | 'system-mismatch' | 'missing-om-system' | 'raw-resource-id' | 'descriptor-mismatch' | 'missing-ontology-actions' | 'ontology-reference-missing' | 'ontology-topology-grant-missing' | 'primary-action-mismatch' | 'topology-reference-missing';
 interface ResourceGovernanceModel {
     systems?: Record<string, SystemEntry>;
     resources?: Record<string, ResourceEntry$1>;
@@ -11830,6 +11856,20 @@ interface ResourceGovernanceValidationOptions {
     mode?: ResourceValidatorMode;
     onWarning?: (issue: ResourceGovernanceValidationIssue) => void;
 }
+interface SystemInterfaceReadinessValidationIssue {
+    type: SystemInterfaceReadinessIssueFamily;
+    orgName: string;
+    systemPath: string;
+    interfaceKey: string;
+    code: string;
+    path?: string;
+    ref?: string;
+    message: string;
+}
+interface SystemInterfaceReadinessValidationResult {
+    valid: boolean;
+    issues: SystemInterfaceReadinessValidationIssue[];
+}
 /**
  * Validates runtime resource definitions against OM Resources and Systems.
  *
@@ -11843,6 +11883,14 @@ interface ResourceGovernanceValidationOptions {
  * permanent emergency escape hatch unless an explicit mode is passed.
  */
 declare function validateResourceGovernance(orgName: string, deployment: DeploymentSpec, organizationModel?: ResourceGovernanceModel | undefined, options?: ResourceGovernanceValidationOptions): ResourceGovernanceValidationResult;
+/**
+ * Validates every explicitly declared API System Interface by deriving
+ * readiness from its scoped resources and ontology bindings.
+ *
+ * Contract-absent models remain valid until they opt in with
+ * `systems.*.apiInterface`.
+ */
+declare function validateDeclaredSystemInterfaceReadiness(orgName: string, organizationModel: ResourceGovernanceModel | undefined): SystemInterfaceReadinessValidationResult;
 
 /**
  * LLM Platform Tool Adapter
@@ -12279,5 +12327,5 @@ declare function projectDeploymentSpec(options: ProjectDeploymentSpecOptions): D
 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, deriveActions, diagnosticOutput, integrationInput, isZodType, parseTopologyNodeRef, projectDeploymentSpec, projectTopologyRelationships, resolveContractRef, runDiagnostic, splitName, toSdkResourceDescriptor, topologyRef, topologyRelationship, validateResourceGovernance, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors };
+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, deriveActions, diagnosticOutput, integrationInput, isZodType, parseTopologyNodeRef, projectDeploymentSpec, projectTopologyRelationships, resolveContractRef, runDiagnostic, splitName, toSdkResourceDescriptor, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors };
 export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqDealRow, AcqList, Action, ActionDef, ActivityEvent, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, 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, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BuildPlanSnapshotStep, BulkDeleteLeadsParams, BulkDeleteLeadsResult, BulkImportParams, BulkImportResult, BusinessOntologyValidationIndex, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, ClickUpToolMap, CompanyFilters, ConcurrentPoolOptions, ConcurrentPoolResult, ConditionalNext, ContactFilters, 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, InstantlyToolMap, IntegrationDefinition, IntegrationResourceDescriptorResolver, LLMAdapterFactory, 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, OrganizationModelIntegrationResourceEntry, OrganizationModelResourceEntry, OrganizationModelResourceOntologyBinding, OrganizationModelTopology, OrganizationModelTopologyNodeRef, OrganizationModelTopologyRelationship, OrganizationModelWorkflowResourceEntry, PaginatedResult, PaginationParams, PdfToolMap, ProcessingStageStatus, ProjectDeploymentSpecOptions, ProjectsToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, 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, 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, WorkflowDefinition, WorkflowLogger, WorkflowResourceDescriptorResolver, WorkflowStep, WriteSheetParams, WriteSheetResult };