ask-sentry 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c459eb70d05be7c610124e9f19253867d23cb9e729b3bd091d710d95e6483a19
-  data.tar.gz: abcc7d0d55dcdda71dbb36217236e3f9f0055466d57be5d8b35f564db2f22c71
+  metadata.gz: 652d533cd09abc7578f38914e793fbdb8c093cb5d3a2caca7295b836a169dc99
+  data.tar.gz: b3e4c7574c0a01b67d8011a619aa16e378399959fe9b2d2eba1c0c44ddd851e9
 SHA512:
-  metadata.gz: 9dfde1d5ea4914ac95c0cf839c3a1d97a6be838d9df6977f3c811d12b4a38abb8fff42f7b47af9677afd25f6d6f9725144d066e0f673429c8e607720939e764d
-  data.tar.gz: 54d3a356e91e1f3ffb19fdf05b7d0840edd60ce86007cc5b2036adff7c7cdcd092b1a56e9e2c386d8ec5f5c43e6e54ff542a5087f019d4de11c7df7d77b40357
+  metadata.gz: 489b6081c56145a76f0dac437abee66655d268ce0fe5d169a0322025042fed782e32c3837d152f5ff3909c66d5da55fc72b22c03ac5eaa8ed9e77366a54bf401
+  data.tar.gz: 1ac0aa367772b509bfc7af8f55c59c622877f3a9160a90f8290f271e33a98135be312f660e24d854a52e3ff628af95f973c50bb92100999635312c7215868ef5

data/README.md

@@ -1,6 +1,10 @@
 # ask-sentry
 
-Sentry — error tracking via the Sentry API
+[![Gem Version](https://badge.fury.io/rb/ask-sentry.svg)](https://badge.fury.io/rb/ask-sentry)
+
+Sentry service context for AI agents in the ask-rb ecosystem. It provides an
+authenticated HTTP client for the Sentry REST API, metadata constants for
+system prompts, and a structured error guide for common Sentry API issues.
 
 ## Installation
 
@@ -8,16 +12,66 @@ Sentry — error tracking via the Sentry API
 gem "ask-sentry"
 ```
 
-## Usage
+## Quick Start
 
 ```ruby
+require "ask-sentry"
+
+# Recent issues for an organization and project
+issues = Ask::Sentry.recent_errors(organization: "myorg", project: "myapp", limit: 10)
+
+# Events for a specific issue
+events = Ask::Sentry.issue_events(12345, limit: 10)
+
+# Or use the raw client (base URL: https://sentry.io/api/0/)
 client = Ask::Sentry.client
-# ... use the client according to its API
+client.get("projects/myorg/myapp/issues/")
 ```
 
-## Development
+## Authentication
+
+`Ask::Sentry.client` resolves a token via `Ask::Auth.resolve(:sentry_token)`.
+Set it in your environment:
 
 ```bash
+export SENTRY_TOKEN=your_token_here
+```
+
+Or add it to `~/.ask/credentials.yml`:
+
+```yaml
+sentry_token: your_token_here
+```
+
+Credentials can also come from Rails credentials, a database, or an OAuth
+provider, depending on your `ask-auth` configuration. The token is sent as a
+Bearer token. Create one at
+[sentry.io/settings/account/api/auth-tokens](https://sentry.io/settings/account/api/auth-tokens/).
+
+## Key entry points
+
+- `Ask::Sentry.client` - an authenticated Faraday client with base URL
+  `https://sentry.io/api/0/`. It is wrapped in a proxy that converts HTTP 401
+  responses into `Ask::Auth::InvalidCredential`.
+- `Ask::Sentry.recent_errors(organization:, project:, limit: 10)` - fetch
+  recent issues for a project.
+- `Ask::Sentry.issue_events(issue_id, limit: 10)` - fetch events for an issue.
+- `Ask::Sentry::Errors` - structured error knowledge for agents: guidance by
+  exception class, HTTP status descriptions, and rate limit info.
+- `Ask::Sentry::DESCRIPTION`, `DOCS_URL`, `AUTH_NAME`, `GEM_NAME`, and
+  `QUICK_START` - metadata constants for system prompts.
+
+## Full documentation
+
+The full ask-rb documentation lives at https://ask-rb.github.io/ask-docs.
+[Services: Sentry](https://ask-rb.github.io/ask-docs/services/sentry) covers
+ask-sentry in depth, including the client, error guide, and constants.
+API reference: https://ask-rb.github.io/ask-docs/reference/api.
+
+## Development
+
+```
+bundle install
 bundle exec rake test
 ```
 

data/lib/ask/sentry/error_guide.rb

@@ -14,7 +14,7 @@ module Ask
       # - When rate-limited, the API returns 429 Too Many Requests.
       # - The agent should wait for the Retry-After header and retry.
       RATE_LIMIT = {
-        description: "Sentry rate limits vary by plan. See https://docs.sentry.io/api/rate-limiting/",
+        description: "Sentry rate limits vary by plan. See https://docs.sentry.io/api/ratelimits/",
         error_status: 429,
         action: "Wait for the Retry-After header duration, then retry the request."
       }.freeze

data/lib/ask/sentry/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Sentry
-    VERSION = "0.1.2"
+    VERSION = "0.1.4"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-sentry
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Kaka Ruto
@@ -15,28 +15,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.11.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.11.3
 - !ruby/object:Gem::Dependency
   name: ask-auth
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.3.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.3.2
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -173,7 +173,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.18
 specification_version: 4
 summary: Sentry — error tracking via the Sentry API
 test_files: []