trycourier 7.0.1 → 7.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: fa1ba12a5ce9481d1c23ca295ffef2ffc499183511f8cbd7271acde9c0260ed1
4
- data.tar.gz: cd342539ab02a178ecd3e91168caa686434c5f46278aa9abda5711aba24e61c8
3
+ metadata.gz: e6f447f7cd12a0248a2741cb9ce80d77eb83cc5e8a9b77a795e0b6d35a8f1209
4
+ data.tar.gz: 404b1162e49e7b833ad0210cee54d1c4a54531f178001164c1c1f3401b8f364c
5
5
  SHA512:
6
- metadata.gz: 64ac21eb81ea343cba355e1b84e7c205ad2bf2fcdcbf4d465be5cf35b6f2cce7a65686593bf4e01e41f2036f32af629cf8cbed6678e3f3221aa59ac3df5d1095
7
- data.tar.gz: 6cdb33293bbe462273034fd4d04b86c5ec0ab6b095d540019bc5c288c0426557fdf73b332075a9f4a00a996bd6bca7541b816e769ed653693efb62b9df2b3967
6
+ metadata.gz: e5346039fcb24b1bc0bf8da969905c01ba62981b4faf7e2e1939735ae9550d98775ae9ce4e598db4719311dc7fc5159f47dce1d22118d33b6815678eee39c0e1
7
+ data.tar.gz: b985e154a801e7a489f370af08c0b26282eb5bfca47d6db24d8dc53ab851b7af1829baba45ac48471d3bc5aa2b74178ac9826a944072f37000db4b9c523d18af
data/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## [7.1.0](https://github.com/trycourier/courier-ruby/compare/v7.0.1...v7.1.0) (2026-11-19)
4
+
5
+
6
+ ### Features
7
+
8
+ * **api:** add POST /feedback for agent and tool feedback [C-22903] ([#194](https://github.com/trycourier/courier-ruby/issues/194)) ([9262636](https://github.com/trycourier/courier-ruby/commit/9262636826acf67891ca9dd20e827fcbced766a2))
9
+
10
+
11
+ ### Documentation
12
+
13
+ * **api:** list GPT-6.2 Astra and Sol as JourneyAINode models [C-22881] ([#192](https://github.com/trycourier/courier-ruby/issues/192)) ([5c82073](https://github.com/trycourier/courier-ruby/commit/5c8207336c576955e1cbafddb6b827aeb7b96fe7))
14
+
3
15
  ## [7.0.1](https://github.com/trycourier/courier-ruby/compare/v7.0.0...v7.0.1) (2026-11-17)
4
16
 
5
17
 
data/README.md CHANGED
@@ -9,7 +9,7 @@ Add the gem to your `Gemfile`:
9
9
  <!-- x-release-please-start-version -->
10
10
 
11
11
  ```ruby
12
- gem "trycourier", "~> 7.0.1"
12
+ gem "trycourier", "~> 7.1.0"
13
13
  ```
14
14
 
15
15
  <!-- x-release-please-end -->
@@ -74,6 +74,11 @@ module Courier
74
74
  # @return [Courier::Resources::Digests]
75
75
  attr_reader :digests
76
76
 
77
+ # Report suspected bugs, confusing behavior and missing features in Courier, from
78
+ # an AI agent, a developer tool or by hand.
79
+ # @return [Courier::Resources::Feedback]
80
+ attr_reader :feedback
81
+
77
82
  # Record an inbound event that triggers the journeys and automations mapped to it.
78
83
  # @return [Courier::Resources::Inbound]
79
84
  attr_reader :inbound
@@ -199,6 +204,7 @@ module Courier
199
204
  @bulk = Courier::Resources::Bulk.new(client: self)
200
205
  @brands = Courier::Resources::Brands.new(client: self)
201
206
  @digests = Courier::Resources::Digests.new(client: self)
207
+ @feedback = Courier::Resources::Feedback.new(client: self)
202
208
  @inbound = Courier::Resources::Inbound.new(client: self)
203
209
  @lists = Courier::Resources::Lists.new(client: self)
204
210
  @messages = Courier::Resources::Messages.new(client: self)
@@ -0,0 +1,124 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Courier
4
+ module Models
5
+ # @see Courier::Resources::Feedback#create
6
+ class FeedbackCreateParams < Courier::Internal::Type::BaseModel
7
+ extend Courier::Internal::Type::RequestParameters::Converter
8
+ include Courier::Internal::Type::RequestParameters
9
+
10
+ # @!attribute category
11
+ # What kind of report this is: `possible_bug` for behavior that looks wrong,
12
+ # `confusing_behavior` for behavior that works but was hard to understand,
13
+ # `feature_request` for something Courier does not do yet, and `other`.
14
+ #
15
+ # @return [Symbol, Courier::Models::FeedbackCreateParams::Category]
16
+ required :category, enum: -> { Courier::FeedbackCreateParams::Category }
17
+
18
+ # @!attribute description
19
+ # What happened, in enough detail for someone at Courier to follow it.
20
+ #
21
+ # @return [String]
22
+ required :description, String
23
+
24
+ # @!attribute surface
25
+ # Where you met the problem: the REST `api`, an `sdk`, the Courier `mcp` server,
26
+ # the Courier app `ui`, the `docs`, or `other`.
27
+ #
28
+ # @return [Symbol, Courier::Models::FeedbackCreateParams::Surface]
29
+ required :surface, enum: -> { Courier::FeedbackCreateParams::Surface }
30
+
31
+ # @!attribute title
32
+ # A one-line summary of the report.
33
+ #
34
+ # @return [String]
35
+ required :title, String
36
+
37
+ # @!attribute expected_behavior
38
+ # What you expected to happen instead.
39
+ #
40
+ # @return [String, nil]
41
+ optional :expected_behavior, String
42
+
43
+ # @!attribute harness
44
+ # The agent or tool that submitted the report, such as `Claude Code`.
45
+ #
46
+ # @return [String, nil]
47
+ optional :harness, String
48
+
49
+ # @!attribute location
50
+ # Where it happened, such as an endpoint (`POST /send`), an SDK method, an MCP
51
+ # tool name or a docs URL.
52
+ #
53
+ # @return [String, nil]
54
+ optional :location, String
55
+
56
+ # @!attribute model
57
+ # The AI model that submitted the report, such as `claude-opus-5-5`.
58
+ #
59
+ # @return [String, nil]
60
+ optional :model, String
61
+
62
+ # @!attribute request_id
63
+ # The request ID of an API call that shows the problem, if there is one.
64
+ #
65
+ # @return [String, nil]
66
+ optional :request_id, String
67
+
68
+ # @!method initialize(category:, description:, surface:, title:, expected_behavior: nil, harness: nil, location: nil, model: nil, request_id: nil, request_options: {})
69
+ # Some parameter documentations has been truncated, see
70
+ # {Courier::Models::FeedbackCreateParams} for more details.
71
+ #
72
+ # @param category [Symbol, Courier::Models::FeedbackCreateParams::Category] What kind of report this is: `possible_bug` for behavior that looks wrong, `conf
73
+ #
74
+ # @param description [String] What happened, in enough detail for someone at Courier to follow it.
75
+ #
76
+ # @param surface [Symbol, Courier::Models::FeedbackCreateParams::Surface] Where you met the problem: the REST `api`, an `sdk`, the Courier `mcp` server, t
77
+ #
78
+ # @param title [String] A one-line summary of the report.
79
+ #
80
+ # @param expected_behavior [String] What you expected to happen instead.
81
+ #
82
+ # @param harness [String] The agent or tool that submitted the report, such as `Claude Code`.
83
+ #
84
+ # @param location [String] Where it happened, such as an endpoint (`POST /send`), an SDK method, an MCP too
85
+ #
86
+ # @param model [String] The AI model that submitted the report, such as `claude-opus-5-5`.
87
+ #
88
+ # @param request_id [String] The request ID of an API call that shows the problem, if there is one.
89
+ #
90
+ # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
91
+
92
+ # What kind of report this is: `possible_bug` for behavior that looks wrong,
93
+ # `confusing_behavior` for behavior that works but was hard to understand,
94
+ # `feature_request` for something Courier does not do yet, and `other`.
95
+ module Category
96
+ extend Courier::Internal::Type::Enum
97
+
98
+ POSSIBLE_BUG = :possible_bug
99
+ CONFUSING_BEHAVIOR = :confusing_behavior
100
+ FEATURE_REQUEST = :feature_request
101
+ OTHER = :other
102
+
103
+ # @!method self.values
104
+ # @return [Array<Symbol>]
105
+ end
106
+
107
+ # Where you met the problem: the REST `api`, an `sdk`, the Courier `mcp` server,
108
+ # the Courier app `ui`, the `docs`, or `other`.
109
+ module Surface
110
+ extend Courier::Internal::Type::Enum
111
+
112
+ API = :api
113
+ SDK = :sdk
114
+ MCP = :mcp
115
+ UI = :ui
116
+ DOCS = :docs
117
+ OTHER = :other
118
+
119
+ # @!method self.values
120
+ # @return [Array<Symbol>]
121
+ end
122
+ end
123
+ end
124
+ end
@@ -0,0 +1,17 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Courier
4
+ module Models
5
+ # @see Courier::Resources::Feedback#create
6
+ class FeedbackCreateResponse < Courier::Internal::Type::BaseModel
7
+ # @!attribute feedback_id
8
+ # The ID of the stored report, `fbk_` followed by a ULID.
9
+ #
10
+ # @return [String]
11
+ required :feedback_id, String
12
+
13
+ # @!method initialize(feedback_id:)
14
+ # @param feedback_id [String] The ID of the stored report, `fbk_` followed by a ULID.
15
+ end
16
+ end
17
+ end
@@ -30,8 +30,8 @@ module Courier
30
30
  # @!attribute model
31
31
  # A supported AI model id. Requests with an unknown id may be rejected with a 400
32
32
  # that lists the supported ids. Supported ids: `claude-fable-5-2`,
33
- # `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6-astra`,
34
- # `gpt-5.5`, `gpt-5.4`, `gpt-6.1-sol`, `gpt-6.1-terra`, `gpt-5.4-mini`,
33
+ # `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6.2-astra`,
34
+ # `gpt-5.5`, `gpt-5.4`, `gpt-6.2-sol`, `gpt-6.1-terra`, `gpt-5.4-mini`,
35
35
  # `gpt-5.4-nano`, `gpt-6-luna`.
36
36
  #
37
37
  # @return [String, nil]
@@ -257,6 +257,8 @@ module Courier
257
257
 
258
258
  Expo = Courier::Models::Expo
259
259
 
260
+ FeedbackCreateParams = Courier::Models::FeedbackCreateParams
261
+
260
262
  FilterConfig = Courier::Models::FilterConfig
261
263
 
262
264
  Icons = Courier::Models::Icons
@@ -0,0 +1,70 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Courier
4
+ module Resources
5
+ # Report suspected bugs, confusing behavior and missing features in Courier, from
6
+ # an AI agent, a developer tool or by hand.
7
+ class Feedback
8
+ # Some parameter documentations has been truncated, see
9
+ # {Courier::Models::FeedbackCreateParams} for more details.
10
+ #
11
+ # Reports a suspected bug, confusing behavior or a missing feature in Courier. It
12
+ # is built for AI agents and developer tools to call when Courier does something
13
+ # unexpected, and people can call it too.
14
+ #
15
+ # A report is not a support ticket. A `201` means Courier stored the report; it
16
+ # does not promise a reply or a fix. For help with your account, contact Courier
17
+ # support.
18
+ #
19
+ # Never include secrets, API keys or customer data such as recipient names, email
20
+ # addresses or message content.
21
+ #
22
+ # Requires an API key with no scope restrictions; a JWT or a scoped API key is
23
+ # refused. Each workspace can submit 200 reports per UTC day, and requests that
24
+ # fail validation count toward that limit.
25
+ #
26
+ # @overload create(category:, description:, surface:, title:, expected_behavior: nil, harness: nil, location: nil, model: nil, request_id: nil, request_options: {})
27
+ #
28
+ # @param category [Symbol, Courier::Models::FeedbackCreateParams::Category] What kind of report this is: `possible_bug` for behavior that looks wrong, `conf
29
+ #
30
+ # @param description [String] What happened, in enough detail for someone at Courier to follow it.
31
+ #
32
+ # @param surface [Symbol, Courier::Models::FeedbackCreateParams::Surface] Where you met the problem: the REST `api`, an `sdk`, the Courier `mcp` server, t
33
+ #
34
+ # @param title [String] A one-line summary of the report.
35
+ #
36
+ # @param expected_behavior [String] What you expected to happen instead.
37
+ #
38
+ # @param harness [String] The agent or tool that submitted the report, such as `Claude Code`.
39
+ #
40
+ # @param location [String] Where it happened, such as an endpoint (`POST /send`), an SDK method, an MCP too
41
+ #
42
+ # @param model [String] The AI model that submitted the report, such as `claude-opus-5-5`.
43
+ #
44
+ # @param request_id [String] The request ID of an API call that shows the problem, if there is one.
45
+ #
46
+ # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
47
+ #
48
+ # @return [Courier::Models::FeedbackCreateResponse]
49
+ #
50
+ # @see Courier::Models::FeedbackCreateParams
51
+ def create(params)
52
+ parsed, options = Courier::FeedbackCreateParams.dump_request(params)
53
+ @client.request(
54
+ method: :post,
55
+ path: "feedback",
56
+ body: parsed,
57
+ model: Courier::Models::FeedbackCreateResponse,
58
+ options: options
59
+ )
60
+ end
61
+
62
+ # @api private
63
+ #
64
+ # @param client [Courier::Client]
65
+ def initialize(client:)
66
+ @client = client
67
+ end
68
+ end
69
+ end
70
+ end
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Courier
4
- VERSION = "7.0.1"
4
+ VERSION = "7.1.0"
5
5
  end
data/lib/courier.rb CHANGED
@@ -202,6 +202,8 @@ require_relative "courier/models/email_footer"
202
202
  require_relative "courier/models/email_head"
203
203
  require_relative "courier/models/email_header"
204
204
  require_relative "courier/models/expo"
205
+ require_relative "courier/models/feedback_create_params"
206
+ require_relative "courier/models/feedback_create_response"
205
207
  require_relative "courier/models/filter_config"
206
208
  require_relative "courier/models/icons"
207
209
  require_relative "courier/models/inbound_bulk_message"
@@ -527,6 +529,7 @@ require_relative "courier/resources/broadcasts"
527
529
  require_relative "courier/resources/bulk"
528
530
  require_relative "courier/resources/digests"
529
531
  require_relative "courier/resources/digests/schedules"
532
+ require_relative "courier/resources/feedback"
530
533
  require_relative "courier/resources/inbound"
531
534
  require_relative "courier/resources/journeys"
532
535
  require_relative "courier/resources/journeys/runs"
@@ -69,6 +69,11 @@ module Courier
69
69
  sig { returns(Courier::Resources::Digests) }
70
70
  attr_reader :digests
71
71
 
72
+ # Report suspected bugs, confusing behavior and missing features in Courier, from
73
+ # an AI agent, a developer tool or by hand.
74
+ sig { returns(Courier::Resources::Feedback) }
75
+ attr_reader :feedback
76
+
72
77
  # Record an inbound event that triggers the journeys and automations mapped to it.
73
78
  sig { returns(Courier::Resources::Inbound) }
74
79
  attr_reader :inbound
@@ -0,0 +1,196 @@
1
+ # typed: strong
2
+
3
+ module Courier
4
+ module Models
5
+ class FeedbackCreateParams < Courier::Internal::Type::BaseModel
6
+ extend Courier::Internal::Type::RequestParameters::Converter
7
+ include Courier::Internal::Type::RequestParameters
8
+
9
+ OrHash =
10
+ T.type_alias do
11
+ T.any(Courier::FeedbackCreateParams, Courier::Internal::AnyHash)
12
+ end
13
+
14
+ # What kind of report this is: `possible_bug` for behavior that looks wrong,
15
+ # `confusing_behavior` for behavior that works but was hard to understand,
16
+ # `feature_request` for something Courier does not do yet, and `other`.
17
+ sig { returns(Courier::FeedbackCreateParams::Category::OrSymbol) }
18
+ attr_accessor :category
19
+
20
+ # What happened, in enough detail for someone at Courier to follow it.
21
+ sig { returns(String) }
22
+ attr_accessor :description
23
+
24
+ # Where you met the problem: the REST `api`, an `sdk`, the Courier `mcp` server,
25
+ # the Courier app `ui`, the `docs`, or `other`.
26
+ sig { returns(Courier::FeedbackCreateParams::Surface::OrSymbol) }
27
+ attr_accessor :surface
28
+
29
+ # A one-line summary of the report.
30
+ sig { returns(String) }
31
+ attr_accessor :title
32
+
33
+ # What you expected to happen instead.
34
+ sig { returns(T.nilable(String)) }
35
+ attr_reader :expected_behavior
36
+
37
+ sig { params(expected_behavior: String).void }
38
+ attr_writer :expected_behavior
39
+
40
+ # The agent or tool that submitted the report, such as `Claude Code`.
41
+ sig { returns(T.nilable(String)) }
42
+ attr_reader :harness
43
+
44
+ sig { params(harness: String).void }
45
+ attr_writer :harness
46
+
47
+ # Where it happened, such as an endpoint (`POST /send`), an SDK method, an MCP
48
+ # tool name or a docs URL.
49
+ sig { returns(T.nilable(String)) }
50
+ attr_reader :location
51
+
52
+ sig { params(location: String).void }
53
+ attr_writer :location
54
+
55
+ # The AI model that submitted the report, such as `claude-opus-5-5`.
56
+ sig { returns(T.nilable(String)) }
57
+ attr_reader :model
58
+
59
+ sig { params(model: String).void }
60
+ attr_writer :model
61
+
62
+ # The request ID of an API call that shows the problem, if there is one.
63
+ sig { returns(T.nilable(String)) }
64
+ attr_reader :request_id
65
+
66
+ sig { params(request_id: String).void }
67
+ attr_writer :request_id
68
+
69
+ sig do
70
+ params(
71
+ category: Courier::FeedbackCreateParams::Category::OrSymbol,
72
+ description: String,
73
+ surface: Courier::FeedbackCreateParams::Surface::OrSymbol,
74
+ title: String,
75
+ expected_behavior: String,
76
+ harness: String,
77
+ location: String,
78
+ model: String,
79
+ request_id: String,
80
+ request_options: Courier::RequestOptions::OrHash
81
+ ).returns(T.attached_class)
82
+ end
83
+ def self.new(
84
+ # What kind of report this is: `possible_bug` for behavior that looks wrong,
85
+ # `confusing_behavior` for behavior that works but was hard to understand,
86
+ # `feature_request` for something Courier does not do yet, and `other`.
87
+ category:,
88
+ # What happened, in enough detail for someone at Courier to follow it.
89
+ description:,
90
+ # Where you met the problem: the REST `api`, an `sdk`, the Courier `mcp` server,
91
+ # the Courier app `ui`, the `docs`, or `other`.
92
+ surface:,
93
+ # A one-line summary of the report.
94
+ title:,
95
+ # What you expected to happen instead.
96
+ expected_behavior: nil,
97
+ # The agent or tool that submitted the report, such as `Claude Code`.
98
+ harness: nil,
99
+ # Where it happened, such as an endpoint (`POST /send`), an SDK method, an MCP
100
+ # tool name or a docs URL.
101
+ location: nil,
102
+ # The AI model that submitted the report, such as `claude-opus-5-5`.
103
+ model: nil,
104
+ # The request ID of an API call that shows the problem, if there is one.
105
+ request_id: nil,
106
+ request_options: {}
107
+ )
108
+ end
109
+
110
+ sig do
111
+ override.returns(
112
+ {
113
+ category: Courier::FeedbackCreateParams::Category::OrSymbol,
114
+ description: String,
115
+ surface: Courier::FeedbackCreateParams::Surface::OrSymbol,
116
+ title: String,
117
+ expected_behavior: String,
118
+ harness: String,
119
+ location: String,
120
+ model: String,
121
+ request_id: String,
122
+ request_options: Courier::RequestOptions
123
+ }
124
+ )
125
+ end
126
+ def to_hash
127
+ end
128
+
129
+ # What kind of report this is: `possible_bug` for behavior that looks wrong,
130
+ # `confusing_behavior` for behavior that works but was hard to understand,
131
+ # `feature_request` for something Courier does not do yet, and `other`.
132
+ module Category
133
+ extend Courier::Internal::Type::Enum
134
+
135
+ TaggedSymbol =
136
+ T.type_alias do
137
+ T.all(Symbol, Courier::FeedbackCreateParams::Category)
138
+ end
139
+ OrSymbol = T.type_alias { T.any(Symbol, String) }
140
+
141
+ POSSIBLE_BUG =
142
+ T.let(
143
+ :possible_bug,
144
+ Courier::FeedbackCreateParams::Category::TaggedSymbol
145
+ )
146
+ CONFUSING_BEHAVIOR =
147
+ T.let(
148
+ :confusing_behavior,
149
+ Courier::FeedbackCreateParams::Category::TaggedSymbol
150
+ )
151
+ FEATURE_REQUEST =
152
+ T.let(
153
+ :feature_request,
154
+ Courier::FeedbackCreateParams::Category::TaggedSymbol
155
+ )
156
+ OTHER =
157
+ T.let(:other, Courier::FeedbackCreateParams::Category::TaggedSymbol)
158
+
159
+ sig do
160
+ override.returns(
161
+ T::Array[Courier::FeedbackCreateParams::Category::TaggedSymbol]
162
+ )
163
+ end
164
+ def self.values
165
+ end
166
+ end
167
+
168
+ # Where you met the problem: the REST `api`, an `sdk`, the Courier `mcp` server,
169
+ # the Courier app `ui`, the `docs`, or `other`.
170
+ module Surface
171
+ extend Courier::Internal::Type::Enum
172
+
173
+ TaggedSymbol =
174
+ T.type_alias { T.all(Symbol, Courier::FeedbackCreateParams::Surface) }
175
+ OrSymbol = T.type_alias { T.any(Symbol, String) }
176
+
177
+ API = T.let(:api, Courier::FeedbackCreateParams::Surface::TaggedSymbol)
178
+ SDK = T.let(:sdk, Courier::FeedbackCreateParams::Surface::TaggedSymbol)
179
+ MCP = T.let(:mcp, Courier::FeedbackCreateParams::Surface::TaggedSymbol)
180
+ UI = T.let(:ui, Courier::FeedbackCreateParams::Surface::TaggedSymbol)
181
+ DOCS =
182
+ T.let(:docs, Courier::FeedbackCreateParams::Surface::TaggedSymbol)
183
+ OTHER =
184
+ T.let(:other, Courier::FeedbackCreateParams::Surface::TaggedSymbol)
185
+
186
+ sig do
187
+ override.returns(
188
+ T::Array[Courier::FeedbackCreateParams::Surface::TaggedSymbol]
189
+ )
190
+ end
191
+ def self.values
192
+ end
193
+ end
194
+ end
195
+ end
196
+ end
@@ -0,0 +1,30 @@
1
+ # typed: strong
2
+
3
+ module Courier
4
+ module Models
5
+ class FeedbackCreateResponse < Courier::Internal::Type::BaseModel
6
+ OrHash =
7
+ T.type_alias do
8
+ T.any(
9
+ Courier::Models::FeedbackCreateResponse,
10
+ Courier::Internal::AnyHash
11
+ )
12
+ end
13
+
14
+ # The ID of the stored report, `fbk_` followed by a ULID.
15
+ sig { returns(String) }
16
+ attr_accessor :feedback_id
17
+
18
+ sig { params(feedback_id: String).returns(T.attached_class) }
19
+ def self.new(
20
+ # The ID of the stored report, `fbk_` followed by a ULID.
21
+ feedback_id:
22
+ )
23
+ end
24
+
25
+ sig { override.returns({ feedback_id: String }) }
26
+ def to_hash
27
+ end
28
+ end
29
+ end
30
+ end
@@ -51,8 +51,8 @@ module Courier
51
51
 
52
52
  # A supported AI model id. Requests with an unknown id may be rejected with a 400
53
53
  # that lists the supported ids. Supported ids: `claude-fable-5-2`,
54
- # `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6-astra`,
55
- # `gpt-5.5`, `gpt-5.4`, `gpt-6.1-sol`, `gpt-6.1-terra`, `gpt-5.4-mini`,
54
+ # `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6.2-astra`,
55
+ # `gpt-5.5`, `gpt-5.4`, `gpt-6.2-sol`, `gpt-6.1-terra`, `gpt-5.4-mini`,
56
56
  # `gpt-5.4-nano`, `gpt-6-luna`.
57
57
  sig { returns(T.nilable(String)) }
58
58
  attr_reader :model
@@ -101,8 +101,8 @@ module Courier
101
101
  conditions: nil,
102
102
  # A supported AI model id. Requests with an unknown id may be rejected with a 400
103
103
  # that lists the supported ids. Supported ids: `claude-fable-5-2`,
104
- # `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6-astra`,
105
- # `gpt-5.5`, `gpt-5.4`, `gpt-6.1-sol`, `gpt-6.1-terra`, `gpt-5.4-mini`,
104
+ # `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6.2-astra`,
105
+ # `gpt-5.5`, `gpt-5.4`, `gpt-6.2-sol`, `gpt-6.1-terra`, `gpt-5.4-mini`,
106
106
  # `gpt-5.4-nano`, `gpt-6-luna`.
107
107
  model: nil,
108
108
  user_prompt: nil,
@@ -222,6 +222,8 @@ module Courier
222
222
 
223
223
  Expo = Courier::Models::Expo
224
224
 
225
+ FeedbackCreateParams = Courier::Models::FeedbackCreateParams
226
+
225
227
  FilterConfig = Courier::Models::FilterConfig
226
228
 
227
229
  Icons = Courier::Models::Icons
@@ -0,0 +1,69 @@
1
+ # typed: strong
2
+
3
+ module Courier
4
+ module Resources
5
+ # Report suspected bugs, confusing behavior and missing features in Courier, from
6
+ # an AI agent, a developer tool or by hand.
7
+ class Feedback
8
+ # Reports a suspected bug, confusing behavior or a missing feature in Courier. It
9
+ # is built for AI agents and developer tools to call when Courier does something
10
+ # unexpected, and people can call it too.
11
+ #
12
+ # A report is not a support ticket. A `201` means Courier stored the report; it
13
+ # does not promise a reply or a fix. For help with your account, contact Courier
14
+ # support.
15
+ #
16
+ # Never include secrets, API keys or customer data such as recipient names, email
17
+ # addresses or message content.
18
+ #
19
+ # Requires an API key with no scope restrictions; a JWT or a scoped API key is
20
+ # refused. Each workspace can submit 200 reports per UTC day, and requests that
21
+ # fail validation count toward that limit.
22
+ sig do
23
+ params(
24
+ category: Courier::FeedbackCreateParams::Category::OrSymbol,
25
+ description: String,
26
+ surface: Courier::FeedbackCreateParams::Surface::OrSymbol,
27
+ title: String,
28
+ expected_behavior: String,
29
+ harness: String,
30
+ location: String,
31
+ model: String,
32
+ request_id: String,
33
+ request_options: Courier::RequestOptions::OrHash
34
+ ).returns(Courier::Models::FeedbackCreateResponse)
35
+ end
36
+ def create(
37
+ # What kind of report this is: `possible_bug` for behavior that looks wrong,
38
+ # `confusing_behavior` for behavior that works but was hard to understand,
39
+ # `feature_request` for something Courier does not do yet, and `other`.
40
+ category:,
41
+ # What happened, in enough detail for someone at Courier to follow it.
42
+ description:,
43
+ # Where you met the problem: the REST `api`, an `sdk`, the Courier `mcp` server,
44
+ # the Courier app `ui`, the `docs`, or `other`.
45
+ surface:,
46
+ # A one-line summary of the report.
47
+ title:,
48
+ # What you expected to happen instead.
49
+ expected_behavior: nil,
50
+ # The agent or tool that submitted the report, such as `Claude Code`.
51
+ harness: nil,
52
+ # Where it happened, such as an endpoint (`POST /send`), an SDK method, an MCP
53
+ # tool name or a docs URL.
54
+ location: nil,
55
+ # The AI model that submitted the report, such as `claude-opus-5-5`.
56
+ model: nil,
57
+ # The request ID of an API call that shows the problem, if there is one.
58
+ request_id: nil,
59
+ request_options: {}
60
+ )
61
+ end
62
+
63
+ # @api private
64
+ sig { params(client: Courier::Client).returns(T.attached_class) }
65
+ def self.new(client:)
66
+ end
67
+ end
68
+ end
69
+ end
@@ -34,6 +34,8 @@ module Courier
34
34
 
35
35
  attr_reader digests: Courier::Resources::Digests
36
36
 
37
+ attr_reader feedback: Courier::Resources::Feedback
38
+
37
39
  attr_reader inbound: Courier::Resources::Inbound
38
40
 
39
41
  attr_reader lists: Courier::Resources::Lists
@@ -0,0 +1,105 @@
1
+ module Courier
2
+ module Models
3
+ type feedback_create_params =
4
+ {
5
+ category: Courier::Models::FeedbackCreateParams::category,
6
+ description: String,
7
+ surface: Courier::Models::FeedbackCreateParams::surface,
8
+ title: String,
9
+ expected_behavior: String,
10
+ harness: String,
11
+ location: String,
12
+ model: String,
13
+ request_id: String
14
+ }
15
+ & Courier::Internal::Type::request_parameters
16
+
17
+ class FeedbackCreateParams < Courier::Internal::Type::BaseModel
18
+ extend Courier::Internal::Type::RequestParameters::Converter
19
+ include Courier::Internal::Type::RequestParameters
20
+
21
+ attr_accessor category: Courier::Models::FeedbackCreateParams::category
22
+
23
+ attr_accessor description: String
24
+
25
+ attr_accessor surface: Courier::Models::FeedbackCreateParams::surface
26
+
27
+ attr_accessor title: String
28
+
29
+ attr_reader expected_behavior: String?
30
+
31
+ def expected_behavior=: (String) -> String
32
+
33
+ attr_reader harness: String?
34
+
35
+ def harness=: (String) -> String
36
+
37
+ attr_reader location: String?
38
+
39
+ def location=: (String) -> String
40
+
41
+ attr_reader model: String?
42
+
43
+ def model=: (String) -> String
44
+
45
+ attr_reader request_id: String?
46
+
47
+ def request_id=: (String) -> String
48
+
49
+ def initialize: (
50
+ category: Courier::Models::FeedbackCreateParams::category,
51
+ description: String,
52
+ surface: Courier::Models::FeedbackCreateParams::surface,
53
+ title: String,
54
+ ?expected_behavior: String,
55
+ ?harness: String,
56
+ ?location: String,
57
+ ?model: String,
58
+ ?request_id: String,
59
+ ?request_options: Courier::request_opts
60
+ ) -> void
61
+
62
+ def to_hash: -> {
63
+ category: Courier::Models::FeedbackCreateParams::category,
64
+ description: String,
65
+ surface: Courier::Models::FeedbackCreateParams::surface,
66
+ title: String,
67
+ expected_behavior: String,
68
+ harness: String,
69
+ location: String,
70
+ model: String,
71
+ request_id: String,
72
+ request_options: Courier::RequestOptions
73
+ }
74
+
75
+ type category =
76
+ :possible_bug | :confusing_behavior | :feature_request | :other
77
+
78
+ module Category
79
+ extend Courier::Internal::Type::Enum
80
+
81
+ POSSIBLE_BUG: :possible_bug
82
+ CONFUSING_BEHAVIOR: :confusing_behavior
83
+ FEATURE_REQUEST: :feature_request
84
+ OTHER: :other
85
+
86
+ def self?.values: -> ::Array[Courier::Models::FeedbackCreateParams::category]
87
+ end
88
+
89
+ type surface = :api | :sdk | :mcp | :ui | :docs | :other
90
+
91
+ module Surface
92
+ extend Courier::Internal::Type::Enum
93
+
94
+ API: :api
95
+ SDK: :sdk
96
+ MCP: :mcp
97
+ UI: :ui
98
+ DOCS: :docs
99
+ OTHER: :other
100
+
101
+ def self?.values: -> ::Array[Courier::Models::FeedbackCreateParams::surface]
102
+ end
103
+ end
104
+ end
105
+ end
@@ -0,0 +1,13 @@
1
+ module Courier
2
+ module Models
3
+ type feedback_create_response = { feedback_id: String }
4
+
5
+ class FeedbackCreateResponse < Courier::Internal::Type::BaseModel
6
+ attr_accessor feedback_id: String
7
+
8
+ def initialize: (feedback_id: String) -> void
9
+
10
+ def to_hash: -> { feedback_id: String }
11
+ end
12
+ end
13
+ end
@@ -217,6 +217,8 @@ module Courier
217
217
 
218
218
  module Expo = Courier::Models::Expo
219
219
 
220
+ class FeedbackCreateParams = Courier::Models::FeedbackCreateParams
221
+
220
222
  class FilterConfig = Courier::Models::FilterConfig
221
223
 
222
224
  class Icons = Courier::Models::Icons
@@ -0,0 +1,20 @@
1
+ module Courier
2
+ module Resources
3
+ class Feedback
4
+ def create: (
5
+ category: Courier::Models::FeedbackCreateParams::category,
6
+ description: String,
7
+ surface: Courier::Models::FeedbackCreateParams::surface,
8
+ title: String,
9
+ ?expected_behavior: String,
10
+ ?harness: String,
11
+ ?location: String,
12
+ ?model: String,
13
+ ?request_id: String,
14
+ ?request_options: Courier::request_opts
15
+ ) -> Courier::Models::FeedbackCreateResponse
16
+
17
+ def initialize: (client: Courier::Client) -> void
18
+ end
19
+ end
20
+ end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: trycourier
3
3
  version: !ruby/object:Gem::Version
4
- version: 7.0.1
4
+ version: 7.1.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Courier
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2026-11-17 00:00:00.000000000 Z
11
+ date: 2026-11-19 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: connection_pool
@@ -177,6 +177,8 @@ files:
177
177
  - lib/courier/models/email_head.rb
178
178
  - lib/courier/models/email_header.rb
179
179
  - lib/courier/models/expo.rb
180
+ - lib/courier/models/feedback_create_params.rb
181
+ - lib/courier/models/feedback_create_response.rb
180
182
  - lib/courier/models/filter_config.rb
181
183
  - lib/courier/models/icons.rb
182
184
  - lib/courier/models/inbound_bulk_message.rb
@@ -532,6 +534,7 @@ files:
532
534
  - lib/courier/resources/bulk.rb
533
535
  - lib/courier/resources/digests.rb
534
536
  - lib/courier/resources/digests/schedules.rb
537
+ - lib/courier/resources/feedback.rb
535
538
  - lib/courier/resources/inbound.rb
536
539
  - lib/courier/resources/journeys.rb
537
540
  - lib/courier/resources/journeys/runs.rb
@@ -706,6 +709,8 @@ files:
706
709
  - rbi/courier/models/email_head.rbi
707
710
  - rbi/courier/models/email_header.rbi
708
711
  - rbi/courier/models/expo.rbi
712
+ - rbi/courier/models/feedback_create_params.rbi
713
+ - rbi/courier/models/feedback_create_response.rbi
709
714
  - rbi/courier/models/filter_config.rbi
710
715
  - rbi/courier/models/icons.rbi
711
716
  - rbi/courier/models/inbound_bulk_message.rbi
@@ -1061,6 +1066,7 @@ files:
1061
1066
  - rbi/courier/resources/bulk.rbi
1062
1067
  - rbi/courier/resources/digests.rbi
1063
1068
  - rbi/courier/resources/digests/schedules.rbi
1069
+ - rbi/courier/resources/feedback.rbi
1064
1070
  - rbi/courier/resources/inbound.rbi
1065
1071
  - rbi/courier/resources/journeys.rbi
1066
1072
  - rbi/courier/resources/journeys/runs.rbi
@@ -1234,6 +1240,8 @@ files:
1234
1240
  - sig/courier/models/email_head.rbs
1235
1241
  - sig/courier/models/email_header.rbs
1236
1242
  - sig/courier/models/expo.rbs
1243
+ - sig/courier/models/feedback_create_params.rbs
1244
+ - sig/courier/models/feedback_create_response.rbs
1237
1245
  - sig/courier/models/filter_config.rbs
1238
1246
  - sig/courier/models/icons.rbs
1239
1247
  - sig/courier/models/inbound_bulk_message.rbs
@@ -1589,6 +1597,7 @@ files:
1589
1597
  - sig/courier/resources/bulk.rbs
1590
1598
  - sig/courier/resources/digests.rbs
1591
1599
  - sig/courier/resources/digests/schedules.rbs
1600
+ - sig/courier/resources/feedback.rbs
1592
1601
  - sig/courier/resources/inbound.rbs
1593
1602
  - sig/courier/resources/journeys.rbs
1594
1603
  - sig/courier/resources/journeys/runs.rbs