@grepr/cli 1.10.8-fff9f89 → 1.11.0-9706f11

package/build/dist/commands/agent-command.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from 'commander';
+import type { ICommand } from '../lib/command-registry.js';
+import type { MergeConfiguration } from '../types.js';
+export declare class AgentCommand implements ICommand {
+    addToProgram(program: Command, merge: MergeConfiguration): void;
+}
+//# sourceMappingURL=agent-command.d.ts.map

package/build/dist/commands/agent-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-command.d.ts","sourceRoot":"","sources":["../../../src/main/typescript/commands/agent-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,qBAAa,YAAa,YAAW,QAAQ;IAC3C,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;CAqBhE"}

package/build/dist/commands/agent-command.js

@@ -0,0 +1,27 @@
+import { createApiClient } from '../lib/api-client-factory.js';
+import { readAction, readCommand, writeReadOutput } from '../lib/investigation-output.js';
+export class AgentCommand {
+    addToProgram(program, merge) {
+        const list = readCommand(program, 'agent:list', 'List agent IDs and names in the organization', 'table')
+            .option('--details', 'Include current configuration, recent health and subscription counts');
+        readAction(list, merge, async (global) => {
+            const options = { ...global, ...list.opts() };
+            const client = createApiClient(options);
+            if (options.details) {
+                const agents = await client.listAgents();
+                await writeReadOutput(agents, options, agents.map(entry => ({ id: entry.agent?.id,
+                    name: entry.agent?.name, recentHealth: entry.recentHealth, subscriptionCounts: entry.subscriptionCounts })));
+            }
+            else {
+                const agents = await client.listAgentRoster();
+                await writeReadOutput(agents, options, agents);
+            }
+        });
+        const get = readCommand(program, 'agent:get <agent-id>', 'Get current agent configuration and aggregate investigation metrics');
+        readAction(get, merge, async (global) => {
+            const options = { ...global, ...get.opts() };
+            await writeReadOutput(await createApiClient(options).getAgent(get.args[0] ?? ''), options);
+        });
+    }
+}
+//# sourceMappingURL=agent-command.js.map

package/build/dist/commands/agent-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-command.js","sourceRoot":"","sources":["../../../src/main/typescript/commands/agent-command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAA0B,MAAM,gCAAgC,CAAC;AAElH,MAAM,OAAO,YAAY;IACvB,YAAY,CAAC,OAAgB,EAAE,KAAyB;QACtD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,8CAA8C,EAAE,OAAO,CAAC;aACrG,MAAM,CAAC,WAAW,EAAE,sEAAsE,CAAC,CAAC;QAC/F,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;YACrC,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAA6C,EAAE,CAAC;YACzF,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;gBACzC,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE;oBAC/E,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC;YACjH,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC9C,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,EAAE,sBAAsB,EAAE,qEAAqE,CAAC,CAAC;QAChI,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;YACpC,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAqB,EAAE,CAAC;YAChE,MAAM,eAAe,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7F,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/build/dist/commands/investigation-command.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from 'commander';
+import type { ICommand } from '../lib/command-registry.js';
+import type { MergeConfiguration } from '../types.js';
+export declare class InvestigationCommand implements ICommand {
+    addToProgram(program: Command, merge: MergeConfiguration): void;
+    private addList;
+    private addTurns;
+    private addTranscript;
+}
+//# sourceMappingURL=investigation-command.d.ts.map

package/build/dist/commands/investigation-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"investigation-command.d.ts","sourceRoot":"","sources":["../../../src/main/typescript/commands/investigation-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAgBtD,qBAAa,oBAAqB,YAAW,QAAQ;IACnD,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAW/D,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,QAAQ;IA6ChB,OAAO,CAAC,aAAa;CAqBtB"}

package/build/dist/commands/investigation-command.js

@@ -0,0 +1,120 @@
+import { createApiClient } from '../lib/api-client-factory.js';
+import { InvestigationSummaryStatus as Status } from '../openapi/openApiTypes.js';
+import { captureTranscript, followInvestigation, readTurnsPage, ReadDeadline } from '../lib/investigation-transcript.js';
+import { enumOption, integerOption, timeoutOption, readAction, readCommand, writeReadOutput, writeReadStream } from '../lib/investigation-output.js';
+function setReadExitCode(reason) {
+    if (reason === 'timeout')
+        process.exitCode = 2;
+    if (reason === 'interrupted')
+        process.exitCode = 130;
+}
+export class InvestigationCommand {
+    addToProgram(program, merge) {
+        this.addList(program, merge);
+        const get = readCommand(program, 'investigation:get <id>', 'Read investigation metadata and recorded actions; no journal turns');
+        readAction(get, merge, async (global) => {
+            const options = { ...global, ...get.opts() };
+            await writeReadOutput(await createApiClient(options).getInvestigation(get.args[0] ?? ''), options);
+        });
+        this.addTurns(program, merge);
+        this.addTranscript(program, merge);
+    }
+    addList(program, merge) {
+        const command = readCommand(program, 'investigation:list', 'List one page of an agent’s investigations, newest first', 'table')
+            .requiredOption('--agent-id <id>', 'Agent whose investigations to list')
+            .option('--status <status>', 'Filter status; repeat to include multiple statuses', (value, previous) => [...previous, enumOption(Object.values(Status), value)], [])
+            .option('--page <number>', 'Zero-based page', integerOption(0, 21_474_836), 0)
+            .option('--page-size <number>', 'Investigations per page (1–100)', integerOption(1, 100), 25);
+        readAction(command, merge, async (global) => {
+            const options = { ...global, ...command.opts() };
+            if (!options.agentId.trim())
+                throw new Error('--agent-id must not be blank');
+            const result = await createApiClient(options).listInvestigations(options.agentId, { page: options.page, pageSize: options.pageSize, statuses: options.status });
+            const items = result.investigations?.items ?? [];
+            const more = (result.start ?? 0) + items.length < (result.total ?? 0);
+            await writeReadOutput(result, options, items.map(item => ({ investigationId: item.investigationId,
+                status: item.status, createdAt: item.createdAt, summary: item.summary,
+                inputTokens: item.inputTokens, outputTokens: item.outputTokens })), `${items.length} returned; total ${result.total ?? 'unknown'}.${more ? ` Next: --page ${options.page + 1}` : ''}`);
+        });
+    }
+    addTurns(program, merge) {
+        const command = readCommand(program, 'investigation:turns <id>', 'Read a bounded page of transcript turns using an exclusive sequence cursor')
+            .option('--after-seq <number>', 'Only turns after this sequence (-1 starts at the beginning)', integerOption(-1, 2_147_483_647), -1)
+            .option('--page-size <number>', 'Turns per request (1–100)', integerOption(1, 100), 50)
+            .option('--follow', 'Follow new turns until paused, terminal or timed out; does not control the run')
+            .option('--timeout <duration>', 'Read deadline including authentication, e.g. 60s or 5m', timeoutOption, 60_000);
+        readAction(command, merge, async (global) => {
+            const options = { ...global, ...command.opts() };
+            if (options.follow && (options.format === 'csv' || options.format === 'table')) {
+                throw new Error('--follow supports raw, compact or pretty output');
+            }
+            const client = createApiClient(options);
+            const id = command.args[0] ?? '';
+            const controller = new AbortController();
+            const interrupt = () => controller.abort();
+            process.once('SIGINT', interrupt);
+            try {
+                if (!options.follow) {
+                    const deadline = new ReadDeadline({ timeoutMs: options.timeout, signal: controller.signal });
+                    try {
+                        const page = await deadline.readOnce(signal => readTurnsPage(client, id, options.afterSeq, options.pageSize, signal));
+                        await writeReadOutput(page, options);
+                    }
+                    catch (error) {
+                        if (!deadline.reason)
+                            throw error;
+                        setReadExitCode(deadline.reason);
+                        console.error(`Read ${deadline.reason}`);
+                    }
+                    finally {
+                        deadline.close();
+                    }
+                    return;
+                }
+                const events = followInvestigation(client, id, { afterSeq: options.afterSeq, pageSize: options.pageSize,
+                    timeoutMs: options.timeout, signal: controller.signal });
+                const withExitCode = async function* () {
+                    for await (const event of events) {
+                        if (event.type === 'end') {
+                            setReadExitCode(event.reason);
+                            if (event.lastError)
+                                console.error(`Read ${event.reason}: ${event.lastError.message}`);
+                        }
+                        yield event;
+                    }
+                };
+                await writeReadStream(withExitCode(), options);
+            }
+            finally {
+                process.removeListener('SIGINT', interrupt);
+            }
+        });
+    }
+    addTranscript(program, merge) {
+        const command = readCommand(program, 'investigation:transcript <id>', 'Export metadata and transcript turns (default 50); use --max-turns or --all to change the bound')
+            .option('--max-turns <number>', 'Maximum turns to export (default 50)', integerOption(1, Number.MAX_SAFE_INTEGER))
+            .option('--all', 'Drain all available history within the deadline')
+            .option('--timeout <duration>', 'Export deadline, e.g. 60s or 5m', timeoutOption, 60_000);
+        readAction(command, merge, async (global) => {
+            const options = { ...global, ...command.opts() };
+            if (options.format === 'table' || options.format === 'csv')
+                throw new Error('Transcript exports support pretty, raw or compact output to preserve coverage');
+            if (options.all && options.maxTurns !== undefined)
+                throw new Error('--all and --max-turns are mutually exclusive');
+            const controller = new AbortController();
+            const interrupt = () => controller.abort();
+            process.once('SIGINT', interrupt);
+            try {
+                const result = await captureTranscript(createApiClient(options), command.args[0] ?? '', { all: options.all, maxTurns: options.maxTurns, timeoutMs: options.timeout, signal: controller.signal });
+                setReadExitCode(result.coverage.reason);
+                if (result.coverage.lastError)
+                    console.error(`Read ${result.coverage.reason}: ${result.coverage.lastError.message}`);
+                await writeReadOutput(result, options);
+            }
+            finally {
+                process.removeListener('SIGINT', interrupt);
+            }
+        });
+    }
+}
+//# sourceMappingURL=investigation-command.js.map

package/build/dist/commands/investigation-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"investigation-command.js","sourceRoot":"","sources":["../../../src/main/typescript/commands/investigation-command.ts"],"names":[],"mappings":"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"}

package/build/dist/commands/investigation-memory-command.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from 'commander';
+import type { ICommand } from '../lib/command-registry.js';
+import type { MergeConfiguration } from '../types.js';
+export declare class InvestigationMemoryCommand implements ICommand {
+    addToProgram(program: Command, merge: MergeConfiguration): void;
+}
+//# sourceMappingURL=investigation-memory-command.d.ts.map

package/build/dist/commands/investigation-memory-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"investigation-memory-command.d.ts","sourceRoot":"","sources":["../../../src/main/typescript/commands/investigation-memory-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA+CtD,qBAAa,0BAA2B,YAAW,QAAQ;IACzD,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;CAiBhE"}

package/build/dist/commands/investigation-memory-command.js

@@ -0,0 +1,59 @@
+import { createApiClient } from '../lib/api-client-factory.js';
+import { enumOption, integerOption, readAction, readCommand, writeReadOutput } from '../lib/investigation-output.js';
+import { parseIsoTimestamp } from '../lib/time-utils.js';
+import { MemorySearchRequestMode as Mode, MemorySearchRequestSignificance as Significance } from '../openapi/openApiTypes.js';
+function requestFor(options) {
+    const entityTags = {};
+    for (const tag of options.entityTag ?? []) {
+        const separator = tag.indexOf('=');
+        const key = tag.slice(0, separator).trim();
+        const value = tag.slice(separator + 1).trim();
+        if (separator <= 0 || !key || !value)
+            throw new Error('--entity-tag must be key=value');
+        if (Object.hasOwn(entityTags, key))
+            throw new Error(`Duplicate entity tag: ${key}`);
+        Object.defineProperty(entityTags, key, { value, enumerable: true });
+    }
+    if (options.mode === Mode.TIMELINE) {
+        if (Object.keys(entityTags).length === 0)
+            throw new Error('timeline requires --entity-tag');
+        if (options.query !== undefined)
+            throw new Error('timeline uses entity tags, not --query');
+    }
+    else if (!options.query?.trim())
+        throw new Error('text and semantic search require --query');
+    if (options.agentId !== undefined && !options.agentId.trim())
+        throw new Error('--agent-id must not be blank');
+    if (options.mode === Mode.SEMANTIC) {
+        if (!options.agentId)
+            throw new Error('semantic search requires --agent-id for a direct CLI caller');
+        if (Object.keys(entityTags).some(key => !key.startsWith('entity:'))) {
+            throw new Error('semantic search accepts only entity:-prefixed tags');
+        }
+    }
+    if (options.significance === Significance.BENIGN && options.mode !== Mode.TIMELINE) {
+        throw new Error('BENIGN is supported only in timeline mode');
+    }
+    return { mode: options.mode, query: options.query, agentId: options.agentId,
+        entityTags, significance: options.significance, limit: options.limit,
+        recordedAfter: options.recordedAfter ? parseIsoTimestamp(options.recordedAfter, '--recorded-after').toISOString() : undefined };
+}
+export class InvestigationMemoryCommand {
+    addToProgram(program, merge) {
+        const command = readCommand(program, 'investigation:memory:search', 'Search recorded investigation memories, not full transcripts')
+            .requiredOption('--mode <mode>', 'Search mode: text, semantic or timeline', value => enumOption(Object.values(Mode), value))
+            .option('--query <text>', 'Symptom or full-text query (required for text/semantic)')
+            .option('--agent-id <id>', 'Restrict to an agent (required for semantic)')
+            .option('--entity-tag <key=value>', 'Filter by entity tag; repeat for multiple tags', (value, previous) => [...previous, value], [])
+            .option('--significance <significance>', 'INCIDENT, OBSERVATION, INCONCLUSIVE or BENIGN (timeline only)', value => enumOption(Object.values(Significance), value))
+            .option('--recorded-after <timestamp>', 'Only memories recorded on/after an RFC3339 timestamp')
+            .option('--limit <number>', 'Maximum memories (1–50; results are not exhaustive)', integerOption(1, 50), 10);
+        readAction(command, merge, async (global) => {
+            const options = { ...global, ...command.opts() };
+            const request = requestFor(options);
+            const result = await createApiClient(options).searchInvestigationMemory(request);
+            await writeReadOutput(result, options, result.results ?? [], [result.preamble, result.note, result.semanticSearchUnavailable ? 'Semantic search unavailable.' : undefined].filter(Boolean).join('\n'));
+        });
+    }
+}
+//# sourceMappingURL=investigation-memory-command.js.map

package/build/dist/commands/investigation-memory-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"investigation-memory-command.js","sourceRoot":"","sources":["../../../src/main/typescript/commands/investigation-memory-command.ts"],"names":[],"mappings":"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"}

package/build/dist/docs-index/0b0db27e-1b72-4cdf-a6e2-83dcf5f54407.txt

@@ -0,0 +1,40 @@
+# Preview a vendor estimation run
+
+**POST** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/preview`
+
+**Operation ID**: `previewVendorEstimationRun`
+**Summary**: Preview a vendor estimation run
+Classifies the exceptions a run would cover — every one the integration has imported — and returns how many distinct queries it would send to the vendor and which exceptions cannot be counted because their query never parsed. Writes nothing.
+
+## Tags
+- Integration Exceptions
+## Parameters
+
+- **integrationId** (required) - path
+  - Integration id
+  - Type: string
+
+## Request Body
+
+**Content-Type**: `application/json`
+
+**Schema**: `CreateVendorEstimationRunRequest`
+
+## Responses
+
+### 200
+
+Preview computed
+
+- **Content-Type**: `application/json` / `VendorEstimationRunPreview`
+### 400
+
+Bad Request - Window is inverted or scope is invalid.
+
+### 401
+
+Unauthorized
+
+### 404
+
+Not Found - Integration not found.

package/build/dist/docs-index/12d9e234-f3b8-4e78-acd9-8f257f7c5504.txt

@@ -0,0 +1,26 @@
+# VendorEstimate
+
+What a run says about one exception. The type field selects the variant.
+
+**Type**: `object`
+
+## One Of
+
+This schema accepts one of the following types:
+
+### Option 1
+`VendorEstimateCounted`
+
+### Option 2
+`VendorEstimatePending`
+
+### Option 3
+`VendorEstimateUnparseable`
+
+### Option 4
+`VendorEstimateError`
+
+## Properties
+
+- name: type (required)
+  type: string

package/build/dist/docs-index/{6c14e19d-bc1d-4b66-ac9f-962fb57d9d12.txt → 1a58745d-c2ed-4fb2-aa2b-0b5ea057b72d.txt}

@@ -10,6 +10,10 @@
 - name: functions (required)
   type: array of `AnalyticsFunction`
 
+- name: maxRowLimit (required)
+  type: integer
+  description: Largest number of result rows an analytics query may ask for. A builder uses it to bound its input; the server refuses a larger request whether or not the caller did.
+
 - name: maxScanBudgetBytes (optional)
   type: integer
   description: Largest scan budget, in bytes, an Athena analytics query over this dataset may request. Absent when no ceiling applies. Queries routed to a Trino query engine are not subject to it.

package/build/dist/docs-index/21be1a31-9317-4d62-8479-47c3b641eb25.txt

@@ -0,0 +1,15 @@
+# UnparseableException
+
+Exceptions whose query could not be parsed at import and so cannot be counted, each with the parse error
+
+**Type**: `object`
+
+## Properties
+
+- name: exceptionId (required)
+  type: string
+  description: Composite exception id
+
+- name: message (required)
+  type: string
+  description: The parse error recorded when the exception was imported

package/build/dist/docs-index/21ef0b4c-917b-4848-9168-9e2125c1dc75.txt

@@ -0,0 +1,18 @@
+# VendorEstimateCounted
+
+The vendor counted this query over the run's scope and window.
+
+**Type**: `object`
+
+## Properties
+
+- name: impactPercentage (required)
+  type: number
+  description: Share of the scope's indexed logs this query matched, as a percentage of the run's scope total
+
+- name: matchedCount (required)
+  type: integer
+  description: Events the query matched over the run's window
+
+- name: type (required)
+  type: enum: `COUNTED`

package/build/dist/docs-index/26e360e1-bee0-45da-9017-64e4ab512983.txt

@@ -0,0 +1,33 @@
+# List vendor estimation runs for an integration
+
+**GET** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs`
+
+**Operation ID**: `listVendorEstimationRuns`
+**Summary**: List vendor estimation runs for an integration
+Returns the integration's estimation runs newest first, including failed and stopped ones. Scope and window identify a run: numbers from runs over different scopes or windows are not comparable.
+
+## Tags
+- Integration Exceptions
+## Parameters
+
+- **integrationId** (required) - path
+  - Integration id
+  - Type: string
+- **limit** (optional) - query
+  - Maximum runs to return
+  - Type: integer
+
+## Responses
+
+### 200
+
+Runs retrieved
+
+- **Content-Type**: `application/json` / array of `VendorEstimationRun`
+### 401
+
+Unauthorized
+
+### 404
+
+Not Found - Integration not found.

package/build/dist/docs-index/{eb270d0f-a1d6-4119-8c93-8f6647439567.txt → 2d46a455-83cd-4e72-a7dd-2bdf815aaa8b.txt}

@@ -1,7 +1,5 @@
 # AnalyticsProjection
 
-Expressions returned by the query.
-
 **Type**: `object`
 
 ## Properties

package/build/dist/docs-index/3d537e62-c9fe-4523-8f4b-ef65464db312.txt

@@ -0,0 +1,17 @@
+# CreateVendorEstimationRunRequest
+
+**Type**: `object`
+
+## Properties
+
+- name: scopeQuery (optional)
+  type: string
+  description: Vendor query limiting the estimate to part of the customer's traffic. Applied to both the matched count and the total. Leave empty for all logs.
+
+- name: windowEnd (required)
+  type: string
+  description: Absolute end of the window to count over; must be after the start
+
+- name: windowStart (required)
+  type: string
+  description: Absolute start of the window to count over

package/build/dist/docs-index/4196d4c8-1208-42af-abaa-a192d11500c2.txt

@@ -0,0 +1,21 @@
+# VendorEstimationRunPreview
+
+**Type**: `object`
+
+## Properties
+
+- name: distinctQueries (required)
+  type: integer
+  description: Distinct countable predicates among those exceptions, and so the number of vendor calls the run would make. Smaller than the exception count wherever several exceptions carry the same query.
+
+- name: exceptions (required)
+  type: integer
+  description: Exceptions the run would cover: every one the integration has imported
+
+- name: queuedAhead (optional)
+  type: integer
+  description: Runs that would start before this one if it were created now. Absent when a slot is free.
+
+- name: unparseable (required)
+  type: array of `UnparseableException`
+  description: Exceptions whose query could not be parsed at import and so cannot be counted, each with the parse error

package/build/dist/docs-index/5a05ff8a-4c99-4a67-8acd-90d5c0b860de.txt

@@ -0,0 +1,37 @@
+# Resume a stalled vendor estimation run
+
+**POST** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/resume`
+
+**Operation ID**: `resumeVendorEstimationRun`
+**Summary**: Resume a stalled vendor estimation run
+Triggers another slice for a run that has been running without progress for longer than the configured stale threshold. Returns 409 for a run that is progressing normally, parked on a rate limit, or already finished.
+
+## Tags
+- Integration Exceptions
+## Parameters
+
+- **integrationId** (required) - path
+  - Integration id
+  - Type: string
+- **runId** (required) - path
+  - Run id
+  - Type: string
+
+## Responses
+
+### 200
+
+Slice triggered
+
+- **Content-Type**: `application/json` / `VendorEstimationRun`
+### 401
+
+Unauthorized
+
+### 404
+
+Not Found - Integration or run not found.
+
+### 409
+
+Conflict - The run is not eligible to be resumed.

package/build/dist/docs-index/5fc5b503-8db6-4ef5-b4ee-a17efa56fac4.txt

@@ -0,0 +1,33 @@
+# Get a vendor estimation run
+
+**GET** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}`
+
+**Operation ID**: `getVendorEstimationRun`
+**Summary**: Get a vendor estimation run
+Returns the run's current state and progress. Poll this while the run is non-terminal; results land incrementally and are readable throughout.
+
+## Tags
+- Integration Exceptions
+## Parameters
+
+- **integrationId** (required) - path
+  - Integration id
+  - Type: string
+- **runId** (required) - path
+  - Run id
+  - Type: string
+
+## Responses
+
+### 200
+
+Run retrieved
+
+- **Content-Type**: `application/json` / `VendorEstimationRun`
+### 401
+
+Unauthorized
+
+### 404
+
+Not Found - Integration or run not found.

package/build/dist/docs-index/6c1a6e99-67ce-494b-954b-bbcc921ee959.txt

@@ -0,0 +1,33 @@
+# Stop a vendor estimation run
+
+**DELETE** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}`
+
+**Operation ID**: `stopVendorEstimationRun`
+**Summary**: Stop a vendor estimation run
+Stops the run and keeps every count it has already made. The run ends partial, with a stop reason recording that a person stopped it. No rows are deleted; calling this on a run that has already finished is a no-op.
+
+## Tags
+- Integration Exceptions
+## Parameters
+
+- **integrationId** (required) - path
+  - Integration id
+  - Type: string
+- **runId** (required) - path
+  - Run id
+  - Type: string
+
+## Responses
+
+### 200
+
+Run stopped
+
+- **Content-Type**: `application/json` / `VendorEstimationRun`
+### 401
+
+Unauthorized
+
+### 404
+
+Not Found - Integration or run not found.

package/build/dist/docs-index/7259fe14-48f0-4ba4-bd8b-d161d5c171e4.txt

@@ -0,0 +1,10 @@
+# VendorEstimatePending
+
+This exception is in the run but has not been counted yet.
+
+**Type**: `object`
+
+## Properties
+
+- name: type (required)
+  type: enum: `PENDING`

package/build/dist/docs-index/79441fe9-08d8-48e1-9581-65c6de6b3e3c.txt

@@ -0,0 +1,15 @@
+# AnalyticsDiagnostic
+
+Request constraints, followed by the first SQL failure when the request is complete, at most one per field. Empty means no draft errors were found; execution still validates the query against its actual table and engine.
+
+**Type**: `object`
+
+## Properties
+
+- name: message (required)
+  type: string
+  description: What is wrong, as a finished sentence to show the person editing the query.
+
+- name: path (required)
+  type: string
+  description: Where the rule was broken, as a path into the request: 'select', 'select[1].expression', 'select[1].alias', 'groupBy[0]', 'window.size', 'window.slide', 'having', 'orderBy[2].expression', 'limit', 'scanBudgetBytes', 'predicate', or 'query' for a failure that names no single item.

package/build/dist/docs-index/80e2c8fb-094d-419e-bc47-de74a6ac7c24.txt

@@ -0,0 +1,16 @@
+# AnalyticsDraftRequest
+
+**Type**: `object`
+
+## Properties
+
+- name: datasetId (optional)
+  type: string
+  description: Dataset the query reads. Supplying it checks the scan budget against that dataset's ceiling and requires VIEW permission on it.
+
+- name: query (required)
+  type: `StructuredAnalyticsQuery`
+
+- name: scanBudgetBytes (required)
+  type: integer
+  description: Bytes the run may scan, checked against the organization's ceiling. Zero stands for a budget field left empty and is reported as a diagnostic.

package/build/dist/docs-index/851f344a-bfdd-45b2-81a3-b8fdf75a6c2a.txt

@@ -0,0 +1,9 @@
+# AnalyticsDraftResponse
+
+**Type**: `object`
+
+## Properties
+
+- name: diagnostics (required)
+  type: array of `AnalyticsDiagnostic`
+  description: Request constraints, followed by the first SQL failure when the request is complete, at most one per field. Empty means no draft errors were found; execution still validates the query against its actual table and engine.