import {z} from 'zod' export type GetApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuidArgs = {projectUuid: string, agentUuid: string, threadUuid: string}; export type GetApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuidOptions = {baseUrl: string, fetch?: typeof fetch | undefined}; export const aiAgentUser = z.object({name: z.string(), uuid: z.string()}); export const aiThreadCreatedFrom = z.enum(["slack", "web_app", "evals", "scheduler"]); export const aiThreadCompaction = z.object({createdAt: z.string(), triggeringPromptUuid: z.string(), compactedThroughPromptUuid: z.string(), threadUuid: z.string(), uuid: z.string()}); 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 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 aiPromptTokenUsage = z.object({totalTokens: z.number()}); export const aiAgentModelConfig = z.object({reasoning: z.boolean().optional(), modelProvider: z.string(), modelName: z.string()}); export const aiAgentMessageAssistantArtifact = z.object({description: z.string().nullable(), title: z.string().nullable(), versionUuid: z.string(), artifactUuid: z.string(), versionNumber: z.number(), artifactType: z.enum(["chart", "dashboard"])}); export const aiAgentReasoning = z.object({createdAt: z.string(), text: z.string(), reasoningId: z.string(), promptUuid: z.string(), uuid: z.string()}); export const excludeToolNameNever = z.enum(["generateDashboard", "generateVisualization", "runSql", "findContent", "generateBarVizConfig", "generateTableVizConfig", "generateTimeSeriesVizConfig", "generateHashes", "generateUuids", "listContent", "findExplores", "findFields", "searchSemanticLayer", "analyzeFieldImpact", "discoverFields", "grepFields", "getMetadata", "searchFieldValues", "findDashboards", "findCharts", "getDashboardCharts", "readContent", "resolveUrl", "editContent", "createContent", "createScheduledDelivery", "updateUserName", "runContentQuery", "improveContext", "listProjects", "getProjectInfo", "loadSkill", "loadProjectContext", "editDbtProject", "editProjectContext", "editRepo", "syncDbtProject", "exploreRepo", "discoverRepos", "listWorkstreams", "closePullRequest", "getPullRequestDiff", "setupPreviewDeploy", "runQuery", "runSavedChart", "listWarehouseTables", "describeWarehouseTable", "listKnowledgeDocuments", "getKnowledgeDocumentContent", "readPinnedThread"]); export const recordStringUnknown = z.record(z.string(), z.unknown()); export const aiAgentMcpToolName = z.string(); export const aiAgentToolResult = z.union([z.object({toolCallId: z.string(), createdAt: z.string(), result: z.string(), promptUuid: z.string(), uuid: z.string(), metadata: z.union([z.object({status: z.enum(["error", "success"])}), z.object({ranking: z.object({topMatchingFields: z.array(z.object({verifiedChartUsage: z.number().nullable().optional(), chartUsage: z.number().nullable().optional(), searchRank: z.number().nullable().optional(), fieldType: z.string(), tableName: z.string(), label: z.string(), name: z.string()})).optional(), exploreSearchResults: z.array(z.object({searchRank: z.number().nullable().optional(), requiredFilters: z.array(z.object({settings: z.unknown(), values: z.array(z.unknown()).optional(), fieldRef: z.string(), fieldId: z.string(), tableName: z.string(), operator: z.string(), required: z.boolean()})).optional(), joinedTables: z.array(z.string()).nullable().optional(), label: z.string(), name: z.string()})).optional(), searchQuery: z.string()}).optional(), status: z.enum(["error", "success"])}), z.object({ranking: z.object({searchQueries: z.array(z.object({pagination: z.object({totalPageCount: z.number(), totalResults: z.number(), pageSize: z.number(), page: z.number()}).optional(), status: z.enum(["error", "success"]).optional(), error: z.string().optional(), results: z.array(z.object({verifiedChartUsage: z.number().nullable().optional(), chartUsage: z.number().nullable().optional(), searchRank: z.number().nullable().optional(), fieldType: z.string(), tableName: z.string(), label: z.string(), name: z.string()})), label: z.string()}))}).optional(), status: z.enum(["error", "success"])}), z.object({contentSizeBytes: z.number(), status: z.literal("success"), name: z.string()}), z.object({status: z.literal("error")}), z.object({status: z.enum(["error", "success", "not_found"])}), z.object({streamingMessage: z.unknown(), status: z.literal("streaming")}), z.object({streamingMessage: z.unknown(), discovery: z.union([z.object({fields: z.array(z.object({isFromJoinedTable: z.boolean(), caseSensitiveFilters: z.enum(["true", "false", "not_applicable"]), fieldValueType: z.string(), fieldFilterType: z.string(), description: z.string().nullable(), fieldType: z.enum(["metric", "dimension"]), table: z.string(), fieldId: z.string(), label: z.string(), name: z.string()})), rationale: z.string().nullable(), explore: z.object({requiredFilters: z.array(z.object({settings: z.unknown(), values: z.array(z.unknown()).optional(), fieldRef: z.string(), fieldId: z.string(), tableName: z.string(), operator: z.string(), required: z.boolean()})).optional(), joinedTables: z.array(z.string()), baseTable: z.string(), label: z.string(), name: z.string()}), status: z.literal("resolved")}), z.object({suggestedQuestion: z.string(), candidates: z.array(z.object({exploreLabel: z.string(), reason: z.string(), exploreName: z.string()})), status: z.literal("ambiguous")}), z.object({reason: z.string(), status: z.literal("no_match")})]), status: z.literal("success")}), z.object({versionUuids: z.object({after: z.string().nullable(), before: z.string().nullable()}), href: z.string(), warnings: z.array(z.string()), status: z.literal("success"), slug: z.string(), uuid: z.string(), name: z.string()}), z.object({aiWritebackRunUuid: z.string(), status: z.literal("pending")}), z.object({dbtSourceOptions: z.array(z.object({projectSubPath: z.string().nullable(), branch: z.string().nullable(), isPrimary: z.boolean(), projectDbtSourceUuid: z.string(), repository: z.string().nullable(), name: z.string()})).nullable().optional(), needsDbtSourceSelection: z.boolean().nullable().optional(), previewUrl: z.string().nullable().optional(), deletions: z.number().nullable().optional(), additions: z.number().nullable().optional(), commitSha: z.string().nullable().optional(), prAction: z.enum(["opened", "updated", "null"]).nullable().optional(), steps: z.array(z.object({kind: z.enum(["search", "read", "edit", "compile", "stage"]), label: z.string()})).nullable().optional(), prUrl: z.string().nullable(), status: z.literal("success")}), z.object({errorCode: z.enum(["unknown", "unsupported_source_control", "github_not_installed", "gitlab_not_installed", "pull_request_not_open", "git_write_permission", "null"]).nullable().optional(), status: z.literal("error")}), z.object({href: z.string(), status: z.literal("success"), slug: z.string(), name: z.string()}), z.object({chartImageUrl: z.string().nullable().optional(), status: z.enum(["error", "success"])}), z.object({status: z.enum(["error", "rejected", "success", "timeout"])}), z.object({ranking: z.object({searchQuery: z.string().nullable(), fields: z.array(z.object({chartUsage: z.number().nullable().optional(), searchRank: z.number().nullable().optional(), fieldType: z.string(), tableName: z.string(), label: z.string(), name: z.string()})), type: z.enum(["metric", "dimension", "null"]).nullable()}).optional(), status: z.enum(["error", "success"])})]), toolName: excludeToolNameNever, toolType: z.literal("built-in")}), z.object({toolCallId: z.string(), createdAt: z.string(), result: z.string(), promptUuid: z.string(), uuid: z.string(), metadata: recordStringUnknown.nullable(), toolName: aiAgentMcpToolName, toolType: z.literal("mcp")})]); export const aiAgentToolCallMcpServer = z.object({name: z.string(), uuid: z.string(), iconUrl: z.string().nullable()}); export const aiAgentToolCall = z.union([z.object({toolArgs: z.record(z.string(), z.unknown()), createdAt: z.string(), parentToolCallId: z.string().nullable(), toolCallId: z.string(), promptUuid: z.string(), uuid: z.string(), toolName: z.string(), toolType: z.literal("built-in")}), z.object({toolArgs: z.record(z.string(), z.unknown()), createdAt: z.string(), parentToolCallId: z.string().nullable(), toolCallId: z.string(), promptUuid: z.string(), uuid: z.string(), mcpServer: aiAgentToolCallMcpServer.nullable(), toolName: aiAgentMcpToolName, toolType: z.literal("mcp")})]); export const aiAgentMessageAssistant = z.object({tokenUsage: aiPromptTokenUsage.nullable(), modelConfig: aiAgentModelConfig.nullable(), referencedArtifacts: z.array(aiAgentMessageAssistantArtifact).nullable(), artifacts: z.array(aiAgentMessageAssistantArtifact).nullable(), savedQueryUuid: z.string().nullable(), reasoning: z.array(aiAgentReasoning), toolResults: z.array(aiAgentToolResult), toolCalls: z.array(aiAgentToolCall), humanFeedback: z.string().nullable().optional(), humanScore: z.number().nullable(), createdAt: z.string(), interrupted: z.boolean(), errorMessage: z.string().nullable(), message: z.string().nullable(), threadUuid: z.string(), uuid: z.string(), status: z.enum(["idle", "pending", "error"]), role: z.literal("assistant")}); export const aiAgentMessageAiAgentUser = z.union([aiAgentMessageUserAiAgentUser, aiAgentMessageAssistant]); export const aiAgentThread = z.object({user: aiAgentUser, firstMessage: z.object({message: z.string(), uuid: z.string()}), titleGeneratedAt: z.string().nullable(), title: z.string().nullable(), createdFrom: aiThreadCreatedFrom, createdAt: z.string(), agentUuid: z.string(), uuid: z.string(), compactions: z.array(aiThreadCompaction), messages: z.array(aiAgentMessageAiAgentUser)}); export const apiAiAgentThreadResponse = z.object({results: aiAgentThread, 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 /api/v1/projects/{projectUuid}/aiAgents/{agentUuid}/threads/{threadUuid} */ export const getApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuid = async (args: GetApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuidArgs, options: GetApiApiV1ProjectsProjectUuidAiAgentsAgentUuidThreadsThreadUuidOptions) => { 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/projects/${encodeURIComponent(String(args.projectUuid))}/aiAgents/${encodeURIComponent(String(args.agentUuid))}/threads/${encodeURIComponent(String(args.threadUuid))}${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(apiAiAgentThreadResponse, await res.json()) };