@elevasis/sdk 1.36.5 → 1.38.0

package/dist/cli.cjs

@@ -38577,17 +38577,48 @@ var SYSTEM_INTERFACE_PROFILES = [
 var SYSTEM_INTERFACE_READINESS_PROFILES = SYSTEM_INTERFACE_PROFILES.map(
   (profile) => profile.readinessProfile
 );
-var SystemInterfaceReadinessProfileSchema = external_exports.enum(SYSTEM_INTERFACE_READINESS_PROFILES);
+var SystemInterfaceReadinessProfileSchema = external_exports.string().trim().min(1);
 var SystemInterfaceResourceScopeSchema = external_exports.array(ModelIdSchema).default([]);
+var SystemApiInterfaceReadinessContractSchema = external_exports.object({
+  /** Ontology IDs of object types the interface depends on. */
+  requiredObjects: external_exports.array(external_exports.string().trim().min(1)).default([]),
+  /** Ontology IDs of catalog types the interface requires (must be non-empty). */
+  requiredCatalogs: external_exports.array(external_exports.string().trim().min(1)).default([]),
+  /** Optional ontology kind filters (reserved for future profile extensions). */
+  requiredKinds: external_exports.array(external_exports.string().trim().min(1)).optional()
+}).strict();
 var SystemApiInterfaceSchema = external_exports.object({
   lifecycle: SystemInterfaceLifecycleSchema.default("active"),
+  /**
+   * Open-string profile id. Built-in platform presets are looked up through
+   * the profile registry; custom ids are validated structurally via
+   * `readinessContract`. Optional — `profileForInterface` provides a default.
+   */
   readinessProfile: SystemInterfaceReadinessProfileSchema.optional(),
   /**
    * Resource ids that participate in this API interface. This scopes readiness
    * derivation without duplicating authored required/provided contract refs.
    */
-  resourceIds: SystemInterfaceResourceScopeSchema.optional()
+  resourceIds: SystemInterfaceResourceScopeSchema.optional(),
+  /**
+   * Tenant-authorable readiness declaration. Required for custom
+   * (non-built-in) profile ids so structural validation can proceed. Built-in
+   * profiles ignore this field (requirements are derived from platform code).
+   */
+  readinessContract: SystemApiInterfaceReadinessContractSchema.optional()
 }).strict();
+var _profileRegistry = new Map(
+  SYSTEM_INTERFACE_READINESS_PROFILES.map((profileId) => [
+    profileId,
+    { profileId, kind: "built-in" }
+  ])
+);
+function profileForInterface(systemPath, interfaceKey, readinessProfile) {
+  return readinessProfile ?? `${systemPath}.${interfaceKey}`;
+}
+function isBuiltInReadinessProfile(profileId) {
+  return _profileRegistry.get(profileId)?.kind === "built-in";
+}
 var SystemInterfaceRefSchema = external_exports.object({
   systemPath: SystemPathSchema,
   interfaceKey: SystemInterfaceKeySchema
@@ -40023,6 +40054,7 @@ function getLeadGenStageCatalog(model) {
       );
       const recordEntity = entry.recordEntity === "company" || entry.recordEntity === "contact" ? entry.recordEntity : void 0;
       const recordStageKey = stringValue(entry.recordStageKey);
+      const readinessTarget = entry.readinessTarget === true ? true : void 0;
       results[entryId] = {
         key: entryId,
         label: stringValue(entry.label) ?? entryId,
@@ -40031,7 +40063,8 @@ function getLeadGenStageCatalog(model) {
         entity,
         ...additionalEntities.length > 0 ? { additionalEntities } : {},
         ...recordEntity ? { recordEntity } : {},
-        ...recordStageKey ? { recordStageKey } : {}
+        ...recordStageKey ? { recordStageKey } : {},
+        ...readinessTarget ? { readinessTarget } : {}
       };
     }
   }
@@ -41491,14 +41524,11 @@ function addReadinessIssue(issues, family, code, message, details = {}) {
 function formatInterfaceIdentity(systemPath, interfaceKey) {
   return `${systemPath}/${interfaceKey}`;
 }
-function profileForInterface(systemPath, interfaceKey, readinessProfile) {
-  return readinessProfile ?? `${systemPath}.${interfaceKey}`;
-}
 function readinessMarkerPath(context) {
   return context.interfaceKey === "api" ? `systems.${context.systemPath}.apiInterface` : `systems.${context.systemPath}.derivedCrmHandoffReadiness`;
 }
 function formatSupportedReadinessProfiles() {
-  return SYSTEM_INTERFACE_READINESS_PROFILES.map((profile) => `"${profile}"`).join(", ");
+  return SYSTEM_INTERFACE_PROFILES.map((p) => `"${p.readinessProfile}"`).join(", ");
 }
 function getActiveScopedResources(model, resourceIds, issues, context) {
   const resources = [];
@@ -41690,9 +41720,6 @@ function getLeadGenCrmHandoffResourceIds(model) {
 function getSystemInterfaceReadinessMarker(model, request) {
   const system = getSystem(model, request.systemPath);
   if (system === void 0) return void 0;
-  if (request.interfaceKey === LEAD_GEN_API_INTERFACE.interfaceKey) {
-    return system.apiInterface;
-  }
   if (request.systemPath === LEAD_GEN_CRM_HANDOFF_INTERFACE.systemPath && request.interfaceKey === LEAD_GEN_CRM_HANDOFF_INTERFACE.interfaceKey) {
     return {
       lifecycle: "active",
@@ -41700,6 +41727,9 @@ function getSystemInterfaceReadinessMarker(model, request) {
       resourceIds: getLeadGenCrmHandoffResourceIds(model)
     };
   }
+  if (request.interfaceKey === "api" && system.apiInterface !== void 0) {
+    return system.apiInterface;
+  }
   return void 0;
 }
 function mergeLeadGenDerivedCatalogs(model) {
@@ -41744,6 +41774,18 @@ function tryCompileBusinessOntology(model, readinessProfile, issues) {
     return void 0;
   }
 }
+function requireContractReadiness(issues, index, resources, contract, context) {
+  const reads = resourceBindingIds(resources, "reads");
+  const catalogs = resourceBindingIds(resources, "usesCatalogs");
+  for (const objectId of contract.requiredObjects) {
+    requireObjectReadiness(issues, index, objectId, context);
+    requireScopedBinding(issues, reads, "reads", objectId, context);
+  }
+  for (const catalogId of contract.requiredCatalogs) {
+    requireCatalogReadiness(issues, index, catalogId, context);
+    requireScopedBinding(issues, catalogs, "usesCatalogs", catalogId, context);
+  }
+}
 function computeInterfaceReadiness(model, request) {
   const issues = [];
   const system = getSystem(model, request.systemPath);
@@ -41791,20 +41833,22 @@ function computeInterfaceReadiness(model, request) {
       { path: `${readinessMarkerPath(request)}.lifecycle` }
     );
   }
-  const supportedProfile = readinessProfile !== void 0 && SYSTEM_INTERFACE_PROFILES.some((profile) => profile.readinessProfile === readinessProfile);
-  if (!supportedProfile) {
+  const checkedReadinessProfile = readinessProfile ?? profileForInterface(request.systemPath, request.interfaceKey);
+  const isBuiltIn = isBuiltInReadinessProfile(checkedReadinessProfile);
+  const readinessContract = systemInterface.readinessContract;
+  if (!isBuiltIn && readinessContract === void 0) {
     addReadinessIssue(
       issues,
       "SYSTEM_INTERFACE_INVALID",
-      "unknown-readiness-profile",
-      `System Interface "${formatInterfaceIdentity(request.systemPath, request.interfaceKey)}" references unknown readiness profile "${readinessProfile}". Supported profiles: ${formatSupportedReadinessProfiles()}. Custom Systems should not declare apiInterface; route custom behavior through workflows/operations plus ontology, resources, and topology.`,
-      { path: `${readinessMarkerPath(request)}.readinessProfile`, ref: readinessProfile }
+      "missing-readiness-contract",
+      `System Interface "${formatInterfaceIdentity(request.systemPath, request.interfaceKey)}" uses custom readiness profile "${checkedReadinessProfile}" but declares no readinessContract. Built-in profiles: ${formatSupportedReadinessProfiles()}.`,
+      { path: `${readinessMarkerPath(request)}.readinessContract`, ref: checkedReadinessProfile }
     );
     return {
       ready: false,
       systemPath: request.systemPath,
       interfaceKey: request.interfaceKey,
-      readinessProfile,
+      readinessProfile: checkedReadinessProfile,
       scopedResourceIds,
       issues
     };
@@ -41818,10 +41862,6 @@ function computeInterfaceReadiness(model, request) {
       { path: `${readinessMarkerPath(request)}.resourceIds` }
     );
   }
-  const checkedReadinessProfile = readinessProfile;
-  if (checkedReadinessProfile === void 0) {
-    throw new Error("Supported readiness profile unexpectedly resolved to undefined");
-  }
   const resources = getActiveScopedResources(model, scopedResourceIds, issues, request);
   const index = tryCompileBusinessOntology(model, checkedReadinessProfile, issues);
   if (index !== void 0) {
@@ -41833,13 +41873,15 @@ function computeInterfaceReadiness(model, request) {
       requireLeadGenInterfaceReadiness(issues, index, resources, request);
       requireCrmInterfaceReadiness(issues, index, resources, { ...request, allowForeignOwner: true });
       requireHandoffBridgeReadiness(issues, model, request);
+    } else if (readinessContract !== void 0) {
+      requireContractReadiness(issues, index, resources, readinessContract, request);
     }
   }
   return {
     ready: issues.length === 0,
     systemPath: request.systemPath,
     interfaceKey: request.interfaceKey,
-    readinessProfile,
+    readinessProfile: checkedReadinessProfile,
     scopedResourceIds,
     issues
   };
@@ -45808,7 +45850,7 @@ function wrapAction(commandName, fn) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "1.36.5",
+  version: "1.38.0",
   description: "SDK for building Elevasis organization resources",
   type: "module",
   bin: {

package/dist/index.d.ts

@@ -5062,6 +5062,18 @@ interface LeadGenStageCatalogEntry {
     recordEntity?: 'company' | 'contact';
     /** Stage key to read from recordEntity.processing_state for Records views. */
     recordStageKey?: string;
+    /**
+     * Marks this stage as the pipeline objective ("ready" target).
+     *
+     * When declared, the platform UI uses the preceding stage (derived from
+     * `order`) as the backlog source and this stage as the drain, producing a
+     * "contacts ready for <next step>" count without hardcoding tenant-specific
+     * stage keys. Only one stage per catalog should set this to `true`.
+     *
+     * Absent (undefined) when not declared — no tenant authoring is required;
+     * the UI falls back to a generic last-incomplete-stage backlog.
+     */
+    readinessTarget?: boolean;
 }
 
 declare const ProcessingStageStatusSchema: z.ZodEnum<{
@@ -6750,12 +6762,13 @@ declare const SystemApiInterfaceSchema: z.ZodObject<{
         archived: "archived";
         disabled: "disabled";
     }>>;
-    readinessProfile: z.ZodOptional<z.ZodEnum<{
-        "sales.lead-gen.api": "sales.lead-gen.api";
-        "sales.crm.api": "sales.crm.api";
-        "sales.lead-gen.crm-handoff": "sales.lead-gen.crm-handoff";
-    }>>;
+    readinessProfile: z.ZodOptional<z.ZodString>;
     resourceIds: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    readinessContract: z.ZodOptional<z.ZodObject<{
+        requiredObjects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requiredCatalogs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requiredKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonValue[] | {
@@ -12274,6 +12287,91 @@ declare class ToolingError extends ExecutionError {
     constructor(errorType: string, message: string, details?: unknown);
 }
 
+/**
+ * Tenant-authorable readiness requirements for a system's API interface.
+ *
+ * Built-in profiles (`sales.lead-gen.api`, `sales.crm.api`,
+ * `sales.lead-gen.crm-handoff`) derive their requirements from platform code
+ * and do not need a `readinessContract`. Custom systems (any profile id not in
+ * the built-in registry) MUST declare a contract so structural readiness
+ * validation can proceed without platform hardcoding.
+ *
+ * Each field is an array of ontology IDs that this system must satisfy:
+ *   - `requiredObjects`  – ontology object types the interface depends on
+ *   - `requiredCatalogs` – catalog types the interface requires (non-empty)
+ *   - `requiredKinds`    – (optional) ontology kind filters for future use
+ */
+declare const SystemApiInterfaceReadinessContractSchema = z
+  .object({
+    /** Ontology IDs of object types the interface depends on. */
+    requiredObjects: z.array(z.string().trim().min(1)).default([]),
+    /** Ontology IDs of catalog types the interface requires (must be non-empty). */
+    requiredCatalogs: z.array(z.string().trim().min(1)).default([]),
+    /** Optional ontology kind filters (reserved for future profile extensions). */
+    requiredKinds: z.array(z.string().trim().min(1)).optional()
+  })
+  .strict()
+
+// ---------------------------------------------------------------------------
+// Profile registry
+//
+// Maps a readiness profile id to a lookup result. Built-in presets are
+// registered at module load; callers may register additional presets via
+// `registerReadinessProfile`. Unknown ids resolve to `undefined` — validated
+// structurally through the system's declared `readinessContract`.
+// ---------------------------------------------------------------------------
+
+type ReadinessProfileKind = 'built-in' | 'custom'
+
+interface ReadinessProfileEntry {
+  readonly profileId: string
+  readonly kind: ReadinessProfileKind
+}
+
+/**
+ * Look up a readiness profile entry by id.
+ *
+ * Returns `undefined` for unknown ids (not in the built-in list and not
+ * registered via `registerReadinessProfile`). Unknown profiles are validated
+ * structurally through the system's `readinessContract` — unknown-profile is
+ * NOT a schema-layer rejection.
+ */
+declare function lookupReadinessProfile(profileId: string): ReadinessProfileEntry | undefined {
+  return _profileRegistry.get(profileId)
+}
+
+/**
+ * Register a custom readiness profile preset.
+ *
+ * Tenant tooling or SDK extensions may call this during startup to register
+ * named presets. Registered presets are then resolvable via `lookupReadinessProfile`.
+ * Built-in profile ids cannot be overwritten.
+ */
+declare function registerReadinessProfile(profileId: string): ReadinessProfileEntry {
+  const existing = _profileRegistry.get(profileId)
+  if (existing !== undefined) return existing
+  const entry: ReadinessProfileEntry = { profileId, kind: 'custom' }
+  _profileRegistry.set(profileId, entry)
+  return entry
+}
+
+/**
+ * Return the effective readiness profile id for a system interface.
+ * Falls back to `systemPath.interfaceKey` when `readinessProfile` is omitted.
+ * This is the canonical profile-resolution function used by validation code.
+ */
+declare function profileForInterface(systemPath: string, interfaceKey: string, readinessProfile?: string): string {
+  return readinessProfile ?? `${systemPath}.${interfaceKey}`
+}
+
+/**
+ * Return true if the given profile id is a built-in platform preset.
+ */
+declare function isBuiltInReadinessProfile(profileId: string): boolean {
+  return _profileRegistry.get(profileId)?.kind === 'built-in'
+}
+type SystemApiInterfaceReadinessContract = z.infer<typeof SystemApiInterfaceReadinessContractSchema>
+
 declare const ResourceOntologyBindingSchema = z
   .object({
     actions: z.array(OntologyIdSchema).optional(),
@@ -12625,5 +12723,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, isZodType, parseTopologyNodeRef, projectDeploymentSpec, projectTopologyRelationships, resolveContractRef, runDiagnostic, splitName, toSdkResourceDescriptor, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors };
-export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqDealRow, AcqList, Action$1 as 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, 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, OrganizationModelAgentResourceEntry, 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, 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, defineStep, defineTopology, defineTopologyRelationship, defineWorkflow, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, profileForInterface, 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$1 as 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, 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, 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 };

package/dist/index.js

@@ -618,17 +618,58 @@ var SYSTEM_INTERFACE_PROFILES = [
 var SYSTEM_INTERFACE_READINESS_PROFILES = SYSTEM_INTERFACE_PROFILES.map(
   (profile) => profile.readinessProfile
 );
-var SystemInterfaceReadinessProfileSchema = z.enum(SYSTEM_INTERFACE_READINESS_PROFILES);
+var SystemInterfaceReadinessProfileSchema = z.string().trim().min(1);
 var SystemInterfaceResourceScopeSchema = z.array(ModelIdSchema).default([]);
+var SystemApiInterfaceReadinessContractSchema = z.object({
+  /** Ontology IDs of object types the interface depends on. */
+  requiredObjects: z.array(z.string().trim().min(1)).default([]),
+  /** Ontology IDs of catalog types the interface requires (must be non-empty). */
+  requiredCatalogs: z.array(z.string().trim().min(1)).default([]),
+  /** Optional ontology kind filters (reserved for future profile extensions). */
+  requiredKinds: z.array(z.string().trim().min(1)).optional()
+}).strict();
 var SystemApiInterfaceSchema = z.object({
   lifecycle: SystemInterfaceLifecycleSchema.default("active"),
+  /**
+   * Open-string profile id. Built-in platform presets are looked up through
+   * the profile registry; custom ids are validated structurally via
+   * `readinessContract`. Optional — `profileForInterface` provides a default.
+   */
   readinessProfile: SystemInterfaceReadinessProfileSchema.optional(),
   /**
    * Resource ids that participate in this API interface. This scopes readiness
    * derivation without duplicating authored required/provided contract refs.
    */
-  resourceIds: SystemInterfaceResourceScopeSchema.optional()
+  resourceIds: SystemInterfaceResourceScopeSchema.optional(),
+  /**
+   * Tenant-authorable readiness declaration. Required for custom
+   * (non-built-in) profile ids so structural validation can proceed. Built-in
+   * profiles ignore this field (requirements are derived from platform code).
+   */
+  readinessContract: SystemApiInterfaceReadinessContractSchema.optional()
 }).strict();
+var _profileRegistry = new Map(
+  SYSTEM_INTERFACE_READINESS_PROFILES.map((profileId) => [
+    profileId,
+    { profileId, kind: "built-in" }
+  ])
+);
+function lookupReadinessProfile(profileId) {
+  return _profileRegistry.get(profileId);
+}
+function registerReadinessProfile(profileId) {
+  const existing = _profileRegistry.get(profileId);
+  if (existing !== void 0) return existing;
+  const entry = { profileId, kind: "custom" };
+  _profileRegistry.set(profileId, entry);
+  return entry;
+}
+function profileForInterface(systemPath, interfaceKey, readinessProfile) {
+  return readinessProfile ?? `${systemPath}.${interfaceKey}`;
+}
+function isBuiltInReadinessProfile(profileId) {
+  return _profileRegistry.get(profileId)?.kind === "built-in";
+}
 var SystemInterfaceRefSchema = z.object({
   systemPath: SystemPathSchema,
   interfaceKey: SystemInterfaceKeySchema
@@ -1103,6 +1144,7 @@ function getLeadGenStageCatalog(model) {
       );
       const recordEntity = entry.recordEntity === "company" || entry.recordEntity === "contact" ? entry.recordEntity : void 0;
       const recordStageKey = stringValue(entry.recordStageKey);
+      const readinessTarget = entry.readinessTarget === true ? true : void 0;
       results[entryId] = {
         key: entryId,
         label: stringValue(entry.label) ?? entryId,
@@ -1111,7 +1153,8 @@ function getLeadGenStageCatalog(model) {
         entity,
         ...additionalEntities.length > 0 ? { additionalEntities } : {},
         ...recordEntity ? { recordEntity } : {},
-        ...recordStageKey ? { recordStageKey } : {}
+        ...recordStageKey ? { recordStageKey } : {},
+        ...readinessTarget ? { readinessTarget } : {}
       };
     }
   }
@@ -1757,9 +1800,6 @@ function addReadinessIssue(issues, family, code, message, details = {}) {
 function formatInterfaceIdentity(systemPath, interfaceKey) {
   return `${systemPath}/${interfaceKey}`;
 }
-function profileForInterface(systemPath, interfaceKey, readinessProfile) {
-  return readinessProfile ?? `${systemPath}.${interfaceKey}`;
-}
 function readinessMarkerPath(context) {
   return context.interfaceKey === "api" ? `systems.${context.systemPath}.apiInterface` : `systems.${context.systemPath}.derivedCrmHandoffReadiness`;
 }
@@ -1769,7 +1809,7 @@ function formatInterfaceReadinessFailure(result) {
   return `${identity} readiness failed${result.readinessProfile ? ` (${result.readinessProfile})` : ""}: ${issueSummary}`;
 }
 function formatSupportedReadinessProfiles() {
-  return SYSTEM_INTERFACE_READINESS_PROFILES.map((profile) => `"${profile}"`).join(", ");
+  return SYSTEM_INTERFACE_PROFILES.map((p) => `"${p.readinessProfile}"`).join(", ");
 }
 function throwIfInterfaceNotReady(result) {
   if (result.ready) return;
@@ -1965,9 +2005,6 @@ function getLeadGenCrmHandoffResourceIds(model) {
 function getSystemInterfaceReadinessMarker(model, request) {
   const system = getSystem(model, request.systemPath);
   if (system === void 0) return void 0;
-  if (request.interfaceKey === LEAD_GEN_API_INTERFACE.interfaceKey) {
-    return system.apiInterface;
-  }
   if (request.systemPath === LEAD_GEN_CRM_HANDOFF_INTERFACE.systemPath && request.interfaceKey === LEAD_GEN_CRM_HANDOFF_INTERFACE.interfaceKey) {
     return {
       lifecycle: "active",
@@ -1975,6 +2012,9 @@ function getSystemInterfaceReadinessMarker(model, request) {
       resourceIds: getLeadGenCrmHandoffResourceIds(model)
     };
   }
+  if (request.interfaceKey === "api" && system.apiInterface !== void 0) {
+    return system.apiInterface;
+  }
   return void 0;
 }
 function mergeLeadGenDerivedCatalogs(model) {
@@ -2019,6 +2059,18 @@ function tryCompileBusinessOntology(model, readinessProfile, issues) {
     return void 0;
   }
 }
+function requireContractReadiness(issues, index, resources, contract, context) {
+  const reads = resourceBindingIds(resources, "reads");
+  const catalogs = resourceBindingIds(resources, "usesCatalogs");
+  for (const objectId of contract.requiredObjects) {
+    requireObjectReadiness(issues, index, objectId, context);
+    requireScopedBinding(issues, reads, "reads", objectId, context);
+  }
+  for (const catalogId of contract.requiredCatalogs) {
+    requireCatalogReadiness(issues, index, catalogId, context);
+    requireScopedBinding(issues, catalogs, "usesCatalogs", catalogId, context);
+  }
+}
 function computeInterfaceReadiness(model, request) {
   const issues = [];
   const system = getSystem(model, request.systemPath);
@@ -2066,20 +2118,22 @@ function computeInterfaceReadiness(model, request) {
       { path: `${readinessMarkerPath(request)}.lifecycle` }
     );
   }
-  const supportedProfile = readinessProfile !== void 0 && SYSTEM_INTERFACE_PROFILES.some((profile) => profile.readinessProfile === readinessProfile);
-  if (!supportedProfile) {
+  const checkedReadinessProfile = readinessProfile ?? profileForInterface(request.systemPath, request.interfaceKey);
+  const isBuiltIn = isBuiltInReadinessProfile(checkedReadinessProfile);
+  const readinessContract = systemInterface.readinessContract;
+  if (!isBuiltIn && readinessContract === void 0) {
     addReadinessIssue(
       issues,
       "SYSTEM_INTERFACE_INVALID",
-      "unknown-readiness-profile",
-      `System Interface "${formatInterfaceIdentity(request.systemPath, request.interfaceKey)}" references unknown readiness profile "${readinessProfile}". Supported profiles: ${formatSupportedReadinessProfiles()}. Custom Systems should not declare apiInterface; route custom behavior through workflows/operations plus ontology, resources, and topology.`,
-      { path: `${readinessMarkerPath(request)}.readinessProfile`, ref: readinessProfile }
+      "missing-readiness-contract",
+      `System Interface "${formatInterfaceIdentity(request.systemPath, request.interfaceKey)}" uses custom readiness profile "${checkedReadinessProfile}" but declares no readinessContract. Built-in profiles: ${formatSupportedReadinessProfiles()}.`,
+      { path: `${readinessMarkerPath(request)}.readinessContract`, ref: checkedReadinessProfile }
     );
     return {
       ready: false,
       systemPath: request.systemPath,
       interfaceKey: request.interfaceKey,
-      readinessProfile,
+      readinessProfile: checkedReadinessProfile,
       scopedResourceIds,
       issues
     };
@@ -2093,10 +2147,6 @@ function computeInterfaceReadiness(model, request) {
       { path: `${readinessMarkerPath(request)}.resourceIds` }
     );
   }
-  const checkedReadinessProfile = readinessProfile;
-  if (checkedReadinessProfile === void 0) {
-    throw new Error("Supported readiness profile unexpectedly resolved to undefined");
-  }
   const resources = getActiveScopedResources(model, scopedResourceIds, issues, request);
   const index = tryCompileBusinessOntology(model, checkedReadinessProfile, issues);
   if (index !== void 0) {
@@ -2108,13 +2158,15 @@ function computeInterfaceReadiness(model, request) {
       requireLeadGenInterfaceReadiness(issues, index, resources, request);
       requireCrmInterfaceReadiness(issues, index, resources, { ...request, allowForeignOwner: true });
       requireHandoffBridgeReadiness(issues, model, request);
+    } else if (readinessContract !== void 0) {
+      requireContractReadiness(issues, index, resources, readinessContract, request);
     }
   }
   return {
     ready: issues.length === 0,
     systemPath: request.systemPath,
     interfaceKey: request.interfaceKey,
-    readinessProfile,
+    readinessProfile: checkedReadinessProfile,
     scopedResourceIds,
     issues
   };
@@ -6337,17 +6389,13 @@ var AcqListMetadataSchema = z.object({
 }).catchall(z.unknown());
 var ProspectingBuildTemplateIdSchema = z.string().trim().min(1).max(100);
 var ListStageCountsSchema = z.object({
-  // Attempted counts by canonical lead-gen stage. The detailed status
-  // distribution lives on ListProgress; telemetry keeps the overview payload small.
-  stageCounts: z.object({
-    populated: z.number().int(),
-    extracted: z.number().int(),
-    qualified: z.number().int(),
-    discovered: z.number().int(),
-    verified: z.number().int(),
-    personalized: z.number().int(),
-    uploaded: z.number().int()
-  }),
+  // Attempted counts keyed by the tenant's declared lead-gen stage catalog IDs.
+  // The catalog is tenant-owned and OM-derived at compute time; the schema
+  // validates the transport shape (string keys → integer values) rather than
+  // a fixed key set, so tenants with custom stages receive complete telemetry.
+  // Canonical Elevasis stages (populated, extracted, qualified, discovered,
+  // verified, personalized, uploaded) are included when declared in the catalog.
+  stageCounts: z.record(z.string().min(1), z.number().int()),
   deliverability: z.object({
     valid: z.number().int(),
     risky: z.number().int(),
@@ -7069,4 +7117,4 @@ function defineWorkflowConfig(resourceId, descriptors, actionRegistry = []) {
 }
 var ListBuilderStageKeySchema = z.string().min(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, isZodType, parseTopologyNodeRef, projectDeploymentSpec, projectTopologyRelationships, resolveContractRef, runDiagnostic, splitName, toSdkResourceDescriptor, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, 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, defineWorkflowConfig, deriveActions, diagnosticOutput, integrationInput, isBuiltInReadinessProfile, isZodType, lookupReadinessProfile, parseTopologyNodeRef, profileForInterface, projectDeploymentSpec, projectTopologyRelationships, registerReadinessProfile, resolveContractRef, runDiagnostic, splitName, toSdkResourceDescriptor, topologyRef, topologyRelationship, validateDeclaredSystemInterfaceReadiness, validateResourceGovernance, withPlatformAgentResourceDescriptor, withPlatformAgentResourceDescriptors, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors };

package/dist/node/index.d.ts

@@ -1396,12 +1396,13 @@ declare const SystemApiInterfaceSchema: z.ZodObject<{
         archived: "archived";
         disabled: "disabled";
     }>>;
-    readinessProfile: z.ZodOptional<z.ZodEnum<{
-        "sales.lead-gen.api": "sales.lead-gen.api";
-        "sales.crm.api": "sales.crm.api";
-        "sales.lead-gen.crm-handoff": "sales.lead-gen.crm-handoff";
-    }>>;
+    readinessProfile: z.ZodOptional<z.ZodString>;
     resourceIds: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    readinessContract: z.ZodOptional<z.ZodObject<{
+        requiredObjects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requiredCatalogs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requiredKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonValue[] | {

package/dist/test-utils/index.d.ts

@@ -5945,12 +5945,13 @@ declare const SystemApiInterfaceSchema: z.ZodObject<{
         archived: "archived";
         disabled: "disabled";
     }>>;
-    readinessProfile: z.ZodOptional<z.ZodEnum<{
-        "sales.lead-gen.api": "sales.lead-gen.api";
-        "sales.crm.api": "sales.crm.api";
-        "sales.lead-gen.crm-handoff": "sales.lead-gen.crm-handoff";
-    }>>;
+    readinessProfile: z.ZodOptional<z.ZodString>;
     resourceIds: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    readinessContract: z.ZodOptional<z.ZodObject<{
+        requiredObjects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requiredCatalogs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requiredKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonValue[] | {