import {z} from 'zod' export type GetApiSnapshotsSnapshotIdHealthPerformanceOpportunitiesArgs = {snapshot_id: string, context?: ('production_tooling' | 'production' | 'tooling' | 'test' | 'unknown' | 'all') | undefined, boundary?: (string | null) | undefined, confidence?: (string | null) | undefined, actionability?: (string | null) | undefined, view?: string | undefined, sort?: string | undefined, file_paths?: (string | null) | undefined, limit?: number | undefined, offset?: number | undefined}; export type GetApiSnapshotsSnapshotIdHealthPerformanceOpportunitiesOptions = {baseUrl: string, HTTPBearer?: string | undefined, fetch?: typeof fetch | undefined}; export const performanceOpportunityEvidence = z.object({finding_id: z.string().optional(), file_path: z.string().optional(), biomarker_type: z.string().optional(), function_name: z.string().nullable().optional(), line_start: z.number().int().nullable().optional(), line_end: z.number().int().nullable().optional(), reason: z.string().optional(), path: z.array(z.string()).optional(), provenance: z.string().optional()}); export const performanceWhyRanked = z.object({factor: z.string(), points: z.number().int().optional(), value: z.unknown()}); export const performanceFix = z.object({strategy: z.string(), safety: z.enum(["proven", "advisory"]), rationale: z.string(), api: z.string().nullable().optional()}); export const performanceOpportunity = z.object({opportunity_id: z.string(), performance_model_version: z.number().int().optional(), biomarker_type: z.string(), biomarker_types: z.array(z.string()).optional(), boundary_kind: z.string().nullable().optional(), execution_context: z.enum(["production", "tooling", "test", "unknown"]), terminal_sink: z.string().nullable().optional(), shared_path_suffix: z.array(z.string()).optional(), intervention_symbol: z.string().nullable().optional(), file_path: z.string().optional(), affected_call_sites_total: z.number().int().optional(), affected_files_total: z.number().int().optional(), observations_total: z.number().int().optional(), evidence: z.array(performanceOpportunityEvidence).optional(), evidence_truncated: z.boolean().optional(), evidence_total: z.number().int().optional(), evidence_emitted: z.number().int().optional(), reliable_entry_reachability: z.boolean().nullable().optional(), provenance: z.string().optional(), confidence: z.enum(["high", "medium", "low"]).optional(), resource_fingerprints: z.array(z.string()).optional(), facets: z.record(z.string(), z.unknown()).optional(), actionability_state: z.enum(["plan_ready", "advisory", "investigate", "expected"]).optional(), actionability_reason: z.string().optional(), prerequisites: z.array(z.string()).optional(), rank_score: z.number().int().optional(), rank_position: z.number().int().optional(), rank_factors: z.record(z.string(), z.unknown()).optional(), why_ranked: z.array(performanceWhyRanked).optional(), fix: performanceFix.nullable().optional(), siblings: z.array(z.record(z.string(), z.unknown())).optional(), plan_id: z.string().nullable().optional(), plan_status: z.enum(["available", "no_safe_plan", "not_persisted"]).optional(), plan_reason: z.string().optional()}); export const performanceOpportunitySummary = z.object({total: z.number().int().optional(), production_total: z.number().int().optional(), tooling_total: z.number().int().optional(), test_total: z.number().int().optional(), context: z.record(z.string(), z.number().int()).optional(), with_plan_total: z.number().int().optional(), without_plan_total: z.number().int().optional(), status: z.enum(["current", "stale_model", "unavailable"]).optional(), repository_total: z.number().int().optional(), performance_model_version: z.number().int().optional(), materialized_model_version: z.number().int().optional(), analyzed_commit: z.string().nullable().optional(), actionability: z.record(z.string(), z.number().int()).optional(), boundary: z.record(z.string(), z.number().int()).optional(), reason: z.string().nullable().optional(), detail: z.string().nullable().optional()}); export const performanceFacetCount = z.object({value: z.string(), total: z.number().int().optional()}); export const performanceOpportunityPage = z.object({items: z.array(performanceOpportunity).optional(), total: z.number().int().optional(), has_more: z.boolean().optional(), next_offset: z.number().int().nullable().optional(), summary: performanceOpportunitySummary.optional(), facets: z.record(z.string(), z.array(performanceFacetCount)).optional(), ignored_arguments: z.record(z.string(), z.string()).nullable().optional(), state: z.string().optional(), reason: z.string().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 }; /** * List Performance Opportunities * * GET /snapshots/{snapshot_id}/health/performance-opportunities */ export const getApiSnapshotsSnapshotIdHealthPerformanceOpportunities = async (args: GetApiSnapshotsSnapshotIdHealthPerformanceOpportunitiesArgs, options: GetApiSnapshotsSnapshotIdHealthPerformanceOpportunitiesOptions) => { const {baseUrl, fetch: fetchFn = fetch, HTTPBearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.context != null) query.append("context", String(args.context)) if (args.boundary != null) query.append("boundary", String(args.boundary)) if (args.confidence != null) query.append("confidence", String(args.confidence)) if (args.actionability != null) query.append("actionability", String(args.actionability)) if (args.view != null) query.append("view", String(args.view)) if (args.sort != null) query.append("sort", String(args.sort)) if (args.file_paths != null) query.append("file_paths", String(args.file_paths)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.offset != null) query.append("offset", String(args.offset)) if (HTTPBearer !== undefined) headers.set('authorization', `Bearer ${HTTPBearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/snapshots/${encodeURIComponent(String(args.snapshot_id))}/health/performance-opportunities${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(performanceOpportunityPage, await res.json()) };