Audit Standard Book
audit_standard_bookAudits one Standard Books document — a set of books: chart, journal, registers, parties and recorded documents — for bookkeeping errors. Supply the book by transfer handle (a sealed book package, a book body, or {book, annotations}), or a small one inline as book. The book is authenticated when sealed and admitted under book law before anything is spent; a book sealed under an older format is refused and must be resealed.
Exact controls are computed in arithmetic with no model: unbalanced entries, entries outside the period, balances opened with nothing stating them or against equity (alone or in a multi-account opening), income debited by purchases, credits beyond the charge. Findings are model judgments over the whole book at once, laid out as a bookkeeper reads it, and each finding quotes the entries and documents it rests on, in ASCII, checked against the book before it is accepted: a purchase posted to income, an opening bill expensed again, a refund or credit that does not match its sale, conflicting dates, entries that need support, and more. Every finding is a question for the bookkeeper with its evidence; certainty says whether it is a confirmed discrepancy, a suspected error or missing information.
Nothing is changed: not the book, not the workspace. The result is a summary with the exact controls inline and the whole report — every finding, citation and question — behind a multi-read download handle; analysed_book_handle names the book with this audit written on it as its analysis, sealed. A book already carrying its own audit, or already audited in this workspace, is answered with no model run; a call for a book whose audit is running attaches to that run, so after a timeout call again with the same book. status is reviewed, needs_information, or incomplete when a request could not be answered (incomplete names which). Findings vary between runs and do not certify that problems are absent. Model-backed and metered; typically three to five minutes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book | No | A small book inline: a sealed book package, a book body, or {book, annotations}. Exclusive with handle. | |
| handle | No | Workspace-scoped transfer handle (upload:N or download:N) naming the book: a sealed book package, a book body, or {book, annotations}. The usual path; a book is hundreds of kilobytes. | |
| workspace_tag | Yes | Active workspace id (the workspace_tag create_workspace and list_workspaces return). Scopes the call and its metered usage. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book | Yes | Which book was audited: identity, chart_identity, name, reporting_currency and its counts, as verify_standard_document reports them. | |
| engine | Yes | Stamped engine build/version identity for the tool result. | |
| handle | Yes | Multi-read download:N handle naming the whole report: status, controls, findings (kind, certainty, summary, accountIds, entryIds, citations, questions), questions, incomplete and limitations. | |
| status | Yes | reviewed (nothing found), needs_information (controls or findings to answer), or incomplete (a request could not be answered). | |
| controls | Yes | The exact controls: code, message, question, postings, reports and evidence. | |
| retained | Yes | Download descriptor for the report: session_id, handle, file_name, media_type, byte_count, sha256, expires_at, download_program. | |
| incomplete | Yes | Requests that could not be answered: scope (the chart accounts) and message. Empty unless status is incomplete. | |
| analysed_book | No | Download descriptor for the analysed book. | |
| control_count | Yes | Exact arithmetic controls that fired. | |
| finding_count | Yes | Findings in the report; one problem reported from several accounts counts once. | |
| finding_kinds | Yes | Findings per kind: opening_balance_gap, expense_in_revenue, opening_liability_expense, refund_mismatch, credit_mismatch, date_conflict, missing_support, other_book_issue. | |
| workspace_tag | Yes | Workspace scoped by the tool call. | |
| question_count | Yes | Questions for the bookkeeper across controls and findings. | |
| analysed_book_handle | No | Multi-read download:N handle naming the book with this audit written on it as its analysis, sealed: the book again, not a new one (its identity is unchanged). |