import {z} from 'zod' export type GenerateVizPlanRequest = {user_hint?: string | undefined, sample_size?: number | undefined, max_distinct_values?: number | undefined, max_tokens?: number | undefined, reasoning?: (string | null) | undefined}; export type CreateApiApiV0KnowledgeBasesKbIdVizPlanArgs = {kb_id: string, body: GenerateVizPlanRequest}; export type CreateApiApiV0KnowledgeBasesKbIdVizPlanOptions = {baseUrl: string, HTTPBearer?: string | undefined, fetch?: typeof fetch | undefined}; export const vizChart = z.object({field: z.string(), chart_type: z.enum(["donut", "bar", "grouped_bar", "rate", "numeric_by_field", "metric"]), label: z.string(), group_by: z.string().nullable().optional(), filter_field: z.string().nullable().optional(), filter_values: z.array(z.string()).nullable().optional(), numeric_field: z.string().nullable().optional(), time_from_field: z.string().nullable().optional(), time_to_field: z.string().nullable().optional(), time_unit: z.enum(["seconds", "minutes", "hours", "days"]).nullable().optional(), aggregation: z.enum(["mean", "median", "min", "max", "sum", "p95"]).nullable().optional(), unit_label: z.string().nullable().optional(), reason: z.string().nullable().optional()}); export const bucket = z.object({label: z.string().nullable(), count: z.number().int()}); export const distributionResult = z.object({kind: z.literal("distribution").optional(), total: z.number().int(), buckets: z.array(bucket)}); export const groupedRow = z.object({label: z.string(), total: z.number().int(), segments: z.array(bucket)}); export const groupedResult = z.object({kind: z.literal("grouped").optional(), total: z.number().int(), rows: z.array(groupedRow), segment_keys: z.array(z.string().nullable())}); export const rateRow = z.object({label: z.string(), matching: z.number().int(), total: z.number().int(), rate: z.number()}); export const rateResult = z.object({kind: z.literal("rate").optional(), total: z.number().int(), rows: z.array(rateRow)}); export const numericRow = z.object({label: z.string(), value: z.number(), count: z.number().int()}); export const numericResult = z.object({kind: z.literal("numeric").optional(), aggregation: z.enum(["mean", "median", "min", "max", "sum", "p95"]), unit: z.string(), rows: z.array(numericRow)}); export const metricResult = z.object({kind: z.literal("metric").optional(), metric: z.enum(["count", "ratio", "numeric", "duration"]), value: z.number(), unit: z.string(), denominator: z.number().int(), matching: z.number().int().nullable().optional(), aggregation: z.enum(["mean", "median", "min", "max", "sum", "p95"]).nullable().optional()}); export const vizPlan = z.object({summary_metric_field: z.string().nullable().optional(), charts: z.array(vizChart).optional(), value_aliases: z.record(z.string(), z.record(z.string(), z.string())).optional(), rationale: z.string().nullable().optional(), sample_size: z.number().int().optional(), record_count: z.number().int().optional(), results: z.array(z.union([distributionResult, groupedResult, rateResult, numericResult, metricResult]).nullable()).optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Generate KB visualization plan * * POST /api/v0/knowledge-bases/{kb_id}/viz-plan */ export const createApiApiV0KnowledgeBasesKbIdVizPlan = async (args: CreateApiApiV0KnowledgeBasesKbIdVizPlanArgs, options: CreateApiApiV0KnowledgeBasesKbIdVizPlanOptions) => { const {baseUrl, fetch: fetchFn = fetch, HTTPBearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (HTTPBearer !== undefined) headers.set('authorization', `Bearer ${HTTPBearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/api/v0/knowledge-bases/${encodeURIComponent(String(args.kb_id))}/viz-plan${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(vizPlan, await res.json()) };