cerca 0.1.0

data/rbi/cerca/models/approval_grant_delete_for_thread_params.rbi

@@ -0,0 +1,51 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalGrantDeleteForThreadParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cerca::ApprovalGrantDeleteForThreadParams,
+            Cerca::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :agent_id
+
+      sig { returns(String) }
+      attr_accessor :thread_id
+
+      sig { returns(String) }
+      attr_accessor :grant_id
+
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          grant_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(agent_id:, thread_id:, grant_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            agent_id: String,
+            thread_id: String,
+            grant_id: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_grant_delete_for_thread_response.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalGrantDeleteForThreadResponse < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cerca::Models::ApprovalGrantDeleteForThreadResponse,
+            Cerca::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T::Boolean) }
+      attr_accessor :ok
+
+      sig { params(ok: T::Boolean).returns(T.attached_class) }
+      def self.new(ok: true)
+      end
+
+      sig { override.returns({ ok: T::Boolean }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_grant_delete_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalGrantDeleteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::ApprovalGrantDeleteParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :agent_id
+
+      sig { returns(String) }
+      attr_accessor :grant_id
+
+      sig do
+        params(
+          agent_id: String,
+          grant_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(agent_id:, grant_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            agent_id: String,
+            grant_id: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_grant_delete_response.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalGrantDeleteResponse < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cerca::Models::ApprovalGrantDeleteResponse,
+            Cerca::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T::Boolean) }
+      attr_accessor :ok
+
+      sig { params(ok: T::Boolean).returns(T.attached_class) }
+      def self.new(ok: true)
+      end
+
+      sig { override.returns({ ok: T::Boolean }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_grant_list_for_thread_params.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalGrantListForThreadParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cerca::ApprovalGrantListForThreadParams,
+            Cerca::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :agent_id
+
+      sig { returns(String) }
+      attr_accessor :thread_id
+
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(agent_id:, thread_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            agent_id: String,
+            thread_id: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_grant_list_for_thread_response.rbi

@@ -0,0 +1,11 @@
+# typed: strong
+
+module Cerca
+  module Models
+    ApprovalGrantListForThreadResponse =
+      T.let(
+        Cerca::Internal::Type::ArrayOf[Cerca::ApprovalGrant],
+        Cerca::Internal::Type::Converter
+      )
+  end
+end

data/rbi/cerca/models/approval_grant_list_params.rbi

@@ -0,0 +1,65 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalGrantListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::ApprovalGrantListParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :agent_id
+
+      # Opaque pagination cursor returned by a previous request.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cursor
+
+      sig { params(cursor: String).void }
+      attr_writer :cursor
+
+      # Maximum number of items to return. Defaults to 20 and preserves parseInt
+      # semantics.
+      sig { returns(T.nilable(String)) }
+      attr_reader :limit
+
+      sig { params(limit: String).void }
+      attr_writer :limit
+
+      sig do
+        params(
+          agent_id: String,
+          cursor: String,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        agent_id:,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            agent_id: String,
+            cursor: String,
+            limit: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_mode.rbi

@@ -0,0 +1,19 @@
+# typed: strong
+
+module Cerca
+  module Models
+    module ApprovalMode
+      extend Cerca::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Cerca::ApprovalMode) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      ALWAYS = T.let(:always, Cerca::ApprovalMode::TaggedSymbol)
+      NEVER = T.let(:never, Cerca::ApprovalMode::TaggedSymbol)
+
+      sig { override.returns(T::Array[Cerca::ApprovalMode::TaggedSymbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_policy.rbi

@@ -0,0 +1,42 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalPolicy < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Cerca::ApprovalPolicy, Cerca::Internal::AnyHash) }
+
+      sig { returns(T.nilable(Float)) }
+      attr_reader :timeout_ms
+
+      sig { params(timeout_ms: Float).void }
+      attr_writer :timeout_ms
+
+      sig { returns(T.nilable(T::Hash[Symbol, Cerca::ApprovalMode::OrSymbol])) }
+      attr_reader :tools
+
+      sig { params(tools: T::Hash[Symbol, Cerca::ApprovalMode::OrSymbol]).void }
+      attr_writer :tools
+
+      sig do
+        params(
+          timeout_ms: Float,
+          tools: T::Hash[Symbol, Cerca::ApprovalMode::OrSymbol]
+        ).returns(T.attached_class)
+      end
+      def self.new(timeout_ms: nil, tools: nil)
+      end
+
+      sig do
+        override.returns(
+          {
+            timeout_ms: Float,
+            tools: T::Hash[Symbol, Cerca::ApprovalMode::OrSymbol]
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_request.rbi

@@ -0,0 +1,152 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalRequest < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Cerca::ApprovalRequest, Cerca::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig { returns(String) }
+      attr_accessor :created_at
+
+      # Parsed JSON tool input from the original tool call. Generated SDKs may expose
+      # this as unknown or Any.
+      sig { returns(T.anything) }
+      attr_accessor :input
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :resolved_at
+
+      sig { returns(Cerca::ToolName::TaggedSymbol) }
+      attr_accessor :runtime_tool_name
+
+      sig { returns(Cerca::ApprovalRequest::Status::TaggedSymbol) }
+      attr_accessor :status
+
+      sig { returns(String) }
+      attr_accessor :thread_id
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :timeout_at
+
+      sig { returns(T.nilable(Float)) }
+      attr_accessor :timeout_ms
+
+      sig { returns(Float) }
+      attr_accessor :tool_index
+
+      sig { returns(String) }
+      attr_accessor :tool_name
+
+      sig { returns(String) }
+      attr_accessor :tool_use_id
+
+      sig { returns(String) }
+      attr_accessor :turn_id
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :tool_source_id
+
+      sig { params(tool_source_id: String).void }
+      attr_writer :tool_source_id
+
+      sig { returns(T.nilable(Float)) }
+      attr_reader :tool_source_version
+
+      sig { params(tool_source_version: Float).void }
+      attr_writer :tool_source_version
+
+      sig do
+        params(
+          id: String,
+          created_at: String,
+          input: T.anything,
+          resolved_at: T.nilable(String),
+          runtime_tool_name: Cerca::ToolName::OrSymbol,
+          status: Cerca::ApprovalRequest::Status::OrSymbol,
+          thread_id: String,
+          timeout_at: T.nilable(String),
+          timeout_ms: T.nilable(Float),
+          tool_index: Float,
+          tool_name: String,
+          tool_use_id: String,
+          turn_id: String,
+          tool_source_id: String,
+          tool_source_version: Float
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        created_at:,
+        # Parsed JSON tool input from the original tool call. Generated SDKs may expose
+        # this as unknown or Any.
+        input:,
+        resolved_at:,
+        runtime_tool_name:,
+        status:,
+        thread_id:,
+        timeout_at:,
+        timeout_ms:,
+        tool_index:,
+        tool_name:,
+        tool_use_id:,
+        turn_id:,
+        tool_source_id: nil,
+        tool_source_version: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created_at: String,
+            input: T.anything,
+            resolved_at: T.nilable(String),
+            runtime_tool_name: Cerca::ToolName::TaggedSymbol,
+            status: Cerca::ApprovalRequest::Status::TaggedSymbol,
+            thread_id: String,
+            timeout_at: T.nilable(String),
+            timeout_ms: T.nilable(Float),
+            tool_index: Float,
+            tool_name: String,
+            tool_use_id: String,
+            turn_id: String,
+            tool_source_id: String,
+            tool_source_version: Float
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Status
+        extend Cerca::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cerca::ApprovalRequest::Status) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PENDING = T.let(:pending, Cerca::ApprovalRequest::Status::TaggedSymbol)
+        APPROVED =
+          T.let(:approved, Cerca::ApprovalRequest::Status::TaggedSymbol)
+        DENIED = T.let(:denied, Cerca::ApprovalRequest::Status::TaggedSymbol)
+        CANCELLED =
+          T.let(:cancelled, Cerca::ApprovalRequest::Status::TaggedSymbol)
+        TIMED_OUT =
+          T.let(:timed_out, Cerca::ApprovalRequest::Status::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Cerca::ApprovalRequest::Status::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_request_list_params.rbi

@@ -0,0 +1,76 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalRequestListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::ApprovalRequestListParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :agent_id
+
+      # Opaque pagination cursor returned by a previous request.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cursor
+
+      sig { params(cursor: String).void }
+      attr_writer :cursor
+
+      # Maximum number of items to return. Defaults to 20 and preserves parseInt
+      # semantics.
+      sig { returns(T.nilable(String)) }
+      attr_reader :limit
+
+      sig { params(limit: String).void }
+      attr_writer :limit
+
+      # Optional thread id filter.
+      sig { returns(T.nilable(String)) }
+      attr_reader :thread_id
+
+      sig { params(thread_id: String).void }
+      attr_writer :thread_id
+
+      sig do
+        params(
+          agent_id: String,
+          cursor: String,
+          limit: String,
+          thread_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        agent_id:,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        # Optional thread id filter.
+        thread_id: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            agent_id: String,
+            cursor: String,
+            limit: String,
+            thread_id: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/approval_request_resolve_params.rbi

@@ -0,0 +1,137 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ApprovalRequestResolveParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::ApprovalRequestResolveParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :agent_id
+
+      sig { returns(String) }
+      attr_accessor :thread_id
+
+      sig { returns(String) }
+      attr_accessor :approval_id
+
+      sig { returns(Cerca::ApprovalRequestResolveParams::Decision::OrSymbol) }
+      attr_accessor :decision
+
+      sig do
+        returns(T.nilable(Cerca::ApprovalRequestResolveParams::Grant::OrSymbol))
+      end
+      attr_reader :grant
+
+      sig do
+        params(grant: Cerca::ApprovalRequestResolveParams::Grant::OrSymbol).void
+      end
+      attr_writer :grant
+
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          approval_id: String,
+          decision: Cerca::ApprovalRequestResolveParams::Decision::OrSymbol,
+          grant: Cerca::ApprovalRequestResolveParams::Grant::OrSymbol,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        agent_id:,
+        thread_id:,
+        approval_id:,
+        decision:,
+        grant: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            agent_id: String,
+            thread_id: String,
+            approval_id: String,
+            decision: Cerca::ApprovalRequestResolveParams::Decision::OrSymbol,
+            grant: Cerca::ApprovalRequestResolveParams::Grant::OrSymbol,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Decision
+        extend Cerca::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Cerca::ApprovalRequestResolveParams::Decision)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        APPROVE =
+          T.let(
+            :approve,
+            Cerca::ApprovalRequestResolveParams::Decision::TaggedSymbol
+          )
+        DENY =
+          T.let(
+            :deny,
+            Cerca::ApprovalRequestResolveParams::Decision::TaggedSymbol
+          )
+        CANCEL =
+          T.let(
+            :cancel,
+            Cerca::ApprovalRequestResolveParams::Decision::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Cerca::ApprovalRequestResolveParams::Decision::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      module Grant
+        extend Cerca::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Cerca::ApprovalRequestResolveParams::Grant)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        THREAD =
+          T.let(
+            :thread,
+            Cerca::ApprovalRequestResolveParams::Grant::TaggedSymbol
+          )
+        AGENT =
+          T.let(
+            :agent,
+            Cerca::ApprovalRequestResolveParams::Grant::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Cerca::ApprovalRequestResolveParams::Grant::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end