feat(frontend): typed API client generated from the OpenAPI spec + gen-verify CI

[AgentWrapper]

Why (scope change)

This PR originally added the code-first OpenAPI generator + a frontend client. The backend generator has since landed on main (via #68/#65) and now covers projects and sessions — superseding this branch's backend work. Rather than duplicate it, this PR is repurposed to the parts main still lacks.

What's here

• frontend/src/api/schema.d.ts — generated from backend/internal/httpd/apispec/openapi.yaml via openapi-typescript (npm run gen:api). Covers projects, sessions, and orchestrators.
• frontend/src/api/client.ts — a small openapi-fetch client typed by that schema, so the renderer's request/response types come from the daemon contract instead of being hand-maintained.
• gen-verify CI job — regenerates the spec from Go and the TS client from the spec, failing if either committed artifact is stale. Backend drift is already covered by the apispec tests; this additionally guards the frontend artifact, which nothing else checks.

Verification

frontend: npm run gen:api ✓   npm run typecheck ✓
pipeline: go generate ./... + npm run gen:api reproduce the committed files with no drift

Rebased on current main; no overlap with the backend codegen or the recent CLI PRs.

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR introduces a typed openapi-fetch client for the Electron frontend, backed by the already-landed schema.ts generated from the backend OpenAPI spec. Port resolution is correctly deferred to the wiring layer rather than hardcoded.

• frontend/src/api/client.ts — exports createApiClient(baseUrl), baseURLForPort(port), and DEFAULT_PORT (documented as a last-resort fallback), plus re-exports paths and components types from schema.ts for renderer consumption.
• frontend/package.json / package-lock.json — adds openapi-fetch@0.17.0 and its openapi-typescript-helpers@0.1.0 transitive dep as runtime dependencies, correct for a tsc-only (non-bundler) Electron project.

Confidence Score: 5/5

Safe to merge — the change is a thin, well-documented client wrapper with no runtime logic beyond URL construction and type re-exports.

The client module introduces no application logic that could regress: it delegates URL construction to the caller, exports a fallback constant with explicit comments warning against relying on it, and passes types straight through from the generated schema. The dependency additions are minimal and the lock file hashes are well-formed.

No files require special attention.

Important Files Changed

Filename	Overview
frontend/src/api/client.ts	New typed API client wrapping openapi-fetch; correctly defers port/URL resolution to the caller, exports DEFAULT_PORT only as a documented fallback, and re-exports generated types for the renderer.
frontend/package.json	Adds openapi-fetch as a runtime dependency (correct placement for an Electron app built with tsc, not a bundler).
frontend/package-lock.json	Lock file updated with openapi-fetch@0.17.0 and its transitive dependency openapi-typescript-helpers@0.1.0; SHA-512 integrity hashes are well-formed.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Renderer Process] -->|calls| B[createApiClient baseUrl]
    C[Main Process / IPC] -->|reads running.json Port| D[baseURLForPort port]
    D -->|http://127.0.0.1:port| B
    E[DEFAULT_PORT = 3001] -.->|last-resort fallback only| D
    B -->|createClient paths baseUrl| F[openapi-fetch Client]
    F -->|typed GET/POST/PATCH/DELETE| G[Daemon /api/v1/...]
    H[schema.ts generated] -->|paths, components types| B

Loading

_{Reviews (2): Last reviewed commit: "fix(frontend): derive API base URL from ..." | Re-trigger Greptile}

[neversettle17-101]

Changes LGTM