Skip to content

QVAC-23971 feat[api]: describe OCR modelConfig fields - #4062

Open
lauripiisang wants to merge 1 commit into
mainfrom
QVAC-23971-describe-ocr
Open

QVAC-23971 feat[api]: describe OCR modelConfig fields#4062
lauripiisang wants to merge 1 commit into
mainfrom
QVAC-23971-describe-ocr

Conversation

@lauripiisang

Copy link
Copy Markdown
Contributor

🎯 What problem does this PR solve?

  • The OCR (ggml-ocr) modelConfig fields shipped without descriptions, so the generated contract (contract/schema.json) — consumed by qvac configure, the typed-client generators, and the Python generator — couldn't say what any field means.

📝 How does it solve it?

  • Adds .describe() to every ocrConfigSchema field: langList, pipelineType, magRatio, canvasSize, defaultRotationAngles, contrastRetry, lowConfidenceThreshold, recognizerBatchSize, nThreads, backendDevice, gpuDevice, detectorModelSrc.
  • Text sourced from @qvac/ocr-ggml index.d.ts (OcrGgmlParams JSDoc) — no invented semantics. detectorModelSrc is noted as derived from the recognizer model source when omitted.
  • Regenerates contract/schema.json and the Python generated models.

Part of QVAC-23933.

🧪 How was it tested?

  • bun run contract:export regenerated; contract:check, typecheck, lint, format, and full test:unit (incl. contract-export freshness) pass.
  • packages/inference typecheck + lint pass.
  • packages/sdk-python generate.py --check passes.

🔌 API Changes

Additive only:

ocrConfigSchema.shape.pipelineType.description
// "OCR pipeline: 'easyocr' (CRAFT detector + CRNN recognizer, default) or 'doctr' (…language-agnostic)."

@lauripiisang
lauripiisang requested review from a team as code owners August 25, 2026 14:55
@github-actions

Copy link
Copy Markdown
Contributor

Review Status

Current Status: ❌ PENDING
Approvals so far: none

Pending reviews: Needs 1 Management or Team Lead, and 1 more from Management, Team Lead, or Member.

@github-actions

Copy link
Copy Markdown
Contributor

License compliance — clean

No new dependency license findings in this PR.

Warn-only (shadow) mode — this check does not block merges yet.

Updated automatically by the canonical license compliance workflow.

NOTICE presence (advisory)

Missing NOTICE (advisory, does not block):

  • ./.github/actions/release-merge-guard
  • ./docs/website
  • ./packages/ggml-coload-smoke
  • ./packages/fabric/test/integration
  • ./packages/inference-addon-cpp/mobile
  • ./packages/sdk/e2e
  • ./packages/llm-llamacpp/benchmarks/performance
  • ./packages/llm-llamacpp/benchmarks/server
  • ./packages/vla-ggml/sim/server
  • ./packages/embed-llamacpp/benchmarks/performance
  • ./packages/embed-llamacpp/benchmarks/server
  • ./packages/asr-ggml/benchmarks/server

- Add .describe() to every ocrConfigSchema field (langList, pipelineType, magRatio, canvasSize, defaultRotationAngles, contrastRetry, lowConfidenceThreshold, recognizerBatchSize, nThreads, backendDevice, gpuDevice, detectorModelSrc)
- Sourced from @qvac/ocr-ggml index.d.ts (OcrGgmlParams); detectorModelSrc noted as derived from the recognizer source when omitted
- Regenerate contract/schema.json and the Python generated models
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants