@danieljvdm/dev-kit 1.0.2 → 2.0.0

package/skills/sentry/references/semantics/cloudflare.md

@@ -0,0 +1,23 @@
+# Cloudflare attributes
+
+Cloudflare Workers, bindings, and edge platform attributes.
+
+| Key                                               | Type      | Brief                                                                    |
+| ------------------------------------------------- | --------- | ------------------------------------------------------------------------ |
+| `cloudflare.d1.duration`                          | `integer` | The duration of a Cloudflare D1 operation.                               |
+| `cloudflare.d1.rows_read`                         | `integer` | The number of rows read in a Cloudflare D1 operation.                    |
+| `cloudflare.d1.rows_written`                      | `integer` | The number of rows written in a Cloudflare D1 operation.                 |
+| `cloudflare.durable_object.query.bindings`        | `integer` | The number of bound parameters passed to the SQL exec call.              |
+| `cloudflare.durable_object.response.rows_read`    | `integer` | The number of rows read by a Cloudflare Durable Object SQL operation.    |
+| `cloudflare.durable_object.response.rows_written` | `integer` | The number of rows written by a Cloudflare Durable Object SQL operation. |
+| `cloudflare.r2.bucket`                            | `string`  | The name of the Cloudflare R2 bucket binding                             |
+| `cloudflare.r2.operation`                         | `string`  | The R2 API operation being performed                                     |
+| `cloudflare.r2.request.delimiter`                 | `string`  | The delimiter used to group objects in an R2 list operation              |
+| `cloudflare.r2.request.key`                       | `string`  | The object key used in the R2 operation                                  |
+| `cloudflare.r2.request.part_number`               | `integer` | The part number in a multipart upload operation                          |
+| `cloudflare.r2.request.prefix`                    | `string`  | The prefix used to filter objects in an R2 list operation                |
+| `cloudflare.workflow.attempt`                     | `integer` | The current attempt number for a Cloudflare Workflow step                |
+| `cloudflare.workflow.retries.backoff`             | `string`  | The backoff strategy for Cloudflare Workflow step retries                |
+| `cloudflare.workflow.retries.delay`               | `string`  | The delay between Cloudflare Workflow step retries                       |
+| `cloudflare.workflow.retries.limit`               | `integer` | The maximum number of retries for a Cloudflare Workflow step             |
+| `cloudflare.workflow.timeout`                     | `string`  | The timeout duration for a Cloudflare Workflow step                      |

package/skills/sentry/references/semantics/code.md

@@ -0,0 +1,11 @@
+# Code attributes
+
+Source location attributes — function, file, line, namespace.
+
+| Key                  | Type      | Brief                                                                                                                                                                                                    |
+| -------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `code.file.path`     | `string`  | The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path).                                                                                      |
+| `code.function`      | `string`  | The method or function name, or equivalent (usually rightmost part of the code unit’s name).                                                                                                             |
+| `code.function.name` | `string`  | The method or function fully-qualified name without arguments.                                                                                                                                           |
+| `code.line.number`   | `integer` | The line number in code.filepath best representing the operation. It SHOULD point within the code unit named in code.function                                                                            |
+| `code.namespace`     | `string`  | The ‘namespace’ within which code.function is defined. Usually the qualified class or module name, such that code.namespace + some separator + code.function form a unique identifier for the code unit. |

package/skills/sentry/references/semantics/culture.md

@@ -0,0 +1,11 @@
+# Culture attributes
+
+Locale and cultural preference attributes.
+
+| Key                         | Type      | Brief                                                             |
+| --------------------------- | --------- | ----------------------------------------------------------------- |
+| `culture.calendar`          | `string`  | The calendar system used by the culture.                          |
+| `culture.display_name`      | `string`  | Human readable name of the culture.                               |
+| `culture.is_24_hour_format` | `boolean` | Whether the culture uses 24-hour time format.                     |
+| `culture.locale`            | `string`  | The locale identifier following RFC 4646.                         |
+| `culture.timezone`          | `string`  | The timezone of the culture, as a geographic timezone identifier. |

package/skills/sentry/references/semantics/db.md

@@ -0,0 +1,21 @@
+# Database attributes
+
+Database query attributes — system, operation, statement summary, and collection.
+
+| Key                        | Type       | Brief                                                                                                                                                                                                                                                                                      |
+| -------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `db.collection.name`       | `string`   | The name of a collection (table, container) within the database.                                                                                                                                                                                                                           |
+| `db.driver.name`           | `string`   | The name of the driver used for the database connection.                                                                                                                                                                                                                                   |
+| `db.namespace`             | `string`   | The name of the database being accessed.                                                                                                                                                                                                                                                   |
+| `db.operation.batch.size`  | `integer`  | The number of queries included in a batch operation. Operations are only considered batches when they contain two or more operations, and so db.operation.batch.size SHOULD never be 1.                                                                                                    |
+| `db.operation.name`        | `string`   | The name of the operation being executed.                                                                                                                                                                                                                                                  |
+| `db.query.parameter.<key>` | `string`   | A query parameter used in db.query.text, with <key> being the parameter name, and the attribute value being a string representation of the parameter value.                                                                                                                                |
+| `db.query.summary`         | `string`   | A shortened representation of operation(s) in the full query. This attribute must be low-cardinality and should only contain the operation table names.                                                                                                                                    |
+| `db.query.text`            | `string`   | The database parameterized query being executed. Any parameter values (filters, insertion values, etc) should be replaced with parameter placeholders. If applicable, use `db.query.parameter.<key>` to add the parameter value.                                                           |
+| `db.redis.connection`      | `string`   | The redis connection name.                                                                                                                                                                                                                                                                 |
+| `db.redis.key`             | `string`   | The key the Redis command is operating on.                                                                                                                                                                                                                                                 |
+| `db.redis.parameters`      | `string[]` | The array of command parameters given to a redis command.                                                                                                                                                                                                                                  |
+| `db.response.status_code`  | `string`   | Database response status code. The status code returned by the database. Usually it represents an error code, but may also represent partial success, warning, or differentiate between various types of successful outcomes.                                                              |
+| `db.stored_procedure.name` | `string`   | The name of a stored procedure being called.                                                                                                                                                                                                                                               |
+| `db.system.name`           | `string`   | An identifier for the database management system (DBMS) product being used. See [OpenTelemetry docs](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/database/database-spans.md#notes-and-well-known-identifiers-for-dbsystem) for a list of well-known identifiers. |
+| `db.user`                  | `string`   | The database user.                                                                                                                                                                                                                                                                         |

package/skills/sentry/references/semantics/device.md

@@ -0,0 +1,43 @@
+# Device attributes
+
+Device hardware and form-factor attributes for mobile and desktop.
+
+| Key                                | Type       | Brief                                                                                                                                                                 |
+| ---------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `device.archs`                     | `string[]` | The CPU architectures of the device.                                                                                                                                  |
+| `device.battery_level`             | `double`   | The battery level of the device as a percentage (0-100).                                                                                                              |
+| `device.battery_temperature`       | `double`   | The battery temperature of the device in Celsius.                                                                                                                     |
+| `device.boot_time`                 | `string`   | A formatted UTC timestamp when the system was booted.                                                                                                                 |
+| `device.brand`                     | `string`   | The brand of the device.                                                                                                                                              |
+| `device.charging`                  | `boolean`  | Whether the device was charging or not.                                                                                                                               |
+| `device.chipset`                   | `string`   | The chipset of the device.                                                                                                                                            |
+| `device.class`                     | `string`   | The classification of the device. For example, `low`, `medium`, or `high`. Typically inferred by Relay - SDKs generally do not need to set this directly.             |
+| `device.cpu_description`           | `string`   | A description of the CPU of the device.                                                                                                                               |
+| `device.external_free_storage`     | `integer`  | External storage free size in bytes.                                                                                                                                  |
+| `device.external_storage_size`     | `integer`  | External storage total size in bytes.                                                                                                                                 |
+| `device.family`                    | `string`   | The family of the device.                                                                                                                                             |
+| `device.free_memory`               | `integer`  | Free system memory in bytes.                                                                                                                                          |
+| `device.free_storage`              | `integer`  | Free device storage in bytes.                                                                                                                                         |
+| `device.id`                        | `string`   | Unique device identifier.                                                                                                                                             |
+| `device.locale`                    | `string`   | The locale of the device.                                                                                                                                             |
+| `device.low_memory`                | `boolean`  | Whether the device was low on memory.                                                                                                                                 |
+| `device.low_power_mode`            | `boolean`  | Whether the device is in Low Power Mode.                                                                                                                              |
+| `device.manufacturer`              | `string`   | The manufacturer of the device.                                                                                                                                       |
+| `device.memory.estimated_capacity` | `integer`  | The estimated total memory capacity of the device, only a rough estimation in gigabytes. Browsers report estimations in buckets of powers of 2, mostly capped at 8 GB |
+| `device.memory_size`               | `integer`  | Total system memory available in bytes.                                                                                                                               |
+| `device.model`                     | `string`   | The model of the device.                                                                                                                                              |
+| `device.model_id`                  | `string`   | An internal hardware revision to identify the device exactly.                                                                                                         |
+| `device.name`                      | `string`   | The name of the device. On mobile, this is the user-assigned device name. On servers and desktops, this is typically the hostname.                                    |
+| `device.online`                    | `boolean`  | Whether the device was online or not.                                                                                                                                 |
+| `device.orientation`               | `string`   | The orientation of the device, either “portrait” or “landscape”.                                                                                                      |
+| `device.processor_count`           | `integer`  | Number of “logical processors”.                                                                                                                                       |
+| `device.processor_frequency`       | `double`   | Processor frequency in MHz.                                                                                                                                           |
+| `device.screen_density`            | `double`   | The screen density of the device.                                                                                                                                     |
+| `device.screen_dpi`                | `integer`  | The screen density in dots-per-inch (DPI) of the device.                                                                                                              |
+| `device.screen_height_pixels`      | `integer`  | The height of the device screen in pixels.                                                                                                                            |
+| `device.screen_width_pixels`       | `integer`  | The width of the device screen in pixels.                                                                                                                             |
+| `device.simulator`                 | `boolean`  | Whether the device is a simulator or an actual device.                                                                                                                |
+| `device.storage_size`              | `integer`  | Total device storage in bytes.                                                                                                                                        |
+| `device.thermal_state`             | `string`   | The thermal state of the device. Based on Apple’s `ProcessInfo.ThermalState` enum: `nominal`, `fair`, `serious`, or `critical`.                                       |
+| `device.timezone`                  | `string`   | The timezone of the device.                                                                                                                                           |
+| `device.usable_memory`             | `integer`  | Memory usable for the app in bytes.                                                                                                                                   |

package/skills/sentry/references/semantics/error.md

@@ -0,0 +1,7 @@
+# Error attributes
+
+Error classification attributes attached to failures.
+
+| Key          | Type     | Brief                                                |
+| ------------ | -------- | ---------------------------------------------------- |
+| `error.type` | `string` | Describes a class of error the operation ended with. |

package/skills/sentry/references/semantics/event.md

@@ -0,0 +1,8 @@
+# Event attributes
+
+Event identity attributes for discrete application events.
+
+| Key          | Type      | Brief                                                     |
+| ------------ | --------- | --------------------------------------------------------- |
+| `event.id`   | `integer` | The unique identifier for this event (log record)         |
+| `event.name` | `string`  | The name that uniquely identifies this event (log record) |

package/skills/sentry/references/semantics/exception.md

@@ -0,0 +1,10 @@
+# Exception attributes
+
+Exception type, message, and stack details on error spans.
+
+| Key                    | Type      | Brief                                                                                                                                                                               |
+| ---------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `exception.escaped`    | `boolean` | SHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span.                                         |
+| `exception.message`    | `string`  | The error message.                                                                                                                                                                  |
+| `exception.stacktrace` | `string`  | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG.                        |
+| `exception.type`       | `string`  | The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. |

package/skills/sentry/references/semantics/faas.md

@@ -0,0 +1,19 @@
+# FaaS attributes
+
+Function-as-a-service / serverless invocation attributes.
+
+| Key                     | Type      | Brief                                                                                                                                                       |
+| ----------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `faas.coldstart`        | `boolean` | A boolean that is true if the serverless function is executed for the first time (aka cold-start).                                                          |
+| `faas.cron`             | `string`  | A string containing the schedule period as Cron Expression.                                                                                                 |
+| `faas.duration_in_ms`   | `integer` | The duration a function took to run, in milliseconds.                                                                                                       |
+| `faas.entry_point`      | `string`  | The code that’s run when the cloud provider invokes your function.                                                                                          |
+| `faas.identity`         | `string`  | The Service Account (GCP), IAM Execution Role (AWS), or Managed Identity (Azure) used by the serverless function when interacting with other cloud services |
+| `faas.invocation_id`    | `string`  | The invocation ID of the current function invocation.                                                                                                       |
+| `faas.invoked_name`     | `string`  | The name of the invoked function.                                                                                                                           |
+| `faas.invoked_provider` | `string`  | The cloud provider of the invoked function.                                                                                                                 |
+| `faas.invoked_region`   | `string`  | The cloud region of the invoked function.                                                                                                                   |
+| `faas.name`             | `string`  | The name of the serverless function                                                                                                                         |
+| `faas.time`             | `string`  | A string containing the function invocation time in the ISO 8601 format expressed in UTC.                                                                   |
+| `faas.trigger`          | `string`  | Type of the trigger which caused this function invocation.                                                                                                  |
+| `faas.version`          | `string`  | The version of the function that was invoked                                                                                                                |

package/skills/sentry/references/semantics/file.md

@@ -0,0 +1,8 @@
+# File attributes
+
+File path and I/O operation attributes.
+
+| Key         | Type      | Brief               |
+| ----------- | --------- | ------------------- |
+| `file.path` | `string`  | Path to the file.   |
+| `file.size` | `integer` | File size in bytes. |

package/skills/sentry/references/semantics/flag.md

@@ -0,0 +1,7 @@
+# Flag attributes
+
+Feature-flag evaluation attributes.
+
+| Key                     | Type      | Brief                                                                                                                                                                      |
+| ----------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `flag.evaluation.<key>` | `boolean` | An instance of a feature flag evaluation. The value of this attribute is the boolean representing the evaluation result. The <key> suffix is the name of the feature flag. |

package/skills/sentry/references/semantics/gcp.md

@@ -0,0 +1,16 @@
+# GCP attributes
+
+Google Cloud Platform service and resource attributes.
+
+| Key                                | Type     | Brief                                                                          |
+| ---------------------------------- | -------- | ------------------------------------------------------------------------------ |
+| `gcp.function.context.event_id`    | `string` | The event ID from the legacy GCP Cloud Function context (1st gen)              |
+| `gcp.function.context.event_type`  | `string` | The type of the GCP Cloud Function event                                       |
+| `gcp.function.context.id`          | `string` | The unique event ID from the GCP CloudEvents context (2nd gen Cloud Functions) |
+| `gcp.function.context.resource`    | `string` | The resource that triggered the GCP Cloud Function event                       |
+| `gcp.function.context.source`      | `string` | The source of the GCP Cloud Function event                                     |
+| `gcp.function.context.specversion` | `string` | The CloudEvents specification version of the GCP Cloud Function event          |
+| `gcp.function.context.time`        | `string` | The timestamp of the GCP Cloud Function event                                  |
+| `gcp.function.context.timestamp`   | `string` | The legacy timestamp of the GCP Cloud Function event                           |
+| `gcp.function.context.type`        | `string` | The type of the GCP Cloud Function event context                               |
+| `gcp.project.id`                   | `string` | The ID of the project in GCP that this resource is associated with             |

package/skills/sentry/references/semantics/gen_ai.md

@@ -0,0 +1,53 @@
+# Gen AI attributes
+
+LLM and agent attributes — model, tokens, cost, tools, and conversation id.
+
+| Key                                        | Type       | Brief                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| ------------------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `gen_ai.agent.name`                        | `string`   | The name of the agent being used.                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `gen_ai.context.utilization`               | `double`   | The fraction of the model context window utilized by this generation.                                                                                                                                                                                                                                                                                                                                                                             |
+| `gen_ai.context.window_size`               | `integer`  | The maximum context window size supported by the model for this generation.                                                                                                                                                                                                                                                                                                                                                                       |
+| `gen_ai.conversation.id`                   | `string`   | The unique identifier for a conversation (session, thread), used to store and correlate messages within this conversation.                                                                                                                                                                                                                                                                                                                        |
+| `gen_ai.cost.cache_creation.input_tokens`  | `double`   | The cost of input tokens written to cache in USD.                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `gen_ai.cost.cache_read.input_tokens`      | `double`   | The cost of cached input tokens in USD.                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `gen_ai.cost.input_tokens`                 | `double`   | The total cost of all input tokens in USD (includes cached and cache creation tokens).                                                                                                                                                                                                                                                                                                                                                            |
+| `gen_ai.cost.output_tokens`                | `double`   | The total cost of all output tokens in USD (includes reasoning tokens).                                                                                                                                                                                                                                                                                                                                                                           |
+| `gen_ai.cost.reasoning.output_tokens`      | `double`   | The cost of reasoning output tokens in USD.                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `gen_ai.cost.total_tokens`                 | `double`   | The total cost for the tokens used.                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `gen_ai.embeddings.input`                  | `string`   | The input to the embeddings model.                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `gen_ai.function_id`                       | `string`   | Framework-specific tracing label for the execution of a function or other unit of execution in a generative AI system.                                                                                                                                                                                                                                                                                                                            |
+| `gen_ai.input.messages`                    | `string`   | The messages passed to the model. It has to be a stringified version of an array of objects. The `role` attribute of each object must be `"user"`, `"assistant"`, `"tool"`, or `"system"`. For messages of the role `"tool"`, the `content` can be a string or an arbitrary object with information about the tool call. For other messages the `content` can be either a string or a list of objects in the format `{type: "text", text:"..."}`. |
+| `gen_ai.operation.name`                    | `string`   | The name of the operation being performed. It has the following list of well-known values: ‘chat’, ‘create_agent’, ‘embeddings’, ‘execute_tool’, ‘generate_content’, ‘invoke_agent’, ‘text_completion’. If one of them applies, then that value MUST be used. Otherwise a custom value MAY be used.                                                                                                                                               |
+| `gen_ai.operation.type`                    | `string`   | The type of AI operation. Must be one of ‘agent’ (invoke_agent and create_agent spans), ‘ai_client’ (any LLM call), ‘tool’ (execute_tool spans), ‘handoff’ (handoff spans), ‘other’ (input and output processors, skill loading, guardrails etc.) . Added during ingestion based on span.op and gen_ai.operation.type. Used to filter and aggregate data in the UI                                                                                |
+| `gen_ai.output.messages`                   | `string`   | The model’s response messages. It has to be a stringified version of an array of message objects, which can include text responses and tool calls.                                                                                                                                                                                                                                                                                                |
+| `gen_ai.pipeline.name`                     | `string`   | Name of the AI pipeline or chain being executed.                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `gen_ai.prompt.name`                       | `string`   | The name of the prompt that uniquely identifies it.                                                                                                                                                                                                                                                                                                                                                                                               |
+| `gen_ai.provider.name`                     | `string`   | The Generative AI provider as identified by the client or server instrumentation.                                                                                                                                                                                                                                                                                                                                                                 |
+| `gen_ai.request.frequency_penalty`         | `double`   | Used to reduce repetitiveness of generated tokens. The higher the value, the stronger a penalty is applied to previously present tokens, proportional to how many times they have already appeared in the prompt or prior generation.                                                                                                                                                                                                             |
+| `gen_ai.request.max_tokens`                | `integer`  | The maximum number of tokens to generate in the response.                                                                                                                                                                                                                                                                                                                                                                                         |
+| `gen_ai.request.model`                     | `string`   | The model identifier being used for the request.                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `gen_ai.request.presence_penalty`          | `double`   | Used to reduce repetitiveness of generated tokens. Similar to frequency_penalty, except that this penalty is applied equally to all tokens that have already appeared, regardless of their exact frequencies.                                                                                                                                                                                                                                     |
+| `gen_ai.request.reasoning.level`           | `string`   | The reasoning or thinking effort level requested for a GenAI model.                                                                                                                                                                                                                                                                                                                                                                               |
+| `gen_ai.request.seed`                      | `string`   | The seed, ideally models given the same seed and same other parameters will produce the exact same output.                                                                                                                                                                                                                                                                                                                                        |
+| `gen_ai.request.stop_sequences`            | `string[]` | List of sequences that the model will use to stop generating further tokens.                                                                                                                                                                                                                                                                                                                                                                      |
+| `gen_ai.request.temperature`               | `double`   | For an AI model call, the temperature parameter. Temperature essentially means how random the output will be.                                                                                                                                                                                                                                                                                                                                     |
+| `gen_ai.request.top_k`                     | `integer`  | Limits the model to only consider the K most likely next tokens, where K is an integer (e.g., top_k=20 means only the 20 highest probability tokens are considered).                                                                                                                                                                                                                                                                              |
+| `gen_ai.request.top_p`                     | `double`   | Limits the model to only consider tokens whose cumulative probability mass adds up to p, where p is a float between 0 and 1 (e.g., top_p=0.7 means only tokens that sum up to 70% of the probability mass are considered).                                                                                                                                                                                                                        |
+| `gen_ai.response.finish_reasons`           | `string`   | The reason why the model stopped generating.                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `gen_ai.response.id`                       | `string`   | Unique identifier for the completion.                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `gen_ai.response.model`                    | `string`   | The vendor-specific ID of the model used.                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `gen_ai.response.streaming`                | `boolean`  | Whether or not the AI model call’s response was streamed back asynchronously                                                                                                                                                                                                                                                                                                                                                                      |
+| `gen_ai.response.time_to_first_chunk`      | `double`   | Time in seconds when the first response content chunk arrived in streaming responses.                                                                                                                                                                                                                                                                                                                                                             |
+| `gen_ai.response.tokens_per_second`        | `double`   | The total output tokens per seconds throughput                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `gen_ai.system_instructions`               | `string`   | The system instructions passed to the model.                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `gen_ai.tool.call.arguments`               | `string`   | The arguments of the tool call. It has to be a stringified version of the arguments to the tool.                                                                                                                                                                                                                                                                                                                                                  |
+| `gen_ai.tool.call.result`                  | `string`   | The result of the tool call. It has to be a stringified version of the result of the tool.                                                                                                                                                                                                                                                                                                                                                        |
+| `gen_ai.tool.definitions`                  | `string`   | The list of source system tool definitions available to the GenAI agent or model.                                                                                                                                                                                                                                                                                                                                                                 |
+| `gen_ai.tool.description`                  | `string`   | The description of the tool being used.                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `gen_ai.tool.name`                         | `string`   | Name of the tool utilized by the agent.                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `gen_ai.usage.cache_creation.input_tokens` | `integer`  | The number of tokens written to the cache when processing the AI input (prompt).                                                                                                                                                                                                                                                                                                                                                                  |
+| `gen_ai.usage.cache_read.input_tokens`     | `integer`  | The number of cached tokens used to process the AI input (prompt).                                                                                                                                                                                                                                                                                                                                                                                |
+| `gen_ai.usage.input_tokens`                | `integer`  | The number of tokens used to process the AI input (prompt) including cached input tokens.                                                                                                                                                                                                                                                                                                                                                         |
+| `gen_ai.usage.output_tokens`               | `integer`  | The number of tokens used for creating the AI output (including reasoning tokens).                                                                                                                                                                                                                                                                                                                                                                |
+| `gen_ai.usage.reasoning.output_tokens`     | `integer`  | The number of tokens used for reasoning to create the AI output.                                                                                                                                                                                                                                                                                                                                                                                  |
+| `gen_ai.usage.total_tokens`                | `integer`  | The total number of tokens used to process the prompt. (input tokens plus output todkens)                                                                                                                                                                                                                                                                                                                                                         |

package/skills/sentry/references/semantics/general.md

@@ -0,0 +1,11 @@
+# General attributes
+
+Uncategorized stable attributes that do not belong to a named domain.
+
+| Key                   | Type      | Brief                                                                       |
+| --------------------- | --------- | --------------------------------------------------------------------------- |
+| `blocked_main_thread` | `boolean` | Whether the main thread was blocked by the span.                            |
+| `channel`             | `string`  | The channel name that is being used.                                        |
+| `id`                  | `string`  | A unique identifier for the span.                                           |
+| `previous_route`      | `string`  | Also used by mobile SDKs to indicate the previous route in the application. |
+| `type`                | `string`  | More granular type of the operation happening.                              |

package/skills/sentry/references/semantics/graphql.md

@@ -0,0 +1,9 @@
+# GraphQL attributes
+
+GraphQL operation name, type, and document attributes.
+
+| Key                      | Type     | Brief                                     |
+| ------------------------ | -------- | ----------------------------------------- |
+| `graphql.document`       | `string` | The GraphQL document being executed.      |
+| `graphql.operation.name` | `string` | The name of the operation being executed. |
+| `graphql.operation.type` | `string` | The type of the operation being executed. |

package/skills/sentry/references/semantics/grpc.md

@@ -0,0 +1,19 @@
+# gRPC attributes
+
+gRPC method, status, and service attributes.
+
+| Key                                          | Type       | Brief                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| -------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `grpc.error.bad_request.field_violations`    | `string[]` | The individual field violations from a google.rpc.BadRequest error detail. Each entry is a JSON-encoded object with field, description, reason, and (optional) localized_message keys, mirroring google.rpc.BadRequest.FieldViolation.                                                                                                                                                                                                                                                   |
+| `grpc.error.debug_info.detail`               | `string`   | Additional debugging information, such as a server-side stack trace, from a google.rpc.DebugInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.                                                                                                                                                                                                                                                          |
+| `grpc.error.debug_info.stack_entries`        | `string[]` | The server-side stack trace entries from a google.rpc.DebugInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.                                                                                                                                                                                                                                                                                           |
+| `grpc.error.error_info.domain`               | `string`   | The logical grouping to which the gRPC error reason belongs, from the google.rpc.ErrorInfo error detail.                                                                                                                                                                                                                                                                                                                                                                                 |
+| `grpc.error.error_info.metadata.<key>`       | `string`   | Additional structured metadata attached to a google.rpc.ErrorInfo error detail, with <key> being the metadata key name. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.                                                                                                                                                                                                                                                 |
+| `grpc.error.error_info.reason`               | `string`   | The reason for the gRPC error, as defined by the service that generated it, from the google.rpc.ErrorInfo error detail.                                                                                                                                                                                                                                                                                                                                                                  |
+| `grpc.error.precondition_failure.violations` | `string[]` | The individual precondition violations from a google.rpc.PreconditionFailure error detail. Each entry is a JSON-encoded object with type, subject, and description keys. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly, since violation subjects may identify specific resources or users.                                                                                                                             |
+| `grpc.error.quota_failure.violations`        | `string[]` | The individual quota violations from a google.rpc.QuotaFailure error detail. Each entry is a JSON-encoded object with subject, description, api_service, quota_metric, quota_id, quota_dimensions, quota_value, and (optional) future_quota_value keys, mirroring google.rpc.QuotaFailure.Violation. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly, since violation subjects may identify specific resources or users. |
+| `grpc.error.resource_info.description`       | `string`   | A description of the error that occurred while accessing the resource, from a google.rpc.ResourceInfo error detail.                                                                                                                                                                                                                                                                                                                                                                      |
+| `grpc.error.resource_info.owner`             | `string`   | The owner of the resource being accessed (e.g. project or account owning it), from a google.rpc.ResourceInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.                                                                                                                                                                                                                                              |
+| `grpc.error.resource_info.resource_name`     | `string`   | The name of the resource being accessed, from a google.rpc.ResourceInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.                                                                                                                                                                                                                                                                                   |
+| `grpc.error.resource_info.resource_type`     | `string`   | The type of resource being accessed, from a google.rpc.ResourceInfo error detail.                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `grpc.error.retry_info.retry_delay_ms`       | `integer`  | How long the client should wait before retrying the gRPC call, in milliseconds, from the google.rpc.RetryInfo error detail.                                                                                                                                                                                                                                                                                                                                                              |

package/skills/sentry/references/semantics/http.md

@@ -0,0 +1,34 @@
+# HTTP attributes
+
+HTTP client and server attributes — method, route, status, timing, and headers.
+
+| Key                                    | Type       | Brief                                                                                                                                                                                                                                                                                                                     |
+| -------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `http.decoded_response_content_length` | `integer`  | The decoded body size of the response (in bytes).                                                                                                                                                                                                                                                                         |
+| `http.fragment`                        | `string`   | The fragments present in the URI. Note that this contains the leading # character, while the `url.fragment` attribute does not.                                                                                                                                                                                           |
+| `http.query`                           | `string`   | The query string present in the URL. Note that this contains the leading ? character, while the `url.query` attribute does not.                                                                                                                                                                                           |
+| `http.request.body.data`               | `string`   | HTTP request body data. Can be given as string or structural data of any format.                                                                                                                                                                                                                                          |
+| `http.request.connect_start`           | `double`   | The UNIX timestamp representing the time immediately before the user agent starts establishing the connection to the server to retrieve the resource.                                                                                                                                                                     |
+| `http.request.connection_end`          | `double`   | The UNIX timestamp representing the time immediately after the browser finishes establishing the connection to the server to retrieve the resource. The timestamp value includes the time interval to establish the transport connection, as well as other time intervals such as TLS handshake and SOCKS authentication. |
+| `http.request.domain_lookup_end`       | `double`   | The UNIX timestamp representing the time immediately after the browser finishes the domain-name lookup for the resource.                                                                                                                                                                                                  |
+| `http.request.domain_lookup_start`     | `double`   | The UNIX timestamp representing the time immediately before the browser starts the domain name lookup for the resource.                                                                                                                                                                                                   |
+| `http.request.fetch_start`             | `double`   | The UNIX timestamp representing the time immediately before the browser starts to fetch the resource.                                                                                                                                                                                                                     |
+| `http.request.header.<key>`            | `string[]` | HTTP request headers, <key> being the normalized HTTP Header name (lowercase), the value being the header values.                                                                                                                                                                                                         |
+| `http.request.method`                  | `string`   | The HTTP method used.                                                                                                                                                                                                                                                                                                     |
+| `http.request.redirect_end`            | `double`   | The UNIX timestamp representing the timestamp immediately after receiving the last byte of the response of the last redirect                                                                                                                                                                                              |
+| `http.request.redirect_start`          | `double`   | The UNIX timestamp representing the start time of the fetch which that initiates the redirect.                                                                                                                                                                                                                            |
+| `http.request.request_start`           | `double`   | The UNIX timestamp representing the time immediately before the browser starts requesting the resource from the server, cache, or local resource. If the transport connection fails and the browser retires the request, the value returned will be the start of the retry request.                                       |
+| `http.request.resend_count`            | `integer`  | The ordinal number of request resending attempt (for any reason, including redirects).                                                                                                                                                                                                                                    |
+| `http.request.response_end`            | `double`   | The UNIX timestamp representing the time immediately after the browser receives the last byte of the resource or immediately before the transport connection is closed, whichever comes first.                                                                                                                            |
+| `http.request.response_start`          | `double`   | The UNIX timestamp representing the time immediately before the browser starts requesting the resource from the server, cache, or local resource. If the transport connection fails and the browser retires the request, the value returned will be the start of the retry request.                                       |
+| `http.request.same_origin`             | `boolean`  | Indicates that a URL has the same origin as the current page’s origin in the browser.                                                                                                                                                                                                                                     |
+| `http.request.secure_connection_start` | `double`   | The UNIX timestamp representing the time immediately before the browser starts the handshake process to secure the current connection. If a secure connection is not used, the property returns zero.                                                                                                                     |
+| `http.request.time_to_first_byte`      | `double`   | The time in seconds from the browser’s timeorigin to when the first byte of the request’s response was received. See https://web.dev/articles/ttfb#measure-resource-requests                                                                                                                                              |
+| `http.request.worker_start`            | `double`   | The UNIX timestamp representing the timestamp immediately before dispatching the FetchEvent if a Service Worker thread is already running, or immediately before starting the Service Worker thread if it is not already running.                                                                                         |
+| `http.response.body.size`              | `integer`  | The encoded body size of the response (in bytes).                                                                                                                                                                                                                                                                         |
+| `http.response.header.<key>`           | `string[]` | HTTP response headers, <key> being the normalized HTTP Header name (lowercase), the value being the header values.                                                                                                                                                                                                        |
+| `http.response.header.content-length`  | `string`   | The size of the message body sent to the recipient (in bytes)                                                                                                                                                                                                                                                             |
+| `http.response.size`                   | `integer`  | The transfer size of the response (in bytes).                                                                                                                                                                                                                                                                             |
+| `http.response.status_code`            | `integer`  | The status code of the HTTP response.                                                                                                                                                                                                                                                                                     |
+| `http.route`                           | `string`   | The matched route, that is, the path template in the format used by the respective server framework.                                                                                                                                                                                                                      |
+| `http.server.request.time_in_queue`    | `double`   | The time in milliseconds the request spent in the server queue before processing began. Measured from the X-Request-Start header set by reverse proxies (e.g., Nginx, HAProxy, Heroku) to when the application started handling the request.                                                                              |

package/skills/sentry/references/semantics/index.md

@@ -0,0 +1,63 @@
+# Semantic conventions
+
+Read only the domain whose attributes you are adding. Use these supported keys
+in preference to inventing a second vocabulary.
+
+- [angular](angular.md)
+- [app](app.md)
+- [art](art.md)
+- [aws](aws.md)
+- [browser](browser.md)
+- [cache](cache.md)
+- [client](client.md)
+- [cloud](cloud.md)
+- [cloudflare](cloudflare.md)
+- [code](code.md)
+- [culture](culture.md)
+- [db](db.md)
+- [device](device.md)
+- [error](error.md)
+- [event](event.md)
+- [exception](exception.md)
+- [faas](faas.md)
+- [file](file.md)
+- [flag](flag.md)
+- [gcp](gcp.md)
+- [gen_ai](gen_ai.md)
+- [general](general.md)
+- [graphql](graphql.md)
+- [grpc](grpc.md)
+- [http](http.md)
+- [jsonrpc](jsonrpc.md)
+- [jvm](jvm.md)
+- [koa](koa.md)
+- [logger](logger.md)
+- [mcp](mcp.md)
+- [mdc](mdc.md)
+- [messaging](messaging.md)
+- [middleware](middleware.md)
+- [navigation](navigation.md)
+- [nel](nel.md)
+- [network](network.md)
+- [os](os.md)
+- [otel](otel.md)
+- [params](params.md)
+- [process](process.md)
+- [react](react.md)
+- [remix](remix.md)
+- [resource](resource.md)
+- [rpc](rpc.md)
+- [score](score.md)
+- [sentry](sentry.md)
+- [server](server.md)
+- [service](service.md)
+- [session](session.md)
+- [state](state.md)
+- [thread](thread.md)
+- [timber](timber.md)
+- [trpc](trpc.md)
+- [ui](ui.md)
+- [url](url.md)
+- [user](user.md)
+- [user_agent](user_agent.md)
+- [vercel](vercel.md)

package/skills/sentry/references/semantics/jsonrpc.md

@@ -0,0 +1,8 @@
+# JSON-RPC attributes
+
+JSON-RPC method and request identity attributes.
+
+| Key                        | Type     | Brief                                                       |
+| -------------------------- | -------- | ----------------------------------------------------------- |
+| `jsonrpc.protocol.version` | `string` | The version of the JSON-RPC protocol used.                  |
+| `jsonrpc.request.id`       | `string` | The JSON-RPC request identifier. Unique within the session. |

package/skills/sentry/references/semantics/jvm.md

@@ -0,0 +1,12 @@
+# JVM attributes
+
+JVM runtime and memory attributes.
+
+| Key                    | Type      | Brief                                 |
+| ---------------------- | --------- | ------------------------------------- |
+| `jvm.gc.action`        | `string`  | Name of the garbage collector action. |
+| `jvm.gc.name`          | `string`  | Name of the garbage collector.        |
+| `jvm.memory.pool.name` | `string`  | Name of the memory pool.              |
+| `jvm.memory.type`      | `string`  | Name of the memory pool.              |
+| `jvm.thread.daemon`    | `boolean` | Whether the thread is daemon or not.  |
+| `jvm.thread.state`     | `string`  | State of the thread.                  |

package/skills/sentry/references/semantics/koa.md

@@ -0,0 +1,7 @@
+# Koa attributes
+
+Koa framework middleware and request attributes.
+
+| Key        | Type     | Brief                                               |
+| ---------- | -------- | --------------------------------------------------- |
+| `koa.type` | `string` | The type of the Koa layer that handled the request. |

package/skills/sentry/references/semantics/logger.md

@@ -0,0 +1,7 @@
+# Logger attributes
+
+Logger name and logging-context attributes.
+
+| Key           | Type     | Brief                                             |
+| ------------- | -------- | ------------------------------------------------- |
+| `logger.name` | `string` | The name of the logger that generated this event. |

package/skills/sentry/references/semantics/mcp.md

@@ -0,0 +1,37 @@
+# MCP attributes
+
+Model Context Protocol attributes for MCP client/server spans.
+
+| Key                                 | Type      | Brief                                                                                                                                                                    |
+| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `mcp.cancelled.reason`              | `string`  | Reason for the cancellation of an MCP operation.                                                                                                                         |
+| `mcp.cancelled.request_id`          | `string`  | Request ID of the cancelled MCP operation.                                                                                                                               |
+| `mcp.client.name`                   | `string`  | Name of the MCP client application.                                                                                                                                      |
+| `mcp.client.title`                  | `string`  | Display title of the MCP client application.                                                                                                                             |
+| `mcp.client.version`                | `string`  | Version of the MCP client application.                                                                                                                                   |
+| `mcp.lifecycle.phase`               | `string`  | Lifecycle phase indicator for MCP operations.                                                                                                                            |
+| `mcp.logging.data_type`             | `string`  | Data type of the logged message content.                                                                                                                                 |
+| `mcp.logging.level`                 | `string`  | Log level for MCP logging operations.                                                                                                                                    |
+| `mcp.logging.logger`                | `string`  | Logger name for MCP logging operations.                                                                                                                                  |
+| `mcp.logging.message`               | `string`  | Log message content from MCP logging operations.                                                                                                                         |
+| `mcp.method.name`                   | `string`  | The name of the MCP request or notification method being called.                                                                                                         |
+| `mcp.progress.current`              | `integer` | Current progress value of an MCP operation.                                                                                                                              |
+| `mcp.progress.message`              | `string`  | Progress message describing the current state of an MCP operation.                                                                                                       |
+| `mcp.progress.percentage`           | `double`  | Calculated progress percentage of an MCP operation. Computed from current/total * 100.                                                                                   |
+| `mcp.progress.token`                | `string`  | Token for tracking progress of an MCP operation.                                                                                                                         |
+| `mcp.progress.total`                | `integer` | Total progress target value of an MCP operation.                                                                                                                         |
+| `mcp.prompt.result.description`     | `string`  | Description of the prompt result.                                                                                                                                        |
+| `mcp.prompt.result.message_content` | `string`  | Content of the message in the prompt result. Used for single message results only.                                                                                       |
+| `mcp.prompt.result.message_count`   | `integer` | Number of messages in the prompt result.                                                                                                                                 |
+| `mcp.prompt.result.message_role`    | `string`  | Role of the message in the prompt result. Used for single message results only.                                                                                          |
+| `mcp.protocol.ready`                | `integer` | Protocol readiness indicator for MCP session. Non-zero value indicates the protocol is ready.                                                                            |
+| `mcp.protocol.version`              | `string`  | MCP protocol version used in the session.                                                                                                                                |
+| `mcp.request.argument.<key>`        | `string`  | MCP request argument with dynamic key suffix. The <key> is replaced with the actual argument name. The value is a JSON-stringified representation of the argument value. |
+| `mcp.request.argument.name`         | `string`  | Name argument from prompts/get MCP request.                                                                                                                              |
+| `mcp.request.argument.uri`          | `string`  | URI argument from resources/read MCP request.                                                                                                                            |
+| `mcp.resource.uri`                  | `string`  | The resource URI being accessed in an MCP operation.                                                                                                                     |
+| `mcp.server.name`                   | `string`  | Name of the MCP server application.                                                                                                                                      |
+| `mcp.server.title`                  | `string`  | Display title of the MCP server application.                                                                                                                             |
+| `mcp.server.version`                | `string`  | Version of the MCP server application.                                                                                                                                   |
+| `mcp.session.id`                    | `string`  | Identifier for the MCP session.                                                                                                                                          |
+| `mcp.tool.result.content_count`     | `integer` | Number of content items in the tool result.                                                                                                                              |

package/skills/sentry/references/semantics/mdc.md

@@ -0,0 +1,7 @@
+# MDC attributes
+
+Mapped diagnostic context (MDC) attributes from logging frameworks.
+
+| Key         | Type     | Brief                                                                                                                                                                                                                                                                                           |
+| ----------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mdc.<key>` | `string` | Attributes from the Mapped Diagnostic Context (MDC) present at the moment the log record was created. The MDC is supported by all the most popular logging solutions in the Java ecosystem, and it’s usually implemented as a thread-local map that stores context for e.g. a specific request. |