Backroom

Submit an invoice PDF for extraction. Reads the local file at pdf_path and uploads it to Backroom. Returns the intake receipt: job_id (null when the submission was deduplicated against an earlier identical document), invoice_id, the deduped flag, and the caller's updated usage meter. Poll the job with get_job, then read the result with get_proposal.

Submit an invoice PDF and wait for the job to finish. Submits the PDF, then polls the job with backoff until it reaches a terminal state (done or failed) or timeout_seconds elapse. Returns {"status", "intake", "job"}: on "completed", job carries the terminal payload — its outcome ("proposal", "needs_human", "failed", "duplicate"), its reason_code when the job ended without a proposal, and proposal_id when one was issued. This tool deliberately does NOT fetch the proposal itself: proposal fetches are exactly-once, so the fetch is left as an explicit get_proposal call whose result the caller keeps. On "timed_out", job holds the last seen state; keep polling with get_job.

Get an extraction job's state and terminal payload. While running, returns the job's state. When done, includes the outcome ("proposal", "needs_human", "failed", "duplicate"), the reason_code when the job ended without a proposal (for example NO_EXTRACTABLE_TEXT for a scan with no readable text), and the proposal_id when a proposal was issued.

Fetch an extraction proposal by id. FETCH EXACTLY ONCE. WARNING: the API purges the result on the first successful fetch (zero retention) — a second fetch of the same id returns 404. Keep everything this call returns; you cannot fetch it again. The proposal is returned exactly as the API serves it: every field is an object {value, status, confidence, provenance, reason} where status is "verified", "extracted", or "unclear". An unclear field has a null value — it was not guessed.

Get the caller's usage meter for the current calendar month. Returns documents_used, the monthly cap, remaining documents, and the period covered, for the API key in BACKROOM_API_KEY.

无需输入参数。

Check the Backroom API's health (no API key required). Returns the service status object, including model-provider availability, exactly as the API reports it.

无需输入参数。