import {z} from 'zod' export type AiAgentModelConfig = {reasoning?: boolean | undefined, modelProvider: string, modelName: string}; export type DateGranularity = 'Second' | 'Minute' | 'Hour' | 'Day' | 'Week' | 'Month' | 'Quarter' | 'Year'; export type DateZoom = {xAxisFieldId?: string | undefined, granularity?: (DateGranularity | string) | undefined}; export type ParameterValue = string | number | Array | Array; export type ParametersValuesMap = {[key: string]: ParameterValue}; export type AnyType = unknown; export type FilterOperator = 'isNull' | 'notNull' | 'equals' | 'notEquals' | 'startsWith' | 'endsWith' | 'include' | 'doesNotInclude' | 'lessThan' | 'lessThanOrEqual' | 'greaterThan' | 'greaterThanOrEqual' | 'inThePast' | 'notInThePast' | 'inTheNext' | 'inTheCurrent' | 'notInTheCurrent' | 'inBetween' | 'notInBetween' | 'inPeriodToDate'; export type DimensionType = 'string' | 'number' | 'timestamp' | 'date' | 'boolean'; export type DashboardFieldTarget = {fallbackType?: DimensionType | undefined, isSqlColumn?: boolean | undefined, tableName: string, fieldId: string}; export type DashboardTileTarget = DashboardFieldTarget | false; export type DashboardTileTargets = {[key: string]: DashboardTileTarget}; export type DashboardFilterRule = {includeNull?: boolean | undefined, values?: Array | undefined, operator: FilterOperator, id: string, target: DashboardFieldTarget, settings?: AnyType | undefined, disabled?: boolean | undefined, required?: boolean | undefined, caseSensitive?: boolean | undefined, lockedTabUuids?: Array | undefined, requiredGroupId?: string | undefined, singleValue?: boolean | undefined, label?: string | undefined, tileTargets?: DashboardTileTargets | undefined} | {[key: string]: unknown}; export type DashboardFilters = {tableCalculations: Array, metrics: Array, dimensions: Array}; export type AiChartRuntimeOverrides = {dateZoom?: DateZoom | undefined, dashboardParameters?: ParametersValuesMap | undefined, dashboardFilters?: DashboardFilters | undefined}; export type PickDashboardFilterRuleExcludeKeyofDashboardFilterRuleIdOrTileTargetsOrLockedTabUuidsOrRequiredGroupId = {label?: string | undefined, target: DashboardFieldTarget, settings: unknown, disabled?: boolean | undefined, required?: boolean | undefined, caseSensitive?: boolean | undefined, operator: FilterOperator, values?: Array | undefined, includeNull?: boolean | undefined, singleValue?: boolean | undefined}; export type AiDashboardFilterRule = PickDashboardFilterRuleExcludeKeyofDashboardFilterRuleIdOrTileTargetsOrLockedTabUuidsOrRequiredGroupId; export type AiDashboardFilters = {tableCalculations: Array, metrics: Array, dimensions: Array}; export type AiDashboardActiveTab = {name: string, uuid: string}; export type AiDashboardRuntimeOverrides = {dateZoom?: (DateZoom | null) | undefined, dashboardParameters?: ParametersValuesMap | undefined, dashboardFilters?: AiDashboardFilters | undefined, activeTab?: AiDashboardActiveTab | undefined}; export type AiPromptContextItemInput = {runtimeOverrides?: AiChartRuntimeOverrides | undefined, chartSlug?: (string | null) | undefined, chartUuid: string, type: 'chart'} | {runtimeOverrides?: AiDashboardRuntimeOverrides | undefined, dashboardSlug?: (string | null) | undefined, dashboardUuid: string, type: 'dashboard'} | {promptUuid?: (string | null) | undefined, threadUuid: string, type: 'thread'} | {path: string, type: 'file'} | {fullName: string, type: 'repository'} | {prUrl: string, type: 'pull_request'} | {fingerprint: string, type: 'proposed_change'} | {fingerprint: string, type: 'review_finding'} | {previewProjectUuid: string, type: 'preview_environment'}; export type AiPromptContextInput = Array; export type ApiAiAgentThreadMessageCreateRequest = {hidden?: boolean | undefined, modelConfig?: AiAgentModelConfig | undefined, context?: AiPromptContextInput | undefined, prompt: string}; export type CreateApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuidMessagesArgs = {projectUuid: string, agentUuid: string, threadUuid: string, body: ApiAiAgentThreadMessageCreateRequest}; export type CreateApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuidMessagesOptions = {baseUrl: string, fetch?: typeof fetch | undefined}; export const aiPromptSteer = z.object({consumedStep: z.number().nullable(), consumedAt: z.string().nullable(), createdAt: z.string(), message: z.string(), promptUuid: z.string(), uuid: z.string()}); export const chartKind = z.enum(["line", "horizontal_bar", "vertical_bar", "scatter", "area", "mixed", "pie", "table", "big_number", "funnel", "custom", "treemap", "gauge", "map", "sankey", "data_app_viz"]); export const dateGranularity = z.enum(["Second", "Minute", "Hour", "Day", "Week", "Month", "Quarter", "Year"]); export const dateZoom = z.object({xAxisFieldId: z.string().optional(), granularity: z.union([dateGranularity, z.string()]).optional()}); export const parameterValue = z.union([z.string(), z.number(), z.array(z.string()), z.array(z.number())]); export const parametersValuesMap = z.record(z.string(), parameterValue); export const anyType = z.unknown(); export const filterOperator = z.enum(["isNull", "notNull", "equals", "notEquals", "startsWith", "endsWith", "include", "doesNotInclude", "lessThan", "lessThanOrEqual", "greaterThan", "greaterThanOrEqual", "inThePast", "notInThePast", "inTheNext", "inTheCurrent", "notInTheCurrent", "inBetween", "notInBetween", "inPeriodToDate"]); export const dimensionType = z.enum(["string", "number", "timestamp", "date", "boolean"]); export const dashboardFieldTarget = z.object({fallbackType: dimensionType.optional(), isSqlColumn: z.boolean().optional(), tableName: z.string(), fieldId: z.string()}); export const dashboardTileTarget = z.union([dashboardFieldTarget, z.literal(false)]); export const dashboardTileTargets = z.record(z.string(), dashboardTileTarget); export const dashboardFilterRule = z.object({includeNull: z.boolean().optional(), values: z.array(anyType).optional(), operator: filterOperator, id: z.string(), target: dashboardFieldTarget, settings: anyType.optional(), disabled: z.boolean().optional(), required: z.boolean().optional(), caseSensitive: z.boolean().optional(), lockedTabUuids: z.array(z.string()).optional(), requiredGroupId: z.string().optional(), singleValue: z.boolean().optional(), label: z.string().optional(), tileTargets: dashboardTileTargets.optional()}).and(z.record(z.string(), z.unknown())); export const dashboardFilters = z.object({tableCalculations: z.array(dashboardFilterRule), metrics: z.array(dashboardFilterRule), dimensions: z.array(dashboardFilterRule)}); export const aiChartRuntimeOverrides = z.object({dateZoom: dateZoom.optional(), dashboardParameters: parametersValuesMap.optional(), dashboardFilters: dashboardFilters.optional()}); export const pickDashboardFilterRuleExcludeKeyofDashboardFilterRuleIdOrTileTargetsOrLockedTabUuidsOrRequiredGroupId = z.object({label: z.string().optional(), target: dashboardFieldTarget, settings: z.unknown(), disabled: z.boolean().optional(), required: z.boolean().optional(), caseSensitive: z.boolean().optional(), operator: filterOperator, values: z.array(z.unknown()).optional(), includeNull: z.boolean().optional(), singleValue: z.boolean().optional()}); export const aiDashboardFilterRule = pickDashboardFilterRuleExcludeKeyofDashboardFilterRuleIdOrTileTargetsOrLockedTabUuidsOrRequiredGroupId; export const aiDashboardFilters = z.object({tableCalculations: z.array(aiDashboardFilterRule), metrics: z.array(aiDashboardFilterRule), dimensions: z.array(aiDashboardFilterRule)}); export const aiDashboardActiveTab = z.object({name: z.string(), uuid: z.string()}); export const aiDashboardRuntimeOverrides = z.object({dateZoom: dateZoom.nullable().optional(), dashboardParameters: parametersValuesMap.optional(), dashboardFilters: aiDashboardFilters.optional(), activeTab: aiDashboardActiveTab.optional()}); export const aiAgentReviewItemPrState = z.enum(["open", "merged", "closed"]); export const pullRequestProvider = z.enum(["github", "gitlab"]); export const aiProjectContextTypedObjectRef = z.union([z.object({name: z.string(), type: z.literal("explore")}), z.object({fieldId: z.string(), explore: z.string(), type: z.literal("field")})]); export const aiProjectContextObjectRef = z.union([z.string(), aiProjectContextTypedObjectRef]); export const aiAgentJudgeProjectContextEntry = z.object({objects: z.array(aiProjectContextObjectRef), terms: z.array(z.string()), content: z.string(), kind: z.enum(["definition", "context"]), id: z.string().nullable(), op: z.enum(["create", "update"])}); export const aiAgentSemanticTargetRef = z.union([z.object({modelName: z.string(), type: z.literal("model")}), z.object({exploreName: z.string(), modelName: z.string(), type: z.literal("explore")}), z.object({exploreName: z.string().optional(), joinName: z.string(), modelName: z.string(), type: z.literal("join")}), z.object({dimensionName: z.string(), modelName: z.string(), type: z.literal("dimension")}), z.object({dimensionName: z.string().optional(), metricName: z.string(), modelName: z.string(), type: z.literal("metric")}), z.object({dimensionName: z.string(), parentDimensionName: z.string(), modelName: z.string(), type: z.literal("additional_dimension")}), z.object({fieldName: z.string(), exploreName: z.string(), modelName: z.string(), type: z.literal("required_filter")}), z.object({targetName: z.string(), targetType: z.enum(["model", "dimension", "metric"]), modelName: z.string(), type: z.literal("ai_hint")})]); export const aiAgentConfigurationSetting = z.enum(["instructions", "knowledge_documents", "data_access", "self_improvement", "sql_mode", "mcp_servers", "explore_tags", "space_access", "user_or_group_access", "unknown"]); export const aiAgentTargetRef = z.union([aiAgentSemanticTargetRef, z.object({agentUuid: z.string(), type: z.literal("agent")}), z.object({setting: aiAgentConfigurationSetting, type: z.literal("agent_config")}), z.object({capabilityKey: z.string(), type: z.literal("product_capability")}), z.object({key: z.string(), type: z.literal("runtime")}), z.object({tileUuid: z.string().nullable(), dashboardUuid: z.string().nullable(), chartUuid: z.string().nullable(), type: z.literal("content")})]); export const aiAgentRecommendationAction = z.enum(["update_semantic_yaml", "update_agent_instructions", "add_knowledge_document", "enable_data_access", "enable_sql_mode", "enable_self_improvement", "configure_mcp_server", "adjust_explore_tags", "update_access", "route_to_product_work", "request_more_evidence", "no_action"]); export const aiAgentRecommendation = z.object({targetRefs: z.array(aiAgentTargetRef), rationale: z.string(), title: z.string(), actionType: aiAgentRecommendationAction}); export const aiPromptProposedChangePayload = z.union([z.object({entry: aiAgentJudgeProjectContextEntry, changeKind: z.literal("project_context")}), z.object({recommendation: aiAgentRecommendation, changeKind: z.literal("semantic_layer")})]); export const aiAgentEvidenceExcerpt = z.object({redacted: z.boolean(), text: z.string(), source: z.enum(["user_prompt", "assistant_answer", "next_user_prompt", "conversation_context", "tool_call", "tool_result", "agent_config"])}); export const aiAgentRootCause = z.enum(["semantic_layer", "project_context", "agent_configuration", "product_capability", "runtime_reliability", "feedback_quality", "not_a_failure", "ambiguous"]); export const aiAgentReviewRemediationStatus = z.enum(["queued", "running", "pr_open", "preview_ready", "resolved", "failed"]); export const aiPromptContextItem = z.union([z.object({chartKind: chartKind.nullable(), runtimeOverrides: aiChartRuntimeOverrides.nullable(), displayName: z.string().nullable(), pinnedVersionUuid: z.string().nullable(), chartSlug: z.string().nullable(), chartUuid: z.string(), type: z.literal("chart")}), z.object({runtimeOverrides: aiDashboardRuntimeOverrides.nullable(), displayName: z.string().nullable(), pinnedVersionUuid: z.string().nullable(), dashboardSlug: z.string().nullable(), dashboardUuid: z.string(), type: z.literal("dashboard")}), z.object({displayName: z.string().nullable(), promptUuid: z.string().nullable(), threadUuid: z.string(), type: z.literal("thread")}), z.object({path: z.string(), type: z.literal("file")}), z.object({fullName: z.string(), type: z.literal("repository")}), z.object({title: z.string().nullable(), status: aiAgentReviewItemPrState.nullable(), provider: pullRequestProvider.nullable(), prNumber: z.number().nullable(), prUrl: z.string(), type: z.literal("pull_request")}), z.object({payload: aiPromptProposedChangePayload, fingerprint: z.string(), type: z.literal("proposed_change")}), z.object({evidenceExcerpts: z.array(aiAgentEvidenceExcerpt), findingCount: z.number(), rootCause: aiAgentRootCause, title: z.string(), fingerprint: z.string(), type: z.literal("review_finding")}), z.object({projectName: z.string().nullable(), status: aiAgentReviewRemediationStatus.nullable(), previewThreadUuid: z.string().nullable(), previewProjectUuid: z.string(), type: z.literal("preview_environment")})]); export const aiPromptContext = z.array(aiPromptContextItem); export const aiAgentUser = z.object({name: z.string(), uuid: z.string()}); export const aiAgentMessageUserAiAgentUser = z.object({hidden: z.boolean(), steers: z.array(aiPromptSteer), context: aiPromptContext, user: aiAgentUser, createdAt: z.string(), message: z.string(), threadUuid: z.string(), uuid: z.string(), role: z.literal("user")}); export const apiAiAgentThreadMessageCreateResponse = z.object({results: aiAgentMessageUserAiAgentUser, 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 }; /** * POST /api/v1/projects/{projectUuid}/aiAgents/{agentUuid}/threads/{threadUuid}/messages */ export const createApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuidMessages = async (args: CreateApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuidMessagesArgs, options: CreateApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuidMessagesOptions) => { const {baseUrl, fetch: fetchFn = fetch} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/projects/${encodeURIComponent(String(args.projectUuid))}/aiAgents/${encodeURIComponent(String(args.agentUuid))}/threads/${encodeURIComponent(String(args.threadUuid))}/messages${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(apiAiAgentThreadMessageCreateResponse, await res.json()) };