@grepr/cli 1.11.5-a7cb911 → 1.11.5-bcb5435

package/build/dist/docs-index/03d9655c-9ab2-45f0-a79f-f946387ebf82.txt

@@ -0,0 +1,14 @@
+# AgentPipelineSubscription
+
+**Type**: `object`
+
+## Properties
+
+- name: jobId (required)
+  type: string
+
+- name: pausedAt (optional)
+  type: string
+
+- name: subscribedAt (required)
+  type: string

package/build/dist/docs-index/{2804c552-ecce-4132-b74c-b504e259e28b.txt → 076ff7de-6b62-4e07-9a3a-b19df3cd8238.txt}

@@ -19,6 +19,9 @@
 - name: payload (required)
   type: `AgentConfigPayload`
 
+- name: state (optional)
+  type: enum: `ACTIVE`, `PAUSED`, `DELETED`
+
 - name: updatedAt (required)
   type: string
 

package/build/dist/docs-index/{30ccdd68-c475-48db-a81f-1398a9eadcd7.txt → 12976ae6-d4bd-415e-9ac5-b29bc4621166.txt}

@@ -26,6 +26,10 @@ The payload containing integration data.
   type: string
   description: Client token for Datadog
 
+- name: dashboardFreshnessWindow (optional)
+  type: string
+  description: The active dashboard threshold: only dashboards viewed within it are imported as parsed queries. When unset, every dashboard is imported. Minimum one day.
+
 - name: exceptions (optional)
   type: object
   description: The imported exceptions from Datadog. This is a map from the vendor resource Id to the exception.
@@ -34,6 +38,10 @@ The payload containing integration data.
   type: string
   description: Filter to apply when reading any data from the Datadog API
 
+- name: includeNeverViewedDashboards (optional)
+  type: boolean
+  description: When the active dashboard threshold is set, whether dashboards that were never viewed are still imported. Unset means they are.
+
 - name: sendKeyId (optional)
   type: string
   description: Identifier of the API key used to send data back to Datadog. Defaults to the only key when unset.

package/build/dist/docs-index/{d677a3ba-6a77-49bb-8798-10aeb97785ac.txt → 15a02442-477c-42e5-ae65-c8dd29218811.txt}

@@ -60,6 +60,15 @@ Grepr parses structured logs into an attribute document. Address a single attrib
 
 The shorthand reads one value out of the parsed document. The `attributes` column is the whole document, so use `@` when you want a field and `attributes` when you want the object itself.
 
+An attribute name is a dotted path of letters, digits, and underscores. A hyphen or a slash can join characters inside a segment, so `@trace-id` and `@app.kubernetes.io/name` are each one name. Because `-` and `/` are name characters, put whitespace around them when you mean subtraction or division: write `@bytes / 1024`, not `@bytes/1024` (which reads `bytes/1024` as one name). Every other character ends the name, so `@status=500` and `@duration_ms*2` work without spaces.
+
+To read a key that uses any other character, such as a space, comma, or bracket, reference it through the `attributes` column with a single-quoted key in brackets. The bracketed key can be any string, dots included, and names exactly one key; double a single quote to include one. Add one bracketed key per level of a nested path:
+
+```sql
+attributes['service.status']
+attributes['special outer key']['special inner key']
+```
+
 An attribute has no declared type, because two logs in the same dataset can carry different types under the same name. Grepr infers a type from how you use the value, so `SUM(@duration_ms)` reads it as a number and `LOWER(@user.email)` reads it as a string.
 
 Cast the attribute when you need a specific type or precision, and when you sort:

package/build/dist/docs-index/{ba1f67e7-b6c6-4347-bb0d-6f9ee1b78711.txt → 40d1ea5e-c590-4a1d-b332-bd8d75a07f7a.txt}

@@ -26,7 +26,7 @@ The log reducer divides incoming log events into fixed-duration, tumbling window
 If the reducer cannot find a matching pattern for a message, the message passes through unmodified. Reasons that the reducer cannot find a pattern include:
 
 * The clustering process is unable to extract patterns from messages.
-* The log message field is empty or null.
+* The selected inputs contain neither message tokens nor attribute structure to group by. See [Choose which fields form a pattern](/transforms/reducer/configuration#structured-configuration).
 * The message matches a configured exception rule that prevents it from being reduced.
 
 To learn more about the transformations the reducer applies to messages and how to modify its default behavior, see [Configure the log reducer in a Grepr pipeline](/transforms/reducer/configuration).

package/build/dist/docs-index/48835412-5e0a-4ed2-b75a-48e907f19ec7.txt

@@ -0,0 +1,18 @@
+# ExceptionUsageResponse
+
+Usage the vendor reports for an integration's parsed queries
+
+**Type**: `object`
+
+## Properties
+
+- name: reportedTypes (required)
+  type: array of string
+  description: The parsed query exception types (values of a parsed query's exceptionType) the vendor reports usage for. Empty when the vendor reports none; a query of any other type has no usage to show.
+
+- name: status (required)
+  type: `UsageStatus`
+
+- name: usage (required)
+  type: object
+  description: Usage keyed by composite exception id (integrationId:vendorResourceId:exceptionType), the key the impacts endpoint uses. A query the vendor reported nothing for is absent, which is not the same as never viewed.

package/build/dist/docs-index/5fdaecc1-260c-4441-a973-5095ee181fef.txt

@@ -0,0 +1,38 @@
+# Pause or resume an agent
+
+**PUT** `/v1/agents/{id}/state`
+
+**Operation ID**: `setState`
+**Summary**: Pause or resume an agent
+Sets the agent to PAUSED or ACTIVE. A paused agent runs no investigations: signals from every source are dropped, manual starts and resumes are refused, and queued investigations wait until the agent is resumed. Pipelines keep marking new patterns as sent, so after resuming, the agent usually reacts only to patterns that are new since then.
+
+## Tags
+- Agents
+## Parameters
+
+- **id** (required) - path
+  - Type: string
+
+## Request Body
+
+**Content-Type**: `application/json`
+
+**Schema**: `StateChangeRequest`
+
+## Responses
+
+### 204
+
+State set (or already set)
+
+### 400
+
+The state is not ACTIVE or PAUSED
+
+### 401
+
+Unauthorized
+
+### 404
+
+Agent not found

package/build/dist/docs-index/686432ed-2ca3-4eef-a0cd-47639d129828.txt

@@ -0,0 +1,15 @@
+# ExceptionUsage
+
+Usage the vendor reports for the source of one parsed query
+
+**Type**: `object`
+
+## Properties
+
+- name: lastViewedAt (optional)
+  type: string
+  description: When the source was last viewed. Null means the vendor reports it was never viewed.
+
+- name: totalViews (optional)
+  type: integer
+  description: How many times the source was viewed, as the vendor counts them. Datadog counts views since January 2025 and refreshes the count daily.

package/build/dist/docs-index/{95d6d604-bd71-42b3-a719-aee71fdcaa4c.txt → 68c6979e-2ec6-46c9-a9fc-aa5d289b34e2.txt}

@@ -4,7 +4,7 @@
 
 **Operation ID**: `subscriptions`
 **Summary**: List an agent's subscriptions
-Returns the pipeline ids the agent is subscribed to.
+Returns the agent's pipeline subscriptions, including when each was paused.
 
 ## Tags
 - Agents
@@ -19,7 +19,7 @@ Returns the pipeline ids the agent is subscribed to.
 
 Subscriptions retrieved successfully
 
-- **Content-Type**: `application/json` / array of string
+- **Content-Type**: `application/json` / array of `AgentPipelineSubscription`
 ### 401
 
 Unauthorized

package/build/dist/docs-index/{377b490c-13c0-46a8-bc90-f0a1f5dffad0.txt → 78f825e9-2509-4f35-bdc9-0fa3433e346d.txt}

@@ -37,6 +37,15 @@ You cannot change an integration's type after you create it. To move to a differ
 
 Select the tab for your provider to see the fields it requires:
 
+| Field | Description |
+| --- | --- |
+| **Name** | A name for the integration, used to identify it when you configure an agent. |
+| **API Key** | Your Anthropic API key. |
+| **Max tokens per window** | The total tokens that all agents using this integration can consume in each window. Leave empty for the default of 20,000,000. |
+| **Max tokens window (hours)** | The length of the budget window. Leave empty for the default of 1 hour. |
+
+An Anthropic integration serves as an agent's model. Anthropic does not supply embeddings, so an agent with memory turned on also needs a Gemini or OpenAI integration for its embedding model.
+
 | Field | Description |
 | --- | --- |
 | **Name** | A name for the integration, used to identify it when you configure an agent. |

package/build/dist/docs-index/907d6720-7730-4965-8a9f-1e3867ed1943.txt

@@ -0,0 +1,40 @@
+# Pause or resume an agent's pipeline subscription
+
+**PUT** `/v1/agents/{id}/pipelines/{jobId}/state`
+
+**Operation ID**: `setPipelineState`
+**Summary**: Pause or resume an agent's pipeline subscription
+Sets one subscription to PAUSED or ACTIVE. While paused, new signals from the pipeline are dropped for this agent, and the pipeline keeps marking new patterns as sent. Investigations already queued still run. The running pipeline is not restarted.
+
+## Tags
+- Agents
+## Parameters
+
+- **id** (required) - path
+  - Type: string
+- **jobId** (required) - path
+  - Type: string
+
+## Request Body
+
+**Content-Type**: `application/json`
+
+**Schema**: `StateChangeRequest`
+
+## Responses
+
+### 204
+
+State set (or already set)
+
+### 400
+
+The state is not ACTIVE or PAUSED
+
+### 401
+
+Unauthorized
+
+### 404
+
+Agent not found, or not subscribed to the pipeline

package/build/dist/docs-index/a4ce8ef8-b1e7-4d0d-aaee-c20d68feb9d2.txt

@@ -0,0 +1,19 @@
+# UsageStatus
+
+The outcome of the last attempt to read the integration's usage
+
+**Type**: `object`
+
+## Properties
+
+- name: collectedAt (optional)
+  type: string
+  description: When usage was last read successfully. The usage returned is as of this time; absent when it was never read.
+
+- name: detail (optional)
+  type: string
+  description: Why the last attempt failed, in words fit to show. Absent when it worked.
+
+- name: state (required)
+  type: enum: `OK`, `PENDING`, `PERMISSION_DENIED`, `NO_VIEWS`, `ERROR`
+  description: Whether the usage of the integration's parsed queries could be read