feat: fe overhaul api changes (#1639)

* api changes

* generate

* pkg

* backmerge main

* revert to main

* revert main

Taskfile.yaml

@@ -53,6 +53,12 @@ tasks:
         SERVER_INTERNAL_CLIENT_BASE_STRATEGY=none
         SERVER_INTERNAL_CLIENT_BASE_INHERIT_BASE=false
         EOF
+  pre:
+    cmds:
+      # FIXME: Remove this once we have a better way to handle pre-commit reliably
+      - pre-commit run --all-files
+      - pre-commit run --all-files
+      - pre-commit run --all-files
   start-db:
     cmds:
       - docker compose up -d
@@ -185,5 +191,10 @@ tasks:
       - pre-commit run --all-files || pre-commit run --all-files
   docs:
     cmds:
-      - npx serve -l 4001 &
-      - cd frontend/docs/ && pnpm run dev
+      - |
+        # Create a trap to kill the watcher when the task exits
+        trap 'kill $(jobs -p) 2>/dev/null' EXIT
+
+        npx chokidar "sdks/**/*.{py,ts,go}" --ignore "**/node_modules/**" --ignore "**/.git/**" --ignore "**/dist/**" --ignore "**/build/**" --initial -c "echo 'TODO: Add a task to generate and sync the docs'" &
+
+        cd frontend/docs/ && pnpm run taskfile-dev