cadSet/text-to-cad/apps/cad-agent-studio

CAD Agent Studio

CAD Agent Studio is a two-pane web app for agent-driven CAD work:

• left pane: agent chat, uploads, provider/model selection, and Viewer context cards
• right pane: embedded 3D preview and CAD edit toolbar

Setup

Configure providers in ../../config/llm.config.yaml. Prefer putting secrets in the environment:

OPENAI_API_KEY=...
OPENAI_BASE_URL=https://api.openai.com/v1
DEEPSEEK_API_KEY=...

OPENAI_BASE_URL can point at an OpenAI-compatible third-party endpoint.

For local-only setups, providers may also use apiKey: sk-... directly in the YAML. If apiKeyEnv accidentally contains a key value instead of an environment variable name, the server treats it as a direct key for compatibility.

Run

npm install
npm run dev -- -H 127.0.0.1 -p 53821

Open http://127.0.0.1:53821.

CAD Flow

Uploads are stored under ../../models/agent-studio/<taskId>. STEP/STP uploads write a cad-task.json manifest and are converted to an STL preview sidecar for the embedded right-pane WebGL renderer.

CAD Agent Studio does not start the standalone CAD Viewer service. Generated models keep STEP as the primary CAD artifact and export STL as a preview mesh. The right-pane toolbar mirrors the CAD Viewer edit tool set and interaction shape, but tool picks are attached to the next agent request as structured cadViewer.editIntent / cadViewer.selection context instead of being copied to the clipboard. The handoff is silent in the UI: no success modal, no copied text panel.

Modification requests create revision folders with edit-request.json. The generation adapter should apply that request to the editable source recorded in cad-task.json; STEP-only uploads are marked as reconstructed edits.