@kadoa/node-sdk 0.12.1 → 0.14.1

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import { RawAxiosRequestConfig, AxiosPromise, AxiosInstance, AxiosError } from 'axios';
-import * as src_generated from 'src/generated';
 
 /**
  * Kadoa API
@@ -648,6 +647,36 @@ type ExtractionSchemaFieldDataTypeEnum = typeof ExtractionSchemaFieldDataTypeEnu
  */
 type SchemaResponseSchemaInner = ExtractionClassificationField | ExtractionMetadataField | ExtractionSchemaField;
 
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Request body for creating a new schema
+ */
+interface CreateSchemaBody {
+    /**
+     * Name of the schema
+     */
+    'name': string;
+    /**
+     * Entity type for the schema
+     */
+    'entity': string;
+    /**
+     * Array of field definitions
+     */
+    'fields': Array<SchemaResponseSchemaInner>;
+}
+
 /**
  * Kadoa API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
@@ -769,7 +798,7 @@ interface MonitoringConfig {
     /**
      * Fields to monitor
      */
-    'fields': Array<MonitoredField>;
+    'fields'?: Array<MonitoredField>;
     /**
      * Notification channels
      */
@@ -1395,6 +1424,7 @@ type DataValidationReportStrategyEnum = typeof DataValidationReportStrategyEnum[
 interface DeleteAllRulesResponseData$1 {
     'deletedCount': number;
     'workflowId'?: string;
+    'deletedRuleIds': Array<string>;
 }
 
 /**
@@ -1531,7 +1561,7 @@ interface RuleParameters {
 /**
  * Complete validation rule with metadata and lifecycle information
  */
-interface Rule {
+interface Rule$1 {
     /**
      * Unique identifier
      */
@@ -1617,7 +1647,7 @@ interface GenerateRules {
  */
 interface RulesListResponse {
     'error': boolean;
-    'data': Array<Rule>;
+    'data': Array<Rule$1>;
     'pagination': PaginationMeta;
 }
 
@@ -1651,6 +1681,74 @@ interface ScheduleValidationResponse {
     'createdAt': string;
 }
 
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Schema description metadata
+ */
+interface SchemaResponseDescription {
+    /**
+     * Hint text for the schema
+     */
+    'hintText': string;
+}
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Schema object response
+ */
+interface SchemaResponse$1 {
+    /**
+     * Unique identifier for the schema
+     */
+    'id': string;
+    /**
+     * Name of the schema
+     */
+    'name': string;
+    /**
+     * Schema type (always NEO)
+     */
+    'type': SchemaResponseTypeEnum;
+    /**
+     * Whether the schema is public
+     */
+    'isPublic': boolean;
+    /**
+     * Array of field definitions
+     */
+    'schema': Array<SchemaResponseSchemaInner>;
+    /**
+     * Entity type for the schema
+     */
+    'entity': string | null;
+    'description': SchemaResponseDescription;
+}
+declare const SchemaResponseTypeEnum: {
+    readonly Neo: "NEO";
+};
+type SchemaResponseTypeEnum = typeof SchemaResponseTypeEnum[keyof typeof SchemaResponseTypeEnum];
+
 /**
  * Kadoa API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
@@ -1710,6 +1808,36 @@ declare const UpdateRuleStatusEnum: {
 };
 type UpdateRuleStatusEnum = typeof UpdateRuleStatusEnum[keyof typeof UpdateRuleStatusEnum];
 
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Request body for updating a schema
+ */
+interface UpdateSchemaBody {
+    /**
+     * Name of the schema
+     */
+    'name'?: string;
+    /**
+     * Entity type for the schema
+     */
+    'entity'?: string | null;
+    /**
+     * Array of field definitions
+     */
+    'fields'?: Array<SchemaResponseSchemaInner>;
+}
+
 /**
  * Kadoa API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
@@ -2055,6 +2183,59 @@ interface V4WorkflowsWorkflowIdGet200ResponseBrowserActionsInner {
     'url'?: string;
 }
 
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+interface V4WorkflowsWorkflowIdGet200ResponseLastJobErrorsInner {
+    /**
+     * Error code identifying the type of error
+     */
+    'errorCode'?: string;
+    /**
+     * Human-readable error message
+     */
+    'message'?: string;
+    /**
+     * When the error occurred
+     */
+    'timestamp'?: string;
+    /**
+     * Optional screenshot URL
+     */
+    'screenshot'?: string;
+    /**
+     * Additional context about the error
+     */
+    'context'?: object;
+}
+
+/**
+ * Kadoa API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 3.0.0
+ * Contact: support@kadoa.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+interface V4WorkflowsWorkflowIdGet200ResponseLastJob {
+    /**
+     * Errors from the last job run
+     */
+    'errors'?: Array<V4WorkflowsWorkflowIdGet200ResponseLastJobErrorsInner>;
+}
+
 /**
  * Kadoa API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
@@ -2221,10 +2402,6 @@ interface V4WorkflowsGet200ResponseWorkflowsInner {
      * When the last job started
      */
     'startedAt'?: string;
-    /**
-     * Protocol information from last job
-     */
-    'protocol'?: string;
     /**
      * ID of the last job
      */
@@ -2278,6 +2455,7 @@ interface V4WorkflowsGet200ResponseWorkflowsInner {
      * Whether the schema can be edited
      */
     'isSchemaEditable'?: boolean;
+    'lastJob'?: V4WorkflowsWorkflowIdGet200ResponseLastJob;
     'dataValidation'?: V4WorkflowsGet200ResponseWorkflowsInnerDataValidation;
     'validationStatistics'?: V4WorkflowsGet200ResponseWorkflowsInnerValidationStatistics;
     /**
@@ -2310,6 +2488,7 @@ declare const V4WorkflowsGet200ResponseWorkflowsInnerDisplayStateEnum: {
     readonly Queued: "QUEUED";
     readonly Setup: "SETUP";
     readonly Running: "RUNNING";
+    readonly Failed: "FAILED";
 };
 type V4WorkflowsGet200ResponseWorkflowsInnerDisplayStateEnum = typeof V4WorkflowsGet200ResponseWorkflowsInnerDisplayStateEnum[keyof typeof V4WorkflowsGet200ResponseWorkflowsInnerDisplayStateEnum];
 declare const V4WorkflowsGet200ResponseWorkflowsInnerSchemaTypeEnum: {
@@ -2724,14 +2903,11 @@ interface V4WorkflowsWorkflowIdGet200Response {
      * When the last job started
      */
     'startedAt'?: string;
-    /**
-     * Protocol information from last job
-     */
-    'protocol'?: string;
     /**
      * Database key for the workflow data
      */
     'dataKey'?: string;
+    'lastJob'?: V4WorkflowsWorkflowIdGet200ResponseLastJob;
     /**
      * Cost of the last job run in credits
      */
@@ -2821,28 +2997,6 @@ declare const V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum: {
 };
 type V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum = typeof V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum[keyof typeof V4WorkflowsWorkflowIdGet200ResponseSchemaTypeEnum];
 
-/**
- * Kadoa API
- * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
- *
- * The version of the OpenAPI document: 3.0.0
- * Contact: support@kadoa.com
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-interface V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInnerProtocol {
-    /**
-     * state of the run if it FAILED
-     */
-    'decision'?: string;
-    /**
-     * description why the run failed
-     */
-    'reasoning'?: string;
-}
-
 /**
  * Kadoa API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
@@ -2880,7 +3034,10 @@ interface V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInner {
      * Number of records processed in the workflow run
      */
     'records'?: number;
-    'protocol'?: V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInnerProtocol;
+    /**
+     * Errors that occurred during the workflow run
+     */
+    'errors'?: Array<V4WorkflowsWorkflowIdGet200ResponseLastJobErrorsInner>;
     /**
      * Number of credits used for this workflow run
      */
@@ -4330,51 +4487,6 @@ interface ValidationListResponse {
     'pagination': PaginationMeta;
 }
 
-/**
- * Request parameters for v4DataValidationRulesActionsBulkApprovePost operation in DataValidationApi.
- */
-interface DataValidationApiV4DataValidationRulesActionsBulkApprovePostRequest {
-    /**
-     * Body
-     */
-    readonly bulkApproveRules?: BulkApproveRules;
-}
-/**
- * Request parameters for v4DataValidationRulesActionsBulkDeletePost operation in DataValidationApi.
- */
-interface DataValidationApiV4DataValidationRulesActionsBulkDeletePostRequest {
-    /**
-     * Body
-     */
-    readonly bulkDeleteRules?: BulkDeleteRules;
-}
-/**
- * Request parameters for v4DataValidationRulesActionsDeleteAllDelete operation in DataValidationApi.
- */
-interface DataValidationApiV4DataValidationRulesActionsDeleteAllDeleteRequest {
-    /**
-     * Body
-     */
-    readonly deleteRuleWithReason?: DeleteRuleWithReason;
-}
-/**
- * Request parameters for v4DataValidationRulesActionsGeneratePost operation in DataValidationApi.
- */
-interface DataValidationApiV4DataValidationRulesActionsGeneratePostRequest {
-    /**
-     * Body
-     */
-    readonly generateRule?: GenerateRule;
-}
-/**
- * Request parameters for v4DataValidationRulesActionsGenerateRulesPost operation in DataValidationApi.
- */
-interface DataValidationApiV4DataValidationRulesActionsGenerateRulesPostRequest {
-    /**
-     * Body
-     */
-    readonly generateRules?: GenerateRules;
-}
 /**
  * Request parameters for v4DataValidationRulesGet operation in DataValidationApi.
  */
@@ -4386,35 +4498,6 @@ interface DataValidationApiV4DataValidationRulesGetRequest {
     readonly pageSize?: number;
     readonly includeDeleted?: V4DataValidationRulesGetIncludeDeletedParameter;
 }
-/**
- * Request parameters for v4DataValidationRulesPost operation in DataValidationApi.
- */
-interface DataValidationApiV4DataValidationRulesPostRequest {
-    /**
-     * Body
-     */
-    readonly createRule?: CreateRule;
-}
-/**
- * Request parameters for v4DataValidationRulesRuleIdDisablePost operation in DataValidationApi.
- */
-interface DataValidationApiV4DataValidationRulesRuleIdDisablePostRequest {
-    readonly ruleId: string;
-    /**
-     * Body
-     */
-    readonly disableRule?: DisableRule;
-}
-/**
- * Request parameters for v4DataValidationRulesRuleIdPut operation in DataValidationApi.
- */
-interface DataValidationApiV4DataValidationRulesRuleIdPutRequest {
-    readonly ruleId: string;
-    /**
-     * Body
-     */
-    readonly updateRule?: UpdateRule;
-}
 /**
  * Request parameters for v4DataValidationWorkflowsWorkflowIdJobsJobIdValidationsGet operation in DataValidationApi.
  */
@@ -4950,7 +5033,7 @@ interface WorkflowsApiV4ChangesGetRequest {
  */
 interface WorkflowsApiV4WorkflowsGetRequest {
     /**
-     * Search term to filter workflows by name or URL
+     * Search term to filter workflows by name, URL, or workflow ID
      */
     readonly search?: string;
     /**
@@ -5356,54 +5439,214 @@ declare const V4WorkflowsWorkflowIdDataGetOrderEnum: {
 };
 type V4WorkflowsWorkflowIdDataGetOrderEnum = typeof V4WorkflowsWorkflowIdDataGetOrderEnum[keyof typeof V4WorkflowsWorkflowIdDataGetOrderEnum];
 
-interface RealtimeConfig {
-    teamApiKey: string;
-    heartbeatInterval?: number;
-    reconnectDelay?: number;
-    missedHeartbeatsLimit?: number;
-}
-declare class Realtime {
-    private socket?;
-    private heartbeatInterval;
-    private reconnectDelay;
-    private lastHeartbeat;
-    private isConnecting;
-    private missedHeartbeatsLimit;
-    private missedHeartbeatCheckTimer?;
-    private teamApiKey?;
-    private eventListeners;
-    private connectionListeners;
-    private errorListeners;
-    constructor(config: RealtimeConfig);
-    connect(): Promise<void>;
-    private handleHeartbeat;
-    private notifyEventListeners;
-    private notifyConnectionListeners;
-    private notifyErrorListeners;
-    private startHeartbeatCheck;
-    private stopHeartbeatCheck;
-    /**
-     * Subscribe to realtime events
-     * @param listener Function to handle incoming events
-     * @returns Function to unsubscribe
-     */
-    onEvent(listener: (event: unknown) => void): () => void;
-    /**
-     * Subscribe to connection state changes
-     * @param listener Function to handle connection state changes
-     * @returns Function to unsubscribe
-     */
-    onConnection(listener: (connected: boolean, reason?: string) => void): () => void;
-    /**
-     * Subscribe to errors
-     * @param listener Function to handle errors
-     * @returns Function to unsubscribe
-     */
-    onError(listener: (error: unknown) => void): () => void;
-    close(): void;
-    isConnected(): boolean;
+/**
+ * Workflows domain ACL.
+ * Wraps generated WorkflowsApi requests/responses and normalizes types.
+ * Downstream code must import from this module instead of `generated/**`.
+ */
+
+/**
+ * Workflow state filter for list queries.
+ */
+declare const WorkflowState: {
+    readonly Active: "ACTIVE";
+    readonly Error: "ERROR";
+    readonly Paused: "PAUSED";
+    readonly NotSupported: "NOT_SUPPORTED";
+};
+type WorkflowState = (typeof WorkflowState)[keyof typeof WorkflowState];
+/**
+ * Monitoring status filter.
+ */
+declare const MonitoringStatus: {
+    readonly Enabled: "true";
+    readonly Disabled: "false";
+};
+type MonitoringStatus = (typeof MonitoringStatus)[keyof typeof MonitoringStatus];
+/**
+ * Update interval filter.
+ */
+declare const UpdateInterval: {
+    readonly Hourly: "HOURLY";
+    readonly Daily: "DAILY";
+    readonly Weekly: "WEEKLY";
+    readonly Monthly: "MONTHLY";
+};
+type UpdateInterval = (typeof UpdateInterval)[keyof typeof UpdateInterval];
+/**
+ * Include deleted workflows filter.
+ */
+declare const IncludeDeleted: {
+    readonly True: "true";
+    readonly False: "false";
+};
+type IncludeDeleted = (typeof IncludeDeleted)[keyof typeof IncludeDeleted];
+/**
+ * Response format for workflow list.
+ */
+declare const ResponseFormat: {
+    readonly Json: "json";
+    readonly Csv: "csv";
+};
+type ResponseFormat = (typeof ResponseFormat)[keyof typeof ResponseFormat];
+/**
+ * Workflow state enum.
+ */
+declare const WorkflowStateEnum: {
+    readonly Active: "ACTIVE";
+    readonly Error: "ERROR";
+    readonly Paused: "PAUSED";
+    readonly NotSupported: "NOT_SUPPORTED";
+    readonly Preview: "PREVIEW";
+    readonly ComplianceReview: "COMPLIANCE_REVIEW";
+    readonly ComplianceRejected: "COMPLIANCE_REJECTED";
+    readonly Queued: "QUEUED";
+    readonly Setup: "SETUP";
+    readonly Deleted: "DELETED";
+};
+type WorkflowStateEnum = (typeof WorkflowStateEnum)[keyof typeof WorkflowStateEnum];
+/**
+ * Workflow display state enum.
+ */
+declare const WorkflowDisplayStateEnum: {
+    readonly Active: "ACTIVE";
+    readonly Error: "ERROR";
+    readonly Paused: "PAUSED";
+    readonly NotSupported: "NOT_SUPPORTED";
+    readonly Preview: "PREVIEW";
+    readonly ComplianceReview: "COMPLIANCE_REVIEW";
+    readonly ComplianceRejected: "COMPLIANCE_REJECTED";
+    readonly Queued: "QUEUED";
+    readonly Setup: "SETUP";
+    readonly Running: "RUNNING";
+    readonly Failed: "FAILED";
+};
+type WorkflowDisplayStateEnum = (typeof WorkflowDisplayStateEnum)[keyof typeof WorkflowDisplayStateEnum];
+/**
+ * Job state enum.
+ */
+declare const JobStateEnum: {
+    readonly InProgress: "IN_PROGRESS";
+    readonly Finished: "FINISHED";
+    readonly Failed: "FAILED";
+    readonly NotSupported: "NOT_SUPPORTED";
+    readonly FailedInsufficientFunds: "FAILED_INSUFFICIENT_FUNDS";
+};
+type JobStateEnum = (typeof JobStateEnum)[keyof typeof JobStateEnum];
+declare class ListWorkflowsRequest implements WorkflowsApiV4WorkflowsGetRequest {
+    search?: string;
+    skip?: number;
+    limit?: number;
+    state?: WorkflowState;
+    tags?: Array<string>;
+    monitoring?: MonitoringStatus;
+    updateInterval?: UpdateInterval;
+    templateId?: string;
+    includeDeleted?: IncludeDeleted;
+    format?: ResponseFormat;
+}
+type CreateWorkflowRequest = CreateWorkflowWithSchemaBody;
+type CreateWorkflowWithCustomSchemaRequest = CreateWorkflowWithCustomSchemaBody;
+/**
+ * Workflow response with SDK-curated enum types.
+ * Remaps generated enum fields to prevent type leakage.
+ */
+interface WorkflowResponse extends Omit<V4WorkflowsGet200ResponseWorkflowsInner, "state" | "displayState"> {
+    state?: WorkflowStateEnum;
+    displayState?: WorkflowDisplayStateEnum;
+}
+/**
+ * Get workflow details response with SDK-curated enum types.
+ */
+interface GetWorkflowResponse extends Omit<V4WorkflowsWorkflowIdGet200Response, "state" | "displayState"> {
+    state?: WorkflowStateEnum;
+    displayState?: WorkflowDisplayStateEnum;
 }
 
+/**
+ * Get job response with SDK-curated enum types.
+ */
+interface GetJobResponse extends Omit<V4WorkflowsWorkflowIdJobsJobIdGet200Response, "state"> {
+    state?: JobStateEnum;
+}
+type RunWorkflowRequest = V4WorkflowsWorkflowIdRunPutRequest;
+type RunWorkflowResponse = V4WorkflowsWorkflowIdRunPut200Response;
+
+/**
+ * Extraction domain ACL.
+ * Wraps generated WorkflowsApi requests/responses for data fetching operations.
+ * Wraps generated schema field types for entity resolution.
+ * Downstream code must import from this module instead of `generated/**`.
+ */
+
+/**
+ * Data pagination metadata.
+ */
+type DataPagination = V4WorkflowsWorkflowIdDataGet200ResponsePagination;
+/**
+ * Workflow data response.
+ * Note: This type doesn't contain enum fields that need remapping.
+ */
+type WorkflowDataResponse = V4WorkflowsWorkflowIdDataGet200Response;
+/**
+ * Data sort order enum.
+ */
+declare const DataSortOrder: {
+    readonly Asc: "asc";
+    readonly Desc: "desc";
+};
+type DataSortOrder = (typeof DataSortOrder)[keyof typeof DataSortOrder];
+/**
+ * Options for fetching workflow data.
+ */
+declare class FetchDataOptions {
+    workflowId: string;
+    runId?: string;
+    sortBy?: string;
+    order?: DataSortOrder;
+    filters?: string;
+    page?: number;
+    limit?: number;
+    includeAnomalies?: boolean;
+}
+/**
+ * Schema field data type enum.
+ */
+declare const SchemaFieldDataType: {
+    readonly Text: "TEXT";
+    readonly Number: "NUMBER";
+    readonly Date: "DATE";
+    readonly Url: "URL";
+    readonly Email: "EMAIL";
+    readonly Image: "IMAGE";
+    readonly Video: "VIDEO";
+    readonly Phone: "PHONE";
+    readonly Boolean: "BOOLEAN";
+    readonly Location: "LOCATION";
+    readonly Array: "ARRAY";
+    readonly Object: "OBJECT";
+};
+type SchemaFieldDataType = (typeof SchemaFieldDataType)[keyof typeof SchemaFieldDataType];
+type SchemaField$1 = ExtractionSchemaField | ExtractionClassificationField | ExtractionMetadataField;
+type NavigationMode = (typeof CreateWorkflowWithSchemaBodyNavigationModeEnum)[keyof typeof CreateWorkflowWithSchemaBodyNavigationModeEnum];
+type DataTypeInternal = (typeof ExtractionSchemaFieldDataTypeEnum)[keyof typeof ExtractionSchemaFieldDataTypeEnum];
+type DataType = Exclude<DataTypeInternal, "CURRENCY" | "JOB_DESCRIPTION" | "CATEGORY_JOB_TYPES" | "CLASSIFICATION" | "CATEGORIZE" | "STATIC_SCRAPER_DATA" | "UNIQUE_ID" | "JOBBIRD_CUSTOM" | "PASS" | "ADDITIONAL_DATA">;
+type MetadataKey = (typeof ExtractionMetadataFieldMetadataKeyEnum)[keyof typeof ExtractionMetadataFieldMetadataKeyEnum];
+type WorkflowInterval = (typeof CreateWorkflowWithSchemaBodyIntervalEnum)[keyof typeof CreateWorkflowWithSchemaBodyIntervalEnum];
+type MonitoringOperator = (typeof V4WorkflowsWorkflowIdMetadataPutRequestMonitoringFieldsInnerOperatorEnum)[keyof typeof V4WorkflowsWorkflowIdMetadataPutRequestMonitoringFieldsInnerOperatorEnum];
+type MonitoringField = V4WorkflowsWorkflowIdMetadataPutRequestMonitoringFieldsInner & {
+    isKeyField?: boolean;
+};
+type LocationConfig = Location;
+type RawFormat = (typeof ExtractionMetadataFieldMetadataKeyEnum)[keyof typeof ExtractionMetadataFieldMetadataKeyEnum];
+type FieldType = ExtractionMetadataFieldFieldTypeEnum | ExtractionClassificationFieldFieldTypeEnum | ExtractionSchemaFieldFieldTypeEnum;
+type WorkflowMonitoringConfig = MonitoringConfig;
+/**
+ * Workflow details response.
+ * Re-exported from workflows.acl.ts to get SDK-curated enum types.
+ */
+type WorkflowDetailsResponse = GetWorkflowResponse;
+
 /**
  * Simple page-based pagination info
  * Maps directly to the most common API pagination format
@@ -5434,9 +5677,6 @@ interface FetchDataResult extends PagedResponse<object> {
     runId?: string | null;
     executedAt?: string | null;
 }
-type FetchDataOptions = Partial<Pick<WorkflowsApiV4WorkflowsWorkflowIdDataGetRequest, "runId" | "sortBy" | "order" | "filters" | "page" | "limit" | "includeAnomalies">> & {
-    workflowId: string;
-};
 /**
  * Service for fetching workflow data with pagination support
  */
@@ -5458,205 +5698,97 @@ declare class DataFetcherService {
     fetchDataPages(options: FetchDataOptions): AsyncGenerator<FetchDataResult, void, unknown>;
 }
 
-type NavigationMode = (typeof CreateWorkflowWithSchemaBodyNavigationModeEnum)[keyof typeof CreateWorkflowWithSchemaBodyNavigationModeEnum];
-type WorkflowInterval = (typeof CreateWorkflowWithSchemaBodyIntervalEnum)[keyof typeof CreateWorkflowWithSchemaBodyIntervalEnum];
-type LocationConfig$1 = Location;
-
-type SchemaField = ExtractionSchemaField | ExtractionClassificationField | ExtractionMetadataField;
-interface EntityPrediction {
-    entity: string;
-    fields: SchemaField[];
-    primaryKeyField?: string;
-    expectedResults?: string;
-}
-interface EntityRequestOptions {
-    link: string;
-    location?: LocationConfig$1;
-    navigationMode?: string;
-}
-interface ResolvedEntity {
-    entity: string;
-    fields: SchemaField[];
+interface KadoaUser {
+    userId: string;
+    email: string;
+    featureFlags: string[];
 }
-type EntityConfig = "ai-detection" | {
-    schemId: string;
-} | {
-    name: string;
-    fields: SchemaField[];
-};
-/**
- * Service for resolving entities and their fields from various sources
- *
- * NOTE: This is a workaround for the /v4/entity endpoint which is not yet exposed in the OpenAPI spec.
- * Once the endpoint is added to the OpenAPI specification, this manual implementation should be
- * replaced with the generated client code.
- */
-declare class EntityResolverService {
+declare class UserService {
     private readonly client;
-    private readonly schemasService;
     constructor(client: KadoaClient);
     /**
-     * Resolves entity and fields from the provided entity configuration
-     *
-     * @param entityConfig The entity configuration to resolve
-     * @param options Additional options for AI detection
-     * @returns Resolved entity with fields
-     */
-    resolveEntity(entityConfig: EntityConfig, options?: {
-        link?: string;
-        location?: LocationConfig$1;
-        navigationMode?: string;
-    }): Promise<ResolvedEntity>;
-    /**
-     * Fetches entity fields dynamically from the /v4/entity endpoint.
-     * This is a workaround implementation using native fetch since the endpoint
-     * is not yet included in the OpenAPI specification.
-     *
-     * @param options Request options including the link to analyze
-     * @returns EntityPrediction containing the detected entity type and fields
-     */
-    fetchEntityFields(options: EntityRequestOptions): Promise<EntityPrediction>;
-    /**
-     * Validates entity request options
+     * Get current user details
+     * @returns User details
      */
-    private validateEntityOptions;
+    getCurrentUser(): Promise<KadoaUser>;
 }
 
 /**
- * Options for polling operations
+ * Notifications domain ACL.
+ * Wraps generated NotificationsApi requests/responses and normalizes types.
+ * Downstream code must import from this module instead of `generated/**`.
  */
-interface PollingOptions {
-    /**
-     * Polling interval in milliseconds (minimum 250ms)
-     * @default 1000
-     */
-    pollIntervalMs?: number;
-    /**
-     * Timeout in milliseconds
-     * @default 300000 (5 minutes)
-     */
-    timeoutMs?: number;
-    /**
-     * AbortSignal to cancel the polling operation
-     */
-    abortSignal?: AbortSignal;
+
+/**
+ * Notification channel type enum.
+ * Re-exported from generated V5NotificationsChannelsPostRequestChannelTypeEnum.
+ */
+declare const NotificationChannelType: {
+    EMAIL: "EMAIL";
+    SLACK: "SLACK";
+    WEBHOOK: "WEBHOOK";
+    WEBSOCKET: "WEBSOCKET";
+};
+type NotificationChannelType = (typeof NotificationChannelType)[keyof typeof NotificationChannelType];
+
+/**
+ * Webhook HTTP method enum.
+ * Re-exported from generated WebhookChannelConfigHttpMethodEnum.
+ */
+type WebhookHttpMethod = WebhookChannelConfigHttpMethodEnum;
+/**
+ * Request parameters for listing notification channels.
+ */
+declare class ListChannelsRequest implements NotificationsApiV5NotificationsChannelsGetRequest {
+    workflowId?: string;
 }
 /**
- * Result of a polling operation
+ * Request to create a notification channel with SDK-curated enum types.
  */
-interface PollingResult<T> {
-    /**
-     * The final result when polling completes successfully
-     */
-    result: T;
-    /**
-     * The number of polling attempts made
-     */
-    attempts: number;
-    /**
-     * The total time spent polling in milliseconds
-     */
-    duration: number;
+interface CreateChannelRequest extends Omit<V5NotificationsChannelsPostRequest, "channelType"> {
+    channelType: NotificationChannelType;
 }
 /**
- * Generic polling utility that polls a function until a condition is met
- *
- * @param pollFn Function to call on each poll attempt
- * @param isComplete Function to check if polling should complete
- * @param options Polling configuration options
- * @returns Promise that resolves with the polling result
- *
- * @example
- * ```typescript
- * const result = await pollUntil(
- *   () => api.getStatus(id),
- *   (status) => status.completedAt !== null,
- *   { pollIntervalMs: 2000, timeoutMs: 60000 }
- * );
- * ```
+ * Notification channel response.
+ * Note: Response types are simple DTOs without enum fields that need remapping.
  */
-declare function pollUntil<T>(pollFn: () => Promise<T>, isComplete: (result: T) => boolean, options?: PollingOptions): Promise<PollingResult<T>>;
+type NotificationChannel = V5NotificationsChannelsGet200ResponseDataChannelsInner;
+/**
+ * Notification channel configuration (union type for all channel configs).
+ */
+type NotificationChannelConfig = V5NotificationsChannelsGet200ResponseDataChannelsInnerConfig;
 
-type LocationConfig = Location;
-type WorkflowId = string;
-type WorkflowStateEnum = V4WorkflowsGet200ResponseWorkflowsInnerStateEnum;
-type WorkflowState = WorkflowStateEnum[keyof WorkflowStateEnum];
-interface WaitOptions$1 extends PollingOptions {
-    targetState?: WorkflowState;
-}
-interface CreateWorkflowInput {
-    urls: string[];
-    navigationMode: NavigationMode;
-    name: string;
-    description?: string;
-    schemaId?: string;
-    entity: string;
-    fields: Array<SchemaField>;
-    tags?: string[];
-    interval?: WorkflowInterval;
-    monitoring?: MonitoringConfig;
-    location?: LocationConfig;
-    bypassPreview?: boolean;
-    autoStart?: boolean;
-    schedules?: string[];
-}
-type JobId = string;
-type JobStatus = (typeof V4WorkflowsWorkflowIdJobsJobIdGet200ResponseStateEnum)[keyof typeof V4WorkflowsWorkflowIdJobsJobIdGet200ResponseStateEnum];
-interface RunWorkflowInput {
-    variables?: Record<string, unknown>;
-    limit?: number;
-}
-interface StartedJob {
-    jobId: JobId;
-    message?: string;
-    status?: string;
-}
-interface FinishedJob extends V4WorkflowsWorkflowIdJobsJobIdGet200Response {
-}
-interface JobWaitOptions extends PollingOptions {
-    targetStatus?: JobStatus;
+/**
+ * WebSocket channel configuration (empty object).
+ */
+type WebsocketChannelConfig = Record<string, never>;
+/**
+ * Union of all channel configuration types.
+ */
+type ChannelConfig = EmailChannelConfig | SlackChannelConfig | WebhookChannelConfig | WebsocketChannelConfig;
+/**
+ * Request parameters for listing notification settings.
+ */
+declare class ListSettingsRequest implements NotificationsApiV5NotificationsSettingsGetRequest {
+    workflowId?: string;
+    eventType?: NotificationSettingsEventType;
 }
-
-type ListWorkflowsOptions = WorkflowsApiV4WorkflowsGetRequest;
-declare class WorkflowsCoreService {
-    private readonly workflowsApi;
-    constructor(workflowsApi: WorkflowsApiInterface);
-    create(input: CreateWorkflowInput): Promise<{
-        id: WorkflowId;
-    }>;
-    get(id: WorkflowId): Promise<V4WorkflowsWorkflowIdGet200Response>;
-    list(filters?: ListWorkflowsOptions): Promise<V4WorkflowsGet200ResponseWorkflowsInner[]>;
-    getByName(name: string): Promise<V4WorkflowsGet200ResponseWorkflowsInner | undefined>;
-    cancel(id: WorkflowId): Promise<void>;
-    resume(id: WorkflowId): Promise<void>;
-    /**
-     * Wait for a workflow to reach the target state or a terminal state if no target state is provided
-     */
-    wait(id: WorkflowId, options?: WaitOptions$1): Promise<V4WorkflowsWorkflowIdGet200Response>;
-    /**
-     * Run a workflow with variables and optional limit
-     */
-    runWorkflow(workflowId: WorkflowId, input: RunWorkflowInput): Promise<StartedJob>;
-    /**
-     * Get job status directly without polling workflow details
-     */
-    getJobStatus(workflowId: WorkflowId, jobId: JobId): Promise<FinishedJob>;
-    /**
-     * Wait for a job to reach the target state or a terminal state
-     */
-    waitForJobCompletion(workflowId: WorkflowId, jobId: JobId, options?: JobWaitOptions): Promise<FinishedJob>;
+/**
+ * Request to create notification settings with SDK-curated enum types.
+ */
+interface CreateSettingsRequest extends Omit<V5NotificationsSettingsPostRequest, "eventType"> {
+    eventType: NotificationSettingsEventType;
 }
+/**
+ * Notification settings response.
+ */
+type NotificationSettings = V5NotificationsSettingsGet200ResponseDataSettingsInner;
+/**
+ * Notification event type enum.
+ * Re-exported from generated V5NotificationsSettingsGetEventTypeEnum.
+ */
+type NotificationSettingsEventType = V5NotificationsSettingsGetEventTypeEnum;
 
-type NotificationChannel = V5NotificationsChannelsGet200ResponseDataChannelsInner;
-declare const NotificationChannelType: {
-    readonly EMAIL: "EMAIL";
-    readonly SLACK: "SLACK";
-    readonly WEBHOOK: "WEBHOOK";
-    readonly WEBSOCKET: "WEBSOCKET";
-};
-type NotificationChannelType = (typeof NotificationChannelType)[keyof typeof NotificationChannelType];
-type WebsocketChannelConfig = Record<string, never>;
-type ChannelConfig = EmailChannelConfig | SlackChannelConfig | WebhookChannelConfig | WebsocketChannelConfig;
 declare class NotificationChannelsService {
     /**
      * Default channel name
@@ -5666,7 +5798,7 @@ declare class NotificationChannelsService {
     private readonly api;
     private readonly userService;
     constructor(notificationsApi: NotificationsApiInterface, userService: UserService);
-    listChannels(filters: NotificationsApiV5NotificationsChannelsGetRequest): Promise<NotificationChannel[]>;
+    listChannels(filters: ListChannelsRequest): Promise<NotificationChannel[]>;
     /**
      * List all channels (both workflow-specific and workspace-level)
      * This is useful for finding workspace-level channels like WebSocket channels
@@ -5674,7 +5806,7 @@ declare class NotificationChannelsService {
      */
     listAllChannels(workflowId?: string): Promise<NotificationChannel[]>;
     deleteChannel(channelId: string): Promise<void>;
-    createChannel(type: NotificationChannelType, config?: Pick<V5NotificationsChannelsPostRequest, "name" | "config">): Promise<NotificationChannel>;
+    createChannel(type: NotificationChannelType, config?: Pick<CreateChannelRequest, "name" | "config">): Promise<NotificationChannel>;
     private buildPayload;
     private buildEmailChannelConfig;
     private buildSlackChannelConfig;
@@ -5682,13 +5814,11 @@ declare class NotificationChannelsService {
     private buildWebsocketChannelConfig;
 }
 
-type NotificationSettings = V5NotificationsSettingsGet200ResponseDataSettingsInner;
-type NotificationSettingsEventType = V5NotificationsSettingsGetEventTypeEnum;
 declare class NotificationSettingsService {
     private readonly api;
     constructor(notificationsApi: NotificationsApiInterface);
-    createSettings(requestData: V5NotificationsSettingsPostRequest): Promise<NotificationSettings>;
-    listSettings(filters: NotificationsApiV5NotificationsSettingsGetRequest): Promise<NotificationSettings[]>;
+    createSettings(requestData: CreateSettingsRequest): Promise<NotificationSettings>;
+    listSettings(filters: ListSettingsRequest): Promise<NotificationSettings[]>;
     listAllEvents(): Promise<NotificationSettingsEventType[]>;
     deleteSettings(settingsId: string): Promise<void>;
 }
@@ -5750,10 +5880,25 @@ interface NotificationOptions {
     events?: NotificationSettingsEventType[] | "all";
     channels?: NotificationSetupRequestChannels;
 }
+interface SetupWorkspaceNotificationSettingsRequest {
+    events: NotificationSettingsEventType[] | "all";
+    channels: NotificationSetupRequestChannels;
+}
+interface SetupWorkflowNotificationSettingsRequest extends SetupWorkspaceNotificationSettingsRequest {
+    workflowId: string;
+}
 declare class NotificationSetupService {
     private readonly channelsService;
     private readonly settingsService;
     constructor(channelsService: NotificationChannelsService, settingsService: NotificationSettingsService);
+    /**
+     * Setup notification settings for a specific workflow ensuring no duplicates exist.
+     */
+    setupForWorkflow(requestData: SetupWorkflowNotificationSettingsRequest): Promise<NotificationSettings[]>;
+    /**
+     * Setup notification settings at the workspace level ensuring no duplicates exist.
+     */
+    setupForWorkspace(requestData: SetupWorkspaceNotificationSettingsRequest): Promise<NotificationSettings[]>;
     /**
      * Complete workflow notification setup including channels and settings
      *
@@ -5770,6 +5915,114 @@ declare class NotificationSetupService {
     private handleChannelsByConfig;
 }
 
+/**
+ * Options for polling operations
+ */
+interface PollingOptions {
+    /**
+     * Polling interval in milliseconds (minimum 250ms)
+     * @default 1000
+     */
+    pollIntervalMs?: number;
+    /**
+     * Timeout in milliseconds
+     * @default 300000 (5 minutes)
+     */
+    timeoutMs?: number;
+    /**
+     * AbortSignal to cancel the polling operation
+     */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Result of a polling operation
+ */
+interface PollingResult<T> {
+    /**
+     * The final result when polling completes successfully
+     */
+    result: T;
+    /**
+     * The number of polling attempts made
+     */
+    attempts: number;
+    /**
+     * The total time spent polling in milliseconds
+     */
+    duration: number;
+}
+/**
+ * Generic polling utility that polls a function until a condition is met
+ *
+ * @param pollFn Function to call on each poll attempt
+ * @param isComplete Function to check if polling should complete
+ * @param options Polling configuration options
+ * @returns Promise that resolves with the polling result
+ *
+ * @example
+ * ```typescript
+ * const result = await pollUntil(
+ *   () => api.getStatus(id),
+ *   (status) => status.completedAt !== null,
+ *   { pollIntervalMs: 2000, timeoutMs: 60000 }
+ * );
+ * ```
+ */
+declare function pollUntil<T>(pollFn: () => Promise<T>, isComplete: (result: T) => boolean, options?: PollingOptions): Promise<PollingResult<T>>;
+
+type WorkflowId = string;
+type JobId = string;
+interface WaitOptions extends PollingOptions {
+    targetState?: WorkflowStateEnum;
+}
+interface JobWaitOptions extends PollingOptions {
+    targetStatus?: JobStateEnum;
+}
+interface CreateWorkflowInput {
+    urls: string[];
+    navigationMode: NavigationMode;
+    name: string;
+    description?: string;
+    schemaId?: string;
+    entity: string;
+    fields: Array<SchemaField$1>;
+    tags?: string[];
+    interval?: WorkflowInterval;
+    monitoring?: MonitoringConfig;
+    location?: LocationConfig;
+    bypassPreview?: boolean;
+    autoStart?: boolean;
+    schedules?: string[];
+}
+declare class WorkflowsCoreService {
+    private readonly workflowsApi;
+    constructor(workflowsApi: WorkflowsApiInterface);
+    create(input: CreateWorkflowInput): Promise<{
+        id: WorkflowId;
+    }>;
+    get(id: WorkflowId): Promise<GetWorkflowResponse>;
+    list(filters?: ListWorkflowsRequest): Promise<WorkflowResponse[]>;
+    getByName(name: string): Promise<WorkflowResponse | undefined>;
+    cancel(id: WorkflowId): Promise<void>;
+    resume(id: WorkflowId): Promise<void>;
+    /**
+     * Wait for a workflow to reach the target state or a terminal state if no target state is provided
+     */
+    wait(id: WorkflowId, options?: WaitOptions): Promise<GetWorkflowResponse>;
+    /**
+     * Run a workflow with variables and optional limit
+     */
+    runWorkflow(workflowId: WorkflowId, input: RunWorkflowRequest): Promise<RunWorkflowResponse>;
+    /**
+     * Get job status directly without polling workflow details
+     */
+    getJobStatus(workflowId: WorkflowId, jobId: JobId): Promise<GetJobResponse>;
+    /**
+     * Wait for a job to reach the target state or a terminal state
+     */
+    waitForJobCompletion(workflowId: WorkflowId, jobId: JobId, options?: JobWaitOptions): Promise<GetJobResponse>;
+}
+
 interface ExtractionOptionsInternal {
     urls: string[];
     prompt?: string;
@@ -5777,13 +6030,13 @@ interface ExtractionOptionsInternal {
     navigationMode: NavigationMode;
     name: string;
     description?: string;
-    location: LocationConfig$1;
+    location: LocationConfig;
     bypassPreview?: boolean;
     pollingInterval: number;
     maxWaitTime: number;
     entity: EntityConfig;
     interval?: WorkflowInterval;
-    monitoring?: MonitoringConfig;
+    monitoring?: WorkflowMonitoringConfig;
     tags?: string[];
     notifications?: NotificationOptions;
     autoStart?: boolean;
@@ -5793,7 +6046,7 @@ type ExtractionOptions = {
 } & Partial<Omit<ExtractionOptionsInternal, "urls">>;
 interface ExtractionResult {
     workflowId: string;
-    workflow?: V4WorkflowsWorkflowIdGet200Response;
+    workflow?: WorkflowDetailsResponse;
     data?: Array<object>;
     pagination?: PageInfo;
 }
@@ -5809,417 +6062,129 @@ declare class ExtractionService {
     private readonly dataFetcherService;
     private readonly entityResolverService;
     private readonly notificationSetupService;
-    constructor(workflowsCoreService: WorkflowsCoreService, dataFetcherService: DataFetcherService, entityResolverService: EntityResolverService, notificationSetupService: NotificationSetupService);
-    /**
-     * execute extraction workflow
-     */
-    executeExtraction(options: ExtractionOptions): Promise<ExtractionResult | SubmitExtractionResult>;
-    /**
-     * Validates extraction options
-     */
-    private validateOptions;
-    /**
-     * Resume a workflow after notification setup
-     */
-    resumeWorkflow(workflowId: string): Promise<ExtractionResult>;
-    /**
-     * Checks if extraction was successful
-     */
-    private isExtractionSuccessful;
-}
-
-declare class ExtractionModule {
-    private readonly extractionService;
-    private readonly dataFetcherService;
-    private readonly channelsService;
-    private readonly settingsService;
-    private readonly workflowsCoreService;
-    constructor(extractionService: ExtractionService, dataFetcherService: DataFetcherService, channelsService: NotificationChannelsService, settingsService: NotificationSettingsService, workflowsCoreService: WorkflowsCoreService);
+    private readonly notificationChannelsService;
+    private readonly notificationSettingsService;
+    constructor(workflowsCoreService: WorkflowsCoreService, dataFetcherService: DataFetcherService, entityResolverService: EntityResolverService, notificationSetupService: NotificationSetupService, notificationChannelsService: NotificationChannelsService, notificationSettingsService: NotificationSettingsService);
     /**
-     * Run extraction workflow using dynamic entity detection
-     *
-     * @param options Extraction configuration options including optional notification settings
-     * @returns ExtractionResult containing workflow ID, workflow details, and first page of extracted data
-     *
-     * @example Simple extraction with AI detection
-     * ```typescript
-     * const result = await client.extraction.run({
-     *   urls: ['https://example.com'],
-     *   name: 'My Extraction'
-     * });
-     * ```
-     *
-     * @example With notifications
-     * ```typescript
-     * const result = await client.extraction.run({
-     *   urls: ['https://example.com'],
-     *   name: 'My Extraction',
-     *   notifications: {
-     *     events: ['workflow_completed', 'workflow_failed'],
-     *     channels: {
-     *       email: true,
-     *       slack: { channelId: 'slack-channel-id' }
-     *     }
-     *   }
-     * });
-     * ```
-     *
-     * @see {@link KadoaClient.extract} For more flexible extraction configuration using the builder API
+     * Run an extraction workflow and wait for completion.
      */
     run(options: ExtractionOptions): Promise<ExtractionResult>;
     /**
-     * Submit extraction workflow for background processing
-     *
-     * @param options Extraction configuration options including optional notification settings
-     * @returns SubmitExtractionResult containing workflow ID
-     *
-     * @example
-     * ```typescript
-     * const result = await client.extraction.submit({
-     *   urls: ['https://example.com'],
-     *   name: 'My Extraction',
-     *   notifications: {
-     *     events: 'all',
-     *     channels: {
-     *       email: true
-     *     }
-     *   }
-     * });
-     * ```
-     *
-     * @see {@link KadoaClient.extract} For more flexible extraction configuration using the builder API
+     * Submit an extraction workflow for asynchronous processing.
      */
     submit(options: ExtractionOptions): Promise<SubmitExtractionResult>;
     /**
-     * Run a workflow with variables and optional limit
+     * Trigger a workflow run without waiting for completion.
      */
-    runJob(workflowId: string, input: RunWorkflowInput): Promise<StartedJob>;
+    runJob(workflowId: string, input: RunWorkflowRequest): Promise<RunWorkflowResponse>;
     /**
-     * Run a workflow and wait for it to complete
+     * Trigger a workflow run and wait for the job to complete.
      */
-    runJobAndWait(workflowId: string, input: RunWorkflowInput): Promise<FinishedJob>;
+    runJobAndWait(workflowId: string, input: RunWorkflowRequest): Promise<GetJobResponse>;
     /**
-     * Fetch paginated data from a workflow
-     *
-     * @param options Options for fetching data including workflowId and pagination parameters
-     * @returns Paginated workflow data with metadata
-     *
-     * @example
-     * ```typescript
-     * // Fetch first page
-     * const firstPage = await client.extraction.fetchData({
-     *   workflowId: 'workflow-id',
-     *   page: 1,
-     *   limit: 100
-     * });
-     *
-     * // Iterate through all pages
-     * for await (const page of client.extraction.fetchDataPages({ workflowId: 'workflow-id' })) {
-     *   console.log(`Processing ${page.data.length} records`);
-     * }
-     * ```
+     * Fetch a single page of extraction data.
      */
     fetchData(options: FetchDataOptions): Promise<FetchDataResult>;
     /**
-     * Fetch all data from a workflow across all pages
-     *
-     * @param options Options for fetching data
-     * @returns All workflow data combined from all pages
-     *
-     * @example
-     * ```typescript
-     * const allData = await client.extraction.fetchAllData({
-     *   workflowId: 'workflow-id'
-     * });
-     * ```
-     */
-    fetchAllData(options: FetchDataOptions): Promise<Array<object>>;
-    /**
-     * Create an async iterator for paginated data fetching
-     *
-     * @param options Options for fetching data
-     * @returns Async iterator that yields pages of data
-     *
-     * @example
-     * ```typescript
-     * for await (const page of client.extraction.fetchDataPages({ workflowId: 'workflow-id' })) {
-     *   console.log(`Page ${page.pagination.page}: ${page.data.length} records`);
-     * }
-     * ```
-     */
-    fetchDataPages(options: FetchDataOptions): AsyncGenerator<FetchDataResult, void, unknown>;
-    /**
-     * Get notification channels for a workflow
-     *
-     * @param workflowId The workflow ID
-     * @returns Array of notification channels
-     *
-     * @example
-     * ```typescript
-     * const channels = await client.extraction.getNotificationChannels('workflow-id');
-     * ```
-     */
-    getNotificationChannels(workflowId: string): Promise<src_generated.V5NotificationsChannelsGet200ResponseDataChannelsInner[]>;
-    /**
-     * Get notification settings for a workflow
-     *
-     * @param workflowId The workflow ID
-     * @returns Array of notification settings
-     *
-     * @example
-     * ```typescript
-     * const settings = await client.extraction.getNotificationSettings('workflow-id');
-     * ```
-     */
-    getNotificationSettings(workflowId: string): Promise<src_generated.V5NotificationsSettingsGet200ResponseDataSettingsInner[]>;
-}
-
-interface SetupWorkspaceNotificationSettingsRequest {
-    events: NotificationSettingsEventType[] | "all";
-    channels: NotificationSetupRequestChannels;
-}
-interface SetupWorkflowNotificationSettingsRequest extends SetupWorkspaceNotificationSettingsRequest {
-    workflowId: string;
-}
-declare class NotificationsModule {
-    private readonly channelsService;
-    private readonly settingsService;
-    private readonly channelSetupService;
-    constructor(channelsService: NotificationChannelsService, settingsService: NotificationSettingsService, channelSetupService: NotificationSetupService);
-    setupForWorkflow(requestData: SetupWorkflowNotificationSettingsRequest): Promise<src_generated.V5NotificationsSettingsGet200ResponseDataSettingsInner[]>;
-    setupForWorkspace(requestData: SetupWorkspaceNotificationSettingsRequest): Promise<src_generated.V5NotificationsSettingsGet200ResponseDataSettingsInner[]>;
-    /**
-     * Get the channels service
-     */
-    get channels(): NotificationChannelsService;
-    /**
-     * Get the settings service
-     */
-    get settings(): NotificationSettingsService;
-}
-
-interface Schema {
-    entity: string;
-    schema: SchemaField[];
-}
-/**
- * Service for managing schemas
- */
-declare class SchemasService {
-    private readonly schemasApi;
-    constructor(client: KadoaClient);
-    /**
-     * Get a schema by ID
-     * //todo: use proper schema type for response from generated client (when avaialble)
-     */
-    getSchema(schemaId: string): Promise<Schema>;
-}
-
-/**
- * Schemas module for managing schemas
- */
-declare class SchemasModule {
-    private readonly service;
-    constructor(service: SchemasService);
-}
-
-/**
- * UserModule provides user management functionality
- *
- * @example
- * ```typescript
- * import { KadoaClient } from '@kadoa/sdk';
- *
- * const client = new KadoaClient({
- *   apiKey: 'your-api-key'
- * });
- *
- * // Get current user details
- * const currentUser = await client.user.getCurrentUser();
- * ```
- */
-declare class UserModule {
-    private readonly userService;
-    constructor(userService: UserService);
-    /**
-     * Get the underlying UserService instance
-     * @returns UserService instance
-     */
-    get service(): UserService;
-    /**
-     * Get current user details
-     * @returns KadoaUser details
+     * Fetch all extraction data across all pages.
      */
-    getCurrentUser(): Promise<KadoaUser>;
-}
-
-type ListRulesOptions = DataValidationApiV4DataValidationRulesGetRequest;
-type CreateRuleOptions = DataValidationApiV4DataValidationRulesPostRequest["createRule"];
-type GenerateRuleOptions = DataValidationApiV4DataValidationRulesActionsGeneratePostRequest["generateRule"];
-type GenerateRulesOptions = DataValidationApiV4DataValidationRulesActionsGenerateRulesPostRequest["generateRules"];
-type UpdateRuleOptions = DataValidationApiV4DataValidationRulesRuleIdPutRequest["updateRule"];
-type DisableRuleOptions = DataValidationApiV4DataValidationRulesRuleIdDisablePostRequest;
-type BulkApproveRulesOptions = DataValidationApiV4DataValidationRulesActionsBulkApprovePostRequest["bulkApproveRules"];
-type BulkDeleteRulesOptions = DataValidationApiV4DataValidationRulesActionsBulkDeletePostRequest["bulkDeleteRules"];
-type DeleteAllRulesOptions = DataValidationApiV4DataValidationRulesActionsDeleteAllDeleteRequest["deleteRuleWithReason"];
-type BulkApproveRulesResponseData = BulkApproveRulesResponse["data"];
-type BulkDeleteRulesResponseData = BulkDeleteRulesResponse["data"];
-type DeleteAllRulesResponseData = DeleteAllRulesResponse["data"];
-
-/**
- * Service for managing data validation rules
- */
-declare class ValidationRulesService {
-    private readonly validationApi;
-    constructor(client: KadoaClient);
-    listRules(options?: ListRulesOptions): Promise<RulesListResponse>;
-    getRuleById(ruleId: string): Promise<Rule | undefined>;
-    getRuleByName(name: string): Promise<Rule | undefined>;
-    createRule(data: CreateRuleOptions): Promise<Rule>;
-    updateRule(ruleId: string, updateData: UpdateRuleOptions): Promise<Rule>;
-    disableRule(data: DisableRuleOptions): Promise<Rule>;
-    generateRule(data: GenerateRuleOptions): Promise<Rule>;
-    generateRules(data: GenerateRulesOptions): Promise<Rule[]>;
-    bulkApproveRules(data: BulkApproveRulesOptions): Promise<BulkApproveRulesResponseData>;
-    bulkDeleteRules(data: BulkDeleteRulesOptions): Promise<BulkDeleteRulesResponseData>;
-    deleteAllRules(data: DeleteAllRulesOptions): Promise<DeleteAllRulesResponseData>;
-}
-
-type ToggleResponse = V4DataValidationWorkflowsWorkflowIdValidationTogglePut200Response;
-type ListWorkflowValidationsOptions = DataValidationApiV4DataValidationWorkflowsWorkflowIdJobsJobIdValidationsGetRequest;
-type WaitUntilCompletedOptions = PollingOptions;
-
-declare class ValidationCoreService {
-    private readonly validationApi;
-    constructor(client: KadoaClient);
-    listWorkflowValidations(filters: ListWorkflowValidationsOptions): Promise<ValidationListResponse>;
-    getValidationDetails(validationId: string): Promise<DataValidationReport>;
-    scheduleValidation(workflowId: string, jobId: string): Promise<ScheduleValidationResponse>;
-    toggleValidationEnabled(workflowId: string): Promise<ToggleResponse>;
-    getLatestValidation(workflowId: string, jobId?: string): Promise<DataValidationReport>;
-    getValidationAnomalies(validationId: string): Promise<AnomaliesByRuleResponse>;
-    getValidationAnomaliesByRule(validationId: string, ruleName: string): Promise<AnomalyRulePageResponse>;
-    waitUntilCompleted(validationId: string, options?: WaitUntilCompletedOptions): Promise<DataValidationReport>;
-}
-
-declare class ValidationModule {
-    private readonly coreService;
-    private readonly rulesService;
-    constructor(coreService: ValidationCoreService, rulesService: ValidationRulesService);
-    listRules(options?: ListRulesOptions): Promise<RulesListResponse>;
-    getRuleByName(name: string): Promise<Rule | undefined>;
-    createRule(data: CreateRuleOptions): Promise<Rule>;
-    generateRule(data: GenerateRuleOptions): Promise<Rule>;
-    generateRules(data: GenerateRulesOptions): Promise<Rule[]>;
-    bulkApproveRules(data: BulkApproveRulesOptions): Promise<BulkApproveRulesResponseData>;
-    bulkDeleteRules(data: BulkDeleteRulesOptions): Promise<BulkDeleteRulesResponseData>;
-    deleteAllRules(data: DeleteAllRulesOptions): Promise<DeleteAllRulesResponseData>;
-    listWorkflowValidations(workflowId: string, jobId: string): Promise<ValidationListResponse>;
-    scheduleValidation(workflowId: string, jobId: string): Promise<ScheduleValidationResponse>;
-    waitUntilCompleted(validationId: string, options?: WaitUntilCompletedOptions): Promise<DataValidationReport>;
-    getValidationDetails(validationId: string): Promise<DataValidationReport>;
-    getLatestValidation(workflowId: string, jobId?: string): Promise<DataValidationReport>;
-    getValidationAnomalies(validationId: string): Promise<AnomaliesByRuleResponse>;
-    getValidationAnomaliesByRule(validationId: string, ruleName: string): Promise<AnomalyRulePageResponse>;
-    toggleValidationEnabled(workflowId: string): Promise<ToggleResponse>;
-}
-
-interface WaitOptions {
-    pollIntervalMs?: number;
-    timeoutMs?: number;
-}
-declare class WorkflowsModule {
-    private readonly core;
-    constructor(core: WorkflowsCoreService);
-    get(workflowId: string): Promise<V4WorkflowsWorkflowIdGet200Response>;
-    list(filters?: ListWorkflowsOptions): Promise<V4WorkflowsGet200ResponseWorkflowsInner[]>;
-    getByName(name: string): Promise<V4WorkflowsGet200ResponseWorkflowsInner | undefined>;
-    create(input: CreateWorkflowInput): Promise<{
-        id: WorkflowId;
-    }>;
-    cancel(workflowId: string): Promise<void>;
-    approve(workflowId: string): Promise<void>;
-    resume(workflowId: string): Promise<void>;
-    wait(workflowId: string, options?: WaitOptions): Promise<V4WorkflowsWorkflowIdGet200Response>;
+    fetchAllData(options: FetchDataOptions): Promise<object[]>;
     /**
-     * Get job status directly without polling workflow details
+     * Iterate through extraction data pages.
+     */
+    fetchDataPages(options: FetchDataOptions): AsyncGenerator<FetchDataResult, void, unknown>;
+    /**
+     * List notification channels for a workflow.
+     */
+    getNotificationChannels(workflowId: string): Promise<NotificationChannel[]>;
+    /**
+     * List notification settings for a workflow.
+     */
+    getNotificationSettings(workflowId: string): Promise<NotificationSettings[]>;
+    /**
+     * execute extraction workflow
+     */
+    private executeExtraction;
+    /**
+     * Validates extraction options
+     */
+    private validateOptions;
+    /**
+     * Resume a workflow after notification setup
      */
-    getJobStatus(workflowId: string, jobId: string): Promise<FinishedJob>;
+    resumeWorkflow(workflowId: string): Promise<ExtractionResult>;
     /**
-     * Wait for a job to complete using the job status endpoint
+     * Checks if extraction was successful
      */
-    waitForJobCompletion(workflowId: string, jobId: string, options?: JobWaitOptions): Promise<FinishedJob>;
+    private isExtractionSuccessful;
 }
 
 /**
- * Raw content format options
+ * Schemas domain ACL.
+ * Wraps generated SchemasApi requests/responses and normalizes types.
+ * Downstream code must import from this module instead of `generated/**`.
+ *
+ * NOTE: This ACL uses type aliases instead of explicit classes/interfaces because:
+ * - The generated types (CreateSchemaBody, UpdateSchemaBody, SchemaResponse) are flat interfaces
+ * - They contain only primitive fields and simple nested types (SchemaResponseSchemaInner)
+ * - No enums or complex nested structures that could leak implementation details
+ * - The types are stable and unlikely to change in structure
  */
-type RawFormat = "html" | "markdown" | "url";
+
 /**
- * Data type for schema fields
+ * Request to create a new schema.
+ * Re-exported from generated CreateSchemaBody model with JSDoc preserved.
  */
-type DataType = (typeof ExtractionSchemaFieldDataTypeEnum)[keyof typeof ExtractionSchemaFieldDataTypeEnum];
+type CreateSchemaRequest = CreateSchemaBody;
 /**
- * Optional configuration for schema fields
+ * Request to update an existing schema.
+ * Re-exported from generated UpdateSchemaBody model with JSDoc preserved.
  */
-interface FieldOptions {
-    /**
-     * Example value for the field (required for STRING, IMAGE, LINK, OBJECT, ARRAY)
-     * Can be a string or an array of strings
-     */
-    example?: ExtractionSchemaFieldExample;
-    /**
-     * Whether this field is a primary key
-     */
-    isKey?: boolean;
-}
+type UpdateSchemaRequest = UpdateSchemaBody;
+/**
+ * Schema response data.
+ * Re-exported from generated SchemaResponse model with JSDoc preserved.
+ */
+type SchemaResponse = SchemaResponse$1;
+/**
+ * Schema field definition.
+ * Re-exported from generated SchemaResponseSchemaInner model.
+ */
+type SchemaField = SchemaResponseSchemaInner;
+/**
+ * Example value for a field.
+ * Re-exported from generated ExtractionSchemaFieldExample model.
+ */
+type FieldExample = ExtractionSchemaFieldExample;
 /**
- * Category definition for classification fields
+ * Category definition for classification fields.
+ * Re-exported from generated ExtractionClassificationFieldCategoriesInner model.
  */
 type Category = ExtractionClassificationFieldCategoriesInner;
 
 /**
- * Base builder for extraction configuration
+ * Optional configuration for schema fields
  */
-declare class ExtractionBuilder {
-    protected fields: SchemaField[];
-    protected schemaName?: string;
-    protected schemaId?: string;
-    /**
-     * Start defining a custom schema with fields
-     * @param name - The entity name (e.g., "Product", "Article")
-     */
-    schema(name: string): SchemaBuilder;
-    /**
-     * Use an existing schema by ID
-     * @param schemaId - The schema ID to reference
-     */
-    useSchema(schemaId: string): this;
-    /**
-     * Extract raw page content without transformation
-     * @param format - Raw content format(s): "html", "markdown", or "url"
-     */
-    raw(format: RawFormat | RawFormat[]): this;
-    /**
-     * Get the fields array (internal use)
-     */
-    getFields(): SchemaField[];
+interface FieldOptions {
     /**
-     * Get the schema name (internal use)
+     * Example value for the field (required for STRING, IMAGE, LINK, OBJECT, ARRAY)
+     * Can be a string or an array of strings
      */
-    getSchemaName(): string | undefined;
+    example?: FieldExample;
     /**
-     * Get the schema ID (internal use)
+     * Whether this field is a primary key
      */
-    getSchemaId(): string | undefined;
+    isKey?: boolean;
 }
 /**
  * Builder for defining custom schemas with fields
  */
-declare class SchemaBuilder extends ExtractionBuilder {
+declare class SchemaBuilder {
     private static readonly FIELD_NAME_PATTERN;
     private static readonly TYPES_REQUIRING_EXAMPLE;
-    constructor(parentBuilder: ExtractionBuilder);
+    readonly fields: SchemaField[];
+    entityName?: string;
+    entity(entityName: string): this;
     /**
      * Add a structured field to the schema
      * @param name - Field name (alphanumeric only)
@@ -6236,10 +6201,15 @@ declare class SchemaBuilder extends ExtractionBuilder {
      */
     classify(name: string, description: string, categories: Category[]): this;
     /**
-     * Add raw page content alongside structured fields
-     * @param format - Raw content format(s): "html", "markdown", or "url"
+     * Add raw page content to extract
+     * @param name - Raw content format(s): "html", "markdown", or "url"
      */
-    raw(format: RawFormat | RawFormat[]): this;
+    raw(name: RawFormat | RawFormat[]): this;
+    build(): {
+        entityName: string;
+        fields: SchemaField[];
+    };
+    private validateFieldName;
 }
 
 interface ExtractOptionsInternal {
@@ -6251,33 +6221,25 @@ interface ExtractOptionsInternal {
     bypassPreview?: boolean;
     interval?: WorkflowInterval;
     schedules?: string[];
-    location?: LocationConfig$1;
+    location?: LocationConfig;
 }
 interface ExtractOptions extends Omit<ExtractOptionsInternal, "navigationMode" | "entity"> {
     navigationMode?: NavigationMode;
-    /**
-     * Extraction configuration builder function
-     * @example
-     * ```typescript
-     * extraction: builder => builder
-     *   .schema("Product")
-     *   .field("title", "Product name", "STRING", { example: "Example Product" })
-     *   .field("price", "Product price", "CURRENCY")
-     * ```
-     */
-    extraction?: (builder: ExtractionBuilder) => ExtractionBuilder;
+    extraction?: (builder: SchemaBuilder) => SchemaBuilder | {
+        schemaId: string;
+    };
 }
 interface PreparedExtraction {
     options: ExtractOptionsInternal;
     withNotifications: (options: NotificationOptions) => PreparedExtraction;
-    withMonitoring: (options: MonitoringConfig) => PreparedExtraction;
+    withMonitoring: (options: WorkflowMonitoringConfig) => PreparedExtraction;
     setInterval: (options: {
         interval: WorkflowInterval;
     } | {
         schedules: string[];
     }) => PreparedExtraction;
     bypassPreview: () => PreparedExtraction;
-    setLocation: (options: LocationConfig$1) => PreparedExtraction;
+    setLocation: (options: LocationConfig) => PreparedExtraction;
     create: () => Promise<CreatedExtraction>;
 }
 interface RunWorkflowOptions {
@@ -6299,6 +6261,265 @@ interface FinishedExtraction {
     fetchData: (options: Omit<FetchDataOptions, "workflowId" | "runId">) => Promise<FetchDataResult>;
     fetchAllData: (options: Omit<FetchDataOptions, "workflowId" | "runId" | "page" | "limit">) => Promise<object[]>;
 }
+declare class ExtractionBuilderService {
+    private readonly workflowsCoreService;
+    private readonly entityResolverService;
+    private readonly dataFetcherService;
+    private readonly notificationSetupService;
+    private _options;
+    private _workflowId;
+    private _jobId;
+    private _notificationOptions;
+    private _monitoringOptions;
+    get options(): ExtractOptionsInternal;
+    get notificationOptions(): NotificationOptions | undefined;
+    get monitoringOptions(): WorkflowMonitoringConfig | undefined;
+    get workflowId(): string;
+    get jobId(): string;
+    constructor(workflowsCoreService: WorkflowsCoreService, entityResolverService: EntityResolverService, dataFetcherService: DataFetcherService, notificationSetupService: NotificationSetupService);
+    extract({ urls, name, description, navigationMode, extraction, }: ExtractOptions): PreparedExtraction;
+    withNotifications(options: Omit<NotificationOptions, "workflowId">): PreparedExtraction;
+    withMonitoring(options: WorkflowMonitoringConfig): PreparedExtraction;
+    bypassPreview(): PreparedExtraction;
+    setInterval(options: {
+        interval: WorkflowInterval;
+    } | {
+        schedules: string[];
+    }): PreparedExtraction;
+    setLocation(options: LocationConfig): PreparedExtraction;
+    create(): Promise<CreatedExtraction>;
+    run(options?: RunWorkflowOptions): Promise<FinishedExtraction>;
+    submit(options?: RunWorkflowOptions): Promise<SubmittedExtraction>;
+    fetchData(options: Omit<FetchDataOptions, "workflowId" | "runId">): Promise<FetchDataResult>;
+    fetchAllData(options: Omit<FetchDataOptions, "workflowId" | "runId" | "page" | "limit">): Promise<object[]>;
+}
+
+interface RealtimeConfig {
+    teamApiKey: string;
+    heartbeatInterval?: number;
+    reconnectDelay?: number;
+    missedHeartbeatsLimit?: number;
+}
+declare class Realtime {
+    private socket?;
+    private heartbeatInterval;
+    private reconnectDelay;
+    private lastHeartbeat;
+    private isConnecting;
+    private missedHeartbeatsLimit;
+    private missedHeartbeatCheckTimer?;
+    private teamApiKey?;
+    private eventListeners;
+    private connectionListeners;
+    private errorListeners;
+    constructor(config: RealtimeConfig);
+    connect(): Promise<void>;
+    private handleHeartbeat;
+    private notifyEventListeners;
+    private notifyConnectionListeners;
+    private notifyErrorListeners;
+    private startHeartbeatCheck;
+    private stopHeartbeatCheck;
+    /**
+     * Subscribe to realtime events
+     * @param listener Function to handle incoming events
+     * @returns Function to unsubscribe
+     */
+    onEvent(listener: (event: unknown) => void): () => void;
+    /**
+     * Subscribe to connection state changes
+     * @param listener Function to handle connection state changes
+     * @returns Function to unsubscribe
+     */
+    onConnection(listener: (connected: boolean, reason?: string) => void): () => void;
+    /**
+     * Subscribe to errors
+     * @param listener Function to handle errors
+     * @returns Function to unsubscribe
+     */
+    onError(listener: (error: unknown) => void): () => void;
+    close(): void;
+    isConnected(): boolean;
+}
+
+/**
+ * Service for managing schemas
+ */
+declare class SchemasService {
+    private readonly schemasApi;
+    constructor(client: KadoaClient);
+    /**
+     * Create a schema builder with fluent API and inline create support.
+     */
+    builder(entityName: string): SchemaBuilder & {
+        create(name?: string): Promise<SchemaResponse>;
+    };
+    /**
+     * Get a schema by ID
+     */
+    getSchema(schemaId: string): Promise<SchemaResponse>;
+    /**
+     * List all schemas
+     */
+    listSchemas(): Promise<SchemaResponse[]>;
+    /**
+     * Create a new schema
+     */
+    createSchema(body: CreateSchemaRequest): Promise<SchemaResponse>;
+    /**
+     * Update an existing schema
+     */
+    updateSchema(schemaId: string, body: UpdateSchemaRequest): Promise<SchemaResponse>;
+    /**
+     * Delete a schema
+     */
+    deleteSchema(schemaId: string): Promise<void>;
+}
+
+/**
+ * Validation domain ACL.
+ * Wraps generated DataValidationApi requests/responses and normalizes enums.
+ * Downstream code must import from this module instead of `generated/**`.
+ */
+
+/**
+ * Rule status enum.
+ */
+declare const RuleStatus: {
+    readonly Preview: "preview";
+    readonly Enabled: "enabled";
+    readonly Disabled: "disabled";
+};
+type RuleStatus = (typeof RuleStatus)[keyof typeof RuleStatus];
+/**
+ * Rule type enum.
+ */
+declare const RuleType: {
+    readonly CustomSql: "custom_sql";
+};
+type RuleType = (typeof RuleType)[keyof typeof RuleType];
+/**
+ * Validation strategy enum.
+ */
+declare const ValidationStrategy: {
+    readonly Isolated: "ISOLATED";
+    readonly LinkingColumns: "LINKING_COLUMNS";
+};
+type ValidationStrategy = (typeof ValidationStrategy)[keyof typeof ValidationStrategy];
+/**
+ * Include deleted rules parameter.
+ */
+type IncludeDeletedRules = V4DataValidationRulesGetIncludeDeletedParameter;
+declare class ListRulesRequest implements DataValidationApiV4DataValidationRulesGetRequest {
+    groupId?: string;
+    workflowId?: string;
+    status?: RuleStatus;
+    page?: number;
+    pageSize?: number;
+    includeDeleted?: IncludeDeletedRules;
+}
+type CreateRuleRequest = CreateRule;
+type GenerateRuleRequest = GenerateRule;
+type GenerateRulesRequest = GenerateRules;
+type UpdateRuleRequest = UpdateRule;
+interface DisableRuleRequest {
+    ruleId: string;
+    disableRule?: DisableRule;
+}
+type BulkApproveRulesRequest = BulkApproveRules;
+type BulkDeleteRulesRequest = BulkDeleteRules;
+type DeleteAllRulesRequest = DeleteRuleWithReason;
+/**
+ * Rule with SDK-curated enum types.
+ * Remaps generated enum fields to prevent type leakage.
+ */
+interface Rule extends Omit<Rule$1, "status" | "ruleType"> {
+    status: RuleStatus;
+    ruleType?: RuleType;
+}
+type ListRulesResponse = RulesListResponse;
+type BulkApproveRulesResponseData = BulkApproveRulesResponse["data"];
+type BulkDeleteRulesResponseData = BulkDeleteRulesResponse["data"];
+type DeleteAllRulesResponseData = DeleteAllRulesResponse["data"];
+declare class ListWorkflowValidationsRequest implements DataValidationApiV4DataValidationWorkflowsWorkflowIdJobsJobIdValidationsGetRequest {
+    workflowId: string;
+    jobId: string;
+    page?: number;
+    pageSize?: number;
+    includeDryRun?: boolean | null;
+}
+type ListValidationsResponse = ValidationListResponse;
+/**
+ * Validation report with SDK-curated enum types.
+ */
+interface GetValidationResponse extends Omit<DataValidationReport, "strategy"> {
+    strategy?: ValidationStrategy;
+}
+type ToggleValidationResponse = V4DataValidationWorkflowsWorkflowIdValidationTogglePut200Response;
+
+type GetAnomaliesByRuleResponse = AnomaliesByRuleResponse;
+type GetAnomalyRulePageResponse = AnomalyRulePageResponse;
+
+declare class ValidationCoreService {
+    private readonly validationApi;
+    constructor(client: KadoaClient);
+    listWorkflowValidations(filters: ListWorkflowValidationsRequest): Promise<ListValidationsResponse>;
+    getValidationDetails(validationId: string): Promise<GetValidationResponse>;
+    scheduleValidation(workflowId: string, jobId: string): Promise<ScheduleValidationResponse>;
+    toggleValidationEnabled(workflowId: string): Promise<ToggleValidationResponse>;
+    getLatestValidation(workflowId: string, jobId?: string): Promise<GetValidationResponse>;
+    getValidationAnomalies(validationId: string): Promise<GetAnomaliesByRuleResponse>;
+    getValidationAnomaliesByRule(validationId: string, ruleName: string): Promise<GetAnomalyRulePageResponse>;
+    waitUntilCompleted(validationId: string, options?: PollingOptions): Promise<GetValidationResponse>;
+}
+
+/**
+ * Service for managing data validation rules
+ */
+declare class ValidationRulesService {
+    private readonly validationApi;
+    constructor(client: KadoaClient);
+    listRules(options?: ListRulesRequest): Promise<ListRulesResponse>;
+    getRuleById(ruleId: string): Promise<Rule | undefined>;
+    getRuleByName(name: string): Promise<Rule | undefined>;
+    createRule(data: CreateRuleRequest): Promise<Rule>;
+    updateRule(ruleId: string, updateData: UpdateRuleRequest): Promise<Rule>;
+    disableRule(data: DisableRuleRequest): Promise<Rule>;
+    generateRule(data: GenerateRuleRequest): Promise<Rule>;
+    generateRules(data: GenerateRulesRequest): Promise<Rule[]>;
+    bulkApproveRules(data: BulkApproveRulesRequest): Promise<BulkApproveRulesResponseData>;
+    bulkDeleteRules(data: BulkDeleteRulesRequest): Promise<BulkDeleteRulesResponseData>;
+    deleteAllRules(data: DeleteAllRulesRequest): Promise<DeleteAllRulesResponseData>;
+}
+
+/**
+ * Facade exposing validation operations directly on the client validation domain,
+ * while preserving access to the underlying `rules` services.
+ */
+interface ValidationDomain {
+    /** Rule management utilities. */
+    rules: ValidationRulesService;
+    /**
+     * Schedule a validation run for a workflow/job.
+     *
+     * Example: `await client.validation.schedule(workflowId, jobId)`
+     */
+    schedule: (...args: Parameters<ValidationCoreService["scheduleValidation"]>) => ReturnType<ValidationCoreService["scheduleValidation"]>;
+    /** List validations for a workflow/job. */
+    listWorkflowValidations: (...args: Parameters<ValidationCoreService["listWorkflowValidations"]>) => ReturnType<ValidationCoreService["listWorkflowValidations"]>;
+    /** Get details for a specific validation. */
+    getValidationDetails: (...args: Parameters<ValidationCoreService["getValidationDetails"]>) => ReturnType<ValidationCoreService["getValidationDetails"]>;
+    /** Enable/disable validation for a workflow. */
+    toggleEnabled: (...args: Parameters<ValidationCoreService["toggleValidationEnabled"]>) => ReturnType<ValidationCoreService["toggleValidationEnabled"]>;
+    /** Get the latest validation for a workflow (optionally filtered by job). */
+    getLatest: (...args: Parameters<ValidationCoreService["getLatestValidation"]>) => ReturnType<ValidationCoreService["getLatestValidation"]>;
+    /** Get aggregated anomalies for a validation. */
+    getAnomalies: (...args: Parameters<ValidationCoreService["getValidationAnomalies"]>) => ReturnType<ValidationCoreService["getValidationAnomalies"]>;
+    /** Get anomalies for a specific rule. */
+    getAnomaliesByRule: (...args: Parameters<ValidationCoreService["getValidationAnomaliesByRule"]>) => ReturnType<ValidationCoreService["getValidationAnomaliesByRule"]>;
+    /** Wait until a validation completes; throws if validation fails. */
+    waitUntilCompleted: (...args: Parameters<ValidationCoreService["waitUntilCompleted"]>) => ReturnType<ValidationCoreService["waitUntilCompleted"]>;
+}
 
 interface KadoaClientStatus {
     baseUrl: string;
@@ -6324,6 +6545,15 @@ interface KadoaClientConfig {
         heartbeatInterval?: number;
     };
 }
+interface NotificationDomain {
+    channels: NotificationChannelsService;
+    settings: NotificationSettingsService;
+    setup: NotificationSetupService;
+    configure(options: NotificationOptions): Promise<NotificationSettings[]>;
+    setupForWorkflow(requestData: SetupWorkflowNotificationSettingsRequest): Promise<NotificationSettings[]>;
+    setupForWorkspace(requestData: SetupWorkspaceNotificationSettingsRequest): Promise<NotificationSettings[]>;
+}
+
 /**
  * KadoaClient provides an object-oriented interface to the Kadoa SDK
  *
@@ -6349,12 +6579,12 @@ declare class KadoaClient {
     private readonly _apiKey;
     private _realtime?;
     private _extractionBuilderService;
-    readonly extraction: ExtractionModule;
-    readonly workflow: WorkflowsModule;
-    readonly notification: NotificationsModule;
-    readonly schema: SchemasModule;
-    readonly user: UserModule;
-    readonly validation: ValidationModule;
+    readonly extraction: ExtractionService;
+    readonly workflow: WorkflowsCoreService;
+    readonly notification: NotificationDomain;
+    readonly schema: SchemasService;
+    readonly user: UserService;
+    readonly validation: ValidationDomain;
     constructor(config: KadoaClientConfig);
     /**
      * Get the underlying configuration
@@ -6455,19 +6685,63 @@ declare class KadoaClient {
     dispose(): void;
 }
 
-interface KadoaUser {
-    userId: string;
-    email: string;
-    featureFlags: string[];
+interface EntityPrediction {
+    entity: string;
+    fields: SchemaField$1[];
+    primaryKeyField?: string;
+    expectedResults?: string;
 }
-declare class UserService {
+interface EntityRequestOptions {
+    link: string;
+    location?: LocationConfig;
+    navigationMode?: string;
+}
+interface ResolvedEntity {
+    entity: string;
+    fields: SchemaField$1[];
+}
+type EntityConfig = "ai-detection" | {
+    schemaId: string;
+} | {
+    name: string;
+    fields: SchemaField$1[];
+};
+/**
+ * Service for resolving entities and their fields from various sources
+ *
+ * NOTE: This is a workaround for the /v4/entity endpoint which is not yet exposed in the OpenAPI spec.
+ * Once the endpoint is added to the OpenAPI specification, this manual implementation should be
+ * replaced with the generated client code.
+ */
+declare class EntityResolverService {
     private readonly client;
+    private readonly schemasService;
     constructor(client: KadoaClient);
     /**
-     * Get current user details
-     * @returns User details
+     * Resolves entity and fields from the provided entity configuration
+     *
+     * @param entityConfig The entity configuration to resolve
+     * @param options Additional options for AI detection
+     * @returns Resolved entity with fields
      */
-    getCurrentUser(): Promise<KadoaUser>;
+    resolveEntity(entityConfig: EntityConfig, options?: {
+        link?: string;
+        location?: LocationConfig;
+        navigationMode?: string;
+    }): Promise<ResolvedEntity>;
+    /**
+     * Fetches entity fields dynamically from the /v4/entity endpoint.
+     * This is a workaround implementation using native fetch since the endpoint
+     * is not yet included in the OpenAPI specification.
+     *
+     * @param options Request options including the link to analyze
+     * @returns EntityPrediction containing the detected entity type and fields
+     */
+    fetchEntityFields(options: EntityRequestOptions): Promise<EntityPrediction>;
+    /**
+     * Validates entity request options
+     */
+    private validateEntityOptions;
 }
 
 declare const KadoaErrorCode: {
@@ -6520,6 +6794,9 @@ declare class KadoaSdkException extends Error {
         readonly SCHEMA_NOT_FOUND: "Schema not found";
         readonly SCHEMA_FETCH_ERROR: "Failed to fetch schema";
         readonly SCHEMAS_FETCH_ERROR: "Failed to fetch schemas";
+        readonly SCHEMA_CREATE_FAILED: "Failed to create schema";
+        readonly SCHEMA_UPDATE_FAILED: "Failed to update schema";
+        readonly SCHEMA_DELETE_FAILED: "Failed to delete schema";
     };
     constructor(message: string, options?: KadoaSdkExceptionOptions);
     static from(error: unknown, details?: Record<string, unknown>): KadoaSdkException;
@@ -6558,6 +6835,9 @@ declare const ERROR_MESSAGES: {
     readonly SCHEMA_NOT_FOUND: "Schema not found";
     readonly SCHEMA_FETCH_ERROR: "Failed to fetch schema";
     readonly SCHEMAS_FETCH_ERROR: "Failed to fetch schemas";
+    readonly SCHEMA_CREATE_FAILED: "Failed to create schema";
+    readonly SCHEMA_UPDATE_FAILED: "Failed to update schema";
+    readonly SCHEMA_DELETE_FAILED: "Failed to delete schema";
 };
 
 type KadoaHttpExceptionOptions = {
@@ -6590,4 +6870,4 @@ declare class KadoaHttpException extends KadoaSdkException {
     static mapStatusToCode(errorOrStatus: AxiosError | number): KadoaErrorCode;
 }
 
-export { ERROR_MESSAGES, type FinishedJob, KadoaClient, type KadoaClientConfig, KadoaErrorCode, KadoaHttpException, KadoaSdkException, type KadoaUser, type ListRulesOptions, type LocationConfig, type PollingOptions, type RunWorkflowInput, type Schema, type SchemaField, SchemasModule, type StartedJob, ValidationModule, pollUntil };
+export { type BulkApproveRulesRequest, type BulkApproveRulesResponseData, type BulkDeleteRulesRequest, type BulkDeleteRulesResponseData, type Category, type ChannelConfig, type ChannelSetupRequestConfig, type CreateChannelRequest, type CreateRuleRequest, type CreateSchemaRequest, type CreateSettingsRequest, type CreateWorkflowInput, type CreateWorkflowRequest, type CreateWorkflowWithCustomSchemaRequest, type CreatedExtraction, DataFetcherService, type DataPagination, DataSortOrder, type DataType, type DeleteAllRulesRequest, type DeleteAllRulesResponseData, type DisableRuleRequest, ERROR_MESSAGES, type EmailChannelConfig, EntityResolverService, type ExtractOptions, ExtractionBuilderService, type ExtractionOptions, type ExtractionResult, ExtractionService, FetchDataOptions, type FetchDataResult, type FieldExample, type FieldOptions, type FieldType, type FinishedExtraction, type GenerateRuleRequest, type GenerateRulesRequest, type GetAnomaliesByRuleResponse, type GetAnomalyRulePageResponse, type GetJobResponse, type GetValidationResponse, type GetWorkflowResponse, type JobId, JobStateEnum, type JobWaitOptions, KadoaClient, type KadoaClientConfig, KadoaErrorCode, KadoaHttpException, KadoaSdkException, type KadoaUser, ListChannelsRequest, ListRulesRequest, type ListRulesResponse, ListSettingsRequest, type ListValidationsResponse, ListWorkflowValidationsRequest, ListWorkflowsRequest, type LocationConfig, type MetadataKey, type MonitoringConfig, type MonitoringField, type MonitoringOperator, MonitoringStatus, type NavigationMode, type NotificationChannel, type NotificationChannelConfig, NotificationChannelType, NotificationChannelsService, type NotificationDomain, type NotificationOptions, type NotificationSettings, type NotificationSettingsEventType, V5NotificationsSettingsGetEventTypeEnum as NotificationSettingsEventTypeEnum, NotificationSettingsService, type NotificationSetupRequestChannels, NotificationSetupService, type PollingOptions, type PreparedExtraction, type RawFormat, Realtime, ResponseFormat, type Rule, RuleStatus, RuleType, type RunWorkflowRequest, type RunWorkflowResponse, type ScheduleValidationResponse, SchemaBuilder, type SchemaField as SchemaDefinitionField, type SchemaField$1 as SchemaField, SchemaFieldDataType, type SchemaResponse, SchemasService, type SetupWorkflowNotificationSettingsRequest, type SetupWorkspaceNotificationSettingsRequest, type SlackChannelConfig, type SubmitExtractionResult, type SubmittedExtraction, type ToggleValidationResponse, UpdateInterval, type UpdateRuleRequest, type UpdateSchemaRequest, UserService, ValidationCoreService, type ValidationDomain, ValidationRulesService, ValidationStrategy, type WaitOptions, type WebhookChannelConfig, type WebhookChannelConfigAuth, type WebhookHttpMethod, type WebsocketChannelConfig, type WorkflowDataResponse, type WorkflowDetailsResponse, WorkflowDisplayStateEnum, type WorkflowId, type WorkflowInterval, type WorkflowMonitoringConfig, type WorkflowResponse, WorkflowState, WorkflowStateEnum, type WorkflowsApiInterface, WorkflowsCoreService, pollUntil };