Migrate Text-to-CAD (edit) to multi-file endpoint (#6066)

* start of migrate to multi file endpoint

* get some relative path stuff sorted

* blobifying files, and making selections work with imports working

* add write to disk

* warn about big projects

* update known circular

* update snapshot

* remove log

* tweak selection filters

* Update src/components/ModelingMachineProvider.tsx

Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>

* fmt

* fix one thing

* typo

* raw dog form data like a fucking peasant

* remove fake data

* fmt

* steal Kevin's stuff

* good progress

* clean up

* fix writing to files when response returns

* comment the terriable code

* push fix of sorts

* better fix

* spot of clean up

* fix: Needed to support the bad request flow, the toast will hang forever, the return control flows don't dismiss a forever toast

* fix: handling more error flows by dismissing the toast

* chore: leaving a comment for a confusing workflow

* fix: trying to clean up some async logic

* fix: trying to fix a few things at once...

* fix: fixing toast success

* fix: how did this desync?

* fix: removing useless logic, we write to disk ahead of time, the continue is to say ya no problem

* fix: typo

* Change back to `spawnChild`, forego `actors` by reference

* fix: updating PR comments

* fix: found a bug with paths from rust! it is actually OS paths!

* fix: updated type still is failing tsc

* fix: the type of the machine was wrong, we always set it to at least ''

* fix: idk man

* Fix happy path test (button labels)

---------

Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
Co-authored-by: Kevin Nadro <kevin@zoo.dev>
Co-authored-by: Frank Noirot <frankjohnson1993@gmail.com>
Co-authored-by: Kevin Nadro <nadr0@users.noreply.github.com>
Co-authored-by: Pierre Jacquier <pierre@zoo.dev>
This commit is contained in:
Kurt Hutten
2025-05-08 03:54:40 +10:00
committed by GitHub
parent f938364d54
commit 43d5a72514
19 changed files with 931 additions and 307 deletions

563
src/lib/promptToEdit.tsx Normal file
View File

@ -0,0 +1,563 @@
import type { SelectionRange } from '@codemirror/state'
import { EditorSelection, Transaction } from '@codemirror/state'
import type { Models } from '@kittycad/lib'
import { VITE_KC_API_BASE_URL } from '@src/env'
import { diffLines } from 'diff'
import toast from 'react-hot-toast'
import type { TextToCadMultiFileIteration_type } from '@kittycad/lib/dist/types/src/models'
import { getCookie, TOKEN_PERSIST_KEY } from '@src/machines/authMachine'
import { COOKIE_NAME } from '@src/lib/constants'
import { isDesktop } from '@src/lib/isDesktop'
import { openExternalBrowserIfDesktop } from '@src/lib/openWindow'
import { ActionButton } from '@src/components/ActionButton'
import { CustomIcon } from '@src/components/CustomIcon'
import {
ToastPromptToEditCadSuccess,
writeOverFilesAndExecute,
} from '@src/components/ToastTextToCad'
import { modelingMachineEvent } from '@src/editor/manager'
import { getArtifactOfTypes } from '@src/lang/std/artifactGraph'
import { topLevelRange } from '@src/lang/util'
import type { ArtifactGraph, SourceRange } from '@src/lang/wasm'
import crossPlatformFetch from '@src/lib/crossPlatformFetch'
import type { Selections } from '@src/lib/selections'
import { codeManager, editorManager, kclManager } from '@src/lib/singletons'
import { err, reportRejection } from '@src/lib/trap'
import { uuidv4 } from '@src/lib/utils'
import type { File as KittyCadLibFile } from '@kittycad/lib/dist/types/src/models'
import type { FileMeta } from '@src/lib/types'
import type { RequestedKCLFile } from '@src/machines/systemIO/utils'
type KclFileMetaMap = {
[execStateFileNamesIndex: number]: Extract<FileMeta, { type: 'kcl' }>
}
function sourceIndexToLineColumn(
code: string,
index: number
): { line: number; column: number } {
const codeStart = code.slice(0, index)
const lines = codeStart.split('\n')
const line = lines.length
const column = lines[lines.length - 1].length
return { line, column }
}
function convertAppRangeToApiRange(
range: SourceRange,
code: string
): Models['SourceRange_type'] {
return {
start: sourceIndexToLineColumn(code, range[0]),
end: sourceIndexToLineColumn(code, range[1]),
}
}
type TextToCadErrorResponse = {
error_code: string
message: string
}
async function submitTextToCadRequest(
body: {
prompt: string
source_ranges: Models['SourceRangePrompt_type'][]
project_name?: string
kcl_version: string
},
files: KittyCadLibFile[],
token: string
): Promise<TextToCadMultiFileIteration_type | Error> {
const formData = new FormData()
formData.append('body', JSON.stringify(body))
files.forEach((file) => {
formData.append('files', file.data, file.name)
})
const response = await fetch(
`${VITE_KC_API_BASE_URL}/ml/text-to-cad/multi-file/iteration`,
{
method: 'POST',
headers: {
Authorization: `Bearer ${token}`,
},
body: formData,
}
)
if (!response.ok) {
return new Error(`HTTP error! status: ${response.status}`)
}
const data = await response.json()
if ('error_code' in data) {
const errorData = data as TextToCadErrorResponse
return new Error(errorData.message || 'Unknown error')
}
return data as TextToCadMultiFileIteration_type
}
export async function submitPromptToEditToQueue({
prompt,
selections,
projectFiles,
token,
artifactGraph,
projectName,
}: {
prompt: string
selections: Selections | null
projectFiles: FileMeta[]
projectName: string
token?: string
artifactGraph: ArtifactGraph
}) {
const _token =
token && token !== ''
? token
: getCookie(COOKIE_NAME) || localStorage?.getItem(TOKEN_PERSIST_KEY) || ''
const kclFilesMap: KclFileMetaMap = {}
const endPointFiles: KittyCadLibFile[] = []
projectFiles.forEach((file) => {
let data: Blob
if (file.type === 'other') {
data = file.data
} else {
// file.type === 'kcl'
kclFilesMap[file.execStateFileNamesIndex] = file
data = new Blob([file.fileContents], { type: 'text/kcl' })
}
endPointFiles.push({
name: file.relPath,
data,
})
})
// If no selection, use whole file
if (selections === null) {
return submitTextToCadRequest(
{
prompt,
source_ranges: [],
project_name:
projectName !== '' && projectName !== 'browser'
? projectName
: undefined,
kcl_version: kclManager.kclVersion,
},
endPointFiles,
_token
)
}
// Handle manual code selections and artifact selections differently
const ranges: Models['SourceRangePrompt_type'][] =
selections.graphSelections.flatMap((selection) => {
const artifact = selection.artifact
const execStateFileNamesIndex = selection?.codeRef?.range?.[2]
const file = kclFilesMap?.[execStateFileNamesIndex]
const code = file?.fileContents || ''
const filePath = file?.relPath || ''
// For artifact selections, add context
const prompts: Models['SourceRangePrompt_type'][] = []
if (artifact?.type === 'cap') {
prompts.push({
prompt: `The users main selection is the end cap of a general-sweep (that is an extrusion, revolve, sweep or loft).
The source range most likely refers to "startProfile" simply because this is the start of the profile that was swept.
If you need to operate on this cap, for example for sketching on the face, you can use the special string ${
artifact.subType === 'end' ? 'END' : 'START'
} i.e. \`startSketchOn(someSweepVariable, face = ${
artifact.subType === 'end' ? 'END' : 'START'
})\`
When they made this selection they main have intended this surface directly or meant something more general like the sweep body.
See later source ranges for more context.`,
range: convertAppRangeToApiRange(selection.codeRef.range, code),
file: filePath,
})
let sweep = getArtifactOfTypes(
{ key: artifact.sweepId, types: ['sweep'] },
artifactGraph
)
if (!err(sweep)) {
prompts.push({
prompt: `This is the sweep's source range from the user's main selection of the end cap.`,
range: convertAppRangeToApiRange(sweep.codeRef.range, code),
file: filePath,
})
}
}
if (artifact?.type === 'wall') {
prompts.push({
prompt: `The users main selection is the wall of a general-sweep (that is an extrusion, revolve, sweep or loft).
The source range though is for the original segment before it was extruded, you can add a tag to that segment in order to refer to this wall, for example "startSketchOn(someSweepVariable, face = segmentTag)"
But it's also worth bearing in mind that the user may have intended to select the sweep itself, not this individual wall, see later source ranges for more context. about the sweep`,
range: convertAppRangeToApiRange(selection.codeRef.range, code),
file: filePath,
})
let sweep = getArtifactOfTypes(
{ key: artifact.sweepId, types: ['sweep'] },
artifactGraph
)
if (!err(sweep)) {
prompts.push({
prompt: `This is the sweep's source range from the user's main selection of the end cap.`,
range: convertAppRangeToApiRange(sweep.codeRef.range, code),
file: filePath,
})
}
}
if (artifact?.type === 'sweepEdge') {
prompts.push({
prompt: `The users main selection is the edge of a general-sweep (that is an extrusion, revolve, sweep or loft).
it is an ${
artifact.subType
} edge, in order to refer to this edge you should add a tag to the segment function in this source range,
and then use the function ${
artifact.subType === 'adjacent'
? 'getAdjacentEdge'
: 'getOppositeEdge'
}
See later source ranges for more context. about the sweep`,
range: convertAppRangeToApiRange(selection.codeRef.range, code),
file: filePath,
})
let sweep = getArtifactOfTypes(
{ key: artifact.sweepId, types: ['sweep'] },
artifactGraph
)
if (!err(sweep)) {
prompts.push({
prompt: `This is the sweep's source range from the user's main selection of the end cap.`,
range: convertAppRangeToApiRange(sweep.codeRef.range, code),
file: filePath,
})
}
}
if (artifact?.type === 'segment') {
if (!artifact.surfaceId) {
prompts.push({
prompt: `This selection is of a segment, likely an individual part of a profile. Segments are often "constrained" by the use of variables and relationships with other segments. Adding tags to segments helps refer to their length, angle or other properties`,
range: convertAppRangeToApiRange(selection.codeRef.range, code),
file: filePath,
})
} else {
prompts.push({
prompt: `This selection is for a segment (line, xLine, angledLine etc) that has been swept (a general-sweep, either an extrusion, revolve, sweep or loft).
Because it now refers to an edge the way to refer to this edge is to add a tag to the segment, and then use that tag directly.
i.e. \`fillet( radius = someInteger, tags = [newTag])\` will work in the case of filleting this edge
See later source ranges for more context. about the sweep`,
range: convertAppRangeToApiRange(selection.codeRef.range, code),
file: filePath,
})
let path = getArtifactOfTypes(
{ key: artifact.pathId, types: ['path'] },
artifactGraph
)
if (!err(path) && path.sweepId) {
const sweep = getArtifactOfTypes(
{ key: path.sweepId, types: ['sweep'] },
artifactGraph
)
if (!err(sweep)) {
prompts.push({
prompt: `This is the sweep's source range from the user's main selection of the edge.`,
range: convertAppRangeToApiRange(sweep.codeRef.range, code),
file: filePath,
})
}
}
}
}
if (!artifact) {
// manually selected code is more likely to not have an artifact
// an example might be highlighting the variable name only in a variable declaration
prompts.push({
prompt: '',
range: convertAppRangeToApiRange(selection.codeRef.range, code),
file: filePath,
})
}
return prompts
})
return submitTextToCadRequest(
{
prompt,
source_ranges: ranges,
project_name:
projectName !== '' && projectName !== 'browser'
? projectName
: undefined,
kcl_version: kclManager.kclVersion,
},
endPointFiles,
_token
)
}
export async function getPromptToEditResult(
id: string,
token?: string
): Promise<Models['TextToCadMultiFileIteration_type'] | Error> {
const url = VITE_KC_API_BASE_URL + '/async/operations/' + id
const data: Models['TextToCadMultiFileIteration_type'] | Error =
await crossPlatformFetch(
url,
{
method: 'GET',
},
token
)
return data
}
export async function doPromptEdit({
prompt,
selections,
projectFiles,
token,
artifactGraph,
projectName,
}: {
prompt: string
selections: Selections
projectFiles: FileMeta[]
token?: string
projectName: string
artifactGraph: ArtifactGraph
}): Promise<Models['TextToCadMultiFileIteration_type'] | Error> {
const toastId = toast.loading('Submitting to Text-to-CAD API...')
let submitResult
// work around for @kittycad/lib not really being built for the browser
;(window as any).process = {
env: {
ZOO_API_TOKEN: token,
ZOO_HOST: VITE_KC_API_BASE_URL,
},
}
try {
submitResult = await submitPromptToEditToQueue({
prompt,
selections,
projectFiles,
token,
artifactGraph,
projectName,
})
} catch (e: any) {
toast.dismiss(toastId)
return new Error(e.message)
}
if (submitResult instanceof Error) {
toast.dismiss(toastId)
return submitResult
}
const textToCadComplete = new Promise<
Models['TextToCadMultiFileIteration_type']
>((resolve, reject) => {
;(async () => {
const MAX_CHECK_TIMEOUT = 3 * 60_000
const CHECK_DELAY = 200
let timeElapsed = 0
while (timeElapsed < MAX_CHECK_TIMEOUT) {
const check = await getPromptToEditResult(submitResult.id, token)
if (
check instanceof Error ||
check.status === 'failed' ||
check.error
) {
reject(check)
return
} else if (check.status === 'completed') {
resolve(check)
return
}
await new Promise((r) => setTimeout(r, CHECK_DELAY))
timeElapsed += CHECK_DELAY
}
reject(new Error('Text-to-CAD API timed out'))
})().catch(reportRejection)
})
try {
const result = await textToCadComplete
toast.dismiss(toastId)
return result
} catch (e) {
toast.dismiss(toastId)
toast.error(
'Failed to edit your KCL code, please try again with a different prompt or selection'
)
console.error('textToCadComplete', e)
}
return textToCadComplete
}
/** takes care of the whole submit prompt to endpoint flow including the accept-reject toast once the result is back */
export async function promptToEditFlow({
prompt,
selections,
projectFiles,
token,
artifactGraph,
projectName,
}: {
prompt: string
selections: Selections
projectFiles: FileMeta[]
token?: string
artifactGraph: ArtifactGraph
projectName: string
}) {
const result = await doPromptEdit({
prompt,
selections,
projectFiles,
token,
artifactGraph,
projectName,
})
if (err(result)) {
toast.error('Failed to modify.')
return Promise.reject(result)
}
const oldCodeWebAppOnly = codeManager.code
if (!isDesktop() && Object.values(result.outputs).length > 1) {
const toastId = uuidv4()
toast.error(
(t) => (
<div className="flex flex-col gap-2">
<p>Multiple files were returned from Text-to-CAD.</p>
<p>You need to use the desktop app to support this.</p>
<div className="flex justify-between items-center mt-2">
<>
<a
href="https://zoo.dev/modeling-app/download"
target="_blank"
rel="noopener noreferrer"
className="text-blue-400 hover:text-blue-300 underline flex align-middle"
onClick={openExternalBrowserIfDesktop(
'https://zoo.dev/modeling-app/download'
)}
>
<CustomIcon
name="link"
className="w-4 h-4 text-chalkboard-70 dark:text-chalkboard-40"
/>
Download Desktop App
</a>
</>
<ActionButton
Element="button"
iconStart={{
icon: 'close',
}}
name="Dismiss"
onClick={() => {
toast.dismiss(toastId)
}}
>
Dismiss
</ActionButton>
</div>
</div>
),
{
id: toastId,
duration: Infinity,
icon: null,
}
)
return
}
if (isDesktop()) {
const requestedFiles: RequestedKCLFile[] = []
for (const [relativePath, fileContents] of Object.entries(result.outputs)) {
requestedFiles.push({
requestedCode: fileContents,
requestedFileName: relativePath,
requestedProjectName: projectName,
})
}
await writeOverFilesAndExecute({
requestedFiles,
projectName,
})
} else {
const newCode = result.outputs['main.kcl']
codeManager.updateCodeEditor(newCode)
const diff = reBuildNewCodeWithRanges(oldCodeWebAppOnly, newCode)
const ranges: SelectionRange[] = diff.insertRanges.map((range) =>
EditorSelection.range(range[0], range[1])
)
editorManager?.editorView?.dispatch({
selection: EditorSelection.create(
ranges,
selections.graphSelections.length - 1
),
annotations: [modelingMachineEvent, Transaction.addToHistory.of(false)],
})
await kclManager.executeCode()
}
const toastId = uuidv4()
toast.success(
() =>
ToastPromptToEditCadSuccess({
toastId,
data: result,
token,
oldCodeWebAppOnly,
oldFiles: projectFiles,
}),
{
id: toastId,
duration: Infinity,
icon: null,
}
)
}
const reBuildNewCodeWithRanges = (
oldCode: string,
newCode: string
): {
newCode: string
insertRanges: SourceRange[]
} => {
let insertRanges: SourceRange[] = []
const changes = diffLines(oldCode, newCode)
let newCodeWithRanges = ''
for (const change of changes) {
if (!change.added && !change.removed) {
// no change add it to newCodeWithRanges
newCodeWithRanges += change.value
} else if (change.added && !change.removed) {
const start = newCodeWithRanges.length
const end = start + change.value.length
insertRanges.push(topLevelRange(start, end))
newCodeWithRanges += change.value
}
}
return {
newCode: newCodeWithRanges,
insertRanges,
}
}