import {z} from 'zod' export type GetApiApiV1AiAgentsAdminReviewItemsFingerprintActivityArgs = {fingerprint: string}; export type GetApiApiV1AiAgentsAdminReviewItemsFingerprintActivityOptions = {baseUrl: string, fetch?: typeof fetch | undefined}; export const aiAgentReviewRemediationLiveState = z.enum(["writeback", "compiling", "verifying"]); export const recordStringNever = z.object({}); export const aiAgentRootCause = z.enum(["semantic_layer", "project_context", "agent_configuration", "product_capability", "runtime_reliability", "feedback_quality", "not_a_failure", "ambiguous"]); export const aiAgentReviewItemDismissedReason = z.enum(["not_actionable", "expected_behavior", "duplicate", "low_confidence", "other"]); export const aiAgentReviewItemStatus = z.enum(["triage", "open", "in_progress", "resolved", "dismissed", "duplicate"]); export const aiAgentReviewItemPriority = z.enum(["urgent", "high", "medium", "low", "none"]); export const aiAgentReviewActivityEvent = z.union([z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: z.object({sourcePromptUuid: z.string().nullable(), sourceThreadUuid: z.string().nullable(), excerpt: z.string().nullable()}), eventType: z.literal("finding_opened")}), z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: z.object({deletions: z.number().nullable(), additions: z.number().nullable(), files: z.array(z.string())}), eventType: z.literal("writeback_completed")}), z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: z.object({prNumber: z.number().nullable(), prUrl: z.string()}), eventType: z.literal("pr_opened")}), z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: z.object({prUrl: z.string().nullable()}), eventType: z.literal("pr_updated")}), z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: z.object({previewProjectUuid: z.string()}), eventType: z.literal("preview_compiled")}), z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: z.object({previewThreadUuid: z.string()}), eventType: z.literal("verification_completed")}), z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: z.object({prUrl: z.string()}), eventType: z.literal("pr_merged")}), z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: z.object({prUrl: z.string()}), eventType: z.literal("pr_closed")}), z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: recordStringNever, eventType: z.literal("resolved")}), z.object({kind: z.literal("remediation"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), remediationUuid: z.string().nullable(), uuid: z.string(), payload: z.object({errorMessage: z.string().nullable()}), eventType: z.literal("failed")}), z.object({kind: z.literal("issue"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), fingerprint: z.string(), uuid: z.string(), payload: z.object({rootCause: aiAgentRootCause.nullable()}), eventType: z.literal("created")}), z.object({kind: z.literal("issue"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), fingerprint: z.string(), uuid: z.string(), payload: z.object({dismissedReason: aiAgentReviewItemDismissedReason.nullable(), to: aiAgentReviewItemStatus, from: aiAgentReviewItemStatus.nullable()}), eventType: z.literal("status_changed")}), z.object({kind: z.literal("issue"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), fingerprint: z.string(), uuid: z.string(), payload: z.object({toUserUuid: z.string().nullable(), fromUserUuid: z.string().nullable()}), eventType: z.literal("assignee_changed")}), z.object({kind: z.literal("issue"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), fingerprint: z.string(), uuid: z.string(), payload: z.object({promptUuid: z.string(), threadUuid: z.string()}), eventType: z.literal("recurred")}), z.object({kind: z.literal("issue"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), fingerprint: z.string(), uuid: z.string(), payload: z.object({to: aiAgentReviewItemPriority, from: aiAgentReviewItemPriority}), eventType: z.literal("priority_changed")}), z.object({kind: z.literal("issue"), createdByUserUuid: z.string().nullable(), occurredAt: z.string(), fingerprint: z.string(), uuid: z.string(), payload: z.object({body: z.string()}), eventType: z.literal("comment_added")})]); export const aiAgentReviewItemActivity = z.object({verdictStale: z.boolean(), liveMessage: z.string().nullable(), liveState: aiAgentReviewRemediationLiveState.nullable(), events: z.array(aiAgentReviewActivityEvent)}); export const apiAiAgentReviewItemActivityResponse = z.object({results: aiAgentReviewItemActivity, status: z.literal("ok")}); 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 }; /** * Get AI agent review item activity * * GET /api/v1/aiAgents/admin/review-items/{fingerprint}/activity */ export const getApiApiV1AiAgentsAdminReviewItemsFingerprintActivity = async (args: GetApiApiV1AiAgentsAdminReviewItemsFingerprintActivityArgs, options: GetApiApiV1AiAgentsAdminReviewItemsFingerprintActivityOptions) => { const {baseUrl, fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/aiAgents/admin/review-items/${encodeURIComponent(String(args.fingerprint))}/activity${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(apiAiAgentReviewItemActivityResponse, await res.json()) };