agentcat 0.0.1 → 1.0.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.
Files changed (50) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE +2 -11
  3. data/README.md +265 -20
  4. data/lib/agentcat/adapters/base.rb +73 -0
  5. data/lib/agentcat/adapters/official.rb +194 -0
  6. data/lib/agentcat/client.rb +171 -0
  7. data/lib/agentcat/clock.rb +16 -0
  8. data/lib/agentcat/custom_event.rb +215 -0
  9. data/lib/agentcat/delivery.rb +58 -0
  10. data/lib/agentcat/diagnostics.rb +434 -0
  11. data/lib/agentcat/error_capture.rb +117 -0
  12. data/lib/agentcat/event_id.rb +19 -0
  13. data/lib/agentcat/event_pipeline.rb +82 -0
  14. data/lib/agentcat/event_queue.rb +151 -0
  15. data/lib/agentcat/exporters/base.rb +135 -0
  16. data/lib/agentcat/exporters/datadog.rb +137 -0
  17. data/lib/agentcat/exporters/otlp.rb +157 -0
  18. data/lib/agentcat/exporters/posthog.rb +185 -0
  19. data/lib/agentcat/exporters/sentry.rb +242 -0
  20. data/lib/agentcat/exporters/trace_context.rb +79 -0
  21. data/lib/agentcat/exporters.rb +108 -0
  22. data/lib/agentcat/fork_safety.rb +30 -0
  23. data/lib/agentcat/hooks.rb +190 -0
  24. data/lib/agentcat/http_post.rb +61 -0
  25. data/lib/agentcat/interceptor.rb +711 -0
  26. data/lib/agentcat/log.rb +80 -0
  27. data/lib/agentcat/options.rb +313 -0
  28. data/lib/agentcat/payload_limits.rb +71 -0
  29. data/lib/agentcat/private_members.rb +271 -0
  30. data/lib/agentcat/redaction.rb +115 -0
  31. data/lib/agentcat/rejected_calls.rb +147 -0
  32. data/lib/agentcat/request_context.rb +266 -0
  33. data/lib/agentcat/sanitization.rb +191 -0
  34. data/lib/agentcat/schema/prompts.rb +44 -0
  35. data/lib/agentcat/session_manager.rb +83 -0
  36. data/lib/agentcat/tags.rb +61 -0
  37. data/lib/agentcat/test_mode.rb +86 -0
  38. data/lib/agentcat/testing.rb +153 -0
  39. data/lib/agentcat/text.rb +68 -0
  40. data/lib/agentcat/token_estimate.rb +98 -0
  41. data/lib/agentcat/tool_call.rb +129 -0
  42. data/lib/agentcat/tool_handle.rb +289 -0
  43. data/lib/agentcat/tracker.rb +201 -0
  44. data/lib/agentcat/truncation.rb +265 -0
  45. data/lib/agentcat/unredacted_event.rb +155 -0
  46. data/lib/agentcat/user_identity.rb +11 -0
  47. data/lib/agentcat/version.rb +2 -2
  48. data/lib/agentcat.rb +391 -21
  49. metadata +193 -16
  50. data/agentcat.gemspec +0 -30
data/lib/agentcat.rb CHANGED
@@ -1,27 +1,397 @@
1
- # frozen_string_literal: true
1
+ # typed: true
2
+
3
+ require "sorbet-runtime"
2
4
 
3
5
  require_relative "agentcat/version"
6
+ require_relative "agentcat/clock"
7
+ require_relative "agentcat/log"
8
+ require_relative "agentcat/private_members"
9
+ require_relative "agentcat/http_post"
10
+ require_relative "agentcat/test_mode"
11
+ require_relative "agentcat/diagnostics"
12
+ require_relative "agentcat/schema/prompts"
13
+ require_relative "agentcat/options"
14
+ require_relative "agentcat/hooks"
15
+ require_relative "agentcat/session_manager"
16
+ require_relative "agentcat/event_id"
17
+ require_relative "agentcat/user_identity"
18
+ require_relative "agentcat/request_context"
19
+ require_relative "agentcat/tool_call"
20
+ require_relative "agentcat/client"
21
+ require_relative "agentcat/tool_handle"
22
+ require_relative "agentcat/adapters/base"
23
+ require_relative "agentcat/adapters/official"
24
+ require_relative "agentcat/text"
25
+ require_relative "agentcat/unredacted_event"
26
+ require_relative "agentcat/token_estimate"
27
+ require_relative "agentcat/payload_limits"
28
+ require_relative "agentcat/tags"
29
+ require_relative "agentcat/sanitization"
30
+ require_relative "agentcat/truncation"
31
+ require_relative "agentcat/error_capture"
32
+ require_relative "agentcat/redaction"
33
+ require_relative "agentcat/event_queue"
34
+ require_relative "agentcat/delivery"
35
+ require_relative "agentcat/exporters"
36
+ require_relative "agentcat/event_pipeline"
37
+ require_relative "agentcat/fork_safety"
38
+ require_relative "agentcat/custom_event"
39
+ require_relative "agentcat/interceptor"
40
+ require_relative "agentcat/tracker"
4
41
 
5
- # AgentCat — analytics for MCP servers.
6
- #
7
- # This release is a name placeholder. The official AgentCat Ruby SDK, built on
8
- # the official Model Context Protocol Ruby SDK (the `mcp` gem), is in active
9
- # development and will ship as version 1.0.0.
10
- #
11
- # Until then, see the reference implementations:
12
- # TypeScript — https://github.com/agentcathq/agentcat-typescript-sdk
13
- # Python — https://github.com/agentcathq/agentcat-python-sdk
14
- # Go — https://github.com/agentcathq/agentcat-go-sdk
15
42
  module AgentCat
16
- # Raised by {AgentCat.track} until the real SDK ships.
17
- class NotYetImplementedError < StandardError; end
18
-
19
- # Placeholder for the SDK entry point.
20
- #
21
- # @raise [NotYetImplementedError] always, in this release.
22
- def self.track(*, **)
23
- raise NotYetImplementedError,
24
- "The AgentCat Ruby SDK is not released yet. This gem reserves the name " \
25
- "for the official implementation. See https://agentcat.com for status."
43
+ # `AgentCat.fake` and its assertions. Loaded on first use, not with the SDK.
44
+ autoload :Testing, File.expand_path("agentcat/testing", __dir__)
45
+
46
+ PROJECT_ID_PATTERN = /\Aproj_[A-Za-z0-9]{27}\z/
47
+ ADAPTERS = [Adapters::Official].freeze
48
+ # Like TS's 5 s graceful shutdown.
49
+ AT_EXIT_FLUSH_TIMEOUT = 5
50
+
51
+ # Server => Tracker, both held weakly, so a server built per request (the README's
52
+ # stateless pattern) is collected with its tracker once the request is done. The
53
+ # server keeps its own tracker alive: the dispatch wrapper and the tool handles that
54
+ # `Tracker#install!` puts on it reference the tracker. WeakMap compares keys by
55
+ # identity on every Ruby we support. Not `ObjectSpace::WeakKeyMap` (3.3+): it holds
56
+ # values strongly and the tracker references its server (through the adapter), so no
57
+ # server would ever be collected.
58
+ @trackers = ObjectSpace::WeakMap.new
59
+ @mutex = Mutex.new
60
+ @event_queue = T.let(nil, T.nilable(EventQueue))
61
+ @event_queue_mutex = Mutex.new
62
+ @event_queue_epoch = T.let(0, Integer)
63
+ @at_exit_registered = false
64
+ # The first tracked server's non-empty `Options#exporters`. Untracked custom events
65
+ # (no tracker, so no options of their own) go here, like TS's process-wide
66
+ # telemetry manager, which is also first-wins.
67
+ @process_exporters = T.let([], T::Array[T.untyped])
68
+ # `AgentCat.fake`'s recorder while a test uses one.
69
+ @fake = T.let(nil, T.untyped)
70
+ # A `track` ran while AgentCat was off (test mode or AGENTCAT_ENABLED=false).
71
+ @skipped_track = T.let(false, T::Boolean)
72
+ # Malformed project IDs already warned about, so a per-request `track` logs one line.
73
+ @warned_project_ids = T.let({}, T::Hash[String, TrueClass])
74
+
75
+ class << self
76
+ extend T::Sig
77
+
78
+ # Instruments `server` so that every tool call is attributed to a session and reported to AgentCat.
79
+ #
80
+ # Returns the server. Tracking is idempotent per server instance, and a server no adapter
81
+ # recognises is returned untouched.
82
+ #
83
+ # `project_id` nil, empty or blank means telemetry only: events go to `Options#exporters`
84
+ # and not to AgentCat (TS parity; `AGENTCAT_PROJECT_ID` is not read). A project ID that
85
+ # does not look like `proj_` plus 27 letters or digits logs one warning and is sent as
86
+ # given, like the TypeScript and PHP SDKs: the AgentCat API decides.
87
+ #
88
+ # `AGENTCAT_ENABLED` turns AgentCat off everywhere with `false`, `0`, `no` or `off`, and
89
+ # on everywhere with `true`, `1`, `yes` or `on`. Otherwise AgentCat does nothing in test
90
+ # environments (Minitest or RSpec loaded, or `RAILS_ENV`/`RACK_ENV`/`APP_ENV` set to
91
+ # `test` or `testing`) unless the test called `AgentCat.fake` first. "Nothing" means the
92
+ # server comes back untouched: no instrumentation, no delivery, no diagnostics.
93
+ sig { params(server: T.untyped, project_id: T.nilable(String), options: T.nilable(AgentCat::Options)).returns(T.untyped) }
94
+ def track(server, project_id = nil, options = nil)
95
+ unless TestMode.sdk_enabled?
96
+ @mutex.synchronize { @skipped_track = true }
97
+ return server
98
+ end
99
+
100
+ project_id = normalize_project_id(project_id)
101
+ options ||= Options.new
102
+ # A fake sends nothing, diagnostics included.
103
+ unless active_fake
104
+ Diagnostics.init(
105
+ project_id: project_id,
106
+ integration: integration_name(options),
107
+ disabled: options.disable_diagnostics
108
+ )
109
+ Diagnostics.record(:info, "AgentCat setup started | project #{project_display(project_id)}")
110
+ # Before anything can fail: a process whose `track` fails and then exits still
111
+ # sends that diagnostics record from the at_exit flush.
112
+ register_at_exit_flush!
113
+ end
114
+
115
+ begin
116
+ warn_if_malformed_project_id(project_id)
117
+ %i[identify resolve_session_id event_tags event_properties].each do |name|
118
+ Hooks.warn_if_two_arguments(options.public_send(name), name.to_s)
119
+ end
120
+
121
+ adapter_class = detect_adapter(server)
122
+ unless adapter_class
123
+ Diagnostics.record(:warn, "AgentCat setup skipped | no adapter for #{server.class}")
124
+ return server
125
+ end
126
+
127
+ # Once per process: every `mcp` gem internal AgentCat uses is there, or its
128
+ # feature is off (one ERROR line each).
129
+ PrivateMembers.check! if adapter_class == Adapters::Official
130
+
131
+ # Process-wide: captures incoming HTTP headers for `parameters.extra`. A
132
+ # no-op for stdio and for a process where the HTTP transport isn't loaded
133
+ # (yet); idempotent, so a second `track` doesn't re-patch.
134
+ RequestContext.install!
135
+
136
+ @mutex.synchronize do
137
+ return server if @trackers.key?(server)
138
+
139
+ # Built first: if building it raises, the first-wins process-wide settings
140
+ # below stay free for a `track` that works.
141
+ tracker = Tracker.new(adapter: adapter_class.new(server), project_id: project_id, options: options)
142
+ configure_default_client(options)
143
+ @process_exporters = options.exporters.dup.freeze if @process_exporters.empty? && !options.exporters.empty?
144
+ begin
145
+ tracker.install!
146
+ rescue => e
147
+ Log.error("AgentCat failed to instrument the server, so some of its calls are not tracked: #{e.class}: #{e.message}")
148
+ Diagnostics.record(:warn, "AgentCat failed to instrument server | #{e.class}: #{e.message}")
149
+ end
150
+ @trackers[server] = tracker
151
+ end
152
+
153
+ server
154
+ rescue => e
155
+ # `track` never raises into setup code. A wrong argument type still
156
+ # fails fast in the sig above, before this method body runs.
157
+ Log.error("AgentCat setup failed, the server is not tracked: #{e.class}: #{e.message}")
158
+ Diagnostics.record(:error, "AgentCat setup failed | #{e.class}: #{e.message}")
159
+ server
160
+ end
161
+ end
162
+
163
+ sig { params(server: T.untyped).returns(T.nilable(AgentCat::Tracker)) }
164
+ def tracker_for(server)
165
+ @mutex.synchronize { @trackers[server] }
166
+ end
167
+ alias_method :_tracking_data, :tracker_for
168
+
169
+ sig { params(server: T.untyped).returns(T::Boolean) }
170
+ def tracked?(server)
171
+ !tracker_for(server).nil?
172
+ end
173
+
174
+ # Forgets every tracked server. Instrumentation already installed on a server stays in place.
175
+ # The event queue is torn down and rebuilt lazily, so nothing queued (or retrying) from before
176
+ # the reset can publish into whatever follows it.
177
+ #
178
+ # Also removes `AgentCat.fake`'s recorder: call it in your test's teardown.
179
+ sig { void }
180
+ def reset!
181
+ Diagnostics.reset!
182
+ Log.reset!
183
+ PrivateMembers.reset!
184
+ @event_queue_mutex.synchronize do
185
+ @event_queue_epoch += 1
186
+ @event_queue&.shutdown
187
+ @event_queue = nil
188
+ end
189
+ @mutex.synchronize do
190
+ @trackers = ObjectSpace::WeakMap.new
191
+ @process_exporters = []
192
+ @fake = nil
193
+ @skipped_track = false
194
+ @warned_project_ids = {}
195
+ end
196
+ end
197
+
198
+ # Starts recording for your test suite and returns the recorder to assert on. While
199
+ # it is active, AgentCat instruments servers even in a test environment (and even
200
+ # with AGENTCAT_ENABLED=false), but every event goes to the fake instead of AgentCat,
201
+ # the exporters or diagnostics. Call it before `track`: in a test environment, a
202
+ # server tracked before `fake` is not tracked at all. A second call replaces the
203
+ # recorder. `AgentCat.reset!` (in your teardown) removes it.
204
+ #
205
+ # fake = AgentCat.fake
206
+ # AgentCat.track(server, "proj_...")
207
+ # # ... call a tool ...
208
+ # fake.assert_tracked("my_tool")
209
+ sig { returns(AgentCat::Testing::Fake) }
210
+ def fake
211
+ recorder = Testing::Fake.new
212
+ @mutex.synchronize { @fake = recorder }
213
+ recorder
214
+ end
215
+
216
+ # The active `fake`, or nil. Internal: the event pipeline asks it.
217
+ sig { returns(T.nilable(AgentCat::Testing::Fake)) }
218
+ def active_fake
219
+ @fake
220
+ end
221
+
222
+ # Whether a `track` ran while AgentCat was off, for the fake's failure messages.
223
+ sig { returns(T::Boolean) }
224
+ def skipped_track?
225
+ @skipped_track
226
+ end
227
+
228
+ # See `@process_exporters` above.
229
+ sig { returns(T::Array[T.untyped]) }
230
+ def process_exporters
231
+ @mutex.synchronize { @process_exporters }
232
+ end
233
+
234
+ # Monotonic counter bumped by `reset!`. `Delivery` compares against it between publish
235
+ # attempts so an event enqueued before a reset isn't delivered into a stale process state.
236
+ sig { returns(Integer) }
237
+ def event_epoch
238
+ @event_queue_mutex.synchronize { @event_queue_epoch }
239
+ end
240
+
241
+ sig { params(server: T.untyped).returns(T.nilable(T.class_of(AgentCat::Adapters::Base))) }
242
+ def detect_adapter(server)
243
+ ADAPTERS.find { |adapter| adapter.supports?(server) }
244
+ end
245
+
246
+ # Lazy, process-wide. Created on first use rather than at `track()` time, so a
247
+ # process that never publishes anything never spawns a worker thread. `queue_size`
248
+ # only takes effect on that first creation, same as the client timeout.
249
+ sig { params(queue_size: T.nilable(Integer)).returns(EventQueue) }
250
+ def event_queue(queue_size: nil)
251
+ @event_queue_mutex.synchronize do
252
+ @event_queue ||= begin
253
+ ForkSafety.install!
254
+ register_at_exit_flush!
255
+ EventQueue.new(max_size: queue_size || EventQueue::DEFAULT_MAX_SIZE)
256
+ end
257
+ end
258
+ end
259
+
260
+ # For the `Process._fork` hook — not meant to be called directly.
261
+ sig { void }
262
+ def reset_event_queue_after_fork!
263
+ @event_queue&.reset_after_fork!
264
+ end
265
+
266
+ # Waits for queued events to publish, then sends AgentCat's pending diagnostics
267
+ # records (at most about 1 s more, see Diagnostics::TOTAL_TIMEOUT). Returns whether
268
+ # the event queue drained in time. `at_exit` calls this too (with a 5 s budget), but
269
+ # that's best-effort only — no SIGKILL, no guaranteed ordering against Puma's
270
+ # shutdown — so call it explicitly on shutdown if you're in a container or anything
271
+ # short-lived.
272
+ sig { params(timeout: Numeric).returns(T::Boolean) }
273
+ def flush(timeout: 5)
274
+ drained = @event_queue.nil? || @event_queue.flush(timeout: timeout)
275
+ # After the events: a publish that gave up records a diagnostics line.
276
+ Diagnostics.flush
277
+ drained
278
+ end
279
+
280
+ # Publishes one `agentcat:custom` event for work that is not a tool call - a
281
+ # background job, a webhook, a checkout step, anything you want on the same
282
+ # timeline as the tool calls AgentCat captures automatically.
283
+ #
284
+ # `server_or_session_id` is either a server already passed to `track()`, or a
285
+ # session ID string used verbatim (never validated, trimmed, or derived - this is
286
+ # a deliberate call, not an agent's guess). `session_id:` takes precedence over
287
+ # a string first argument, and attributes the event to a task; without one, a
288
+ # tracked server publishes without a session (handles are per-request, so a
289
+ # tracked server has no ambient one to fall back on).
290
+ #
291
+ # `project_id` is used as given in the session-ID-string form. In the tracked-
292
+ # server form it's ignored - the project captured at `track()` time wins, so a
293
+ # telemetry-only server still publishes.
294
+ #
295
+ # Does nothing where `track` does nothing (see `AGENTCAT_ENABLED` there); with
296
+ # `AgentCat.fake`, the event goes to the fake.
297
+ #
298
+ # Fire-and-forget: never raises. A mistyped `resource_name`/`message`/`duration`/
299
+ # `is_error`/`tags` costs that field, not the event; a non-Hash `parameters`/
300
+ # `response`/`properties` is wrapped as `{value: ...}` and kept, since the wire
301
+ # field holds an object and the payload is yours to keep.
302
+ #
303
+ # Every customer-data param below is `T.untyped`, not the type it's documented to
304
+ # want: a `sig` must not be what enforces this (same rule as hook return values,
305
+ # see Options' typing note) - a mistyped field has to reach CustomEvent's own
306
+ # wire_* coercion to be downgraded gracefully, not raise here first.
307
+ sig do
308
+ params(
309
+ server_or_session_id: T.untyped,
310
+ project_id: T.untyped,
311
+ session_id: T.untyped,
312
+ resource_name: T.untyped,
313
+ parameters: T.untyped,
314
+ response: T.untyped,
315
+ message: T.untyped,
316
+ duration: T.untyped,
317
+ is_error: T.untyped,
318
+ error: T.untyped,
319
+ tags: T.untyped,
320
+ properties: T.untyped
321
+ ).void
322
+ end
323
+ def publish_custom_event(
324
+ server_or_session_id,
325
+ project_id,
326
+ session_id: nil,
327
+ resource_name: nil,
328
+ parameters: nil,
329
+ response: nil,
330
+ message: nil,
331
+ duration: nil,
332
+ is_error: nil,
333
+ error: nil,
334
+ tags: nil,
335
+ properties: nil
336
+ )
337
+ return unless TestMode.sdk_enabled?
338
+
339
+ CustomEvent.publish(
340
+ server_or_session_id, project_id,
341
+ session_id: session_id, resource_name: resource_name, parameters: parameters,
342
+ response: response, message: message, duration: duration, is_error: is_error,
343
+ error: error, tags: tags, properties: properties
344
+ )
345
+ end
346
+
347
+ private
348
+
349
+ sig { void }
350
+ def register_at_exit_flush!
351
+ return if @at_exit_registered
352
+
353
+ @at_exit_registered = true
354
+ at_exit { flush(timeout: AT_EXIT_FLUSH_TIMEOUT) }
355
+ end
356
+
357
+ # First `track` wins, like the event queue's size.
358
+ sig { params(options: AgentCat::Options).void }
359
+ def configure_default_client(options)
360
+ return unless options.default_client?
361
+
362
+ Client.configure_timeout(options.request_timeout)
363
+ base_url = options.api_base_url
364
+ Client.configure_base_url(base_url) if base_url
365
+ end
366
+
367
+ # nil, "" and whitespace-only all mean telemetry only.
368
+ sig { params(project_id: T.nilable(String)).returns(T.nilable(String)) }
369
+ def normalize_project_id(project_id)
370
+ return nil if project_id.nil? || project_id.strip.empty?
371
+
372
+ project_id
373
+ end
374
+
375
+ sig { params(project_id: T.nilable(String)).void }
376
+ def warn_if_malformed_project_id(project_id)
377
+ return if project_id.nil? || project_id.match?(PROJECT_ID_PATTERN)
378
+ first_time = @mutex.synchronize { @warned_project_ids.store(project_id, true) unless @warned_project_ids.key?(project_id) }
379
+ return unless first_time
380
+
381
+ message = "project_id #{project_id.inspect} does not match proj_ followed by 27 letters or digits; " \
382
+ "events are sent with it as given, and the AgentCat API can reject them"
383
+ logger.warn(message)
384
+ Diagnostics.record(:warn, "AgentCat setup warning | #{message}")
385
+ end
386
+
387
+ sig { params(_options: AgentCat::Options).returns(String) }
388
+ def integration_name(_options)
389
+ "ruby"
390
+ end
391
+
392
+ sig { params(project_id: T.nilable(String)).returns(String) }
393
+ def project_display(project_id)
394
+ project_id.to_s.empty? ? "(telemetry-only)" : project_id.to_s
395
+ end
26
396
  end
27
397
  end
metadata CHANGED
@@ -1,28 +1,206 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: agentcat
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.1
4
+ version: 1.0.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - AgentCat, Inc.
8
- autorequire:
9
8
  bindir: bin
10
9
  cert_chain: []
11
- date: 2026-08-23 00:00:00.000000000 Z
12
- dependencies: []
13
- description: AgentCat captures tool usage patterns and user intent from MCP (Model
14
- Context Protocol) servers. This release reserves the gem name for the official Ruby
15
- SDK, which is in active development.
16
- email:
17
- - support@agentcat.com
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: agentcat-api
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - '='
17
+ - !ruby/object:Gem::Version
18
+ version: 0.0.3
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - '='
24
+ - !ruby/object:Gem::Version
25
+ version: 0.0.3
26
+ - !ruby/object:Gem::Dependency
27
+ name: sorbet-runtime
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - ">="
31
+ - !ruby/object:Gem::Version
32
+ version: '0.5'
33
+ type: :runtime
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - ">="
38
+ - !ruby/object:Gem::Version
39
+ version: '0.5'
40
+ - !ruby/object:Gem::Dependency
41
+ name: mcp
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - ">="
45
+ - !ruby/object:Gem::Version
46
+ version: 0.23.0
47
+ type: :runtime
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - ">="
52
+ - !ruby/object:Gem::Version
53
+ version: 0.23.0
54
+ - !ruby/object:Gem::Dependency
55
+ name: minitest
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - ">="
59
+ - !ruby/object:Gem::Version
60
+ version: '6'
61
+ type: :development
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - ">="
66
+ - !ruby/object:Gem::Version
67
+ version: '6'
68
+ - !ruby/object:Gem::Dependency
69
+ name: minitest-mock
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - ">="
73
+ - !ruby/object:Gem::Version
74
+ version: '5.27'
75
+ type: :development
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - ">="
80
+ - !ruby/object:Gem::Version
81
+ version: '5.27'
82
+ - !ruby/object:Gem::Dependency
83
+ name: rack
84
+ requirement: !ruby/object:Gem::Requirement
85
+ requirements:
86
+ - - ">="
87
+ - !ruby/object:Gem::Version
88
+ version: '2.2'
89
+ type: :development
90
+ prerelease: false
91
+ version_requirements: !ruby/object:Gem::Requirement
92
+ requirements:
93
+ - - ">="
94
+ - !ruby/object:Gem::Version
95
+ version: '2.2'
96
+ - !ruby/object:Gem::Dependency
97
+ name: rake
98
+ requirement: !ruby/object:Gem::Requirement
99
+ requirements:
100
+ - - ">="
101
+ - !ruby/object:Gem::Version
102
+ version: '13'
103
+ type: :development
104
+ prerelease: false
105
+ version_requirements: !ruby/object:Gem::Requirement
106
+ requirements:
107
+ - - ">="
108
+ - !ruby/object:Gem::Version
109
+ version: '13'
110
+ - !ruby/object:Gem::Dependency
111
+ name: simplecov
112
+ requirement: !ruby/object:Gem::Requirement
113
+ requirements:
114
+ - - ">="
115
+ - !ruby/object:Gem::Version
116
+ version: '0.22'
117
+ type: :development
118
+ prerelease: false
119
+ version_requirements: !ruby/object:Gem::Requirement
120
+ requirements:
121
+ - - ">="
122
+ - !ruby/object:Gem::Version
123
+ version: '0.22'
124
+ - !ruby/object:Gem::Dependency
125
+ name: sorbet
126
+ requirement: !ruby/object:Gem::Requirement
127
+ requirements:
128
+ - - ">="
129
+ - !ruby/object:Gem::Version
130
+ version: '0.5'
131
+ type: :development
132
+ prerelease: false
133
+ version_requirements: !ruby/object:Gem::Requirement
134
+ requirements:
135
+ - - ">="
136
+ - !ruby/object:Gem::Version
137
+ version: '0.5'
138
+ - !ruby/object:Gem::Dependency
139
+ name: standard
140
+ requirement: !ruby/object:Gem::Requirement
141
+ requirements:
142
+ - - ">="
143
+ - !ruby/object:Gem::Version
144
+ version: 1.35.1
145
+ type: :development
146
+ prerelease: false
147
+ version_requirements: !ruby/object:Gem::Requirement
148
+ requirements:
149
+ - - ">="
150
+ - !ruby/object:Gem::Version
151
+ version: 1.35.1
152
+ description: AgentCat is an analytics platform for MCP server owners. It tracks tool
153
+ usage patterns of the MCP servers built on the official mcp gem and provides insights.
18
154
  executables: []
19
155
  extensions: []
20
156
  extra_rdoc_files: []
21
157
  files:
22
158
  - LICENSE
23
159
  - README.md
24
- - agentcat.gemspec
25
160
  - lib/agentcat.rb
161
+ - lib/agentcat/adapters/base.rb
162
+ - lib/agentcat/adapters/official.rb
163
+ - lib/agentcat/client.rb
164
+ - lib/agentcat/clock.rb
165
+ - lib/agentcat/custom_event.rb
166
+ - lib/agentcat/delivery.rb
167
+ - lib/agentcat/diagnostics.rb
168
+ - lib/agentcat/error_capture.rb
169
+ - lib/agentcat/event_id.rb
170
+ - lib/agentcat/event_pipeline.rb
171
+ - lib/agentcat/event_queue.rb
172
+ - lib/agentcat/exporters.rb
173
+ - lib/agentcat/exporters/base.rb
174
+ - lib/agentcat/exporters/datadog.rb
175
+ - lib/agentcat/exporters/otlp.rb
176
+ - lib/agentcat/exporters/posthog.rb
177
+ - lib/agentcat/exporters/sentry.rb
178
+ - lib/agentcat/exporters/trace_context.rb
179
+ - lib/agentcat/fork_safety.rb
180
+ - lib/agentcat/hooks.rb
181
+ - lib/agentcat/http_post.rb
182
+ - lib/agentcat/interceptor.rb
183
+ - lib/agentcat/log.rb
184
+ - lib/agentcat/options.rb
185
+ - lib/agentcat/payload_limits.rb
186
+ - lib/agentcat/private_members.rb
187
+ - lib/agentcat/redaction.rb
188
+ - lib/agentcat/rejected_calls.rb
189
+ - lib/agentcat/request_context.rb
190
+ - lib/agentcat/sanitization.rb
191
+ - lib/agentcat/schema/prompts.rb
192
+ - lib/agentcat/session_manager.rb
193
+ - lib/agentcat/tags.rb
194
+ - lib/agentcat/test_mode.rb
195
+ - lib/agentcat/testing.rb
196
+ - lib/agentcat/text.rb
197
+ - lib/agentcat/token_estimate.rb
198
+ - lib/agentcat/tool_call.rb
199
+ - lib/agentcat/tool_handle.rb
200
+ - lib/agentcat/tracker.rb
201
+ - lib/agentcat/truncation.rb
202
+ - lib/agentcat/unredacted_event.rb
203
+ - lib/agentcat/user_identity.rb
26
204
  - lib/agentcat/version.rb
27
205
  homepage: https://agentcat.com
28
206
  licenses:
@@ -30,10 +208,9 @@ licenses:
30
208
  metadata:
31
209
  homepage_uri: https://agentcat.com
32
210
  source_code_uri: https://github.com/agentcathq/agentcat-ruby-sdk
211
+ changelog_uri: https://github.com/agentcathq/agentcat-ruby-sdk/blob/main/CHANGELOG.md
33
212
  bug_tracker_uri: https://github.com/agentcathq/agentcat-ruby-sdk/issues
34
- documentation_uri: https://docs.agentcat.com
35
213
  rubygems_mfa_required: 'true'
36
- post_install_message:
37
214
  rdoc_options: []
38
215
  require_paths:
39
216
  - lib
@@ -41,15 +218,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
41
218
  requirements:
42
219
  - - ">="
43
220
  - !ruby/object:Gem::Version
44
- version: 2.7.0
221
+ version: '3.3'
45
222
  required_rubygems_version: !ruby/object:Gem::Requirement
46
223
  requirements:
47
224
  - - ">="
48
225
  - !ruby/object:Gem::Version
49
226
  version: '0'
50
227
  requirements: []
51
- rubygems_version: 3.0.3.1
52
- signing_key:
228
+ rubygems_version: 3.6.9
53
229
  specification_version: 4
54
- summary: Analytics for MCP servers - placeholder for the official AgentCat Ruby SDK
230
+ summary: Analytics tool for MCP (Model Context Protocol) servers, Claude Connectors,
231
+ and ChatGPT Plugins
55
232
  test_files: []
data/agentcat.gemspec DELETED
@@ -1,30 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative "lib/agentcat/version"
4
-
5
- Gem::Specification.new do |spec|
6
- spec.name = "agentcat"
7
- spec.version = AgentCat::VERSION
8
- spec.authors = ["AgentCat, Inc."]
9
- spec.email = ["support@agentcat.com"]
10
-
11
- spec.summary = "Analytics for MCP servers - placeholder for the official AgentCat Ruby SDK"
12
- spec.description = "AgentCat captures tool usage patterns and user intent from MCP " \
13
- "(Model Context Protocol) servers. This release reserves the gem name " \
14
- "for the official Ruby SDK, which is in active development."
15
- spec.homepage = "https://agentcat.com"
16
- spec.license = "MIT"
17
-
18
- spec.required_ruby_version = ">= 2.7.0"
19
-
20
- spec.metadata = {
21
- "homepage_uri" => "https://agentcat.com",
22
- "source_code_uri" => "https://github.com/agentcathq/agentcat-ruby-sdk",
23
- "bug_tracker_uri" => "https://github.com/agentcathq/agentcat-ruby-sdk/issues",
24
- "documentation_uri" => "https://docs.agentcat.com",
25
- "rubygems_mfa_required" => "true"
26
- }
27
-
28
- spec.files = %w[README.md LICENSE agentcat.gemspec] + Dir["lib/**/*.rb"]
29
- spec.require_paths = ["lib"]
30
- end