@grepr/cli 1.8.9-f3f8d18 → 1.8.11-df72e67

package/build/dist/docs-index/{33e62aa2-c52d-4133-b035-4809b7e3e5b0.txt → 03952c33-2ffa-4d35-93c6-ed1b149abbd0.txt}

@@ -2,7 +2,7 @@
 
 **POST** `/v1/integrations/sumo`
 
-**Operation ID**: `create_16`
+**Operation ID**: `create_15`
 **Summary**: Create a SumoLogic integration
 Creates an integration to connect to SumoLogic.
 

package/build/dist/docs-index/{eebbeb5f-7a9b-4ecb-afa5-354d8d43b6e5.txt → 0437f1b1-4e75-4929-a0ae-77f3ce94c374.txt}

@@ -10,7 +10,7 @@
 
 - name: emitNewPatternSignals (optional)
   type: boolean
-  description: Whether this operation emits LogPatternSignal events to the agent-service when new patterns are detected or replayed.
+  description: Whether this operation may emit LogPatternSignal events to the agent-service when new patterns are detected or replayed. Must be enabled before an agent can subscribe to this pipeline.
 
 - name: enabledMasks (required)
   type: array of string

package/build/dist/docs-index/{c902dc50-6970-4815-b8dc-aaf1aadcbea4.txt → 0df195d3-d818-45a9-963f-1dec5db362e1.txt}

@@ -21,7 +21,7 @@
 
 - name: emitNewPatternSignals (optional)
   type: boolean
-  description: Whether this operation emits LogPatternSignal events to the agent-service when new patterns are detected or replayed.
+  description: Whether this operation may emit LogPatternSignal events to the agent-service when new patterns are detected or replayed. Must be enabled before an agent can subscribe to this pipeline.
 
 - name: enabledMasks (required)
   type: array of string

package/build/dist/docs-index/{4ea1aae9-d4d7-42b7-bc1f-5a7f2d9e1b91.txt → 1b5f1342-f7a7-47c7-ac1f-1a5388a8c61e.txt}

@@ -4,7 +4,7 @@
 
 **Operation ID**: `subscriptions`
 **Summary**: List an agent's subscriptions
-Returns the pipeline ids the agent is subscribed to via its signal integration.
+Returns the pipeline ids the agent is subscribed to.
 
 ## Tags
 - Agents

package/build/dist/docs-index/32dab64b-6d37-4d62-a776-2e9f04303223.txt

@@ -0,0 +1,30 @@
+# Create a logs backfill job
+
+**POST** `/v1/jobs/backfills`
+
+**Operation ID**: `submitBackfillJob`
+**Summary**: Create a logs backfill job
+Creates a logs backfill batch job from backfill parameters (time window, query, vendor sinks, and optional limit, variables, and tags). This is an asynchronous batch job: the response returns an identifier (field: `id`) that can be used to query the status of the job using the `GET` jobs endpoint. The server builds the backfill job graph from the parameters, so callers do not assemble it themselves.
+
+## Tags
+- Jobs
+## Request Body
+
+**Content-Type**: `application/json`
+
+**Schema**: `CreateBackfillJob`
+
+## Responses
+
+### 201
+
+Backfill job submitted successfully
+
+- **Content-Type**: `application/json` / `ReadJob`
+### 400
+
+Bad Request
+
+### 401
+
+Unauthorized

package/build/dist/{openapi-docs/api/S3-Vector-Index-Integration/delete_14.md → docs-index/37ea86a1-1cac-4910-9c22-6c30c24fc179.txt}

@@ -2,7 +2,7 @@
 
 **DELETE** `/v1/integrations/s3-vector-index/{id}`
 
-**Operation ID**: `delete_14`
+**Operation ID**: `delete_13`
 **Summary**: Delete an S3 Vector Index integration
 Deletes an S3 Vector Index integration and removes the index from the S3 vector bucket. No-op if integration doesn't exist.
 

package/build/dist/docs-index/3b294939-cedb-4b8e-89f4-3a5c6f93431e.txt

@@ -0,0 +1,38 @@
+# Subscribe an agent to a pipeline
+
+**POST** `/v1/agents/{id}/pipelines/{jobId}`
+
+**Operation ID**: `subscribe`
+**Summary**: Subscribe an agent to a pipeline
+Subscribes the agent to the pipeline's pattern signals. Requires the pipeline to have new-pattern signal emission enabled on its reducer or pattern matcher. The running pipeline picks up the subscriber automatically, without a restart.
+
+## Tags
+- Agents
+## Parameters
+
+- **id** (required) - path
+  - Type: string
+- **jobId** (required) - path
+  - Type: string
+
+## Responses
+
+### 204
+
+Subscription created (or already present)
+
+### 400
+
+The pipeline has no reducer or pattern matcher, so it can never emit
+
+### 401
+
+Unauthorized
+
+### 404
+
+Agent or pipeline not found
+
+### 409
+
+The pipeline is not enabled to emit pattern signals

package/build/dist/docs-index/{be659c78-96e5-45a9-a93e-9acb465cbcf7.txt → 3c6768df-cb4a-4877-8684-c7ebaffade0c.txt}

@@ -2,7 +2,7 @@
 
 **GET** `/v1/integrations/splunk`
 
-**Operation ID**: `list_15`
+**Operation ID**: `list_14`
 **Summary**: List all Splunk integrations
 Get all Splunk integrations for your organization. This will contain masked keys if present.
 

package/build/dist/docs-index/519708e2-ae68-4567-ae33-8aa9551a507a.txt

@@ -0,0 +1,42 @@
+# LogsBackfillTemplateInput
+
+Schema for the logs backfill job graph.
+
+**Type**: `object`
+
+## Properties
+
+- name: backfillTimestampTag (required)
+  type: string
+  description: ISO-8601 value stamped onto backfilled events as the grepr.backfilled.timestamp tag. Computed by the builder so the template stays free of time logic.
+
+- name: datasetId (required)
+  type: string
+  description: The dataset the backfill reads from and the dedup sinks track delivery in.
+
+- name: end (required)
+  type: string
+  description: End of the time interval to backfill.
+
+- name: limit (required)
+  type: integer
+  description: The maximum number of rows to backfill. A negative value means no limit.
+
+- name: query (required)
+  type: `EventPredicate`
+
+- name: sinks (required)
+  type: array of `Operation`
+  description: The vendor sink operations to deliver the backfilled events to.
+
+- name: start (required)
+  type: string
+  description: Start of the time interval to backfill.
+
+- name: variables (optional)
+  type: object
+  description: Variables used to modify the query while it is parsed.
+
+- name: vendorSinkIntegrationIds (optional)
+  type: array of string
+  description: Vendor integration IDs, if any, whose prior delivery the backfill source skips. Empty when the source does no per-vendor dedup join (e.g. trace backfills).

package/build/dist/docs-index/{e8bf1f85-f0bc-4da3-9a64-d34e11d89c9f.txt → 55a946a0-cd07-451f-984a-9d1dad19dddf.txt}

@@ -2,7 +2,7 @@
 
 **GET** `/v1/integrations/webhooks`
 
-**Operation ID**: `list_17`
+**Operation ID**: `list_16`
 **Summary**: List webhook integrations
 Get all webhook integrations for your organization, optionally filtered to integrations that target the given agent.
 

package/build/dist/{openapi-docs/api/Webhook-Integration/create_17.md → docs-index/5b1ec976-c897-43f2-a92b-63461187e5f2.txt}

@@ -2,7 +2,7 @@
 
 **POST** `/v1/integrations/webhooks`
 
-**Operation ID**: `create_17`
+**Operation ID**: `create_16`
 **Summary**: Create a webhook integration
 Creates a webhook integration. Senders POST events to /v1/integrations/webhooks/{id}/events and authenticate with a Grepr API key (GREPR-API-KEY header).
 

package/build/dist/{openapi-docs/api/Sumo-Logic-Integration/list_16.md → docs-index/5ddf6af0-759b-4d10-9196-a4358792f0c8.txt}

@@ -2,7 +2,7 @@
 
 **GET** `/v1/integrations/sumo`
 
-**Operation ID**: `list_16`
+**Operation ID**: `list_15`
 **Summary**: List all SumoLogic integrations
 Get all SumoLogic integrations.
 

package/build/dist/{openapi-docs/api/Splunk-Integration/delete_15.md → docs-index/6d73e2ff-9def-45a4-a847-e7a2c42569ac.txt}

@@ -2,7 +2,7 @@
 
 **DELETE** `/v1/integrations/splunk/{id}`
 
-**Operation ID**: `delete_15`
+**Operation ID**: `delete_14`
 **Summary**: Delete a Splunk integration
 Deletes an integration to connect to Splunk. This will delete the associated keys as well. No-op if already deleted.
 

package/build/dist/docs-index/70af7fca-82c7-4721-8b54-8aed1a1a19d8.txt

@@ -0,0 +1,30 @@
+# Unsubscribe an agent from a pipeline
+
+**DELETE** `/v1/agents/{id}/pipelines/{jobId}`
+
+**Operation ID**: `unsubscribe`
+**Summary**: Unsubscribe an agent from a pipeline
+Unsubscribes the agent from the pipeline's pattern signals. The running pipeline drops the subscriber automatically, without a restart.
+
+## Tags
+- Agents
+## Parameters
+
+- **id** (required) - path
+  - Type: string
+- **jobId** (required) - path
+  - Type: string
+
+## Responses
+
+### 204
+
+Subscription removed (or was not present)
+
+### 401
+
+Unauthorized
+
+### 404
+
+Agent not found

package/build/dist/docs-index/{d09edca5-fcce-4529-8379-532fb6cabb89.txt → 8475d358-d8a7-466e-adf5-c7b3fee39500.txt}

@@ -4,7 +4,7 @@
 
 **Operation ID**: `delete`
 **Summary**: Delete an agent
-Soft-deletes an agent. Returns 409 if the agent still has a signal integration; delete that first.
+Soft-deletes an agent. Returns 409 while the agent is still subscribed to any pipeline; unsubscribe it first.
 
 ## Tags
 - Agents
@@ -25,4 +25,4 @@ Unauthorized
 
 ### 409
 
-Agent still has a signal integration
+Agent is still subscribed to one or more pipelines

package/build/dist/docs-index/a4958c8b-1548-401c-84eb-1e7e9b71acdd.txt

@@ -0,0 +1,46 @@
+# CreateBackfillJob
+
+Parameters for creating a logs backfill batch job.
+
+**Type**: `object`
+
+## Properties
+
+- name: datasetId (required)
+  type: string
+  description: The dataset the backfill reads from and the dedup sinks track delivery in.
+
+- name: end (required)
+  type: string
+  description: End of the time interval to backfill.
+
+- name: limit (optional)
+  type: integer
+  description: Maximum number of rows to backfill. Default and max is 500,000. A negative value means no limit.
+
+- name: name (required)
+  type: string
+  description: Name of the backfill job. Must match the job name pattern [a-z0-9_]{1,128}.
+
+- name: query (required)
+  type: `EventPredicate`
+
+- name: sinks (required)
+  type: array of `Operation`
+  description: The vendor sink operations that deliver the backfilled events. Passed through verbatim, matching the sinks a rule action would carry.
+
+- name: start (required)
+  type: string
+  description: Start of the time interval to backfill, inclusive.
+
+- name: tags (optional)
+  type: object
+  description: Custom tags added to the backfill job for ease of search.
+
+- name: variables (optional)
+  type: object
+  description: Variables used to modify the query while it is parsed.
+
+- name: vendorSinkIntegrationIds (optional)
+  type: array of string
+  description: Vendor integration IDs, if any, whose prior delivery the backfill skips. Also gates concurrent overlapping backfills. Empty (the default) does no per-vendor dedup join and never blocks on other backfills.

package/build/dist/{openapi-docs/api/Webhook-Integration/delete_17.md → docs-index/a7d6eb91-c361-4a94-bc83-5a130ca06dd6.txt}

@@ -2,7 +2,7 @@
 
 **DELETE** `/v1/integrations/webhooks/{id}`
 
-**Operation ID**: `delete_17`
+**Operation ID**: `delete_16`
 **Summary**: Delete a webhook integration
 Deletes a webhook integration. No-op if already deleted.
 

package/build/dist/docs-index/{42887e49-e59a-41b8-9d88-6a1be9faf044.txt → c0a47ef0-f2ca-4b67-a69f-4e2e6f98a2ce.txt}

@@ -2,7 +2,7 @@
 
 **POST** `/v1/integrations/splunk`
 
-**Operation ID**: `create_15`
+**Operation ID**: `create_14`
 **Summary**: Create a Splunk integration
 Creates an integration to connect to Splunk.
 

package/build/dist/docs-index/{feff2fdf-1d47-4d5b-bf0f-caef025a1fe0.txt → c3925ac4-fb7c-4a7b-9032-800d09736184.txt}

@@ -7,7 +7,7 @@ The payload containing integration data.
 ## Properties
 
 - name: agentSubscriptions (required)
-  type: array of `AgentSignalSubscription`
+  type: array of `WebhookAgentSubscription`
 
 - name: schemaDescription (required)
   type: string

package/build/dist/{openapi-docs/schemas/JobSignal.md → docs-index/c8483b33-b85d-4ad8-a5ba-05354ef4fbe7.txt}

@@ -1,6 +1,4 @@
-# JobSignal
-
-The payload containing integration data.
+# WebhookAgentSubscription
 
 **Type**: `object`