@kadoa/node-sdk 0.13.0 → 0.15.0

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
@@ -671,7 +670,7 @@ interface CreateSchemaBody {
     /**
      * Entity type for the schema
      */
-    'entity': string;
+    'entity'?: string;
     /**
      * Array of field definitions
      */
@@ -799,7 +798,7 @@ interface MonitoringConfig {
     /**
      * Fields to monitor
      */
-    'fields': Array<MonitoredField>;
+    'fields'?: Array<MonitoredField>;
     /**
      * Notification channels
      */
@@ -997,7 +996,7 @@ interface CreateWorkflowWithCustomSchemaBody {
     /**
      * Entity name for extraction
      */
-    'entity': string;
+    'entity'?: string;
     /**
      * Schema fields for extraction
      */
@@ -1425,6 +1424,7 @@ type DataValidationReportStrategyEnum = typeof DataValidationReportStrategyEnum[
 interface DeleteAllRulesResponseData$1 {
     'deletedCount': number;
     'workflowId'?: string;
+    'deletedRuleIds': Array<string>;
 }
 
 /**
@@ -1561,7 +1561,7 @@ interface RuleParameters {
 /**
  * Complete validation rule with metadata and lifecycle information
  */
-interface Rule {
+interface Rule$1 {
     /**
      * Unique identifier
      */
@@ -1647,7 +1647,7 @@ interface GenerateRules {
  */
 interface RulesListResponse {
     'error': boolean;
-    'data': Array<Rule>;
+    'data': Array<Rule$1>;
     'pagination': PaginationMeta;
 }
 
@@ -1717,7 +1717,7 @@ interface SchemaResponseDescription {
 /**
  * Schema object response
  */
-interface SchemaResponse {
+interface SchemaResponse$1 {
     /**
      * Unique identifier for the schema
      */
@@ -2292,6 +2292,76 @@ declare const V4WorkflowsWorkflowIdGet200ResponseSchemaInnerDataTypeEnum: {
 };
 type V4WorkflowsWorkflowIdGet200ResponseSchemaInnerDataTypeEnum = typeof V4WorkflowsWorkflowIdGet200ResponseSchemaInnerDataTypeEnum[keyof typeof V4WorkflowsWorkflowIdGet200ResponseSchemaInnerDataTypeEnum];
 
+/**
+ * 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.
+ */
+/**
+ * Additional context about the error
+ */
+interface V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInnerErrorsInnerContext {
+    [key: string]: any;
+    /**
+     * The URL where the error occurred
+     */
+    'url'?: string;
+    /**
+     * HTTP status code if applicable
+     */
+    'httpStatus'?: number;
+    /**
+     * Number of retry attempts made
+     */
+    'retryCount'?: number;
+    /**
+     * Additional error-specific details
+     */
+    'details'?: string;
+    /**
+     * When the error context was captured
+     */
+    'timestamp'?: 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 V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInnerErrorsInner {
+    /**
+     * 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;
+    'context'?: V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInnerErrorsInnerContext;
+}
+
 /**
  * Kadoa API
  * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
@@ -2349,10 +2419,6 @@ interface V4WorkflowsGet200ResponseWorkflowsInner {
      * When the last job started
      */
     'startedAt'?: string;
-    /**
-     * Protocol information from last job
-     */
-    'protocol'?: string;
     /**
      * ID of the last job
      */
@@ -2406,6 +2472,10 @@ interface V4WorkflowsGet200ResponseWorkflowsInner {
      * Whether the schema can be edited
      */
     'isSchemaEditable'?: boolean;
+    /**
+     * Errors from the last job run
+     */
+    'errors'?: Array<V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInnerErrorsInner>;
     'dataValidation'?: V4WorkflowsGet200ResponseWorkflowsInnerDataValidation;
     'validationStatistics'?: V4WorkflowsGet200ResponseWorkflowsInnerValidationStatistics;
     /**
@@ -2438,6 +2508,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: {
@@ -2745,6 +2816,40 @@ interface V4WorkflowsWorkflowIdGet200ResponseDataValidation {
     'ruleCounts'?: V4WorkflowsWorkflowIdGet200ResponseDataValidationRuleCounts;
 }
 
+/**
+ * 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 V4WorkflowsWorkflowIdGet200ResponseErrorsInner {
+    /**
+     * 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)
@@ -2852,14 +2957,14 @@ interface V4WorkflowsWorkflowIdGet200Response {
      * When the last job started
      */
     'startedAt'?: string;
-    /**
-     * Protocol information from last job
-     */
-    'protocol'?: string;
     /**
      * Database key for the workflow data
      */
     'dataKey'?: string;
+    /**
+     * Errors from the last job run
+     */
+    'errors'?: Array<V4WorkflowsWorkflowIdGet200ResponseErrorsInner>;
     /**
      * Cost of the last job run in credits
      */
@@ -2949,28 +3054,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)
@@ -3008,7 +3091,10 @@ interface V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInner {
      * Number of records processed in the workflow run
      */
     'records'?: number;
-    'protocol'?: V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInnerProtocol;
+    /**
+     * Errors that occurred during the workflow run
+     */
+    'errors'?: Array<V4WorkflowsWorkflowIdHistoryGet200ResponseWorkflowRunsInnerErrorsInner>;
     /**
      * Number of credits used for this workflow run
      */
@@ -4458,51 +4544,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.
  */
@@ -4514,35 +4555,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.
  */
@@ -5078,7 +5090,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;
     /**
@@ -5484,108 +5496,195 @@ 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/**`.
+ */
 
 /**
- * Simple page-based pagination info
- * Maps directly to the most common API pagination format
+ * Workflow state filter for list queries.
  */
-interface PageInfo {
-    /** Total number of items */
-    totalCount?: number;
-    /** Current page number */
-    page?: number;
-    /** Total number of pages */
-    totalPages?: number;
-    /** Number of items per page */
-    limit?: number;
-}
+declare const WorkflowState: {
+    readonly Active: "ACTIVE";
+    readonly Error: "ERROR";
+    readonly Paused: "PAUSED";
+    readonly NotSupported: "NOT_SUPPORTED";
+};
+type WorkflowState = (typeof WorkflowState)[keyof typeof WorkflowState];
 /**
- * Paginated response with data and pagination info
- * @template T The type of items in the data array
+ * Monitoring status filter.
  */
-interface PagedResponse<T> {
-    /** Array of items for the current page */
-    data: T[];
-    /** Pagination metadata */
-    pagination: PageInfo;
-}
-
-interface FetchDataResult extends PagedResponse<object> {
-    workflowId: string;
-    runId?: string | null;
-    executedAt?: string | null;
-}
-type FetchDataOptions = Partial<Pick<WorkflowsApiV4WorkflowsWorkflowIdDataGetRequest, "runId" | "sortBy" | "order" | "filters" | "page" | "limit" | "includeAnomalies">> & {
-    workflowId: string;
+declare const MonitoringStatus: {
+    readonly Enabled: "true";
+    readonly Disabled: "false";
 };
+type MonitoringStatus = (typeof MonitoringStatus)[keyof typeof MonitoringStatus];
 /**
- * Service for fetching workflow data with pagination support
+ * Update interval filter.
  */
-declare class DataFetcherService {
-    private readonly workflowsApi;
-    private readonly defaultLimit;
-    constructor(workflowsApi: WorkflowsApiInterface);
-    /**
-     * Fetch a page of workflow data
-     */
-    fetchData(options: FetchDataOptions): Promise<FetchDataResult>;
-    /**
-     * Fetch all pages of workflow data
-     */
-    fetchAllData(options: FetchDataOptions): Promise<object[]>;
-    /**
-     * Create an async iterator for paginated data fetching
-     */
-    fetchDataPages(options: FetchDataOptions): AsyncGenerator<FetchDataResult, void, unknown>;
+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">;
@@ -5595,68 +5694,282 @@ type MonitoringOperator = (typeof V4WorkflowsWorkflowIdMetadataPutRequestMonitor
 type MonitoringField = V4WorkflowsWorkflowIdMetadataPutRequestMonitoringFieldsInner & {
     isKeyField?: boolean;
 };
-type LocationConfig$1 = Location;
+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;
 
-type SchemaField = ExtractionSchemaField | ExtractionClassificationField | ExtractionMetadataField;
-interface EntityPrediction {
-    entity: string;
-    fields: SchemaField[];
-    primaryKeyField?: string;
-    expectedResults?: string;
+/**
+ * Simple page-based pagination info
+ * Maps directly to the most common API pagination format
+ */
+interface PageInfo {
+    /** Total number of items */
+    totalCount?: number;
+    /** Current page number */
+    page?: number;
+    /** Total number of pages */
+    totalPages?: number;
+    /** Number of items per page */
+    limit?: number;
 }
-interface EntityRequestOptions {
-    link: string;
-    location?: LocationConfig$1;
-    navigationMode?: string;
+/**
+ * Paginated response with data and pagination info
+ * @template T The type of items in the data array
+ */
+interface PagedResponse<T> {
+    /** Array of items for the current page */
+    data: T[];
+    /** Pagination metadata */
+    pagination: PageInfo;
 }
-interface ResolvedEntity {
-    entity: string;
-    fields: SchemaField[];
+
+interface FetchDataResult extends PagedResponse<object> {
+    workflowId: string;
+    runId?: string | null;
+    executedAt?: string | null;
 }
-type EntityConfig = "ai-detection" | {
-    schemaId: 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.
+ * Service for fetching workflow data with pagination support
  */
-declare class EntityResolverService {
+declare class DataFetcherService {
+    private readonly workflowsApi;
+    private readonly defaultLimit;
+    constructor(workflowsApi: WorkflowsApiInterface);
+    /**
+     * Fetch a page of workflow data
+     */
+    fetchData(options: FetchDataOptions): Promise<FetchDataResult>;
+    /**
+     * Fetch all pages of workflow data
+     */
+    fetchAllData(options: FetchDataOptions): Promise<object[]>;
+    /**
+     * Create an async iterator for paginated data fetching
+     */
+    fetchDataPages(options: FetchDataOptions): AsyncGenerator<FetchDataResult, void, unknown>;
+}
+
+interface KadoaUser {
+    userId: string;
+    email: string;
+    featureFlags: string[];
+}
+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
+     * Get current user details
+     * @returns User details
      */
-    resolveEntity(entityConfig: EntityConfig, options?: {
-        link?: string;
-        location?: LocationConfig$1;
-        navigationMode?: string;
-    }): Promise<ResolvedEntity>;
+    getCurrentUser(): Promise<KadoaUser>;
+}
+
+/**
+ * Notifications domain ACL.
+ * Wraps generated NotificationsApi requests/responses and normalizes types.
+ * Downstream code must import from this module instead of `generated/**`.
+ */
+
+/**
+ * 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;
+}
+/**
+ * Request to create a notification channel with SDK-curated enum types.
+ */
+interface CreateChannelRequest extends Omit<V5NotificationsChannelsPostRequest, "channelType"> {
+    channelType: NotificationChannelType;
+}
+/**
+ * Notification channel response.
+ * Note: Response types are simple DTOs without enum fields that need remapping.
+ */
+type NotificationChannel = V5NotificationsChannelsGet200ResponseDataChannelsInner;
+/**
+ * Notification channel configuration (union type for all channel configs).
+ */
+type NotificationChannelConfig = V5NotificationsChannelsGet200ResponseDataChannelsInnerConfig;
+
+/**
+ * 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;
+}
+/**
+ * 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;
+
+declare class NotificationChannelsService {
     /**
-     * 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.
+     * Default channel name
      *
-     * @param options Request options including the link to analyze
-     * @returns EntityPrediction containing the detected entity type and fields
      */
-    fetchEntityFields(options: EntityRequestOptions): Promise<EntityPrediction>;
+    static readonly DEFAULT_CHANNEL_NAME = "default";
+    private readonly api;
+    private readonly userService;
+    constructor(notificationsApi: NotificationsApiInterface, userService: UserService);
+    listChannels(filters: ListChannelsRequest): Promise<NotificationChannel[]>;
     /**
-     * Validates entity request options
+     * List all channels (both workflow-specific and workspace-level)
+     * This is useful for finding workspace-level channels like WebSocket channels
+     * that might not be associated with a specific workflow
      */
-    private validateEntityOptions;
+    listAllChannels(workflowId?: string): Promise<NotificationChannel[]>;
+    deleteChannel(channelId: string): Promise<void>;
+    createChannel(type: NotificationChannelType, config?: Pick<CreateChannelRequest, "name" | "config">): Promise<NotificationChannel>;
+    private buildPayload;
+    private buildEmailChannelConfig;
+    private buildSlackChannelConfig;
+    private buildWebhookChannelConfig;
+    private buildWebsocketChannelConfig;
+}
+
+declare class NotificationSettingsService {
+    private readonly api;
+    constructor(notificationsApi: NotificationsApiInterface);
+    createSettings(requestData: CreateSettingsRequest): Promise<NotificationSettings>;
+    listSettings(filters: ListSettingsRequest): Promise<NotificationSettings[]>;
+    listAllEvents(): Promise<NotificationSettingsEventType[]>;
+    deleteSettings(settingsId: string): Promise<void>;
+}
+
+type ChannelSetupRequestConfig = ChannelConfig & {
+    /**
+     * The name of the email channel. "default" if not provided
+     */
+    name: string;
+};
+type NotificationSetupRequestChannels = {
+    /**
+     * - true: create a new email channel using user's default email
+     * - { channelId: string }: use existing email channel
+     * - EmailChannelConfig: create a new email channel using the provided configuration
+     */
+    EMAIL?: true | {
+        channelId: string;
+    } | (ChannelSetupRequestConfig & {
+        /**
+         * The name of the email channel. "default" if not provided
+         */
+        name: string;
+    });
+    /**
+     * - true: create a new websocket channel using user's default websocket
+     * - { channelId: string }: use existing websocket channel
+     */
+    WEBSOCKET?: true | {
+        channelId: string;
+    };
+    /**
+     * - { channelId: string }: use existing slack channel
+     * - SlackChannelConfig: create a new slack channel using the provided configuration
+     */
+    SLACK?: {
+        channelId: string;
+    } | (SlackChannelConfig & {
+        /**
+         * The name of the slack channel. "default" if not provided
+         */
+        name: string;
+    });
+    /**
+     * - { channelId: string }: use existing webhook channel
+     * - WebhookChannelConfig: create a new webhook channel using the provided configuration
+     */
+    WEBHOOK?: {
+        channelId: string;
+    } | (WebhookChannelConfig & {
+        /**
+         * The name of the webhook channel
+         */
+        name: string;
+    });
+};
+interface NotificationOptions {
+    workflowId?: string;
+    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
+     *
+     * @param requestData Workflow notification setup configuration
+     * @returns Array of created notification settings
+     */
+    setup(requestData: NotificationOptions): Promise<NotificationSettings[]>;
+    setupChannels(requestData: {
+        workflowId?: string;
+        channels: NotificationSetupRequestChannels;
+    }): Promise<NotificationChannel[]>;
+    private handleChannelsById;
+    private handleDefaultChannels;
+    private handleChannelsByConfig;
 }
 
 /**
@@ -5714,12 +6027,13 @@ interface PollingResult<T> {
  */
 declare function pollUntil<T>(pollFn: () => Promise<T>, isComplete: (result: T) => boolean, options?: PollingOptions): Promise<PollingResult<T>>;
 
-type LocationConfig = Location;
 type WorkflowId = string;
-type WorkflowStateEnum = V4WorkflowsGet200ResponseWorkflowsInnerStateEnum;
-type WorkflowState = WorkflowStateEnum[keyof WorkflowStateEnum];
-interface WaitOptions$1 extends PollingOptions {
-    targetState?: WorkflowState;
+type JobId = string;
+interface WaitOptions extends PollingOptions {
+    targetState?: WorkflowStateEnum;
+}
+interface JobWaitOptions extends PollingOptions {
+    targetStatus?: JobStateEnum;
 }
 interface CreateWorkflowInput {
     urls: string[];
@@ -5727,8 +6041,8 @@ interface CreateWorkflowInput {
     name: string;
     description?: string;
     schemaId?: string;
-    entity: string;
-    fields: Array<SchemaField>;
+    entity?: string;
+    fields: Array<SchemaField$1>;
     tags?: string[];
     interval?: WorkflowInterval;
     monitoring?: MonitoringConfig;
@@ -5737,174 +6051,33 @@ interface CreateWorkflowInput {
     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;
-}
-
-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>;
+    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$1): Promise<V4WorkflowsWorkflowIdGet200Response>;
+    wait(id: WorkflowId, options?: WaitOptions): Promise<GetWorkflowResponse>;
     /**
      * 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>;
-}
-
-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
-     *
-     */
-    static readonly DEFAULT_CHANNEL_NAME = "default";
-    private readonly api;
-    private readonly userService;
-    constructor(notificationsApi: NotificationsApiInterface, userService: UserService);
-    listChannels(filters: NotificationsApiV5NotificationsChannelsGetRequest): Promise<NotificationChannel[]>;
-    /**
-     * List all channels (both workflow-specific and workspace-level)
-     * This is useful for finding workspace-level channels like WebSocket channels
-     * that might not be associated with a specific workflow
-     */
-    listAllChannels(workflowId?: string): Promise<NotificationChannel[]>;
-    deleteChannel(channelId: string): Promise<void>;
-    createChannel(type: NotificationChannelType, config?: Pick<V5NotificationsChannelsPostRequest, "name" | "config">): Promise<NotificationChannel>;
-    private buildPayload;
-    private buildEmailChannelConfig;
-    private buildSlackChannelConfig;
-    private buildWebhookChannelConfig;
-    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[]>;
-    listAllEvents(): Promise<NotificationSettingsEventType[]>;
-    deleteSettings(settingsId: string): Promise<void>;
-}
-
-type ChannelSetupRequestConfig = ChannelConfig & {
-    /**
-     * The name of the email channel. "default" if not provided
-     */
-    name: string;
-};
-type NotificationSetupRequestChannels = {
-    /**
-     * - true: create a new email channel using user's default email
-     * - { channelId: string }: use existing email channel
-     * - EmailChannelConfig: create a new email channel using the provided configuration
-     */
-    EMAIL?: true | {
-        channelId: string;
-    } | (ChannelSetupRequestConfig & {
-        /**
-         * The name of the email channel. "default" if not provided
-         */
-        name: string;
-    });
-    /**
-     * - true: create a new websocket channel using user's default websocket
-     * - { channelId: string }: use existing websocket channel
-     */
-    WEBSOCKET?: true | {
-        channelId: string;
-    };
-    /**
-     * - { channelId: string }: use existing slack channel
-     * - SlackChannelConfig: create a new slack channel using the provided configuration
-     */
-    SLACK?: {
-        channelId: string;
-    } | (SlackChannelConfig & {
-        /**
-         * The name of the slack channel. "default" if not provided
-         */
-        name: string;
-    });
-    /**
-     * - { channelId: string }: use existing webhook channel
-     * - WebhookChannelConfig: create a new webhook channel using the provided configuration
+    runWorkflow(workflowId: WorkflowId, input: RunWorkflowRequest): Promise<RunWorkflowResponse>;
+    /**
+     * Get job status directly without polling workflow details
      */
-    WEBHOOK?: {
-        channelId: string;
-    } | (WebhookChannelConfig & {
-        /**
-         * The name of the webhook channel
-         */
-        name: string;
-    });
-};
-interface NotificationOptions {
-    workflowId?: string;
-    events?: NotificationSettingsEventType[] | "all";
-    channels?: NotificationSetupRequestChannels;
-}
-declare class NotificationSetupService {
-    private readonly channelsService;
-    private readonly settingsService;
-    constructor(channelsService: NotificationChannelsService, settingsService: NotificationSettingsService);
+    getJobStatus(workflowId: WorkflowId, jobId: JobId): Promise<GetJobResponse>;
     /**
-     * Complete workflow notification setup including channels and settings
-     *
-     * @param requestData Workflow notification setup configuration
-     * @returns Array of created notification settings
+     * Wait for a job to reach the target state or a terminal state
      */
-    setup(requestData: NotificationOptions): Promise<NotificationSettings[]>;
-    setupChannels(requestData: {
-        workflowId?: string;
-        channels: NotificationSetupRequestChannels;
-    }): Promise<NotificationChannel[]>;
-    private handleChannelsById;
-    private handleDefaultChannels;
-    private handleChannelsByConfig;
+    waitForJobCompletion(workflowId: WorkflowId, jobId: JobId, options?: JobWaitOptions): Promise<GetJobResponse>;
 }
 
 interface ExtractionOptionsInternal {
@@ -5914,13 +6087,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;
@@ -5930,7 +6103,7 @@ type ExtractionOptions = {
 } & Partial<Omit<ExtractionOptionsInternal, "urls">>;
 interface ExtractionResult {
     workflowId: string;
-    workflow?: V4WorkflowsWorkflowIdGet200Response;
+    workflow?: WorkflowDetailsResponse;
     data?: Array<object>;
     pagination?: PageInfo;
 }
@@ -5946,11 +6119,49 @@ declare class ExtractionService {
     private readonly dataFetcherService;
     private readonly entityResolverService;
     private readonly notificationSetupService;
-    constructor(workflowsCoreService: WorkflowsCoreService, dataFetcherService: DataFetcherService, entityResolverService: EntityResolverService, notificationSetupService: NotificationSetupService);
+    private readonly notificationChannelsService;
+    private readonly notificationSettingsService;
+    constructor(workflowsCoreService: WorkflowsCoreService, dataFetcherService: DataFetcherService, entityResolverService: EntityResolverService, notificationSetupService: NotificationSetupService, notificationChannelsService: NotificationChannelsService, notificationSettingsService: NotificationSettingsService);
+    /**
+     * Run an extraction workflow and wait for completion.
+     */
+    run(options: ExtractionOptions): Promise<ExtractionResult>;
+    /**
+     * Submit an extraction workflow for asynchronous processing.
+     */
+    submit(options: ExtractionOptions): Promise<SubmitExtractionResult>;
+    /**
+     * Trigger a workflow run without waiting for completion.
+     */
+    runJob(workflowId: string, input: RunWorkflowRequest): Promise<RunWorkflowResponse>;
+    /**
+     * Trigger a workflow run and wait for the job to complete.
+     */
+    runJobAndWait(workflowId: string, input: RunWorkflowRequest): Promise<GetJobResponse>;
+    /**
+     * Fetch a single page of extraction data.
+     */
+    fetchData(options: FetchDataOptions): Promise<FetchDataResult>;
+    /**
+     * Fetch all extraction data across all pages.
+     */
+    fetchAllData(options: FetchDataOptions): Promise<object[]>;
+    /**
+     * 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
      */
-    executeExtraction(options: ExtractionOptions): Promise<ExtractionResult | SubmitExtractionResult>;
+    private executeExtraction;
     /**
      * Validates extraction options
      */
@@ -5965,174 +6176,228 @@ declare class ExtractionService {
     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);
-    /**
-     * 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(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(options: ExtractionOptions): Promise<SubmitExtractionResult>;
-    /**
-     * Run a workflow with variables and optional limit
-     */
-    runJob(workflowId: string, input: RunWorkflowInput): Promise<StartedJob>;
-    /**
-     * Run a workflow and wait for it to complete
-     */
-    runJobAndWait(workflowId: string, input: RunWorkflowInput): Promise<FinishedJob>;
+/**
+ * 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
+ */
+
+/**
+ * Request to create a new schema.
+ * Re-exported from generated CreateSchemaBody model with JSDoc preserved.
+ */
+type CreateSchemaRequest = CreateSchemaBody;
+/**
+ * Request to update an existing schema.
+ * Re-exported from generated UpdateSchemaBody model with JSDoc preserved.
+ */
+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.
+ * Re-exported from generated ExtractionClassificationFieldCategoriesInner model.
+ */
+type Category = ExtractionClassificationFieldCategoriesInner;
+
+/**
+ * Optional configuration for schema fields
+ */
+interface FieldOptions {
     /**
-     * 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`);
-     * }
-     * ```
+     * Example value for the field (required for STRING, IMAGE, LINK, OBJECT, ARRAY)
+     * Can be a string or an array of strings
      */
-    fetchData(options: FetchDataOptions): Promise<FetchDataResult>;
+    example?: FieldExample;
     /**
-     * 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'
-     * });
-     * ```
+     * Whether this field is a primary key
      */
-    fetchAllData(options: FetchDataOptions): Promise<Array<object>>;
+    isKey?: boolean;
+}
+/**
+ * Builder for defining custom schemas with fields
+ */
+declare class SchemaBuilder {
+    private static readonly FIELD_NAME_PATTERN;
+    private static readonly TYPES_REQUIRING_EXAMPLE;
+    readonly fields: SchemaField[];
+    entityName?: string;
+    private hasSchemaFields;
+    entity(entityName: string): this;
     /**
-     * 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`);
-     * }
-     * ```
+     * Add a structured field to the schema
+     * @param name - Field name (alphanumeric only)
+     * @param description - Field description
+     * @param dataType - Data type (STRING, NUMBER, BOOLEAN, etc.)
+     * @param options - Optional field configuration
      */
-    fetchDataPages(options: FetchDataOptions): AsyncGenerator<FetchDataResult, void, unknown>;
+    field(name: string, description: string, dataType: DataType, options?: FieldOptions): this;
     /**
-     * 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');
-     * ```
+     * Add a classification field to categorize content
+     * @param name - Field name (alphanumeric only)
+     * @param description - Field description
+     * @param categories - Array of category definitions
      */
-    getNotificationChannels(workflowId: string): Promise<src_generated.V5NotificationsChannelsGet200ResponseDataChannelsInner[]>;
+    classify(name: string, description: string, categories: Category[]): this;
     /**
-     * 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');
-     * ```
+     * Add raw page content to extract
+     * @param name - Raw content format(s): "html", "markdown", or "url"
      */
-    getNotificationSettings(workflowId: string): Promise<src_generated.V5NotificationsSettingsGet200ResponseDataSettingsInner[]>;
+    raw(name: RawFormat | RawFormat[]): this;
+    build(): {
+        entityName?: string;
+        fields: SchemaField[];
+    };
+    private validateFieldName;
 }
 
-interface SetupWorkspaceNotificationSettingsRequest {
-    events: NotificationSettingsEventType[] | "all";
-    channels: NotificationSetupRequestChannels;
+interface ExtractOptionsInternal {
+    urls: string[];
+    name: string;
+    description?: string;
+    navigationMode: NavigationMode;
+    entity: EntityConfig;
+    bypassPreview?: boolean;
+    interval?: WorkflowInterval;
+    schedules?: string[];
+    location?: LocationConfig;
 }
-interface SetupWorkflowNotificationSettingsRequest extends SetupWorkspaceNotificationSettingsRequest {
+interface ExtractOptions extends Omit<ExtractOptionsInternal, "navigationMode" | "entity"> {
+    navigationMode?: NavigationMode;
+    extraction?: (builder: SchemaBuilder) => SchemaBuilder | {
+        schemaId: string;
+    };
+}
+interface PreparedExtraction {
+    options: ExtractOptionsInternal;
+    withNotifications: (options: NotificationOptions) => PreparedExtraction;
+    withMonitoring: (options: WorkflowMonitoringConfig) => PreparedExtraction;
+    setInterval: (options: {
+        interval: WorkflowInterval;
+    } | {
+        schedules: string[];
+    }) => PreparedExtraction;
+    bypassPreview: () => PreparedExtraction;
+    setLocation: (options: LocationConfig) => PreparedExtraction;
+    create: () => Promise<CreatedExtraction>;
+}
+interface RunWorkflowOptions {
+    variables: Record<string, unknown>;
+    limit: number;
+}
+interface CreatedExtraction {
+    options: ExtractOptionsInternal;
     workflowId: string;
+    run: (options?: RunWorkflowOptions) => Promise<FinishedExtraction>;
+    submit: (options?: RunWorkflowOptions) => Promise<SubmittedExtraction>;
 }
-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[]>;
+interface SubmittedExtraction {
+    workflowId: string;
+    jobId: string;
+}
+interface FinishedExtraction {
+    jobId: string;
+    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;
     /**
-     * Get the channels service
+     * Subscribe to connection state changes
+     * @param listener Function to handle connection state changes
+     * @returns Function to unsubscribe
      */
-    get channels(): NotificationChannelsService;
+    onConnection(listener: (connected: boolean, reason?: string) => void): () => void;
     /**
-     * Get the settings service
+     * Subscribe to errors
+     * @param listener Function to handle errors
+     * @returns Function to unsubscribe
      */
-    get settings(): NotificationSettingsService;
+    onError(listener: (error: unknown) => void): () => void;
+    close(): void;
+    isConnected(): boolean;
 }
 
 /**
@@ -6141,6 +6406,12 @@ declare class NotificationsModule {
 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
      */
@@ -6152,11 +6423,11 @@ declare class SchemasService {
     /**
      * Create a new schema
      */
-    createSchema(body: CreateSchemaBody): Promise<SchemaResponse>;
+    createSchema(body: CreateSchemaRequest): Promise<SchemaResponse>;
     /**
      * Update an existing schema
      */
-    updateSchema(schemaId: string, body: UpdateSchemaBody): Promise<SchemaResponse>;
+    updateSchema(schemaId: string, body: UpdateSchemaRequest): Promise<SchemaResponse>;
     /**
      * Delete a schema
      */
@@ -6164,314 +6435,148 @@ declare class SchemasService {
 }
 
 /**
- * Example value for a field (re-exported from generated types)
+ * Validation domain ACL.
+ * Wraps generated DataValidationApi requests/responses and normalizes enums.
+ * Downstream code must import from this module instead of `generated/**`.
  */
-type FieldExample = ExtractionSchemaFieldExample;
+
 /**
- * Optional configuration for schema fields
+ * Rule status enum.
  */
-interface FieldOptions {
-    /**
-     * Example value for the field (required for STRING, IMAGE, LINK, OBJECT, ARRAY)
-     * Can be a string or an array of strings
-     */
-    example?: FieldExample;
-    /**
-     * Whether this field is a primary key
-     */
-    isKey?: boolean;
-}
+declare const RuleStatus: {
+    readonly Preview: "preview";
+    readonly Enabled: "enabled";
+    readonly Disabled: "disabled";
+};
+type RuleStatus = (typeof RuleStatus)[keyof typeof RuleStatus];
 /**
- * Category definition for classification fields (re-exported from generated types)
+ * Rule type enum.
  */
-type Category = ExtractionClassificationFieldCategoriesInner;
+declare const RuleType: {
+    readonly CustomSql: "custom_sql";
+};
+type RuleType = (typeof RuleType)[keyof typeof RuleType];
 /**
- * Builder for defining custom schemas with fields
+ * Validation strategy enum.
  */
-declare class SchemaBuilder {
-    private static readonly FIELD_NAME_PATTERN;
-    private static readonly TYPES_REQUIRING_EXAMPLE;
-    readonly fields: SchemaField[];
-    entityName?: string;
-    entity(entityName: string): this;
-    /**
-     * Add a structured field to the schema
-     * @param name - Field name (alphanumeric only)
-     * @param description - Field description
-     * @param dataType - Data type (STRING, NUMBER, BOOLEAN, etc.)
-     * @param options - Optional field configuration
-     */
-    field(name: string, description: string, dataType: DataType, options?: FieldOptions): this;
-    /**
-     * Add a classification field to categorize content
-     * @param name - Field name (alphanumeric only)
-     * @param description - Field description
-     * @param categories - Array of category definitions
-     */
-    classify(name: string, description: string, categories: Category[]): this;
-    /**
-     * Add raw page content to extract
-     * @param name - Raw content format(s): "html", "markdown", or "url"
-     */
-    raw(name: RawFormat | RawFormat[]): this;
-    build(): {
-        entityName: string;
-        fields: SchemaField[];
-    };
-    private validateFieldName;
-}
-
+declare const ValidationStrategy: {
+    readonly Isolated: "ISOLATED";
+    readonly LinkingColumns: "LINKING_COLUMNS";
+};
+type ValidationStrategy = (typeof ValidationStrategy)[keyof typeof ValidationStrategy];
 /**
- * Schema builder with create capability
- * Extends SchemaBuilder to add direct schema creation
+ * Include deleted rules parameter.
  */
-declare class SchemaBuilderWithCreate extends SchemaBuilder {
-    private readonly service;
-    constructor(entityName: string, service: SchemasService);
-    /**
-     * Create the schema directly in Kadoa
-     * @param name - Optional schema name (defaults to entity name)
-     * @returns Promise resolving to the created schema
-     */
-    create(name?: string): Promise<SchemaResponse>;
+type IncludeDeletedRules = V4DataValidationRulesGetIncludeDeletedParameter;
+declare class ListRulesRequest implements DataValidationApiV4DataValidationRulesGetRequest {
+    groupId?: string;
+    workflowId?: string;
+    status?: RuleStatus;
+    page?: number;
+    pageSize?: number;
+    includeDeleted?: IncludeDeletedRules;
 }
-/**
- * Schemas module for managing schemas
- */
-declare class SchemasModule {
-    private readonly service;
-    constructor(service: SchemasService);
-    /**
-     * Create a new schema builder for fluent schema definition
-     * @param entityName - The name of the entity this schema represents
-     * @returns A new SchemaBuilder instance with the entity name already set
-     * @example Build then create
-     * ```typescript
-     * const schema = kadoa.schema.builder("Product")
-     *   .field("title", "Product name", "STRING", { example: "iPhone 15" })
-     *   .field("price", "Product price", "NUMBER")
-     *   .build();
-     *
-     * await kadoa.schema.create(schema);
-     * ```
-     *
-     * @example Fluent chain with create
-     * ```typescript
-     * const schema = await kadoa.schema.builder("Product")
-     *   .field("title", "Product name", "STRING", { example: "iPhone 15" })
-     *   .field("price", "Product price", "NUMBER")
-     *   .create("Product Schema");
-     * ```
-     */
-    builder(entityName: string): SchemaBuilderWithCreate;
-    /**
-     * Get a schema by ID
-     */
-    get(schemaId: string): Promise<SchemaResponse>;
-    /**
-     * List all schemas
-     */
-    list(): Promise<SchemaResponse[]>;
-    /**
-     * Create a new schema from a body
-     */
-    create(body: CreateSchemaBody): Promise<SchemaResponse>;
-    /**
-     * Update an existing schema
-     */
-    update(schemaId: string, body: UpdateSchemaBody): Promise<SchemaResponse>;
-    /**
-     * Delete a schema
-     */
-    delete(schemaId: string): Promise<void>;
+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;
 /**
- * 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();
- * ```
+ * Rule with SDK-curated enum types.
+ * Remaps generated enum fields to prevent type leakage.
  */
-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
-     */
-    getCurrentUser(): Promise<KadoaUser>;
+interface Rule extends Omit<Rule$1, "status" | "ruleType"> {
+    status: RuleStatus;
+    ruleType?: RuleType;
 }
-
-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 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;
 /**
- * Service for managing data validation rules
+ * Validation report with SDK-curated enum types.
  */
-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>;
+interface GetValidationResponse extends Omit<DataValidationReport, "strategy"> {
+    strategy?: ValidationStrategy;
 }
+type ToggleValidationResponse = V4DataValidationWorkflowsWorkflowIdValidationTogglePut200Response;
 
-type ToggleResponse = V4DataValidationWorkflowsWorkflowIdValidationTogglePut200Response;
-type ListWorkflowValidationsOptions = DataValidationApiV4DataValidationWorkflowsWorkflowIdJobsJobIdValidationsGetRequest;
-type WaitUntilCompletedOptions = PollingOptions;
+type GetAnomaliesByRuleResponse = AnomaliesByRuleResponse;
+type GetAnomalyRulePageResponse = AnomalyRulePageResponse;
 
 declare class ValidationCoreService {
     private readonly validationApi;
     constructor(client: KadoaClient);
-    listWorkflowValidations(filters: ListWorkflowValidationsOptions): Promise<ValidationListResponse>;
-    getValidationDetails(validationId: string): Promise<DataValidationReport>;
+    listWorkflowValidations(filters: ListWorkflowValidationsRequest): Promise<ListValidationsResponse>;
+    getValidationDetails(validationId: string): Promise<GetValidationResponse>;
     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>;
+    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>;
 }
 
-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>;
-    /**
-     * Get job status directly without polling workflow details
-     */
-    getJobStatus(workflowId: string, jobId: string): Promise<FinishedJob>;
-    /**
-     * Wait for a job to complete using the job status endpoint
-     */
-    waitForJobCompletion(workflowId: string, jobId: string, options?: JobWaitOptions): Promise<FinishedJob>;
+/**
+ * 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>;
 }
 
-interface ExtractOptionsInternal {
-    urls: string[];
-    name: string;
-    description?: string;
-    navigationMode: NavigationMode;
-    entity: EntityConfig;
-    bypassPreview?: boolean;
-    interval?: WorkflowInterval;
-    schedules?: string[];
-    location?: LocationConfig$1;
-}
-interface ExtractOptions extends Omit<ExtractOptionsInternal, "navigationMode" | "entity"> {
-    navigationMode?: NavigationMode;
+/**
+ * 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;
     /**
-     * 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: SchemaBuilder) => SchemaBuilder | {
-        schemaId: string;
-    };
-}
-interface PreparedExtraction {
-    options: ExtractOptionsInternal;
-    withNotifications: (options: NotificationOptions) => PreparedExtraction;
-    withMonitoring: (options: MonitoringConfig) => PreparedExtraction;
-    setInterval: (options: {
-        interval: WorkflowInterval;
-    } | {
-        schedules: string[];
-    }) => PreparedExtraction;
-    bypassPreview: () => PreparedExtraction;
-    setLocation: (options: LocationConfig$1) => PreparedExtraction;
-    create: () => Promise<CreatedExtraction>;
-}
-interface RunWorkflowOptions {
-    variables: Record<string, unknown>;
-    limit: number;
-}
-interface CreatedExtraction {
-    options: ExtractOptionsInternal;
-    workflowId: string;
-    run: (options?: RunWorkflowOptions) => Promise<FinishedExtraction>;
-    submit: (options?: RunWorkflowOptions) => Promise<SubmittedExtraction>;
-}
-interface SubmittedExtraction {
-    workflowId: string;
-    jobId: string;
-}
-interface FinishedExtraction {
-    jobId: string;
-    fetchData: (options: Omit<FetchDataOptions, "workflowId" | "runId">) => Promise<FetchDataResult>;
-    fetchAllData: (options: Omit<FetchDataOptions, "workflowId" | "runId" | "page" | "limit">) => Promise<object[]>;
+     * 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 {
@@ -6498,6 +6603,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
  *
@@ -6523,12 +6637,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
@@ -6629,19 +6743,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: {
@@ -6770,4 +6928,4 @@ declare class KadoaHttpException extends KadoaSdkException {
     static mapStatusToCode(errorOrStatus: AxiosError | number): KadoaErrorCode;
 }
 
-export { type Category, type CreateSchemaBody, type DataType, ERROR_MESSAGES, type FieldExample, type FieldOptions, type FieldType, type FinishedJob, KadoaClient, type KadoaClientConfig, KadoaErrorCode, KadoaHttpException, KadoaSdkException, type KadoaUser, type ListRulesOptions, type LocationConfig, type MetadataKey, type MonitoringField, type MonitoringOperator, type NavigationMode, type PollingOptions, type RawFormat, type RunWorkflowInput, SchemaBuilder, type SchemaField, type SchemaResponse, SchemasModule, type StartedJob, type UpdateSchemaBody, ValidationModule, type WorkflowInterval, 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 };