@grepr/cli 1.10.8-fff9f89 → 1.11.0-0032e93

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/1137a87e-e883-4a0d-bfed-fb40f1cf69f4.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/{6c14e19d-bc1d-4b66-ac9f-962fb57d9d12.txt → 2a4f97b0-3715-4c32-8a81-6e39e16477c5.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/2a8df341-a78e-402e-8ef5-9b2210045547.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/2cb67e6f-d127-4480-b991-f051efeff055.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/31270548-5476-413b-bbde-6059af90099f.txt

@@ -0,0 +1,14 @@
+# VendorEstimateUnparseable
+
+The exception's query could not be parsed, so it was never counted.
+
+**Type**: `object`
+
+## Properties
+
+- name: message (required)
+  type: string
+  description: The parse error recorded when the exception was imported
+
+- name: type (required)
+  type: enum: `UNPARSEABLE`

package/build/dist/docs-index/3540209a-240b-4855-9599-9b97c12b5122.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/35fe3619-84f5-44b8-9405-7fbeea33c65b.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/4fdcae76-2799-4384-b064-70f7b52fdc94.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/5db00dc6-0f97-4248-8bcb-76d32872b414.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.

package/build/dist/docs-index/61e5c6d6-566c-4d39-bbfc-5e0bf1f5f59a.txt

@@ -0,0 +1,44 @@
+# Start a vendor estimation run
+
+**POST** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs`
+
+**Operation ID**: `createVendorEstimationRun`
+**Summary**: Start a vendor estimation run
+Creates a run over the given scope and window covering every exception the integration has imported, with one result row per distinct predicate, and queues its first slice. One non-terminal run per organization: starting a second returns 409 while the first is still in flight.
+
+## Tags
+- Integration Exceptions
+## Parameters
+
+- **integrationId** (required) - path
+  - Integration id
+  - Type: string
+
+## Request Body
+
+**Content-Type**: `application/json`
+
+**Schema**: `CreateVendorEstimationRunRequest`
+
+## Responses
+
+### 201
+
+Run created
+
+- **Content-Type**: `application/json` / `VendorEstimationRun`
+### 400
+
+Bad Request - Window is inverted or scope is invalid.
+
+### 401
+
+Unauthorized
+
+### 404
+
+Not Found - Integration not found.
+
+### 409
+
+Conflict - The organization already has a run that has not finished.

package/build/dist/docs-index/664e9b1d-a05d-40b9-be4d-59cbe165d26f.txt

@@ -0,0 +1,33 @@
+# Get vendor estimation results for a run
+
+**GET** `/v1/integrations/{integrationId}/exceptions/vendor-estimation-runs/{runId}/results`
+
+**Operation ID**: `getVendorEstimationRunResults`
+**Summary**: Get vendor estimation results for a run
+Returns the run's per-exception estimates keyed by composite exception id. Each entry is one of four variants selected by its type field, because an estimate can be pending, unparseable or failed as well as counted. An exception missing from the response was not in this run, which is not the same as matching nothing.
+
+## Tags
+- Integration Exceptions
+## Parameters
+
+- **integrationId** (required) - path
+  - Integration id
+  - Type: string
+- **runId** (required) - path
+  - Run id
+  - Type: string
+
+## Responses
+
+### 200
+
+Results retrieved
+
+- **Content-Type**: `application/json` / object
+### 401
+
+Unauthorized
+
+### 404
+
+Not Found - Integration or run not found.

package/build/dist/docs-index/{237ce406-5106-477e-a67a-824af45af115.txt → 692c3c8a-68bf-41f2-bf64-624c6ca01224.txt}

@@ -19,6 +19,12 @@ Returns the investigations the agent has run, newest first.
 - **statuses** (optional) - query
   - Investigation statuses to include, e.g. QUEUED, RUNNING, COMPLETED; repeat for multiple. Absent or empty for all statuses.
   - Type: array of string
+- **hasActions** (optional) - query
+  - Whether the investigation has recorded actions; absent for either
+  - Type: boolean
+- **triggers** (optional) - query
+  - Signal types to include; repeat for multiple. Absent for all.
+  - Type: array of enum: `MANUAL`, `WEBHOOK_SIGNAL`, `LOG_PATTERN_SIGNAL`
 
 ## Responses
 

package/build/dist/docs-index/77ce127e-26a3-4bb2-992e-7aee1623f2df.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/{1c818e9b-7f45-4f55-ac24-6c692f00ad52.txt → 7d177281-a910-4115-9a82-f32429f5ec46.txt}

@@ -7,12 +7,18 @@
 - name: appBaseUrl (optional)
   type: string
 
+- name: billingEnabled (optional)
+  type: boolean
+
 - name: flinkBaseUrl (optional)
   type: string
 
 - name: gtmContainerId (optional)
   type: string
 
+- name: intercomEnabled (optional)
+  type: boolean
+
 - name: kafkaToolkitClusterName (optional)
   type: string
 

package/build/dist/docs-index/83186310-c7aa-4f55-b1e5-f1a1b1d6a1fa.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/8c0bcc6e-2fdc-4890-86cf-b411a6d2f2e4.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.