cerca 0.1.0

data/lib/cerca/models/sandbox_exec_params.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Sandbox#exec_
+    class SandboxExecParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute command
+      #
+      #   @return [String]
+      required :command, String
+
+      # @!attribute max_buffer
+      #
+      #   @return [Float, nil]
+      optional :max_buffer, Float, api_name: :maxBuffer
+
+      # @!attribute execution_timeout
+      #   Timeout in seconds. Runtime converts this to milliseconds.
+      #
+      #   @return [Float, nil]
+      optional :execution_timeout, Float, api_name: :timeout
+
+      # @!attribute workdir
+      #   Optional sandbox working directory.
+      #
+      #   @return [String, nil]
+      optional :workdir, String, nil?: true
+
+      # @!method initialize(agent_id:, command:, max_buffer: nil, execution_timeout: nil, workdir: nil, request_options: {})
+      #   @param agent_id [String]
+      #
+      #   @param command [String]
+      #
+      #   @param max_buffer [Float]
+      #
+      #   @param execution_timeout [Float] Timeout in seconds. Runtime converts this to milliseconds.
+      #
+      #   @param workdir [String, nil] Optional sandbox working directory.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/sandbox_read_params.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Sandbox#read
+    class SandboxReadParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute path
+      #
+      #   @return [String]
+      required :path, String
+
+      # @!attribute limit
+      #
+      #   @return [Float, nil]
+      optional :limit, Float
+
+      # @!attribute offset
+      #
+      #   @return [Float, nil]
+      optional :offset, Float
+
+      # @!method initialize(agent_id:, path:, limit: nil, offset: nil, request_options: {})
+      #   @param agent_id [String]
+      #   @param path [String]
+      #   @param limit [Float]
+      #   @param offset [Float]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/sandbox_write_params.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Sandbox#write
+    class SandboxWriteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute content
+      #
+      #   @return [String]
+      required :content, String
+
+      # @!attribute path
+      #
+      #   @return [String]
+      required :path, String
+
+      # @!method initialize(agent_id:, content:, path:, request_options: {})
+      #   @param agent_id [String]
+      #   @param content [String]
+      #   @param path [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/sandbox_write_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Sandbox#write
+    class SandboxWriteResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute success
+      #
+      #   @return [Boolean, true]
+      required :success, const: true
+
+      # @!method initialize(success: true)
+      #   @param success [Boolean, true]
+    end
+  end
+end

data/lib/cerca/models/schedule.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Schedules#create
+    class Schedule < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute enabled
+      #
+      #   @return [Boolean]
+      required :enabled, Cerca::Internal::Type::Boolean
+
+      # @!attribute message
+      #
+      #   @return [String]
+      required :message, String
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute next_at
+      #
+      #   @return [String, nil]
+      required :next_at, String, api_name: :nextAt, nil?: true
+
+      # @!attribute timezone
+      #
+      #   @return [String]
+      required :timezone, String
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute cron
+      #
+      #   @return [String, nil]
+      optional :cron, String
+
+      # @!attribute instructions
+      #
+      #   @return [String, nil]
+      optional :instructions, String
+
+      # @!attribute model
+      #
+      #   @return [String, nil]
+      optional :model, String
+
+      # @!attribute run_at
+      #
+      #   @return [Time, nil]
+      optional :run_at, Time, api_name: :runAt
+
+      # @!attribute tools
+      #   Per-schedule tool subset. Scheduled threads inherit the agent's effective tools
+      #   when omitted and can only narrow them when provided.
+      #
+      #   @return [Array<String>, nil]
+      optional :tools, Cerca::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(id:, created_at:, enabled:, message:, name:, next_at:, timezone:, updated_at:, cron: nil, instructions: nil, model: nil, run_at: nil, tools: nil)
+      #   Some parameter documentations has been truncated, see {Cerca::Models::Schedule}
+      #   for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param created_at [String]
+      #
+      #   @param enabled [Boolean]
+      #
+      #   @param message [String]
+      #
+      #   @param name [String]
+      #
+      #   @param next_at [String, nil]
+      #
+      #   @param timezone [String]
+      #
+      #   @param updated_at [String]
+      #
+      #   @param cron [String]
+      #
+      #   @param instructions [String]
+      #
+      #   @param model [String]
+      #
+      #   @param run_at [Time]
+      #
+      #   @param tools [Array<String>] Per-schedule tool subset. Scheduled threads inherit the agent's effective tools
+    end
+  end
+end

data/lib/cerca/models/schedule_create_params.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Schedules#create
+    class ScheduleCreateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute message
+      #
+      #   @return [String]
+      required :message, String
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute cron
+      #
+      #   @return [String, nil]
+      optional :cron, String
+
+      # @!attribute instructions
+      #
+      #   @return [String, nil]
+      optional :instructions, String
+
+      # @!attribute model
+      #
+      #   @return [String, nil]
+      optional :model, String
+
+      # @!attribute run_at
+      #
+      #   @return [Time, nil]
+      optional :run_at, Time, api_name: :runAt
+
+      # @!attribute timezone
+      #
+      #   @return [String, nil]
+      optional :timezone, String
+
+      # @!attribute tools
+      #   Per-schedule tool subset. When the schedule starts a thread, these tools can
+      #   only narrow the agent's effective tools.
+      #
+      #   @return [Array<String>, nil]
+      optional :tools, Cerca::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(agent_id:, message:, name:, cron: nil, instructions: nil, model: nil, run_at: nil, timezone: nil, tools: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ScheduleCreateParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param message [String]
+      #
+      #   @param name [String]
+      #
+      #   @param cron [String]
+      #
+      #   @param instructions [String]
+      #
+      #   @param model [String]
+      #
+      #   @param run_at [Time]
+      #
+      #   @param timezone [String]
+      #
+      #   @param tools [Array<String>] Per-schedule tool subset. When the schedule starts a thread, these tools can onl
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/schedule_delete_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Schedules#delete
+    class ScheduleDeleteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute schedule_id
+      #
+      #   @return [String]
+      required :schedule_id, String
+
+      # @!method initialize(agent_id:, schedule_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param schedule_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/schedule_delete_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Schedules#delete
+    class ScheduleDeleteResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute success
+      #
+      #   @return [Boolean, true]
+      required :success, const: true
+
+      # @!method initialize(success: true)
+      #   @param success [Boolean, true]
+    end
+  end
+end

data/lib/cerca/models/schedule_list_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Schedules#list
+    class ScheduleListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!method initialize(agent_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/schedule_list_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Schedules#list
+    class ScheduleListResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute schedules
+      #
+      #   @return [Array<Cerca::Models::Schedule>]
+      required :schedules, -> { Cerca::Internal::Type::ArrayOf[Cerca::Schedule] }
+
+      # @!method initialize(schedules:)
+      #   @param schedules [Array<Cerca::Models::Schedule>]
+    end
+  end
+end

data/lib/cerca/models/schedule_trigger_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Schedules#trigger
+    class ScheduleTriggerParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute schedule_id
+      #
+      #   @return [String]
+      required :schedule_id, String
+
+      # @!method initialize(agent_id:, schedule_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param schedule_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/schedule_trigger_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Schedules#trigger
+    class ScheduleTriggerResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute thread_id
+      #
+      #   @return [String]
+      required :thread_id, String, api_name: :threadId
+
+      # @!method initialize(thread_id:)
+      #   @param thread_id [String]
+    end
+  end
+end

data/lib/cerca/models/schedule_update_params.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Schedules#update
+    class ScheduleUpdateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute schedule_id
+      #
+      #   @return [String]
+      required :schedule_id, String
+
+      # @!attribute cron
+      #
+      #   @return [String, nil]
+      optional :cron, String
+
+      # @!attribute enabled
+      #
+      #   @return [Boolean, nil]
+      optional :enabled, Cerca::Internal::Type::Boolean
+
+      # @!attribute instructions
+      #
+      #   @return [String, nil]
+      optional :instructions, String
+
+      # @!attribute message
+      #
+      #   @return [String, nil]
+      optional :message, String
+
+      # @!attribute model
+      #
+      #   @return [String, nil]
+      optional :model, String
+
+      # @!attribute name
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!attribute run_at
+      #
+      #   @return [Time, nil]
+      optional :run_at, Time, api_name: :runAt
+
+      # @!attribute timezone
+      #
+      #   @return [String, nil]
+      optional :timezone, String
+
+      # @!attribute tools
+      #   Per-schedule tool subset. When updated, these tools can only narrow the agent's
+      #   effective tools for future scheduled threads.
+      #
+      #   @return [Array<String>, nil]
+      optional :tools, Cerca::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(agent_id:, schedule_id:, cron: nil, enabled: nil, instructions: nil, message: nil, model: nil, name: nil, run_at: nil, timezone: nil, tools: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ScheduleUpdateParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param schedule_id [String]
+      #
+      #   @param cron [String]
+      #
+      #   @param enabled [Boolean]
+      #
+      #   @param instructions [String]
+      #
+      #   @param message [String]
+      #
+      #   @param model [String]
+      #
+      #   @param name [String]
+      #
+      #   @param run_at [Time]
+      #
+      #   @param timezone [String]
+      #
+      #   @param tools [Array<String>] Per-schedule tool subset. When updated, these tools can only narrow the agent's
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/search_result.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Context#search
+    class SearchResult < Cerca::Internal::Type::BaseModel
+      # @!attribute byte_length
+      #
+      #   @return [Float]
+      required :byte_length, Float, api_name: :byteLength
+
+      # @!attribute key
+      #
+      #   @return [String]
+      required :key, String
+
+      # @!attribute score
+      #
+      #   @return [Float]
+      required :score, Float
+
+      # @!attribute snippet
+      #
+      #   @return [String]
+      required :snippet, String
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute version
+      #
+      #   @return [Float]
+      required :version, Float
+
+      # @!attribute mime_type
+      #
+      #   @return [String, nil]
+      optional :mime_type, String, api_name: :mimeType
+
+      # @!method initialize(byte_length:, key:, score:, snippet:, updated_at:, version:, mime_type: nil)
+      #   @param byte_length [Float]
+      #   @param key [String]
+      #   @param score [Float]
+      #   @param snippet [String]
+      #   @param updated_at [String]
+      #   @param version [Float]
+      #   @param mime_type [String]
+    end
+  end
+end

data/lib/cerca/models/source_warning.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class SourceWarning < Cerca::Internal::Type::BaseModel
+      # @!attribute message
+      #
+      #   @return [String]
+      required :message, String
+
+      # @!attribute source
+      #
+      #   @return [String]
+      required :source, String
+
+      # @!attribute source_id
+      #
+      #   @return [String, nil]
+      optional :source_id, String, api_name: :sourceId
+
+      # @!method initialize(message:, source:, source_id: nil)
+      #   @param message [String]
+      #   @param source [String]
+      #   @param source_id [String]
+    end
+  end
+end

data/lib/cerca/models/status.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # `idle` threads can accept a new turn or be closed. `running` threads have an
+    # active turn. `awaiting` threads are paused on external input such as approvals.
+    # `closed` threads are terminal.
+    module Status
+      extend Cerca::Internal::Type::Enum
+
+      IDLE = :idle
+      RUNNING = :running
+      AWAITING = :awaiting
+      CLOSED = :closed
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end