retab 0.1.4 → 0.1.5

data/rbi/retab/split_workflow_artifact.rbi

@@ -45,12 +45,24 @@ module Retab
     sig { params(value: T.nilable(String)).returns(T.nilable(String)) }
     def instructions=(value); end
 
-    sig { returns(T::Array[Retab::SplitResult]) }
+    sig { returns(T.nilable(T::Array[Retab::SplitResult])) }
     def output; end
 
-    sig { params(value: T::Array[Retab::SplitResult]).returns(T::Array[Retab::SplitResult]) }
+    sig { params(value: T.nilable(T::Array[Retab::SplitResult])).returns(T.nilable(T::Array[Retab::SplitResult])) }
     def output=(value); end
 
+    sig { returns(T.nilable(String)) }
+    def status; end
+
+    sig { params(value: T.nilable(String)).returns(T.nilable(String)) }
+    def status=(value); end
+
+    sig { returns(T.nilable(Retab::PrimitiveError)) }
+    def error; end
+
+    sig { params(value: T.nilable(Retab::PrimitiveError)).returns(T.nilable(Retab::PrimitiveError)) }
+    def error=(value); end
+
     sig { returns(T.nilable(Retab::SplitConsensus)) }
     def consensus; end
 

data/rbi/retab/splits.rbi

@@ -16,12 +16,13 @@ module Retab
         limit: T.nilable(Integer),
         order: T.nilable(String),
         filename: T.nilable(String),
+        status: T.nilable(String),
         from_date: T.nilable(String),
         to_date: T.nilable(String),
         request_options: T::Hash[Symbol, T.untyped]
       ).returns(Retab::PaginatedList[Retab::Split])
     end
-    def list(before:, after:, limit:, order:, filename:, from_date:, to_date:, request_options:); end
+    def list(before:, after:, limit:, order:, filename:, status:, from_date:, to_date:, request_options:); end
 
     sig do
       params(
@@ -31,18 +32,20 @@ module Retab
         instructions: T.nilable(String),
         n_consensus: T.nilable(Integer),
         bust_cache: T.nilable(T::Boolean),
+        background: T.nilable(T::Boolean),
         request_options: T::Hash[Symbol, T.untyped]
       ).returns(Retab::Split)
     end
-    def create(document:, subdocuments:, model:, instructions:, n_consensus:, bust_cache:, request_options:); end
+    def create(document:, subdocuments:, model:, instructions:, n_consensus:, bust_cache:, background:, request_options:); end
 
     sig do
       params(
         split_id: String,
+        include_output: T.nilable(T::Boolean),
         request_options: T::Hash[Symbol, T.untyped]
       ).returns(Retab::Split)
     end
-    def get(split_id:, request_options:); end
+    def get(split_id:, include_output:, request_options:); end
 
     sig do
       params(
@@ -52,5 +55,13 @@ module Retab
     end
     def delete(split_id:, request_options:); end
 
+    sig do
+      params(
+        split_id: String,
+        request_options: T::Hash[Symbol, T.untyped]
+      ).returns(Retab::Split)
+    end
+    def create_split_cancel(split_id:, request_options:); end
+
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: retab
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Retab
@@ -53,6 +53,7 @@ files:
 - lib/retab/classifications/classification_decision.rb
 - lib/retab/classifications/classification_request.rb
 - lib/retab/classifications/file_ref.rb
+- lib/retab/classifications/primitive_error.rb
 - lib/retab/classifications/retab_usage.rb
 - lib/retab/client.rb
 - lib/retab/configuration.rb
@@ -120,12 +121,6 @@ files:
 - lib/retab/files/file_link.rb
 - lib/retab/files/upload_file_request.rb
 - lib/retab/inflections.rb
-- lib/retab/jobs.rb
-- lib/retab/jobs/create_job_request.rb
-- lib/retab/jobs/job.rb
-- lib/retab/jobs/job_error.rb
-- lib/retab/jobs/job_response.rb
-- lib/retab/jobs/job_warning.rb
 - lib/retab/mime.rb
 - lib/retab/paginated_list.rb
 - lib/retab/parses.rb
@@ -156,19 +151,24 @@ files:
 - lib/retab/types/assertion_outcome.rb
 - lib/retab/types/base_model.rb
 - lib/retab/types/cancel_workflow_response_cancellation_status.rb
+- lib/retab/types/classification_status.rb
+- lib/retab/types/classification_workflow_artifact_status.rb
 - lib/retab/types/classifications_order.rb
+- lib/retab/types/classifications_status.rb
 - lib/retab/types/condition_evaluation_details_logical_operator.rb
 - lib/retab/types/condition_evaluation_result_logical_operator.rb
 - lib/retab/types/create_experiment_request_n_consensus.rb
-- lib/retab/types/create_job_request_endpoint.rb
 - lib/retab/types/declarative_apply_response_action.rb
 - lib/retab/types/declarative_plan_field_change_action.rb
 - lib/retab/types/declarative_plan_resource_change_actions.rb
 - lib/retab/types/declarative_plan_resource_change_target.rb
 - lib/retab/types/declarative_plan_resource_change_type.rb
 - lib/retab/types/declarative_plan_response_action.rb
+- lib/retab/types/edit_status.rb
 - lib/retab/types/edit_templates_order.rb
+- lib/retab/types/edit_workflow_artifact_status.rb
 - lib/retab/types/edits_order.rb
+- lib/retab/types/edits_status.rb
 - lib/retab/types/error_step_lifecycle_category.rb
 - lib/retab/types/error_step_lifecycle_stage.rb
 - lib/retab/types/error_terminal_category.rb
@@ -183,14 +183,12 @@ files:
 - lib/retab/types/experiment_runs_order.rb
 - lib/retab/types/experiment_schema_drift_status.rb
 - lib/retab/types/experiment_summary_metrics_response_block_type.rb
+- lib/retab/types/extraction_status.rb
+- lib/retab/types/extraction_workflow_artifact_status.rb
 - lib/retab/types/extractions_order.rb
+- lib/retab/types/extractions_status.rb
 - lib/retab/types/field_type.rb
 - lib/retab/types/files_order.rb
-- lib/retab/types/job_status.rb
-- lib/retab/types/jobs_endpoint.rb
-- lib/retab/types/jobs_order.rb
-- lib/retab/types/jobs_source.rb
-- lib/retab/types/jobs_status.rb
 - lib/retab/types/latest_block_test_run_summary_outcome.rb
 - lib/retab/types/latest_block_test_run_summary_status.rb
 - lib/retab/types/length_compare_condition_op.rb
@@ -198,9 +196,14 @@ files:
 - lib/retab/types/n_consensus_value.rb
 - lib/retab/types/number_compare_condition_op.rb
 - lib/retab/types/parse_request_table_parsing_format.rb
+- lib/retab/types/parse_status.rb
+- lib/retab/types/parse_workflow_artifact_status.rb
 - lib/retab/types/parse_workflow_artifact_table_parsing_format.rb
 - lib/retab/types/parses_order.rb
+- lib/retab/types/partition_status.rb
+- lib/retab/types/partition_workflow_artifact_status.rb
 - lib/retab/types/partitions_order.rb
+- lib/retab/types/partitions_status.rb
 - lib/retab/types/public_handle_payload_type.rb
 - lib/retab/types/request_options.rb
 - lib/retab/types/resume_status.rb
@@ -210,10 +213,12 @@ files:
 - lib/retab/types/review_verdict.rb
 - lib/retab/types/similarity_gte_condition_method.rb
 - lib/retab/types/sources_response_document_type.rb
+- lib/retab/types/split_status.rb
+- lib/retab/types/split_workflow_artifact_status.rb
 - lib/retab/types/splits_order.rb
+- lib/retab/types/splits_status.rb
 - lib/retab/types/step_artifact_ref_operation.rb
 - lib/retab/types/submission_status.rb
-- lib/retab/types/supported_endpoint.rb
 - lib/retab/types/table_parsing_format.rb
 - lib/retab/types/trigger_info_type.rb
 - lib/retab/types/update_experiment_request_n_consensus.rb
@@ -460,7 +465,6 @@ files:
 - rbi/retab/create_edit_template_request.rbi
 - rbi/retab/create_experiment_request.rbi
 - rbi/retab/create_experiment_run_request.rbi
-- rbi/retab/create_job_request.rbi
 - rbi/retab/create_review_version_request.rbi
 - rbi/retab/create_upload_response.rbi
 - rbi/retab/create_workflow_request.rbi
@@ -536,11 +540,6 @@ files:
 - rbi/retab/function_invocation.rbi
 - rbi/retab/generate_schema_request.rbi
 - rbi/retab/http_validation_error.rbi
-- rbi/retab/job.rbi
-- rbi/retab/job_error.rbi
-- rbi/retab/job_response.rbi
-- rbi/retab/job_warning.rbi
-- rbi/retab/jobs.rbi
 - rbi/retab/json_handle_input.rbi
 - rbi/retab/json_schema_valid_condition.rbi
 - rbi/retab/latest_block_test_run_summary.rbi
@@ -575,6 +574,7 @@ files:
 - rbi/retab/pending_workflow_experiment_result.rbi
 - rbi/retab/pending_workflow_experiment_run.rbi
 - rbi/retab/pending_workflow_test_run.rbi
+- rbi/retab/primitive_error.rbi
 - rbi/retab/public_handle_payload.rbi
 - rbi/retab/publish_workflow_request.rbi
 - rbi/retab/queued_step_lifecycle.rbi

data/lib/retab/jobs/create_job_request.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-# This file is auto-generated by oagen. Do not edit.
-
-module Retab
-  class CreateJobRequest < Retab::Types::BaseModel
-
-    HASH_ATTRS = {
-      endpoint: :endpoint,
-      request: :request,
-      metadata: :metadata
-    }.freeze
-
-    attr_accessor(
-      :endpoint,
-      :request,
-      :metadata
-    )
-
-    def initialize(json)
-      super()
-      hash = self.class.normalize(json)
-      @endpoint = hash[:endpoint]
-      @request = hash[:request] || {}
-      @metadata = hash[:metadata] || {}
-    end
-  end
-end

data/lib/retab/jobs/job.rb

@@ -1,70 +0,0 @@
-# frozen_string_literal: true
-
-# This file is auto-generated by oagen. Do not edit.
-
-module Retab
-  class Job < Retab::Types::BaseModel
-
-    HASH_ATTRS = {
-      id: :id,
-      object: :object,
-      status: :status,
-      endpoint: :endpoint,
-      error: :error,
-      warnings: :warnings,
-      created_at: :created_at,
-      started_at: :started_at,
-      completed_at: :completed_at,
-      expires_at: :expires_at,
-      metadata: :metadata,
-      cancelled: :cancelled,
-      attempt_count: :attempt_count,
-      last_attempt_at: :last_attempt_at,
-      last_failure_code: :last_failure_code,
-      request: :request,
-      response: :response
-    }.freeze
-
-    attr_accessor(
-      :id,
-      :object,
-      :status,
-      :endpoint,
-      :error,
-      :warnings,
-      :created_at,
-      :started_at,
-      :completed_at,
-      :expires_at,
-      :metadata,
-      :cancelled,
-      :attempt_count,
-      :last_attempt_at,
-      :last_failure_code,
-      :request,
-      :response
-    )
-
-    def initialize(json)
-      super()
-      hash = self.class.normalize(json)
-      @id = hash[:id]
-      @object = hash[:object].nil? ? "job" : hash[:object]
-      @status = hash[:status].nil? ? "validating" : hash[:status]
-      @endpoint = hash[:endpoint]
-      @error = hash[:error] ? Retab::JobError.new(hash[:error]) : nil
-      @warnings = (hash[:warnings] || []).map { |item| item ? Retab::JobWarning.new(item) : nil }
-      @created_at = hash[:created_at]
-      @started_at = hash[:started_at]
-      @completed_at = hash[:completed_at]
-      @expires_at = hash[:expires_at]
-      @metadata = hash[:metadata] || {}
-      @cancelled = hash[:cancelled].nil? ? false : hash[:cancelled]
-      @attempt_count = hash[:attempt_count]
-      @last_attempt_at = hash[:last_attempt_at]
-      @last_failure_code = hash[:last_failure_code]
-      @request = hash[:request] || {}
-      @response = hash[:response] ? Retab::JobResponse.new(hash[:response]) : nil
-    end
-  end
-end

data/lib/retab/jobs/job_response.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-# This file is auto-generated by oagen. Do not edit.
-
-module Retab
-  class JobResponse < Retab::Types::BaseModel
-
-    HASH_ATTRS = {
-      status_code: :status_code,
-      body: :body
-    }.freeze
-
-    attr_accessor(
-      :status_code,
-      :body
-    )
-
-    def initialize(json)
-      super()
-      hash = self.class.normalize(json)
-      @status_code = hash[:status_code]
-      @body = hash[:body] || {}
-    end
-  end
-end

data/lib/retab/jobs/job_warning.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-# This file is auto-generated by oagen. Do not edit.
-
-module Retab
-  JobWarning = JobError
-end

data/lib/retab/jobs.rb

@@ -1,252 +0,0 @@
-# frozen_string_literal: true
-
-# This file is auto-generated by oagen. Do not edit.
-
-require "json"
-
-module Retab
-  class Jobs
-    def initialize(client)
-      @client = client
-    end
-
-    # List Jobs
-    # @param before [String, nil] First job ID from the current page, used to fetch the previous page
-    # @param after [String, nil] Last job ID from the previous page, used to fetch the next page
-    # @param limit [Integer, nil] Number of jobs to return
-    # @param order [Retab::Types::JobsOrder, nil] Sort order by created_at
-    # @param job_id [String, nil] Filter by job ID
-    # @param status [Retab::Types::JobsStatus, nil] Filter by status
-    # @param endpoint [Retab::Types::JobsEndpoint, nil] Filter by endpoint
-    # @param source [Retab::Types::JobsSource, nil] High-level source filter. Use api/project/workflow.
-    # @param project_id [String, nil] Filter by request.project_id
-    # @param workflow_id [String, nil] Filter by metadata.workflow_id
-    # @param workflow_block_id [String, nil] Filter by metadata.workflow_block_id or metadata.block_id
-    # @param model [String, nil] Filter by request.model
-    # @param filename_regex [String, nil] Regex or plain text pattern applied to request filenames.
-    # @param filename_contains [String, nil] Plain text substring applied to request filenames.
-    # @param document_type [Array<String>, nil] Filter by document type. Can be repeated. Accepted values: bmp, csv, doc, docm, docx, dotm, dotx, eml, gif, heic, heif, htm, html, jpeg, jpg, json, md, mhtml, msg, odp, ods, odt, ots, ott, pdf, png, ppt, pptx, rtf, svg, tif, tiff, tsv, txt, webp, xlam, xls, xlsb, xlsm, xlsx, xltm, xltx, xml, yaml, yml.
-    # @param from_date [String, nil] Filter jobs created on or after this date (YYYY-MM-DD)
-    # @param to_date [String, nil] Filter jobs created on or before this date (YYYY-MM-DD)
-    # @param metadata [String, nil] JSON object string to filter metadata key/value pairs.
-    # @param include_request [Boolean, nil] Whether to include the full original request body in each listed job.
-    # @param include_response [Boolean, nil] Whether to include full response payloads in each listed job.
-    # @param request_options [Hash] (see Retab::Types::RequestOptions)
-    # @return [Retab::PaginatedList<Retab::Job>]
-    def list(
-      before: nil,
-      after: nil,
-      limit: 20,
-      order: "desc",
-      job_id: nil,
-      status: nil,
-      endpoint: nil,
-      source: nil,
-      project_id: nil,
-      workflow_id: nil,
-      workflow_block_id: nil,
-      model: nil,
-      filename_regex: nil,
-      filename_contains: nil,
-      document_type: nil,
-      from_date: nil,
-      to_date: nil,
-      metadata: nil,
-      include_request: false,
-      include_response: false,
-      request_options: {}
-    )
-      params = {
-        "before" => before,
-        "after" => after,
-        "limit" => limit,
-        "order" => order,
-        "job_id" => job_id,
-        "status" => status,
-        "endpoint" => endpoint,
-        "source" => source,
-        "project_id" => project_id,
-        "workflow_id" => workflow_id,
-        "workflow_block_id" => workflow_block_id,
-        "model" => model,
-        "filename_regex" => filename_regex,
-        "filename_contains" => filename_contains,
-        "document_type" => document_type,
-        "from_date" => from_date,
-        "to_date" => to_date,
-        "metadata" => metadata,
-        "include_request" => include_request,
-        "include_response" => include_response
-      }.compact
-      response = @client.request(
-        method: :get,
-        path: "/v1/jobs",
-        auth: true,
-        params: params,
-        request_options: request_options
-      )
-      fetch_next = -> (cursor) {
-        list(
-          before: before,
-          after: cursor,
-          limit: limit,
-          order: order,
-          job_id: job_id,
-          status: status,
-          endpoint: endpoint,
-          source: source,
-          project_id: project_id,
-          workflow_id: workflow_id,
-          workflow_block_id: workflow_block_id,
-          model: model,
-          filename_regex: filename_regex,
-          filename_contains: filename_contains,
-          document_type: document_type,
-          from_date: from_date,
-          to_date: to_date,
-          metadata: metadata,
-          include_request: include_request,
-          include_response: include_response,
-          request_options: request_options
-        )
-      }
-      Retab::PaginatedList.from_response(
-        response,
-        model: Retab::Job,
-        filters: {
-          before: before,
-          limit: limit,
-          order: order,
-          job_id: job_id,
-          status: status,
-          endpoint: endpoint,
-          source: source,
-          project_id: project_id,
-          workflow_id: workflow_id,
-          workflow_block_id: workflow_block_id,
-          model: model,
-          filename_regex: filename_regex,
-          filename_contains: filename_contains,
-          document_type: document_type,
-          from_date: from_date,
-          to_date: to_date,
-          metadata: metadata,
-          include_request: include_request,
-          include_response: include_response
-        },
-        fetch_next: fetch_next
-      )
-    end
-
-    # Create Job
-    # @param endpoint [Retab::Types::CreateJobRequestEndpoint]
-    # @param request [Hash{String => Object}]
-    # @param metadata [Hash{String => String}, nil] Max 16 pairs; keys ≤64 chars, values ≤512 chars
-    # @param request_options [Hash] (see Retab::Types::RequestOptions)
-    # @return [Retab::Job]
-    def create(
-      endpoint:,
-      request:,
-      metadata: nil,
-      request_options: {}
-    )
-      body = {
-        "endpoint" => endpoint,
-        "request" => request,
-        "metadata" => metadata
-      }.compact
-      response = @client.request(
-        method: :post,
-        path: "/v1/jobs",
-        auth: true,
-        body: body,
-        request_options: request_options
-      )
-      result = Retab::Job.new(response.body)
-      result.last_response = Retab::Types::ApiResponse.new(
-        http_status: response.code.to_i,
-        http_headers: response.each_header.to_h,
-        request_id: response["x-request-id"]
-      )
-      result
-    end
-
-    # Retrieve Job
-    # @param job_id [String]
-    # @param include_request [Boolean, nil] Include the original request payload in the response.
-    # @param include_response [Boolean, nil] Include the job response payload in the response.
-    # @param request_options [Hash] (see Retab::Types::RequestOptions)
-    # @return [Retab::Job]
-    def get(
-      job_id:,
-      include_request: false,
-      include_response: false,
-      request_options: {}
-    )
-      params = {
-        "include_request" => include_request,
-        "include_response" => include_response
-      }.compact
-      response = @client.request(
-        method: :get,
-        path: "/v1/jobs/#{Retab::Util.encode_path(job_id)}",
-        auth: true,
-        params: params,
-        request_options: request_options
-      )
-      result = Retab::Job.new(response.body)
-      result.last_response = Retab::Types::ApiResponse.new(
-        http_status: response.code.to_i,
-        http_headers: response.each_header.to_h,
-        request_id: response["x-request-id"]
-      )
-      result
-    end
-
-    # Cancel Job
-    # @param job_id [String]
-    # @param request_options [Hash] (see Retab::Types::RequestOptions)
-    # @return [Retab::Job]
-    def cancel(
-      job_id:,
-      request_options: {}
-    )
-      response = @client.request(
-        method: :post,
-        path: "/v1/jobs/#{Retab::Util.encode_path(job_id)}/cancel",
-        auth: true,
-        request_options: request_options
-      )
-      result = Retab::Job.new(response.body)
-      result.last_response = Retab::Types::ApiResponse.new(
-        http_status: response.code.to_i,
-        http_headers: response.each_header.to_h,
-        request_id: response["x-request-id"]
-      )
-      result
-    end
-
-    # Retry Job
-    # @param job_id [String]
-    # @param request_options [Hash] (see Retab::Types::RequestOptions)
-    # @return [Retab::Job]
-    def retry(
-      job_id:,
-      request_options: {}
-    )
-      response = @client.request(
-        method: :post,
-        path: "/v1/jobs/#{Retab::Util.encode_path(job_id)}/retry",
-        auth: true,
-        request_options: request_options
-      )
-      result = Retab::Job.new(response.body)
-      result.last_response = Retab::Types::ApiResponse.new(
-        http_status: response.code.to_i,
-        http_headers: response.each_header.to_h,
-        request_id: response["x-request-id"]
-      )
-      result
-    end
-  end
-end

data/lib/retab/types/create_job_request_endpoint.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-# This file is auto-generated by oagen. Do not edit.
-
-module Retab
-  module Types
-    class CreateJobRequestEndpoint
-      V_1_EXTRACTIONS = "/v1/extractions"
-      V_1_PARSES = "/v1/parses"
-      V_1_SPLITS = "/v1/splits"
-      V_1_PARTITIONS = "/v1/partitions"
-      V_1_CLASSIFICATIONS = "/v1/classifications"
-      V_1_SCHEMAS_GENERATE = "/v1/schemas/generate"
-      V_1_EDITS = "/v1/edits"
-      V_1_EDITS_TEMPLATES_GENERATE = "/v1/edits/templates/generate"
-      V_1_EVALS_EXTRACT_PROCESS = "/v1/evals/extract/process"
-      V_1_EVALS_EXTRACT_EXTRACT = "/v1/evals/extract/extract"
-      V_1_EVALS_EXTRACT_SPLIT = "/v1/evals/extract/split"
-      ALL = [
-        V_1_EXTRACTIONS,
-        V_1_PARSES,
-        V_1_SPLITS,
-        V_1_PARTITIONS,
-        V_1_CLASSIFICATIONS,
-        V_1_SCHEMAS_GENERATE,
-        V_1_EDITS,
-        V_1_EDITS_TEMPLATES_GENERATE,
-        V_1_EVALS_EXTRACT_PROCESS,
-        V_1_EVALS_EXTRACT_EXTRACT,
-        V_1_EVALS_EXTRACT_SPLIT
-      ].freeze
-    end
-  end
-end

data/lib/retab/types/jobs_source.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-# This file is auto-generated by oagen. Do not edit.
-
-module Retab
-  module Types
-    class JobsSource
-      API = "api"
-      PROJECT = "project"
-      WORKFLOW = "workflow"
-      ALL = [API, PROJECT, WORKFLOW].freeze
-    end
-  end
-end

data/rbi/retab/create_job_request.rbi

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-
-# This file is auto-generated by oagen. Do not edit.
-
-# typed: strong
-
-module Retab
-  class CreateJobRequest
-    sig { params(json: T.any(String, T::Hash[Symbol, T.untyped])).void }
-    def initialize(json); end
-
-    sig { returns(String) }
-    def endpoint; end
-
-    sig { params(value: String).returns(String) }
-    def endpoint=(value); end
-
-    sig { returns(T::Hash[String, T.untyped]) }
-    def request; end
-
-    sig { params(value: T::Hash[String, T.untyped]).returns(T::Hash[String, T.untyped]) }
-    def request=(value); end
-
-    sig { returns(T.nilable(T::Hash[String, String])) }
-    def metadata; end
-
-    sig { params(value: T.nilable(T::Hash[String, String])).returns(T.nilable(T::Hash[String, String])) }
-    def metadata=(value); end
-
-    sig { returns(T::Hash[Symbol, T.untyped]) }
-    def to_h; end
-
-    sig { params(args: T.untyped).returns(String) }
-    def to_json(*args); end
-  end
-end