{"server":"FactLot","checked":"2026-11-22","tools":[{"name":"audit_expense_portfolio","title":"Audit many expense statements at once","description":"Audit many landlord operating-expense (CAM) statements at once, for a tenant with many locations or for a lease audit firm or tenant-rep broker acting for one. Takes up to 50 audits, each the input audit_expense_statement takes (the lease's verified facts, the statement's verified facts, optionally the prior year's lines) plus a label and optionally the landlord, and one as_of date for all. Runs audit_expense_statement on each location (the same function, not a second implementation). Returns, per location, the audit's summary (findings by class, dollars at stake by class, the dispute deadline, the checks that could not run), its findings in short form with lease and statement pages, a reference to its full result (digests of its input and result; include_results returns the whole result) and its own package_items for fact_package_send; across the portfolio, totals by finding class and by check, dollars at stake in total and by landlord, the locations ranked by dollars at stake, dispute deadlines in date order with days remaining counted from as_of, repeated issues (the same check failing at several locations, or in several statement years for one landlord) and the locations whose input failed validation, each with its issues (the other locations are still audited). Deterministic and no model: same inputs, same answer, no clock. Findings are differences against quoted terms, not legal conclusions. On the hosted API the answer carries, for each location, its own attestation (the one audit_expense_statement returns for that location's input), so each location's package is sent to its own landlord and checked on its own through fact_package_send; a service without a signing key returns none and says so. On the hosted API, callers without a Pro or Team key get the summary only (counts and totals); the one free full document of an email-verified account covers a single audit (audit_expense_statement), not a portfolio, and the answer says so. Metering: the portfolio report (report_create kind expense_audit_portfolio) counts one unit of the monthly report allowance for each location audited in full (report_units); this tool call is not counted, as audit_expense_statement is not.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"audits":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"label":{"description":"Required: the location's name as the person knows it (a store number, a property name, a suite), 1 to 120 characters, unique within the call. Printed in the answer and the report."},"landlord":{"description":"Optional: the landlord organisation named on the statement, as typed (at most 200 characters). Locations with the same landlord (compared by letters and digits only) are totalled together and checked for repeated issues. Left out: the location is totalled under 'Landlord not named'."},"lease_facts":{"description":"Required: the location's lease facts, exactly as audit_expense_statement's lease_facts (an array of verified facts, each with its quote and page)."},"statement_facts":{"description":"Required: the landlord's statement as verified facts, exactly as audit_expense_statement's statement_facts."},"prior_statement_facts":{"description":"Optional: the prior year's statement.line and statement.period facts for this location, as audit_expense_statement's prior_statement_facts."},"yoy_threshold":{"description":"Optional: this location's year-over-year threshold, a number above 0 and at most 10, as audit_expense_statement's yoy_threshold. Default: the call's yoy_threshold."}},"additionalProperties":{}},"description":"Up to 50 audits, one per location (or per location and year), each the input audit_expense_statement takes (lease_facts, statement_facts, prior_statement_facts, yoy_threshold) plus a label and optionally the landlord. An entry that fails validation is reported with its issues under locations_invalid and the others are audited; the call does not fail for it."},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Today's date, YYYY-MM-DD, for every location. The tool reads no clock: every deadline's days remaining is counted from this date."},"yoy_threshold":{"default":0.1,"description":"A line that rose by more than this fraction over the prior year is listed as a question to ask (default 0.10 = 10%), for every location that does not set its own. Must be greater than 0.","type":"number","maximum":10,"minimum":0},"include_results":{"default":false,"description":"True: each location also carries its whole audit_expense_statement result (every finding with its quotes, pages and calculation steps) under result. Default false: each location carries its summary, its findings in short form and result_ref (the digests of its input and result, to check a result against).","type":"boolean"}},"required":["audits","as_of"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"audit_expense_statement","title":"Audit a landlord's expense statement against the lease","description":"Audit a landlord's operating-expense (CAM) statement for a tenant, from verified facts only. Give the lease's facts (doc_abstract_lease or doc_verify_facts: pro-rata share, cap, base year or stop, admin fee, gross-up, excluded categories, capital-item treatment, audit right) and the statement's facts (each billed line, share applied, fee, gross-up, cap applied, totals, estimates, the date the tenant received it), each with its quote and page and passing fact_validate; optionally the prior year's lines. Returns findings, each with a stable code, the landlord's figure, the figure the lease yields, the dollar difference, the lease and statement fact ids with the quotes and pages, the calculation steps, a confidence class (follows_from_terms: the arithmetic follows from a quoted term and the statement's own numbers; depends_on_reading: it depends on how the lease sentence is read; question_to_ask: a question, never an overcharge) and what a person must confirm; totals; the last day to dispute or invoke the audit right with the notice form the lease requires; whether the difference crosses the lease's cost-shifting threshold; package_items ready for fact_package_send (state_ours with the landlord's figure as their_value for each finding, accept_theirs for lines with no finding); and checks_not_run with the reason (a missing lease term is never guessed). Twelve checks: management fee, cap, capital items, gross-up, pro-rata share, excluded categories, duplicates, base year or stop, arithmetic, year over year, deadlines, cost-shifting. Deterministic and no model: a finding without a verified lease fact behind it is never produced; same inputs, same findings; as_of is an input. Findings are differences against quoted terms, not legal conclusions: each finding carries its quote, for a person to review before anything is sent. On the hosted API the whole answer also carries attestation, the service's signature over the items, grades and figures that fact_package_send carries, so the FactLot record can show them as computed by FactLot and unchanged since; a service without a signing key returns none and says so. On the hosted API, callers without a Pro or Team key get the summary only (finding count, total difference, deadlines, checks not run) and the answer says what is withheld. Each free, email-verified account (an fl_free_ key) gets one whole document in total across audit_expense_statement, estoppel_prepare and rent_roll_certify: that answer says so, and the report built from the same arguments is included for 24 hours; Pro and Team include every document with the monthly allowance.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"lease_facts":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":"The lease's verified facts (doc_abstract_lease's facts, or doc_verify_facts' verified[].fact), each with its quote and page. Read by predicate: lease.pro_rata_share (number; required: every finding rests on it), lease.pro_rata_basis {tenant_sf, building_sf}, lease.cam_cap {method, rate} or, when the lease says only 'cumulative' or 'non-cumulative' and not how, lease.cam_cap_rate {rate} (the audit then shows the figure under each of the three methods), lease.operating_expense_base_year (integer), lease.expense_stop {amount} (building-level USD per year), lease.cam_admin_fee {rate, base: actual|grossed_up, excluded_from_base: [category words]}, lease.cam_gross_up {target_occupancy, applies_to: variable_expenses|all_expenses, base_year_grossed_up?: boolean}, lease.cam_exclusion (one per excluded category: a string, or {category, keywords?: [words]}), lease.capex_treatment {keywords: [words], recoverable: excluded|amortized, amortization_years?, interest_rate?}, lease.audit_right {window_days, starts_from: statement_receipt|statement_date, notice_form, auditor?, cost_shift_threshold?: {type: percent_of_billed|amount, value}}. A check whose lease term is missing is listed in checks_not_run; nothing is guessed."},"statement_facts":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":"The landlord's statement as verified facts, each with its quote and page. Read by predicate: statement.period {year, statement_date, received_date}, statement.line {label, amount (building-level USD), controllable?, variable?, capital?, grossed_up_amount?, amortization?: {cost, years, rate}} (one per billed line), statement.total {amount}, statement.share_applied {share, building_sf?}, statement.gross_up {actual_occupancy, target_occupancy}, statement.admin_fee {rate, base_amount, amount}, statement.cap_reference {year, amount} (the tenant's controllable amount in the cap's reference year), statement.cap_applied {limit: number or null}, statement.base_year_applied {base_year?, stop_amount?, deduction, grossed_up?}, statement.base_year_total {year, amount}, statement.separately_billed {label, amount}, statement.tenant_charge {amount}, statement.estimates_credited {amount}, statement.estimates_paid {amount}, statement.balance_claimed {amount}."},"prior_statement_facts":{"description":"Optional: the prior year's statement.line and statement.period facts, for the year-over-year questions.","minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Today's date, YYYY-MM-DD. The tool reads no clock: deadlines are counted from this date."},"yoy_threshold":{"default":0.1,"description":"A line that rose by more than this fraction over the prior year is listed as a question to ask (default 0.10 = 10%). Never an overcharge. Must be greater than 0.","type":"number","maximum":10,"minimum":0}},"required":["lease_facts","statement_facts","as_of"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_amortization_schedule","title":"Loan amortization schedule","description":"Period-by-period schedule of a fixed-rate loan, monthly or quarterly: an optional interest-only period, then level payments on an amortization term that can run past maturity (balloon), with 30/360, actual/360, or actual/365 interest (the payment on a 30/360 basis). Rows are in cents that foot: interest is rounded each period, the final payment repays the whole balance, and the totals are the row sums. Deterministic: the same inputs always give the same result, with formula ID calc.amortization_schedule@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"principal":{"type":"number","description":"Loan amount funded, USD. Must be greater than 0.","minimum":0},"rate_annual":{"type":"number","minimum":0,"description":"Fixed nominal annual interest rate as a decimal, e.g. 0.065 for 6.5%. Must be less than 1.","maximum":1},"payment_frequency":{"default":"monthly","description":"Payment period: monthly (12 a year) or quarterly (4 a year). Term, amortization, and interest-only months must be whole periods.","type":"string","enum":["monthly","quarterly"]},"term_months":{"type":"integer","minimum":1,"maximum":600,"description":"Months from funding to maturity, when any remaining balance (the balloon) is repaid."},"amortization_months":{"type":"integer","minimum":0,"maximum":600,"description":"Amortization period in months that sets the level payment after any interest-only period, e.g. 360 for a 30-year schedule; 0 means interest-only to maturity. Must be at least term_months − interest_only_months (a shorter schedule would repay the loan before maturity)."},"interest_only_months":{"default":0,"description":"Months of interest-only payments at the start of the loan; amortization over amortization_months begins after them. At most term_months.","type":"integer","minimum":0,"maximum":600},"day_count":{"default":"30/360","description":"Interest day count: \"30/360\" (each period is 30 days a month: interest = balance × rate ÷ periods a year), \"actual/360\" or \"actual/365\" (balance × rate × actual days in the period ÷ 360 or 365; needs start_date). Under actual day counts the level payment is still computed on a 30/360 basis, as US commercial loans usually are, so the balloon absorbs the difference.","type":"string","enum":["30/360","actual/360","actual/365"]},"start_date":{"description":"Funding date, YYYY-MM-DD. Payment k falls k periods later on the same day of the month (clamped to month end); the first period runs from this date to the first payment date. Required for actual/360 and actual/365; optional for 30/360, where it only dates the rows.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"required":["principal","rate_annual","term_months","amortization_months"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_cam_reconciliation","title":"CAM / operating expense reconciliation","description":"Reconcile a tenant's annual CAM charge: exclusions, occupancy gross-up of variable expenses, pro rata share, controllable-expense caps (compounding_from_base, simple_from_base, year_over_year), an admin fee (before or after the cap, inside or outside it, with per-line exclusions), base year or expense stop, partial-year occupancy (move-in/move-out prorates share, cap, and base by days), and estimates paid. Returns balance due and a full trace with order-of-operations warnings. Deterministic: the same inputs always give the same result, with formula ID calc.cam_reconciliation@2, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2200,"description":"Calendar or lease year being reconciled."},"pro_rata_share":{"type":"number","maximum":1,"description":"Tenant's pro rata share, 0 < share ≤ 1 (e.g. 12,000 / 150,000 = 0.08). Must be greater than 0.","minimum":0},"expenses":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"category":{"type":"string","minLength":1,"maxLength":200,"description":"Expense line as named in the operating statement, e.g. \"janitorial\"."},"amount":{"type":"number","minimum":0,"description":"Building-level actual expense for the year, USD."},"controllable":{"default":true,"description":"Subject to the cap. Taxes, insurance, and utilities are typically uncontrollable. Default true; under a cap, lines left unset are named in warnings.","type":"boolean"},"recoverable":{"default":true,"description":"Excluded expenses (capital items, landlord-only costs) are dropped entirely.","type":"boolean"},"variable":{"default":false,"description":"Varies with occupancy, so eligible for gross-up (janitorial, utilities, management fee). Default false; with a gross-up, lines left unset are named in warnings.","type":"boolean"},"admin_fee_applies":{"default":true,"description":"Included in the admin_fee base. Set false for lines the lease excludes from the fee (often taxes, insurance, utilities, or a management fee already charged).","type":"boolean"}},"required":["category","amount"]},"description":"Building operating expense lines for the year."},"gross_up":{"description":"Gross up variable expenses to the target occupancy when actual occupancy is lower. Omit if the lease has no gross-up.","type":"object","properties":{"actual_occupancy":{"type":"number","maximum":1,"description":"Average occupancy for the year, e.g. 0.82. Must be greater than 0.","minimum":0},"target_occupancy":{"default":0.95,"description":"Gross-up occupancy stated in the lease (commonly 0.95 or 1.0). Must be greater than 0.","type":"number","maximum":1,"minimum":0}},"required":["actual_occupancy"]},"structure":{"default":{"type":"net"},"description":"Expense structure from the lease. Default: net.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"net"}},"required":["type"],"description":"Tenant pays its full share of recoverable expenses (NNN / net)."},{"type":"object","properties":{"type":{"type":"string","const":"base_year"},"base_year_expenses":{"type":"number","minimum":0,"description":"Total building recoverable expenses in the base year, already grossed up, USD."}},"required":["type","base_year_expenses"],"description":"Tenant pays its share of the excess over base-year expenses."},{"type":"object","properties":{"type":{"type":"string","const":"expense_stop"},"stop_amount":{"type":"number","minimum":0,"description":"Building-level expense stop, USD per year."}},"required":["type","stop_amount"],"description":"Tenant pays its share of the excess over a fixed expense stop."}]},"cap":{"description":"Cap on the tenant's share of controllable expenses. Omit if the lease has no cap.","type":"object","properties":{"method":{"type":"string","enum":["compounding_from_base","simple_from_base","year_over_year"],"description":"compounding_from_base: reference × (1+rate)^years (often called cumulative, compounding). simple_from_base: reference × (1 + rate × years) (cumulative, non-compounding). year_over_year: prior year's capped amount × (1+rate) (non-cumulative). Map the lease language to one of these explicitly."},"rate":{"type":"number","description":"Annual cap as a decimal, e.g. 0.05. Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"reference_amount":{"type":"number","minimum":0,"description":"Tenant's share of controllable expenses in the reference year: the base year for *_from_base, or the prior year's capped amount for year_over_year, USD."},"years_elapsed":{"description":"Years since the base year (required for `*_from_base`).","type":"integer","minimum":0}},"required":["method","rate","reference_amount"]},"admin_fee":{"description":"Administrative fee the lease adds to the tenant's share. Omit if the lease has none.","type":"object","properties":{"rate":{"type":"number","description":"Administrative or management fee as a decimal of the fee base, e.g. 0.15 for 15%. The base is the tenant's share of recoverable lines with admin_fee_applies (after gross-up). Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"applied":{"default":"after_cap","description":"Fee on controllable lines computed on the tenant's share before the cap (before_cap) or on the capped amount (after_cap). Fees on uncontrollable lines are never capped. Irrelevant without a cap.","type":"string","enum":["before_cap","after_cap"]},"capped":{"default":false,"description":"True when the fee on controllable lines counts toward the controllable cap (controllable share plus fee may not exceed the cap limit); false adds it outside the cap.","type":"boolean"}},"required":["rate"]},"occupancy":{"description":"Partial-year occupancy: the tenant's share, cap limit, and base-year or stop deduction are prorated by occupied days ÷ period days (both inclusive), so a full-year cap and base are not applied to a part year. Omit for a full year.","type":"object","properties":{"move_in_date":{"description":"Date the tenant's share starts within the reconciliation period, YYYY-MM-DD (inclusive). Defaults to period_start_date.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"move_out_date":{"description":"Last day of the tenant's share within the period, YYYY-MM-DD (inclusive). Defaults to period_end_date.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"period_start_date":{"description":"First day of the reconciliation period, YYYY-MM-DD. Defaults to January 1 of year; set it for a lease year.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"period_end_date":{"description":"Last day of the reconciliation period, YYYY-MM-DD (at most 366 days after the start). Defaults to December 31 of year.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}}},"estimates_paid":{"default":0,"description":"Estimated CAM payments the tenant made during the year, USD (total for the year, not monthly).","type":"number","minimum":0}},"required":["year","pro_rata_share","expenses"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_cam_reconciliation_batch","title":"CAM reconciliation for every tenant (batch)","description":"Reconcile CAM for a whole building in one call: the expense pool and gross-up once, then up to 500 tenants each with share, base year or expense stop, cap, admin fee, occupancy, estimates paid, and lease-specific excluded categories. Returns each tenant's statement (identical to calc_cam_reconciliation for that tenant, with its trace and warnings) and a building reconciliation: total billed against the recoverable pool, the unrecovered amount, and why (unleased or vacant share, lease exclusions, gross-up, caps, base years and stops, admin fees, zero floor, rounding). Deterministic: the same inputs always give the same result, with formula ID calc.cam_reconciliation_batch@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2200,"description":"Calendar or lease year being reconciled."},"expenses":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"category":{"type":"string","minLength":1,"maxLength":200,"description":"Expense line as named in the operating statement, e.g. \"janitorial\"."},"amount":{"type":"number","minimum":0,"description":"Building-level actual expense for the year, USD."},"controllable":{"default":true,"description":"Subject to the cap. Taxes, insurance, and utilities are typically uncontrollable. Default true; under a cap, lines left unset are named in warnings.","type":"boolean"},"recoverable":{"default":true,"description":"Excluded expenses (capital items, landlord-only costs) are dropped entirely.","type":"boolean"},"variable":{"default":false,"description":"Varies with occupancy, so eligible for gross-up (janitorial, utilities, management fee). Default false; with a gross-up, lines left unset are named in warnings.","type":"boolean"},"admin_fee_applies":{"default":true,"description":"Included in the admin_fee base. Set false for lines the lease excludes from the fee (often taxes, insurance, utilities, or a management fee already charged).","type":"boolean"}},"required":["category","amount"]},"description":"The building's operating expense pool for the year, entered once for every tenant: category, amount, controllable, recoverable, variable, admin_fee_applies."},"gross_up":{"description":"Gross up variable expenses to the target occupancy when actual occupancy is lower. Omit if the lease has no gross-up.","type":"object","properties":{"actual_occupancy":{"type":"number","maximum":1,"description":"Average occupancy for the year, e.g. 0.82. Must be greater than 0.","minimum":0},"target_occupancy":{"default":0.95,"description":"Gross-up occupancy stated in the lease (commonly 0.95 or 1.0). Must be greater than 0.","type":"number","maximum":1,"minimum":0}},"required":["actual_occupancy"]},"tenants":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Tenant or suite label, unique, e.g. \"Suite 200 – Acme\"."},"pro_rata_share":{"type":"number","maximum":1,"description":"Tenant's pro rata share, 0 < share ≤ 1 (e.g. 12,000 / 150,000 = 0.08). Must be greater than 0.","minimum":0},"structure":{"default":{"type":"net"},"description":"Expense structure from the lease. Default: net.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"net"}},"required":["type"],"description":"Tenant pays its full share of recoverable expenses (NNN / net)."},{"type":"object","properties":{"type":{"type":"string","const":"base_year"},"base_year_expenses":{"type":"number","minimum":0,"description":"Total building recoverable expenses in the base year, already grossed up, USD."}},"required":["type","base_year_expenses"],"description":"Tenant pays its share of the excess over base-year expenses."},{"type":"object","properties":{"type":{"type":"string","const":"expense_stop"},"stop_amount":{"type":"number","minimum":0,"description":"Building-level expense stop, USD per year."}},"required":["type","stop_amount"],"description":"Tenant pays its share of the excess over a fixed expense stop."}]},"cap":{"description":"Cap on the tenant's share of controllable expenses. Omit if the lease has no cap.","type":"object","properties":{"method":{"type":"string","enum":["compounding_from_base","simple_from_base","year_over_year"],"description":"compounding_from_base: reference × (1+rate)^years (often called cumulative, compounding). simple_from_base: reference × (1 + rate × years) (cumulative, non-compounding). year_over_year: prior year's capped amount × (1+rate) (non-cumulative). Map the lease language to one of these explicitly."},"rate":{"type":"number","description":"Annual cap as a decimal, e.g. 0.05. Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"reference_amount":{"type":"number","minimum":0,"description":"Tenant's share of controllable expenses in the reference year: the base year for *_from_base, or the prior year's capped amount for year_over_year, USD."},"years_elapsed":{"description":"Years since the base year (required for `*_from_base`).","type":"integer","minimum":0}},"required":["method","rate","reference_amount"]},"admin_fee":{"description":"Administrative fee the lease adds to the tenant's share. Omit if the lease has none.","type":"object","properties":{"rate":{"type":"number","description":"Administrative or management fee as a decimal of the fee base, e.g. 0.15 for 15%. The base is the tenant's share of recoverable lines with admin_fee_applies (after gross-up). Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"applied":{"default":"after_cap","description":"Fee on controllable lines computed on the tenant's share before the cap (before_cap) or on the capped amount (after_cap). Fees on uncontrollable lines are never capped. Irrelevant without a cap.","type":"string","enum":["before_cap","after_cap"]},"capped":{"default":false,"description":"True when the fee on controllable lines counts toward the controllable cap (controllable share plus fee may not exceed the cap limit); false adds it outside the cap.","type":"boolean"}},"required":["rate"]},"occupancy":{"description":"Partial-year occupancy: the tenant's share, cap limit, and base-year or stop deduction are prorated by occupied days ÷ period days (both inclusive), so a full-year cap and base are not applied to a part year. Omit for a full year.","type":"object","properties":{"move_in_date":{"description":"Date the tenant's share starts within the reconciliation period, YYYY-MM-DD (inclusive). Defaults to period_start_date.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"move_out_date":{"description":"Last day of the tenant's share within the period, YYYY-MM-DD (inclusive). Defaults to period_end_date.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"period_start_date":{"description":"First day of the reconciliation period, YYYY-MM-DD. Defaults to January 1 of year; set it for a lease year.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"period_end_date":{"description":"Last day of the reconciliation period, YYYY-MM-DD (at most 366 days after the start). Defaults to December 31 of year.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}}},"estimates_paid":{"default":0,"description":"Estimated CAM payments the tenant made during the year, USD (total for the year, not monthly).","type":"number","minimum":0},"excluded_categories":{"default":[],"description":"Expense categories this tenant's lease excludes, treated as recoverable: false for this tenant only. Each must match a category in expenses.","maxItems":1000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"admin_fee_excluded_categories":{"default":[],"description":"Expense categories this tenant's lease keeps out of the admin fee base, treated as admin_fee_applies: false for this tenant only. Each must match a category in expenses.","maxItems":1000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["name","pro_rata_share"]},"description":"Every tenant to reconcile (up to 500): each one's share, structure (base year or stop), cap, admin fee, occupancy, estimates paid, and lease-specific exclusions. Each statement equals calc_cam_reconciliation for that tenant."}},"required":["year","expenses","tenants"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_capex_recovery","title":"Capital expenditure recovery","description":"Recoverable capital expenditure under a lease clause: amortize a capital cost over its useful life or the lease-specified period, straight-line (declining interest) or level payment, with interest on the unamortized balance or none; optionally cap each year's recovery at demonstrated cost savings (with or without carry-forward); and allocate each year to tenants by pro rata share. Every assumption is echoed with an optional lease clause citation. Deterministic: the same inputs always give the same result, with formula ID calc.capex_recovery@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"cost":{"type":"number","description":"Capital cost of the improvement to recover, USD (building level). Must be greater than 0.","minimum":0},"amortization_years":{"type":"integer","minimum":1,"maximum":100,"description":"Years over which the cost is recovered: the useful life, or the amortization period the lease specifies."},"period_basis":{"default":"useful_life","description":"Where amortization_years comes from: useful_life (e.g. under GAAP or tax guidance) or lease_specified (a period the lease states). Labels only.","type":"string","enum":["useful_life","lease_specified"]},"method":{"default":"straight_line","description":"straight_line: equal principal (cost ÷ years) plus interest on the declining unamortized balance, so recovery falls each year. level_payment: a level annual payment like a mortgage, cost × r ÷ (1 − (1 + r)^−years), split into interest and principal. Identical when interest_rate_annual is 0.","type":"string","enum":["straight_line","level_payment"]},"interest_rate_annual":{"default":0,"description":"Annual interest on the unamortized balance as a decimal, e.g. 0.08; 0 (default) for none. Charged on the balance at the start of each year. Must be greater than -1. Must be less than 10.","type":"number","minimum":-1,"maximum":10},"first_year":{"description":"Calendar or lease year of the first recovery year, e.g. 2026; labels the schedule rows. Omit to number years 1, 2, 3.","type":"integer","minimum":1900,"maximum":2200},"cost_savings_cap":{"description":"Cost-savings limit: recovery in each year may not exceed the operating-cost savings the improvement demonstrably produces. Omit if the lease has none.","type":"object","properties":{"annual_savings":{"description":"Demonstrated operating-cost savings per year, USD, the same every year. Give this or savings_by_year.","type":"number","minimum":0},"savings_by_year":{"description":"Demonstrated savings for each recovery year, USD, one per year of amortization_years. Give this or annual_savings.","minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":0}},"carry_forward":{"default":false,"description":"True if amortization disallowed by the cap in one year may be recovered in a later year of the period (still within that year's savings); false (default) if it is lost.","type":"boolean"}}},"tenants":{"description":"Tenants to allocate the annual recoverable amount to by pro rata share. Shares may sum to less than 1 (the landlord bears the rest), not more. Omit for the building-level schedule only.","minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Tenant or suite label, unique."},"pro_rata_share":{"type":"number","maximum":1,"description":"Tenant's pro rata share of the recoverable amount, 0 < share ≤ 1. Must be greater than 0.","minimum":0}},"required":["name","pro_rata_share"]}},"clauses":{"description":"Lease clause behind each assumption, free text, echoed in the result's assumptions so a reviewer can check each against the lease.","type":"object","properties":{"cost":{"description":"Free-text lease reference for this assumption, e.g. \"Lease §6.2(b)\" or \"First Amendment ¶4\". Echoed with the assumption.","type":"string","minLength":1,"maxLength":500},"amortization_period":{"description":"Free-text lease reference for this assumption, e.g. \"Lease §6.2(b)\" or \"First Amendment ¶4\". Echoed with the assumption.","type":"string","minLength":1,"maxLength":500},"interest":{"description":"Free-text lease reference for this assumption, e.g. \"Lease §6.2(b)\" or \"First Amendment ¶4\". Echoed with the assumption.","type":"string","minLength":1,"maxLength":500},"method":{"description":"Free-text lease reference for this assumption, e.g. \"Lease §6.2(b)\" or \"First Amendment ¶4\". Echoed with the assumption.","type":"string","minLength":1,"maxLength":500},"cost_savings_cap":{"description":"Free-text lease reference for this assumption, e.g. \"Lease §6.2(b)\" or \"First Amendment ¶4\". Echoed with the assumption.","type":"string","minLength":1,"maxLength":500},"pro_rata_share":{"description":"Free-text lease reference for this assumption, e.g. \"Lease §6.2(b)\" or \"First Amendment ¶4\". Echoed with the assumption.","type":"string","minLength":1,"maxLength":500}}}},"required":["cost","amortization_years"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_compare_proposals","title":"Compare lease proposals","description":"Rank 2–20 lease proposals with different terms, sizes, free rent, TI, concessions, and operating-expense structures (gross, NNN, base year, expense stop, with opex growth) on one discounted $/SF/yr basis, per rentable or usable SF (load factor): effective occupancy cost (tenant perspective) or discounted net effective rent after landlord-borne opex and optional pre-commencement downtime (landlord perspective). Cash flows monthly in advance at annual rate ÷ 12; warns when the usable-SF ranking differs and when terms differ. schedule.unit (kw, mw, unit, acre, key, room, space, the same for every proposal) ranks per kW, MW, unit, acre, key, room, or space instead of per SF. Deterministic: the same inputs always give the same result, with formula ID calc.compare_proposals@2, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"perspective":{"default":"tenant","description":"Whose economics to rank on: tenant (effective occupancy cost, lower is better) or landlord (discounted net effective rent, higher is better).","type":"string","enum":["tenant","landlord"]},"discount_rate_annual":{"default":0.08,"description":"Annual discount rate as a decimal, e.g. 0.08, applied to every proposal (monthly rate = annual ÷ 12, cash flows at the start of each month). Default 0.08, named in warnings when omitted: the ranking can change with the rate. Must be less than 1.","type":"number","minimum":0,"maximum":1},"area_basis":{"default":"rentable","description":"Area the $/SF/yr metric is divided by: rentable (schedule.area_sf, the default) or usable (each proposal's usable_sf, or area_sf ÷ load_factor). Rents and expenses stay quoted per rentable SF; use usable when proposals have different load factors and the tenant needs a fixed usable area.","type":"string","enum":["rentable","usable"]},"proposals":{"minItems":2,"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Unique label for the proposal, e.g. building name."},"schedule":{"type":"object","properties":{"commencement_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Rent commencement date, YYYY-MM-DD. Month n starts on this day-of-month (clamped to month end)."},"term_months":{"type":"integer","maximum":1200,"description":"Lease term in months, e.g. 120 for ten years.","minimum":1},"area_sf":{"type":"number","description":"Rentable square feet, or the quantity leased in unit (kW, MW, units, acres, keys, rooms, spaces) when unit is set. Must be greater than 0.","minimum":0},"starting_rent_psf_annual":{"type":"number","minimum":0,"description":"Year-one base rent in dollars per SF per year (annual, not monthly), e.g. 42.5; per unit per year when unit is set (a $/kW/month quote × 12)."},"escalation":{"default":{"type":"none"},"description":"How base rent escalates. Omit for flat rent.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"description":"Flat rent for the whole term."},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"rate":{"type":"number","description":"Bump as a decimal, e.g. 0.03 for 3%. Bumps compound. Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","rate"],"description":"Percentage bumps: rate_k = starting_rate × (1 + rate)^k."},{"type":"object","properties":{"type":{"type":"string","const":"fixed_psf"},"amount":{"type":"number","description":"Dollars per SF per year (or per unit per year when unit is set) added at each bump, e.g. 0.50."},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","amount"],"description":"Fixed $/SF bumps: rate_k = starting_rate + amount × k."}]},"abated_months":{"default":[],"description":"Fully abated (free) months, 1-based from commencement (e.g. [1,2,3] for three months free up front). Each listed month's base rent is zero.","maxItems":1200,"type":"array","items":{"type":"integer","minimum":1}},"round_rate_to_cents":{"default":false,"description":"Round each step's $/SF/yr to cents, as many lease rent tables do.","type":"boolean"},"include_monthly":{"default":false,"description":"Include a month-by-month table (can be long).","type":"boolean"},"unit":{"description":"What area_sf and the per-SF fields measure: sf (default, square feet), kw or mw (data-center critical load), unit (apartment or other unit), acre (ground or yard lease), key or room (hotel), or space (parking). Every number is computed exactly as for square feet; the unit changes labels, steps, and warnings and adds unit and rate_unit to the result. Fields keep their _sf and _psf names: with unit kw, area_sf holds kW and starting_rent_psf_annual holds $/kW/yr. Omit for square feet.","type":"string","enum":["sf","kw","mw","unit","acre","key","room","space"]}},"required":["commencement_date","term_months","area_sf","starting_rent_psf_annual"],"description":"Base-rent terms of this proposal (same input as calc_rent_schedule); schedule.area_sf is the rentable area. With schedule.unit (kw, mw, unit, acre, key, room, space), area_sf and every $/SF field of this proposal are per that unit; all proposals must use the same unit."},"usable_sf":{"description":"Usable square feet of this proposal (at most schedule.area_sf). Give this or load_factor, not both; required for area_basis usable. Must be greater than 0.","type":"number","minimum":0},"load_factor":{"description":"Rentable ÷ usable area, e.g. 1.15 (usable_sf = area_sf ÷ load_factor). Give this or usable_sf, not both.","type":"number","minimum":1,"maximum":3},"ti_allowance_psf":{"default":0,"description":"TI allowance paid by the landlord, USD per rentable SF, once at commencement (not per year).","type":"number","minimum":0},"other_concessions":{"default":0,"description":"Other cash concessions to the tenant at commencement (moving allowance, buyout), USD.","type":"number","minimum":0},"leasing_commissions":{"default":0,"description":"Leasing commissions paid by landlord at commencement, USD (landlord perspective only).","type":"number","minimum":0},"operating_expenses":{"description":"Operating-expense structure of this proposal: gross, nnn, base_year, or expense_stop, with a lease-year-1 estimate and growth. Tenant perspective adds what the tenant pays; landlord perspective deducts what the landlord bears. Omit to price no operating expenses (as before).","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"gross"},"expense_psf_annual":{"default":0,"description":"Estimated operating expenses the landlord pays, $/SF/yr in lease year 1 (used in the landlord perspective; the tenant pays none).","type":"number","minimum":0},"growth_rate_annual":{"default":0,"description":"Annual growth of operating expenses as a decimal, e.g. 0.03, compounding each lease year from commencement (lease year 1 is expense_psf_annual). Must be greater than -1. Must be less than 10.","type":"number","minimum":-1,"maximum":10}},"required":["type"],"description":"Full-service gross: the landlord pays all operating expenses; the tenant pays none beyond base rent."},{"type":"object","properties":{"type":{"type":"string","const":"nnn"},"expense_psf_annual":{"type":"number","minimum":0,"description":"Estimated operating expenses (CAM, taxes, insurance) for lease year 1, $/SF/yr on rentable area."},"growth_rate_annual":{"default":0,"description":"Annual growth of operating expenses as a decimal, e.g. 0.03, compounding each lease year from commencement (lease year 1 is expense_psf_annual). Must be greater than -1. Must be less than 10.","type":"number","minimum":-1,"maximum":10}},"required":["type","expense_psf_annual"],"description":"Net (NNN): the tenant pays all operating expenses, estimated at expense_psf_annual in lease year 1."},{"type":"object","properties":{"type":{"type":"string","const":"base_year"},"expense_psf_annual":{"type":"number","minimum":0,"description":"Estimated operating expenses (CAM, taxes, insurance) for lease year 1, $/SF/yr on rentable area."},"base_year_psf_annual":{"description":"Base-year operating expenses, $/SF/yr. Defaults to expense_psf_annual (the base year is lease year 1).","type":"number","minimum":0},"growth_rate_annual":{"default":0,"description":"Annual growth of operating expenses as a decimal, e.g. 0.03, compounding each lease year from commencement (lease year 1 is expense_psf_annual). Must be greater than -1. Must be less than 10.","type":"number","minimum":-1,"maximum":10}},"required":["type","expense_psf_annual"],"description":"Gross with a base year: the tenant pays operating expenses above the base-year amount."},{"type":"object","properties":{"type":{"type":"string","const":"expense_stop"},"expense_psf_annual":{"type":"number","minimum":0,"description":"Estimated operating expenses (CAM, taxes, insurance) for lease year 1, $/SF/yr on rentable area."},"stop_psf_annual":{"type":"number","minimum":0,"description":"Expense stop, $/SF/yr: the tenant pays operating expenses above this fixed amount."},"growth_rate_annual":{"default":0,"description":"Annual growth of operating expenses as a decimal, e.g. 0.03, compounding each lease year from commencement (lease year 1 is expense_psf_annual). Must be greater than -1. Must be less than 10.","type":"number","minimum":-1,"maximum":10}},"required":["type","expense_psf_annual","stop_psf_annual"],"description":"Gross with an expense stop: the tenant pays operating expenses above a fixed $/SF/yr stop."}]},"additional_costs_psf_annual":{"default":0,"description":"Other costs the tenant pays on top of base rent, flat $/SF/yr on rentable area (tenant perspective only), e.g. parking. Prefer operating_expenses for opex pass-throughs, which can grow and follow a base year or stop.","type":"number","minimum":0},"tenant_upfront_costs":{"default":0,"description":"Tenant's own costs at commencement not covered by allowances (TI overage, moving), USD.","type":"number","minimum":0},"downtime_months":{"default":0,"description":"Landlord perspective: vacant months before this proposal commences (no rent; the landlord carries lease-year-1 operating expenses if operating_expenses is given). The metric is then the level monthly amount over downtime plus term. Ignored for the tenant.","type":"integer","minimum":0,"maximum":120}},"required":["name","schedule"]},"description":"2–20 proposals to compare."}},"required":["proposals"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_critical_dates","title":"Lease critical dates","description":"Dated list of a lease's notice deadlines and option windows, from its expiration date and options: each renewal option's notice deadline or notice window and renewal term (successive options count back from the term before), each termination option's last day to give notice, an expansion option deadline, and other deadlines (a stated date, or N days after a date such as a ROFO notice). Calendar months; N months before a date keeps the day of month, clamped to a shorter month's end (a warning gives the month-end reading when it is later). Deadlines on a weekend or US federal holiday (5 U.S.C. §6103, observed days included) are flagged, or rolled to the preceding or following business day when business_day_roll says so. With as_of: days to each event, passed deadlines warned, and the next deadline. Steps show each computation. Deterministic: the same inputs always give the same result, with formula ID calc.critical_dates@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"expiration_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Expiration date of the current term (YYYY-MM-DD), as the lease or the latest amendment states it."},"commencement_date":{"description":"Commencement date (YYYY-MM-DD). Optional; listed as an event and checked to be before expiration_date.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"as_of":{"description":"Date to measure from (YYYY-MM-DD), usually today. Deadlines before it are flagged as passed; next_deadline is the first one on or after it.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"renewal_option":{"description":"Renewal options, as lease.renewal_option states them: each is exercised by notice counted back from the expiration in effect when it is exercised.","type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":10,"description":"Number of successive renewal options."},"term_months":{"type":"integer","minimum":1,"maximum":600,"description":"Length of each renewal term in calendar months."},"notice_months":{"type":"integer","minimum":0,"maximum":120,"description":"Notice \"no later than N months before\" the date it counts back from, in calendar months."},"notice_days":{"type":"integer","minimum":0,"maximum":3650,"description":"Notice \"no later than N days before\" the date it counts back from, in calendar days."},"notice_window":{"description":"A notice window (\"not earlier than 18 nor later than 12 months before expiration\"), instead of notice_months or notice_days.","type":"object","properties":{"earliest_months_before":{"type":"integer","minimum":1,"maximum":120,"description":"The window opens this many calendar months before the expiration in effect (notice given earlier is premature)."},"latest_months_before":{"type":"integer","minimum":0,"maximum":120,"description":"The window closes this many calendar months before the expiration in effect (the last day to give notice)."}},"required":["earliest_months_before","latest_months_before"]}},"required":["count","term_months"]},"termination_options":{"default":[],"description":"Early termination options, as lease.termination_option states them; notice counts back from each effective_date.","maxItems":20,"type":"array","items":{"type":"object","properties":{"effective_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Date the early termination takes effect (YYYY-MM-DD)."},"notice_months":{"type":"integer","minimum":0,"maximum":120,"description":"Notice \"no later than N months before\" the date it counts back from, in calendar months."},"notice_days":{"type":"integer","minimum":0,"maximum":3650,"description":"Notice \"no later than N days before\" the date it counts back from, in calendar days."},"label":{"description":"Name for this option, e.g. \"Year 5 termination right\".","type":"string","minLength":1,"maxLength":200}},"required":["effective_date"]}},"expansion_option_deadline":{"description":"Last day to exercise an expansion option (lease.expansion_option_deadline), YYYY-MM-DD.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"other_deadlines":{"default":[],"description":"Other deadlines: expansion rights, ROFO or ROFR response periods, contraction rights.","maxItems":50,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200,"description":"What the deadline is, e.g. \"ROFO response for Suite 410\"."},"date":{"description":"The deadline, when the lease states the date.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"from_date":{"description":"Or the date it counts from (e.g. the day Landlord's ROFO notice was received), with days_after.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"days_after":{"description":"Calendar days after from_date.","type":"integer","minimum":0,"maximum":3650}},"required":["label"]}},"business_day_roll":{"default":"none","description":"What to do with a deadline that falls on a weekend or holiday: \"none\" (default) keeps the date and flags it; \"preceding\" moves it to the business day before (never later than the lease date: the safe choice); \"following\" moves it to the next business day, which only a lease clause that says so allows.","type":"string","enum":["none","preceding","following"]},"holidays":{"default":"us_federal","description":"Holidays that are not business days: \"us_federal\" (the eleven US federal holidays of 5 U.S.C. §6103(a), with the federal observed day when one falls on a weekend) or \"none\" (weekends only).","type":"string","enum":["us_federal","none"]}},"required":["expiration_date"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_dcf_pro_forma","title":"Property DCF from a rent roll","description":"Property-level discounted cash flow from an in-place rent roll: each lease's rent, escalations, remaining term, and expense recovery (NNN, gross, base year), then at expiration one blended lease weighted by the renewal probability (renewal vs new-tenant rent, free rent, TI, leasing commissions, and new-tenant downtime, with fractional downtime and free rent kept as part months rather than rounded); market rent growth, general vacancy and credit loss, operating expenses, management fee, and capital reserves. Returns the annual cash-flow table (NOI and cash flow before debt) for the hold plus one year, the exit value at a cap rate on forward (or trailing) NOI less selling costs, the value (PV at the discount rate, end-of-year or mid-year), and with a purchase price the NPV, unlevered IRR, and equity multiple, with every lease event and convention stated. Deterministic: the same inputs always give the same result, with formula ID calc.dcf_pro_forma@2, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"hold_years":{"type":"integer","minimum":1,"maximum":30,"description":"Holding period in years. The property is sold at the end of the last year; one more year is projected for the forward NOI."},"leases":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Suite or tenant label, e.g. \"Suite 200\"."},"area_sf":{"type":"number","description":"Leased area, SF. Must be greater than 0.","minimum":0},"rent_psf_annual":{"type":"number","minimum":0,"description":"Current in-place base rent, USD/SF/yr (0 for space vacant at the start)."},"months_remaining":{"type":"integer","minimum":0,"maximum":600,"description":"Months left on the lease from the analysis start: the lease runs through this month (1 = expires at the end of month 1). 0 means the space is vacant at the start and is leased to a new tenant after downtime_months."},"escalation_rate":{"default":0,"description":"Annual bump in the in-place rent, e.g. 0.03, applied first in next_escalation_month and every 12 months after. Must be less than 1.","type":"number","minimum":0,"maximum":1},"next_escalation_month":{"default":13,"description":"Analysis month of the next in-place rent bump (default 13, the start of year 2). Use the lease's anniversary month.","type":"integer","minimum":1,"maximum":600},"free_rent_months_remaining":{"default":0,"description":"Months of in-place free base rent still to run from the analysis start (months 1 to this are abated).","type":"integer","minimum":0,"maximum":600},"recovery":{"default":"nnn","description":"In-place expense recovery: \"nnn\", \"gross\", or \"base_year\" (needs base_year_opex_psf_annual).","type":"string","enum":["nnn","gross","base_year"]},"base_year_opex_psf_annual":{"description":"Operating expenses in the lease's base year, USD/SF/yr: the tenant pays the excess above it. Required when recovery is base_year.","type":"number","minimum":0},"market_rent_psf_annual":{"type":"number","minimum":0,"description":"Market rent for this space today, USD/SF/yr. Grows at market_rent_growth_rate each analysis year."},"leasing":{"type":"object","properties":{"renewal_probability":{"type":"number","minimum":0,"maximum":1,"description":"Probability the tenant renews at expiration, 0 to 1 (e.g. 0.65). Blends the renewal and new-tenant assumptions below."},"lease_term_months":{"type":"integer","minimum":1,"maximum":240,"description":"Term of each lease signed at rollover (renewal or new tenant), months."},"downtime_months":{"type":"integer","minimum":0,"maximum":60,"description":"Months vacant before a new tenant starts paying (no downtime is assumed on renewal). Blended downtime = (1 − renewal_probability) × this, kept fractional, not rounded: the suite is vacant for the whole months and the rollover lease's first month collects 1 − the fraction of its rent and recoveries (0.45 months of downtime: the first month collects 55%)."},"renewal_rent_pct_of_market":{"type":"number","maximum":2,"description":"Renewal rent as a share of market rent, e.g. 0.95 for a 5% renewal discount; new tenants pay market rent. Must be greater than 0.","minimum":0},"rent_escalation_rate":{"type":"number","minimum":0,"description":"Annual bump in a rollover lease's base rent, compounding every 12 months from its start, e.g. 0.03. Must be less than 1.","maximum":1},"free_rent_months_new":{"type":"integer","minimum":0,"maximum":60,"description":"Months of free base rent for a new tenant at the start of its lease."},"free_rent_months_renewal":{"type":"integer","minimum":0,"maximum":60,"description":"Months of free base rent on a renewal. Blended free rent = p × this + (1 − p) × free_rent_months_new, kept fractional: the whole months are fully abated and the next month by the fraction."},"ti_psf_new":{"type":"number","minimum":0,"description":"Tenant improvement allowance for a new tenant, USD/SF in today's dollars (grown at market_rent_growth_rate to the lease start)."},"ti_psf_renewal":{"type":"number","minimum":0,"description":"Tenant improvement allowance on a renewal, USD/SF in today's dollars."},"lc_rate_new":{"type":"number","minimum":0,"description":"Leasing commission for a new tenant as a share of the base rent payable over the lease term after free rent, e.g. 0.06. Must be less than 1.","maximum":1},"lc_rate_renewal":{"type":"number","minimum":0,"description":"Leasing commission on a renewal, same basis, e.g. 0.03. Must be less than 1.","maximum":1},"recovery":{"type":"string","enum":["nnn","gross","base_year"],"description":"Expense recovery on rollover leases: \"nnn\" (tenant pays its share of operating expenses), \"gross\" (none), or \"base_year\" (expenses above the lease's first-year level)."}},"description":"Per-lease overrides of market_leasing (any subset of its fields)."}},"required":["name","area_sf","rent_psf_annual","months_remaining","market_rent_psf_annual"]},"description":"Rent roll: one entry per lease or vacant suite (at most 200). The building area is the sum of their areas."},"market_leasing":{"type":"object","properties":{"renewal_probability":{"type":"number","minimum":0,"maximum":1,"description":"Probability the tenant renews at expiration, 0 to 1 (e.g. 0.65). Blends the renewal and new-tenant assumptions below."},"lease_term_months":{"type":"integer","minimum":1,"maximum":240,"description":"Term of each lease signed at rollover (renewal or new tenant), months."},"downtime_months":{"type":"integer","minimum":0,"maximum":60,"description":"Months vacant before a new tenant starts paying (no downtime is assumed on renewal). Blended downtime = (1 − renewal_probability) × this, kept fractional, not rounded: the suite is vacant for the whole months and the rollover lease's first month collects 1 − the fraction of its rent and recoveries (0.45 months of downtime: the first month collects 55%)."},"renewal_rent_pct_of_market":{"default":1,"type":"number","maximum":2,"description":"Renewal rent as a share of market rent, e.g. 0.95 for a 5% renewal discount; new tenants pay market rent. Must be greater than 0.","minimum":0},"rent_escalation_rate":{"default":0,"type":"number","minimum":0,"description":"Annual bump in a rollover lease's base rent, compounding every 12 months from its start, e.g. 0.03. Must be less than 1.","maximum":1},"free_rent_months_new":{"default":0,"type":"integer","minimum":0,"maximum":60,"description":"Months of free base rent for a new tenant at the start of its lease."},"free_rent_months_renewal":{"default":0,"type":"integer","minimum":0,"maximum":60,"description":"Months of free base rent on a renewal. Blended free rent = p × this + (1 − p) × free_rent_months_new, kept fractional: the whole months are fully abated and the next month by the fraction."},"ti_psf_new":{"default":0,"type":"number","minimum":0,"description":"Tenant improvement allowance for a new tenant, USD/SF in today's dollars (grown at market_rent_growth_rate to the lease start)."},"ti_psf_renewal":{"default":0,"type":"number","minimum":0,"description":"Tenant improvement allowance on a renewal, USD/SF in today's dollars."},"lc_rate_new":{"default":0,"type":"number","minimum":0,"description":"Leasing commission for a new tenant as a share of the base rent payable over the lease term after free rent, e.g. 0.06. Must be less than 1.","maximum":1},"lc_rate_renewal":{"default":0,"type":"number","minimum":0,"description":"Leasing commission on a renewal, same basis, e.g. 0.03. Must be less than 1.","maximum":1},"recovery":{"default":"nnn","type":"string","enum":["nnn","gross","base_year"],"description":"Expense recovery on rollover leases: \"nnn\" (tenant pays its share of operating expenses), \"gross\" (none), or \"base_year\" (expenses above the lease's first-year level)."}},"required":["renewal_probability","lease_term_months","downtime_months"],"description":"Market leasing assumptions applied at every lease expiration (and to space vacant at the start). A lease's own `leasing` object overrides any of them."},"market_rent_growth_rate":{"default":0,"description":"Annual market rent growth, e.g. 0.03. Market rent and TI in analysis year y = today's × (1 + g)^(y − 1). Must be greater than -1. Must be less than 1.","type":"number","minimum":-1,"maximum":1},"operating_expenses_psf_annual":{"default":0,"description":"Year-1 recoverable operating expenses, USD/SF/yr over the whole building area.","type":"number","minimum":0},"non_recoverable_expenses_annual":{"default":0,"description":"Year-1 operating expenses no tenant reimburses, USD/yr.","type":"number","minimum":0},"expense_growth_rate":{"default":0,"description":"Annual growth of operating expenses and capital reserves, e.g. 0.03: year y = year 1 × (1 + g)^(y − 1). Must be greater than -1. Must be less than 1.","type":"number","minimum":-1,"maximum":1},"management_fee_rate":{"default":0,"description":"Management fee as a share of effective gross revenue, e.g. 0.03; not recovered. Must be less than 1.","type":"number","minimum":0,"maximum":1},"general_vacancy_rate":{"default":0,"description":"General vacancy allowance as a share of gross revenue (base rent after free rent, plus recoveries), on top of the downtime modelled at rollover. Must be less than 1.","type":"number","minimum":0,"maximum":1},"credit_loss_rate":{"default":0,"description":"Credit loss as a share of gross revenue, on top of general vacancy. Must be less than 1.","type":"number","minimum":0,"maximum":1},"capital_reserve_psf_annual":{"default":0,"description":"Year-1 capital reserve, USD/SF/yr over the building area, below NOI. Grows with expense_growth_rate.","type":"number","minimum":0},"exit_cap_rate":{"type":"number","description":"Exit (terminal) cap rate applied to the exit NOI, e.g. 0.07. Must be greater than 0. Must be less than 1.","minimum":0,"maximum":1},"exit_noi_basis":{"default":"forward","description":"\"forward\": the NOI of the year after the hold (the usual convention); \"trailing\": the NOI of the final hold year.","type":"string","enum":["forward","trailing"]},"selling_cost_rate":{"default":0,"description":"Selling costs as a share of the gross sale price, e.g. 0.02. Must be less than 1.","type":"number","minimum":0,"maximum":1},"discount_rate":{"type":"number","minimum":0,"description":"Annual unlevered discount rate, e.g. 0.08. The present value at this rate is the value. Must be less than 1.","maximum":1},"timing":{"default":"end_of_year","description":"\"end_of_year\": each year's cash flow is discounted (1 + r)^y (Excel NPV). \"mid_year\": operating cash flows at (1 + r)^(y − 0.5); the sale is always discounted at the end of the hold.","type":"string","enum":["end_of_year","mid_year"]},"purchase_price":{"description":"Price paid at the start, USD. Adds the NPV (value − price), the unlevered IRR and the going-in cap rate on price. Must be greater than 0.","type":"number","minimum":0}},"required":["hold_years","leases","market_leasing","exit_cap_rate","discount_rate"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_debt_sizing","title":"Loan sizing (LTV / DSCR / debt yield)","description":"Size the maximum loan under any combination of max LTV, min DSCR, and min debt yield for a given NOI, rate, and amortization. Reports the binding constraint, debt service, and resulting metrics; optionally a stress table over NOI, rate, and value shocks (max loan, binding constraint, LTV, DSCR, debt yield per scenario) and the refinance shortfall against an existing loan balance. Deterministic: the same inputs always give the same result, with formula ID calc.debt_sizing@3, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"noi":{"type":"number","description":"Underwritten net operating income, USD/yr. Must be greater than 0.","minimum":0},"value":{"description":"Appraised or underwritten value, USD. Required when max_ltv is set. Must be greater than 0.","type":"number","minimum":0},"rate_annual":{"type":"number","minimum":0,"description":"Annual interest rate, e.g. 0.065. Must be less than 1.","maximum":1},"amortization_years":{"type":"integer","minimum":0,"maximum":50,"description":"Amortization in years; 0 means interest-only."},"max_ltv":{"description":"Maximum loan-to-value, e.g. 0.65. Must be greater than 0.","type":"number","maximum":1,"minimum":0},"min_dscr":{"description":"Minimum debt service coverage ratio, e.g. 1.25. Must be greater than 0.","type":"number","minimum":0},"min_debt_yield":{"description":"Minimum debt yield (NOI ÷ loan), e.g. 0.09. Must be greater than 0. Must be less than 1.","type":"number","minimum":0,"maximum":1},"round_down_to":{"default":1,"description":"Round the final loan amount down to this increment (lenders often use 1,000 or 10,000). Must be greater than 0.","type":"number","minimum":0},"existing_loan_balance":{"description":"Balance of the loan being refinanced, USD. Adds a refinance result (shortfall or excess proceeds against the max loan) and a shortfall per stress scenario. Must be greater than 0.","type":"number","minimum":0},"stress":{"description":"Stress table: every combination of the NOI, rate, and value shocks (up to 1,000 scenarios), each sized under the same constraints and rounding. The base result is unchanged.","type":"object","properties":{"noi_shocks":{"description":"Relative NOI changes as decimals, e.g. [-0.05, -0.1, -0.2] for NOI down 5%, 10%, 20%. Omit for no NOI shock.","minItems":1,"maxItems":10,"type":"array","items":{"type":"number","minimum":-1,"maximum":10,"description":"Must be greater than -1. Must be less than 10."}},"rate_shocks":{"description":"Absolute changes to rate_annual as decimals, e.g. [0.005, 0.01] for +50 and +100 bp. The stressed rate must stay at or above 0 and below 1. Omit for no rate shock.","minItems":1,"maxItems":10,"type":"array","items":{"type":"number","minimum":-1,"maximum":1,"description":"Must be greater than -1. Must be less than 1."}},"value_shocks":{"description":"Relative value changes as decimals, e.g. [-0.1, -0.2]; requires value. Omit for no value shock.","minItems":1,"maxItems":10,"type":"array","items":{"type":"number","minimum":-1,"maximum":10,"description":"Must be greater than -1. Must be less than 10."}},"value_moves_with_noi":{"default":false,"description":"Also scale value by each NOI shock (value × (1 + noi_shock), a constant cap rate), as a lender repricing value on stressed NOI would.","type":"boolean"}}}},"required":["noi","rate_annual","amortization_years"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_direct_cap","title":"Direct capitalization value and implied cap rate","description":"Value by direct capitalization: (NOI − capital reserve) ÷ cap rate, then below-the-line deductions for lease-up costs, free-rent burn-off, and other adjustments to an as-is value (optionally rounded); and the cap rate a price implies, before and after reserves and all-in after the below-the-line costs. Records the NOI basis (trailing, forward, stabilized). Deterministic: the same inputs always give the same result, with formula ID calc.direct_cap@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"noi":{"type":"number","description":"Net operating income to capitalize, USD/yr, before capital reserves (they are deducted separately below). Must be greater than 0.","minimum":0},"noi_basis":{"description":"What the NOI is: trailing 12 months (T-12), forward 12 months (year 1 of a pro forma), or stabilized. The cap rate must be on the same basis; this is recorded in the steps, not checked.","type":"string","enum":["trailing_12","forward_12","stabilized"]},"cap_rate":{"description":"Capitalization rate as a decimal, e.g. 0.065 for 6.5%. Gives the value. Provide cap_rate, price, or both. Must be greater than 0. Must be less than 1.","type":"number","minimum":0,"maximum":1},"price":{"description":"Purchase or asking price, USD. Gives the implied cap rate. Provide cap_rate, price, or both. Must be greater than 0.","type":"number","minimum":0},"capex_reserve_annual":{"default":0,"description":"Annual capital (replacement) reserve deducted from NOI before capitalizing, USD/yr. 0 if the NOI is already after reserves.","type":"number","minimum":0},"lease_up_costs":{"default":0,"description":"One-time costs to reach the stabilized NOI (TI, leasing commissions, lost rent during lease-up), USD, deducted from the capitalized value.","type":"number","minimum":0},"free_rent_burn_off":{"default":0,"description":"Free rent still to be given under signed leases (rent the stabilized NOI assumes but the owner will not collect), USD, deducted from the capitalized value.","type":"number","minimum":0},"other_adjustments":{"default":[],"description":"Further below-the-line value adjustments, applied after capitalizing.","maxItems":20,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200,"description":"What the adjustment is, e.g. \"deferred maintenance\" or \"excess land\"."},"amount":{"type":"number","description":"USD added to the value: negative for a deduction (deferred maintenance), positive for an addition (excess land)."}},"required":["label","amount"]}},"area_sf":{"description":"Rentable area in SF, for value per SF. Optional. Must be greater than 0.","type":"number","minimum":0},"round_value_to":{"description":"Also report the as-is value rounded to this increment (half away from zero), e.g. 100000 as appraisers round. Optional. Must be greater than 0.","type":"number","minimum":0}},"required":["noi"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_equity_waterfall","title":"LP/GP equity distribution waterfall","description":"Split periodic project equity cash flows between LP and GP: preferred return (compounding or simple) and return of capital pro rata to capital in either order, an optional GP catch-up, IRR-hurdle tiers with promote splits measured on the LP's IRR, and a residual split. Returns per-period LP and GP contributions and distributions (with the GP's promote) that foot to the cent, and LP, GP, and project IRRs and multiples, with the conventions to confirm against the operating agreement. Deterministic: the same inputs always give the same result, with formula ID calc.equity_waterfall@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"cash_flows":{"minItems":2,"maxItems":600,"type":"array","items":{"type":"number"},"description":"Project-level equity cash flows at t = 0, 1, 2, … periods: negative = capital contributed by the investors, positive = cash available to distribute. At most 600."},"periods_per_year":{"default":1,"description":"Cash-flow periods per year: 1 annual, 4 quarterly, 12 monthly. Sets the pref accrual per period and annualizes the IRRs.","type":"integer","minimum":1,"maximum":12},"lp_share":{"type":"number","maximum":1,"description":"Share of every contribution funded by the LP, e.g. 0.9; the GP co-invests the rest (1 for no GP capital). Capital, pref, and the non-promote part of every split are shared in this ratio. Must be greater than 0.","minimum":0},"pref":{"description":"Preferred return on unreturned capital, paid to all investors pro rata to capital. Omit for none.","type":"object","properties":{"rate_annual":{"type":"number","description":"Preferred return, annual, e.g. 0.08. Must be greater than 0. Must be less than 1.","minimum":0,"maximum":1},"compounding":{"default":"compound","description":"\"compound\": unpaid pref earns pref, at the effective periodic rate (1 + rate)^(1 ÷ periods_per_year) − 1, so a fully paid pref is an IRR of rate on the capital. \"simple\": each period accrues unreturned capital × rate ÷ periods_per_year, and unpaid pref earns nothing.","type":"string","enum":["compound","simple"]}},"required":["rate_annual"]},"distribution_order":{"default":"pref_then_capital","description":"Which comes first from each distribution: accrued pref, then return of capital (the usual order), or capital first.","type":"string","enum":["pref_then_capital","capital_then_pref"]},"catch_up":{"description":"GP catch-up after the pref and return of capital. Omit for none.","type":"object","properties":{"gp_share":{"type":"number","maximum":1,"description":"Share of each catch-up dollar paid to the GP as promote, e.g. 1 for a full catch-up or 0.5 for a 50% catch-up; the rest goes to the investors pro rata. Must be greater than 0.","minimum":0},"target_promote":{"type":"number","description":"Catch-up continues until the GP's promote is this share of all profit distributed so far (everything other than return of capital), e.g. 0.2. Must be below gp_share. Must be greater than 0. Must be less than 1.","minimum":0,"maximum":1}},"required":["gp_share","target_promote"]},"tiers":{"default":[],"description":"IRR-hurdle tiers after the catch-up, in increasing until_irr order: each distributes with its promote until the LP's IRR reaches until_irr.","maxItems":10,"type":"array","items":{"type":"object","properties":{"until_irr":{"type":"number","description":"LP IRR hurdle (annual, as calc_irr annualizes) that ends this tier, e.g. 0.12. Must be greater than 0. Must be less than 10.","minimum":0,"maximum":10},"promote":{"type":"number","minimum":0,"description":"Share of each dollar in this tier paid to the GP as promote, e.g. 0.2 for an 80/20 split; the rest goes to the investors pro rata to capital. Must be less than 1.","maximum":1}},"required":["until_irr","promote"]}},"residual_promote":{"default":0,"description":"GP promote share of everything after the last tier, e.g. 0.3 for a 70/30 split. Must be less than 1.","type":"number","minimum":0,"maximum":1}},"required":["cash_flows","lp_share"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_exchange_1031","title":"1031 exchange deadlines, identification, and boot","description":"Not tax advice: arithmetic only. The 45-day identification and 180-day exchange deadlines of IRC §1031(a)(3) (the exchange period ends earlier at a given tax-return due date), the three-property, 200%, and 95% identification tests of Treas. Reg. §1.1031(k)-1(c)(4), and the cash boot, mortgage boot, debt replacement, and trade-down of an exchange, with the boot-limited gain when the basis is given. Deterministic: the same inputs always give the same result, with formula ID calc.exchange_1031@2, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"relinquished_transfer_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Date the relinquished property was transferred (closed), YYYY-MM-DD. With several relinquished properties, the earliest transfer starts both periods."},"tax_return_due_date":{"description":"Due date, including extensions, of the taxpayer's federal return for the year of the transfer, YYYY-MM-DD. IRC §1031(a)(3)(B) ends the exchange period on this date if it is earlier than day 180. FactLot does not compute it.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"as_of":{"description":"Date to count the days remaining from, YYYY-MM-DD. Optional.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"relinquished":{"type":"object","properties":{"sale_price":{"type":"number","description":"Contract sale price (fair market value) of the relinquished property, USD. Also the base of the 200% identification test. Must be greater than 0.","minimum":0},"selling_expenses":{"default":0,"description":"Exchange and closing expenses paid at the sale (commissions, title, QI fees), USD.","type":"number","minimum":0},"debt_relieved":{"default":0,"description":"Mortgages and other liabilities paid off or assumed by the buyer at the sale, USD.","type":"number","minimum":0},"adjusted_basis":{"description":"Taxpayer's adjusted basis in the relinquished property, USD. Optional; adds the realized gain and the boot-limited gain.","type":"number","minimum":0}},"required":["sale_price"],"description":"The property given up."},"cash_received_at_sale":{"default":0,"description":"Cash the taxpayer took from the sale proceeds instead of leaving them with the qualified intermediary, USD.","type":"number","minimum":0},"replacement":{"description":"The property acquired (in total). Omit to check only the deadlines and identification.","type":"object","properties":{"purchase_price":{"type":"number","minimum":0,"description":"Total price of the replacement property or properties acquired, USD."},"acquisition_costs":{"default":0,"description":"Closing costs paid at the purchase, USD.","type":"number","minimum":0},"new_debt":{"default":0,"description":"New or assumed mortgage debt on the replacement property, USD.","type":"number","minimum":0}},"required":["purchase_price"]},"identified_properties":{"default":[],"description":"Replacement properties identified in writing. Empty to skip the identification checks.","maxItems":100,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Label for the identified property."},"fair_market_value":{"type":"number","description":"Fair market value at the end of the identification period, USD. Must be greater than 0.","minimum":0},"identified_date":{"description":"Date the written identification was delivered, YYYY-MM-DD. Optional; checked against the 45-day deadline.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"received":{"default":false,"description":"Whether the taxpayer acquired this property.","type":"boolean"},"received_date":{"description":"Date it was acquired, YYYY-MM-DD. Optional; checked against the exchange deadline.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"required":["name","fair_market_value"]}}},"required":["relinquished_transfer_date","relinquished"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_hotel_metrics","title":"Hotel operating metrics (USALI)","description":"Occupancy, ADR, RevPAR, TRevPAR, and a USALI-style profit ladder for a period: departmental profit, GOP and margin, GOPPAR, management fees, EBITDA, FF&E reserve, and NOI (EBITDA less replacement reserve). Deterministic: the same inputs always give the same result, with formula ID calc.hotel_metrics@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"nights":{"type":"integer","description":"Nights in the period, e.g. 365 for a year or 30 for a month.","minimum":1},"rooms":{"type":"integer","description":"Rooms in inventory (keys).","minimum":1},"rooms_out_of_order":{"default":0,"description":"Room-nights (rooms × nights, not rooms) taken off the market in the period, e.g. 20 rooms closed for a 30-night renovation = 600. Subtracted from rooms × nights to give rooms available. USALI (11th ed.) keeps short-term out-of-order rooms in rooms available; include only rooms formally removed from sale.","type":"integer","minimum":0},"rooms_sold":{"type":"integer","minimum":0,"description":"Room-nights occupied by paying guests in the period (USALI: rooms sold, excluding complimentary rooms)."},"room_revenue":{"type":"number","minimum":0,"description":"Rooms revenue for the period, USD (USALI Rooms department revenue, net of taxes and allowances)."},"fb_revenue":{"default":0,"description":"Food and beverage revenue, USD (USALI Food and Beverage department revenue).","type":"number","minimum":0},"other_revenue":{"default":0,"description":"Other operated departments plus miscellaneous income, USD (USALI Other Operated Departments and Miscellaneous Income).","type":"number","minimum":0},"departmental_expenses":{"default":0,"description":"Total departmental expenses, USD: rooms, F&B, and other operated departments (USALI Total Departmental Expenses).","type":"number","minimum":0},"undistributed_expenses":{"default":0,"description":"Total undistributed operating expenses, USD: administrative and general, information and telecommunications, sales and marketing, property operation and maintenance, utilities (USALI Total Undistributed Operating Expenses).","type":"number","minimum":0},"management_fee_rate":{"default":0,"description":"Base management fee as a share of total operating revenue, e.g. 0.03 (USALI Management Fees). Must be less than 1.","type":"number","minimum":0,"maximum":1},"management_fee_fixed":{"default":0,"description":"Fixed or incentive management fee for the period, USD, added to the percentage fee (USALI Management Fees).","type":"number","minimum":0},"non_operating_expenses":{"default":0,"description":"Property taxes, insurance, ground rent, and other non-operating expenses, USD (USALI Non-Operating Income and Expenses).","type":"number","minimum":0},"ffe_reserve_rate":{"default":0,"description":"FF&E replacement reserve as a share of total operating revenue, e.g. 0.04 (USALI Replacement Reserve, below EBITDA). Must be less than 1.","type":"number","minimum":0,"maximum":1}},"required":["nights","rooms","rooms_sold","room_revenue"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_irr","title":"Internal rate of return","description":"Periodic and annualized IRR of periodic cash flows, as decimals (0.085 = 8.5%), solved deterministically by scanning a 1-point grid of per-period rates and bisecting each sign change; reports every root it finds when cash flows have multiple IRRs (two roots within one grid step can be missed). Errors when the flows do not change sign or no root lies between -99.99% and 1000% per period. Deterministic: the same inputs always give the same result, with formula ID calc.irr@2, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"cash_flows":{"minItems":2,"maxItems":1200,"type":"array","items":{"type":"number"},"description":"Periodic cash flows at t = 0, 1, 2, …; negative for outflows (e.g. purchase price at t = 0). At most 1200."},"periods_per_year":{"default":1,"description":"Cash-flow periods per year, used only to annualize the result: 1 for annual flows, 4 for quarterly, 12 for monthly.","type":"integer","minimum":1}},"required":["cash_flows"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_lease_remeasurement_asc842","title":"Lease remeasurement (ASC 842, lessee)","description":"Remeasure a lessee's lease liability and right-of-use asset under ASC 842 after a modification, lease-term reassessment, contingency resolution, or residual value guarantee change: new liability (PV of remaining payments), liability and ROU adjustments with any gain (ASC 842-20-35-4), and the per-period amortization table (operating: straight-line single lease cost; finance: interest plus amortization) in cents that foots: every row rolls forward exactly, totals are the row sums, and the final period trues up liability and ROU asset to zero. Warns where judgment is needed. Deterministic: the same inputs always give the same result, with formula ID calc.lease_remeasurement_asc842@2, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"classification":{"type":"string","enum":["operating","finance"],"description":"Lessee classification (ASC 842-10-25-2): operating (single straight-line lease cost) or finance (interest on the liability plus straight-line ROU amortization)."},"payments":{"minItems":1,"maxItems":1200,"type":"array","items":{"type":"object","properties":{"period":{"type":"integer","minimum":1,"maximum":1200,"description":"Period index counted from the remeasurement date (1 = first remaining period)."},"amount":{"type":"number","minimum":0,"description":"Lease payment due in that period after the event, USD for the period (a monthly amount when periods_per_year is 12, not annualized): fixed and in-substance fixed payments, less incentives receivable (ASC 842-10-30-5)."}},"required":["period","amount"]},"description":"Remaining lease payments after the event, in ascending period order. Periods not listed carry no payment (rent-free)."},"remaining_periods":{"description":"Remaining lease term in periods after the event. Defaults to the last period index in payments; set it higher when the final periods are rent-free.","type":"integer","minimum":1,"maximum":1200},"payment_timing":{"default":"end","description":"Whether each payment falls at the beginning (in advance) or end (in arrears) of its period.","type":"string","enum":["begin","end"]},"discount_rate_annual":{"type":"number","minimum":0,"description":"Annual discount rate applied to the remaining payments, e.g. 0.06. Nominal: the periodic rate is this ÷ periods_per_year. Must be less than 1.","maximum":1},"periods_per_year":{"default":12,"description":"Payment periods per year (12 for monthly, 4 for quarterly).","type":"integer","minimum":1,"maximum":365},"discount_rate_updated":{"type":"boolean","description":"True when discount_rate_annual was determined at the remeasurement date (ASC 842-10-35-5: required for modifications and lease-term or purchase-option reassessments); false when it is the rate from commencement (kept for contingency resolutions and residual value guarantee changes)."},"liability_before":{"type":"number","minimum":0,"description":"Carrying amount of the lease liability immediately before the remeasurement, USD."},"rou_asset_before":{"type":"number","minimum":0,"description":"Carrying amount of the right-of-use asset immediately before the remeasurement, USD (after any impairment)."},"event":{"type":"string","enum":["modification_extend_term","modification_shorten_term","modification_change_in_payments","reassessment_of_term_or_option","contingency_resolved","residual_value_guarantee_change","index_or_rate_change"],"description":"What triggered the remeasurement: modification_extend_term / modification_shorten_term / modification_change_in_payments (a modification not accounted for as a separate contract, ASC 842-10-25-8 and 25-11), reassessment_of_term_or_option (ASC 842-10-35-1 and 35-4(c)), contingency_resolved (variable payments became fixed, ASC 842-10-35-4(b)), residual_value_guarantee_change (ASC 842-10-35-4(c)(3)), or index_or_rate_change (ASC 842-10-35-4: not a remeasurement trigger by itself; computed as if remeasured for another reason)."}},"required":["classification","payments","discount_rate_annual","discount_rate_updated","liability_before","rou_asset_before","event"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_lease_vs_own","title":"Lease vs. own","description":"Compare leasing with buying over a fixed horizon: NPV of each case's annual cash costs (rent, free rent, tenant expenses, and move-in costs versus equity, debt service, owner expenses, reserves, and a sale at the horizon by stated value or exit cap rate), optionally after tax, with the year-by-year tables and the break-even residual value at which owning equals leasing. Deterministic: the same inputs always give the same result, with formula ID calc.lease_vs_own@2, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"horizon_years":{"type":"integer","minimum":1,"maximum":50,"description":"Analysis horizon in years. Both cases are compared over this period; the own case sells at the end of it."},"discount_rate_annual":{"type":"number","minimum":0,"description":"Annual discount rate as a decimal, e.g. 0.08, applied to both cases' year-end cash flows (year 0 = closing / move-in). Must be less than 1.","maximum":1},"lease":{"type":"object","properties":{"rent":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"schedule"},"annual_rent":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"number","minimum":0},"description":"Rent due in each year of the horizon, USD, year 1 first. Must have exactly horizon_years entries."}},"required":["type","annual_rent"],"description":"Explicit rent per year."},{"type":"object","properties":{"type":{"type":"string","const":"escalating"},"base_rent_annual":{"type":"number","minimum":0,"description":"Year-1 rent, USD per year."},"escalation_rate_annual":{"default":0,"description":"Compounding annual bump, e.g. 0.03: rent_k = base × (1 + e)^(k − 1). Must be less than 1.","type":"number","minimum":0,"maximum":1}},"required":["type","base_rent_annual"],"description":"Base rent with a compounding annual escalation."}],"description":"Annual rent, as an explicit schedule or base rent with escalation."},"free_rent_months":{"default":0,"description":"Rent-free months at the start of the lease, abated from year 1 (and year 2 if more than 12). Must not exceed the horizon.","type":"integer","minimum":0},"operating_expenses_annual":{"default":0,"description":"Year-1 operating expenses borne by the tenant on top of rent (NNN charges, utilities), USD per year.","type":"number","minimum":0},"expense_growth_rate_annual":{"default":0,"description":"Annual growth applied to expenses after year 1, e.g. 0.03 (year k = year-1 amount × (1 + g)^(k − 1)). Must be less than 1.","type":"number","minimum":0,"maximum":1},"upfront_costs":{"default":0,"description":"Tenant's one-time costs at move-in not covered by allowances: TI overage, moving, security deposit treated as cost, USD.","type":"number","minimum":0}},"required":["rent"],"description":"The lease alternative."},"own":{"type":"object","properties":{"purchase_price":{"type":"number","minimum":0,"description":"Purchase price, USD."},"closing_costs":{"default":0,"description":"Acquisition closing costs, USD (added to the purchase price for cash and for depreciable basis).","type":"number","minimum":0},"loan":{"description":"Acquisition financing. Omit for an all-cash purchase.","type":"object","properties":{"amount":{"type":"number","minimum":0,"description":"Loan principal at closing, USD."},"rate_annual":{"type":"number","minimum":0,"description":"Annual interest rate, e.g. 0.065. Must be less than 1.","maximum":1},"amortization_years":{"type":"integer","minimum":0,"maximum":50,"description":"Amortization in years with monthly payments; 0 means interest-only. Any balance outstanding at the horizon is repaid from sale proceeds."}},"required":["amount","rate_annual","amortization_years"]},"operating_expenses_annual":{"default":0,"description":"Year-1 operating expenses borne by the owner (utilities, repairs, management), USD per year.","type":"number","minimum":0},"capex_reserve_annual":{"default":0,"description":"Year-1 capital reserve, USD per year. Treated as a cash cost; not tax-deductible.","type":"number","minimum":0},"property_taxes_annual":{"default":0,"description":"Year-1 property taxes, USD per year.","type":"number","minimum":0},"insurance_annual":{"default":0,"description":"Year-1 property insurance, USD per year.","type":"number","minimum":0},"expense_growth_rate_annual":{"default":0,"description":"Annual growth applied to expenses after year 1, e.g. 0.03 (year k = year-1 amount × (1 + g)^(k − 1)). Must be less than 1.","type":"number","minimum":0,"maximum":1},"residual":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"value"},"amount":{"type":"number","minimum":0,"description":"Expected gross sale price at the end of the horizon, USD."}},"required":["type","amount"],"description":"A stated residual value."},{"type":"object","properties":{"type":{"type":"string","const":"exit_cap"},"cap_rate":{"type":"number","description":"Exit capitalization rate, e.g. 0.07. Must be greater than 0. Must be less than 1.","minimum":0,"maximum":1},"stabilized_noi":{"type":"number","minimum":0,"description":"Stabilized NOI the property would earn if leased at market in the year after the horizon, USD per year."}},"required":["type","cap_rate","stabilized_noi"],"description":"Residual = stabilized NOI ÷ exit cap rate (direct capitalization)."}],"description":"How the sale price at the horizon is set."},"selling_costs_rate":{"default":0,"description":"Brokerage and closing costs on sale as a share of the sale price, e.g. 0.03. Must be less than 1.","type":"number","minimum":0,"maximum":1},"tax":{"description":"Optional after-tax comparison. When omitted (the default), both cases are compared pre-tax. Operating expenses, property taxes, and insurance are always deductible when this block is present; the gain on sale is taxed at the marginal rate (no separate recapture rate).","type":"object","properties":{"marginal_tax_rate":{"type":"number","minimum":0,"description":"Combined marginal income tax rate applied to deductions and to the gain on sale, e.g. 0.26. Must be less than 1.","maximum":1},"depreciation_life_years":{"default":39,"description":"Straight-line depreciation life for the building (39 for US non-residential real property). No mid-month convention.","type":"integer","minimum":1,"maximum":100},"land_share":{"default":0.2,"description":"Share of purchase price plus closing costs allocated to land, which is not depreciated. Must be less than 1.","type":"number","minimum":0,"maximum":1},"rent_deductible":{"default":true,"description":"Whether rent paid in the lease case is deductible (true for an operating business).","type":"boolean"},"interest_deductible":{"default":true,"description":"Whether loan interest in the own case is deductible.","type":"boolean"},"depreciation_deductible":{"default":true,"description":"Whether depreciation in the own case is deductible.","type":"boolean"}},"required":["marginal_tax_rate"]}},"required":["purchase_price","residual"],"description":"The purchase alternative."}},"required":["horizon_years","discount_rate_annual","lease","own"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_multifamily_rent_roll","title":"Multifamily rent roll","description":"Analyze an apartment rent roll (up to 5,000 units with status occupied, notice, vacant, model, or down; market and lease rent per month; lease dates; concessions as weeks free, months free, or dollars): gross potential rent, vacancy, non-revenue units, loss to lease, concessions amortised straight-line over each lease term, effective rent income, physical and economic occupancy, effective rent per unit and per SF, a lease expiration schedule by month, and a per-unit-type summary. Single-lease mode (lease instead of units) returns the effective monthly rent after a weeks-free or months-free concession. Deterministic: the same inputs always give the same result, with formula ID calc.multifamily_rent_roll@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"as_of":{"description":"Rent roll date, YYYY-MM-DD. Required with units: leases that ended before it are month-to-month, and expirations are scheduled from it.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"units":{"description":"Rent roll mode: every unit in the property, one row each (up to 5,000). Give units or lease, not both.","minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"unit_id":{"type":"string","minLength":1,"maxLength":100,"description":"Unit number or ID as on the rent roll, e.g. \"101\"."},"unit_type":{"description":"Floor plan or type, e.g. \"1x1\" or \"A2\". Groups the per-type summary; defaults to the bedroom count.","type":"string","minLength":1,"maxLength":100},"bedrooms":{"description":"Bedrooms (0 = studio). Used to group units when unit_type is absent.","type":"integer","minimum":0,"maximum":20},"sf":{"description":"Unit square feet. Needed for per-SF figures. Must be greater than 0.","type":"number","minimum":0},"status":{"type":"string","enum":["occupied","vacant","notice","model","down"],"description":"occupied (leased and in place), notice (leased, the resident has given notice to vacate), vacant, model, or down (offline). Occupied and notice units are leased; model and down units are non-revenue."},"market_rent":{"type":"number","minimum":0,"description":"Market (asking) rent per month for the unit, USD."},"lease_rent":{"description":"Contract (lease) rent per month, USD, before concessions. Required for occupied and notice units; ignored for vacant, model, and down units.","type":"number","minimum":0},"lease_start":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Lease start date, YYYY-MM-DD."},"lease_end":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Lease end date (last day), YYYY-MM-DD. A lease that ended before as_of is month-to-month."},"lease_term_months":{"type":"number","maximum":120,"description":"Lease term in months for amortising the concession, e.g. 12. Defaults to the term from lease_start to lease_end. Must be greater than 0.","minimum":0},"concession":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"weeks_free"},"weeks":{"type":"number","maximum":104,"description":"Weeks of free rent, e.g. 6. Must be greater than 0.","minimum":0}},"required":["type","weeks"],"description":"Weeks free: worth lease_rent × 12 ÷ 52 per week (a week of a year's rent)."},{"type":"object","properties":{"type":{"type":"string","const":"months_free"},"months":{"type":"number","maximum":24,"description":"Months of free rent, e.g. 1 or 1.5. Must be greater than 0.","minimum":0}},"required":["type","months"],"description":"Months free: worth lease_rent × months."},{"type":"object","properties":{"type":{"type":"string","const":"amount"},"amount":{"type":"number","minimum":0,"description":"Total concession over the lease in USD, e.g. a $500 look-and-lease credit."}},"required":["type","amount"],"description":"A dollar concession for the whole lease."}],"description":"Concession on this lease: weeks_free, months_free, or a dollar amount. Amortised straight-line over the lease term; needs lease_term_months or lease_start and lease_end."}},"required":["unit_id","status","market_rent"]}},"lease":{"description":"Single-lease mode: the effective monthly rent of one lease after a weeks-free, months-free, or dollar concession. Give units or lease, not both.","type":"object","properties":{"lease_rent":{"type":"number","minimum":0,"description":"Contract (lease) rent per month, USD, before concessions."},"market_rent":{"description":"Market (asking) rent per month, USD, for the loss to lease. Optional.","type":"number","minimum":0},"sf":{"description":"Unit square feet, for effective rent per SF. Optional. Must be greater than 0.","type":"number","minimum":0},"lease_start":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Lease start date, YYYY-MM-DD."},"lease_end":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Lease end date (last day), YYYY-MM-DD. A lease that ended before as_of is month-to-month."},"lease_term_months":{"description":"Lease term in months, e.g. 12. Give this, or lease_start and lease_end. Must be greater than 0.","type":"number","maximum":120,"minimum":0},"concession":{"description":"Concession: weeks_free, months_free, or a dollar amount, amortised straight-line over the term. Omit for none.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"weeks_free"},"weeks":{"type":"number","maximum":104,"description":"Weeks of free rent, e.g. 6. Must be greater than 0.","minimum":0}},"required":["type","weeks"],"description":"Weeks free: worth lease_rent × 12 ÷ 52 per week (a week of a year's rent)."},{"type":"object","properties":{"type":{"type":"string","const":"months_free"},"months":{"type":"number","maximum":24,"description":"Months of free rent, e.g. 1 or 1.5. Must be greater than 0.","minimum":0}},"required":["type","months"],"description":"Months free: worth lease_rent × months."},{"type":"object","properties":{"type":{"type":"string","const":"amount"},"amount":{"type":"number","minimum":0,"description":"Total concession over the lease in USD, e.g. a $500 look-and-lease credit."}},"required":["type","amount"],"description":"A dollar concession for the whole lease."}]}},"required":["lease_rent"]},"include_units":{"default":false,"description":"Rent roll mode: include a per-unit table with loss to lease, amortised concession, and effective rent (can be long).","type":"boolean"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_net_effective_rent","title":"Net effective rent (NER)","description":"Compute effective rent, straight-line net effective rent, and discounted net effective rent ($/SF/yr) after free rent, TI allowance, leasing commissions, and other landlord concessions. Rent is monthly in advance from the commencement day (no calendar proration), discounted at annual rate ÷ 12. schedule.unit (kw, mw, unit, acre, key, room, space) reports $/kW/yr, $/acre/yr and so on instead of $/SF/yr. Deterministic: the same inputs always give the same result, with formula ID calc.net_effective_rent@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"schedule":{"type":"object","properties":{"commencement_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Rent commencement date, YYYY-MM-DD. Month n starts on this day-of-month (clamped to month end)."},"term_months":{"type":"integer","maximum":1200,"description":"Lease term in months, e.g. 120 for ten years.","minimum":1},"area_sf":{"type":"number","description":"Rentable square feet, or the quantity leased in unit (kW, MW, units, acres, keys, rooms, spaces) when unit is set. Must be greater than 0.","minimum":0},"starting_rent_psf_annual":{"type":"number","minimum":0,"description":"Year-one base rent in dollars per SF per year (annual, not monthly), e.g. 42.5; per unit per year when unit is set (a $/kW/month quote × 12)."},"escalation":{"default":{"type":"none"},"description":"How base rent escalates. Omit for flat rent.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"description":"Flat rent for the whole term."},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"rate":{"type":"number","description":"Bump as a decimal, e.g. 0.03 for 3%. Bumps compound. Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","rate"],"description":"Percentage bumps: rate_k = starting_rate × (1 + rate)^k."},{"type":"object","properties":{"type":{"type":"string","const":"fixed_psf"},"amount":{"type":"number","description":"Dollars per SF per year (or per unit per year when unit is set) added at each bump, e.g. 0.50."},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","amount"],"description":"Fixed $/SF bumps: rate_k = starting_rate + amount × k."}]},"abated_months":{"default":[],"description":"Fully abated (free) months, 1-based from commencement (e.g. [1,2,3] for three months free up front). Each listed month's base rent is zero.","maxItems":1200,"type":"array","items":{"type":"integer","minimum":1}},"round_rate_to_cents":{"default":false,"description":"Round each step's $/SF/yr to cents, as many lease rent tables do.","type":"boolean"},"include_monthly":{"default":false,"description":"Include a month-by-month table (can be long).","type":"boolean"},"unit":{"description":"What area_sf and the per-SF fields measure: sf (default, square feet), kw or mw (data-center critical load), unit (apartment or other unit), acre (ground or yard lease), key or room (hotel), or space (parking). Every number is computed exactly as for square feet; the unit changes labels, steps, and warnings and adds unit and rate_unit to the result. Fields keep their _sf and _psf names: with unit kw, area_sf holds kW and starting_rent_psf_annual holds $/kW/yr. Omit for square feet.","type":"string","enum":["sf","kw","mw","unit","acre","key","room","space"]}},"required":["commencement_date","term_months","area_sf","starting_rent_psf_annual"],"description":"The lease's base-rent terms (same input as calc_rent_schedule)."},"ti_allowance_psf":{"default":0,"description":"Landlord-funded tenant improvement allowance, USD per SF (per schedule.unit when set), paid once at commencement (not per year).","type":"number","minimum":0},"leasing_commissions":{"default":0,"description":"Total leasing commissions paid by landlord, USD.","type":"number","minimum":0},"other_concessions":{"default":0,"description":"Any other landlord concessions paid at commencement (moving allowance, buyout), USD.","type":"number","minimum":0},"discount_rate_annual":{"default":0,"description":"Annual discount rate as a decimal, e.g. 0.08 (monthly rate = annual ÷ 12); 0 gives the undiscounted (straight-line) NER. Must be less than 1.","type":"number","minimum":0,"maximum":1}},"required":["schedule"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_npv","title":"Net present value","description":"NPV of periodic cash flows (t = 0, 1, 2, ...; the t = 0 flow is not discounted) at a per-period discount rate given as a decimal. Deterministic: the same inputs always give the same result, with formula ID calc.npv@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"cash_flows":{"minItems":2,"maxItems":10000,"type":"array","items":{"type":"number"},"description":"Periodic cash flows at t = 0, 1, 2, …; negative for outflows (e.g. purchase price at t = 0). At most 10000."},"rate":{"type":"number","description":"Discount rate per period as a decimal, e.g. 0.08 for 8%. Match the cash-flow period: for monthly flows pass the monthly rate (e.g. 0.06 ÷ 12 = 0.005). Must be greater than -1.","minimum":-1}},"required":["cash_flows","rate"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_percentage_rent","title":"Retail percentage rent","description":"Percentage (overage) rent for a lease year: net sales after exclusions over a natural or fixed breakpoint, prorated for partial years, less amounts already paid. Deterministic: the same inputs always give the same result, with formula ID calc.percentage_rent@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"gross_sales":{"type":"number","minimum":0,"description":"Gross sales reported for the lease year (or partial year), USD."},"sales_exclusions":{"default":0,"description":"Sales excluded by the lease (returns, sales tax, gift cards, employee sales, …), USD.","type":"number","minimum":0},"rate":{"type":"number","description":"Percentage rent rate, e.g. 0.06 for 6%. Must be greater than 0. Must be less than 1.","minimum":0,"maximum":1},"base_rent_annual":{"type":"number","minimum":0,"description":"Annual base rent, USD per year (a full lease year, even for a partial period); used for the natural breakpoint."},"breakpoint":{"default":{"type":"natural"},"description":"Breakpoint above which percentage rent applies. Default: natural.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"natural"}},"required":["type"],"description":"Natural breakpoint = annual base rent ÷ rate."},{"type":"object","properties":{"type":{"type":"string","const":"fixed"},"amount":{"type":"number","minimum":0,"description":"Annual sales breakpoint stated in the lease, USD."}},"required":["type","amount"],"description":"Artificial (fixed) breakpoint stated in the lease."}]},"period_fraction":{"default":1,"description":"Fraction of a full lease year covered (e.g. 0.5 for a six-month partial year). Prorates the breakpoint. Must be greater than 0.","type":"number","maximum":1,"minimum":0},"percentage_rent_paid":{"default":0,"description":"Percentage rent already paid during the period, USD.","type":"number","minimum":0}},"required":["gross_sales","rate","base_rent_annual"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_prepayment_and_defeasance","title":"Loan prepayment premium and defeasance","description":"Prepayment premium, total payoff, and cost as a share of balance for a fixed-rate amortizing or interest-only loan under yield maintenance (PV of remaining payments or rate differential, with a minimum and an explicit discounting convention), a step-down schedule, a flat percentage, or defeasance (cost of the securities portfolio that funds the remaining payments plus stated costs). Deterministic: the same inputs always give the same result, with formula ID calc.prepayment_and_defeasance@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"balance":{"type":"number","description":"Outstanding principal balance at the payoff date, USD. Must be greater than 0.","minimum":0},"note_rate_annual":{"type":"number","minimum":0,"description":"Fixed annual note rate, e.g. 0.055. Must be less than 1.","maximum":1},"remaining_term_months":{"type":"integer","minimum":1,"maximum":600,"description":"Months from the payoff date to the loan's maturity date (the balloon is due with the final payment)."},"amortization_months":{"type":"integer","minimum":0,"maximum":720,"description":"Remaining amortization basis in months at the payoff date (e.g. 300 for a 30-year schedule with 5 years elapsed); 0 for interest-only. Must be at least remaining_term_months."},"accrued_interest":{"default":0,"description":"Accrued but unpaid interest to the payoff date, USD; added to the total payoff.","type":"number","minimum":0},"prepayment":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"yield_maintenance"},"treasury_rate_annual":{"type":"number","minimum":0,"description":"Yield on the reference Treasury (usually the one maturing closest to the loan's maturity), e.g. 0.041. Must be less than 1.","maximum":1},"spread_annual":{"default":0,"description":"Spread added to the Treasury yield for discounting, e.g. 0.005 when the note says 'Treasury plus 50 basis points'. Default 0 (Treasury flat). Must be less than 1.","type":"number","minimum":0,"maximum":1},"minimum_pct":{"default":0.01,"description":"Minimum premium as a fraction of the balance, e.g. 0.01 for a 1% floor (default). 0 for no floor. Must be less than 1.","type":"number","minimum":0,"maximum":1},"basis":{"default":"pv_of_payments","description":"pv_of_payments (default): premium = PV of the remaining scheduled payments at the discount rate − balance. rate_differential: premium = PV of (note rate − discount rate) ÷ 12 × scheduled balance for each remaining month.","type":"string","enum":["pv_of_payments","rate_differential"]},"discount_convention":{"default":"monthly","description":"Compounding convention for the discount rate. monthly (default): monthly rate = annual ÷ 12. semiannual: annual is a bond-equivalent yield, monthly rate = (1 + annual ÷ 2)^(1/6) − 1. Lenders differ; read the note.","type":"string","enum":["monthly","semiannual"]}},"required":["type","treasury_rate_annual"],"description":"Yield maintenance."},{"type":"object","properties":{"type":{"type":"string","const":"step_down"},"loan_month":{"type":"integer","minimum":1,"description":"Loan month (1 = first month after origination) in which the payoff occurs."},"schedule":{"minItems":1,"maxItems":1200,"type":"array","items":{"type":"object","properties":{"through_month":{"type":"integer","minimum":1,"description":"Last loan month in which this percentage applies."},"pct":{"type":"number","minimum":0,"description":"Premium as a fraction of the balance, e.g. 0.05 for 5%. Must be less than 1.","maximum":1}},"required":["through_month","pct"]},"description":"Step-down schedule in ascending through_month order, e.g. 5-4-3-2-1. After the last through_month the loan is open (0%)."}},"required":["type","loan_month","schedule"],"description":"Step-down (declining percentage) premium."},{"type":"object","properties":{"type":{"type":"string","const":"fixed_pct"},"pct":{"type":"number","minimum":0,"description":"Premium as a fraction of the balance, e.g. 0.02. Must be less than 1.","maximum":1}},"required":["type","pct"],"description":"Flat percentage premium."},{"type":"object","properties":{"type":{"type":"string","const":"defeasance"},"replacement_yield":{"anyOf":[{"type":"number","minimum":0,"description":"One flat annual yield for all replacement securities. Must be less than 1.","maximum":1},{"minItems":1,"maxItems":1200,"type":"array","items":{"type":"object","properties":{"months":{"type":"integer","minimum":1,"description":"Months from the payoff date up to and including which this yield applies; points in ascending order."},"rate":{"type":"number","minimum":0,"description":"Annual yield on replacement securities maturing at or before that month, e.g. 0.042. Must be less than 1.","maximum":1}},"required":["months","rate"]},"description":"Yield curve as a step function: each payment uses the first point whose months ≥ its month; beyond the last point, the last rate."}],"description":"Yield on the government securities bought to fund the remaining payments: a flat annual rate, or a list of {months, rate} points."},"costs":{"default":0,"description":"Stated transaction costs, USD: defeasance consultant, legal, accountant, rating agency, servicer and custodian fees.","type":"number","minimum":0},"discount_convention":{"default":"monthly","description":"Compounding convention for the discount rate. monthly (default): monthly rate = annual ÷ 12. semiannual: annual is a bond-equivalent yield, monthly rate = (1 + annual ÷ 2)^(1/6) − 1. Lenders differ; read the note.","type":"string","enum":["monthly","semiannual"]}},"required":["type","replacement_yield"],"description":"Defeasance: buy securities that replicate the remaining payments."}],"description":"Prepayment provision from the note."}},"required":["balance","note_rate_annual","remaining_term_months","amortization_months","prepayment"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_reconcile_cam","title":"Tie out CAM reconciliations against another system's results","description":"Reconcile FactLot's CAM reconciliation for one expense pool with another system's per-tenant results (Yardi or any other; parity is not claimed and is untested against a real export): give the calc_cam_reconciliation_batch input plus, per tenant, what the other system reported (share, gross-up, cap limit and reduction, admin fee, base-year or stop deduction, billed amount, estimates, balance; billed_amount required) and a tolerance. Returns per tenant and line FactLot's amount, the other amount, the difference and whether it is within tolerance, tenants missing on either side, and likely causes worded as hypotheses to check: a different pro rata share (and, when every share differs by one factor, the pool's denominator), or a FactLot rerun that matches the other system with lines left to the default controllable: true set uncontrollable, the cap's base year one year off, the other cap method, the other gross-up target or no gross-up, the admin fee before or after and within or outside the cap, or no fee on uncontrollable lines; and differing estimates paid. Deterministic: the same inputs always give the same result, with formula ID calc.reconcile_cam@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"cam":{"type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2200,"description":"Calendar or lease year being reconciled."},"expenses":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"category":{"type":"string","minLength":1,"maxLength":200,"description":"Expense line as named in the operating statement, e.g. \"janitorial\"."},"amount":{"type":"number","minimum":0,"description":"Building-level actual expense for the year, USD."},"controllable":{"default":true,"description":"Subject to the cap. Taxes, insurance, and utilities are typically uncontrollable. Default true; under a cap, lines left unset are named in warnings.","type":"boolean"},"recoverable":{"default":true,"description":"Excluded expenses (capital items, landlord-only costs) are dropped entirely.","type":"boolean"},"variable":{"default":false,"description":"Varies with occupancy, so eligible for gross-up (janitorial, utilities, management fee). Default false; with a gross-up, lines left unset are named in warnings.","type":"boolean"},"admin_fee_applies":{"default":true,"description":"Included in the admin_fee base. Set false for lines the lease excludes from the fee (often taxes, insurance, utilities, or a management fee already charged).","type":"boolean"}},"required":["category","amount"]},"description":"The building's operating expense pool for the year, entered once for every tenant: category, amount, controllable, recoverable, variable, admin_fee_applies."},"gross_up":{"description":"Gross up variable expenses to the target occupancy when actual occupancy is lower. Omit if the lease has no gross-up.","type":"object","properties":{"actual_occupancy":{"type":"number","maximum":1,"description":"Average occupancy for the year, e.g. 0.82. Must be greater than 0.","minimum":0},"target_occupancy":{"default":0.95,"description":"Gross-up occupancy stated in the lease (commonly 0.95 or 1.0). Must be greater than 0.","type":"number","maximum":1,"minimum":0}},"required":["actual_occupancy"]},"tenants":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Tenant or suite label, unique, e.g. \"Suite 200 – Acme\"."},"pro_rata_share":{"type":"number","maximum":1,"description":"Tenant's pro rata share, 0 < share ≤ 1 (e.g. 12,000 / 150,000 = 0.08). Must be greater than 0.","minimum":0},"structure":{"default":{"type":"net"},"description":"Expense structure from the lease. Default: net.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"net"}},"required":["type"],"description":"Tenant pays its full share of recoverable expenses (NNN / net)."},{"type":"object","properties":{"type":{"type":"string","const":"base_year"},"base_year_expenses":{"type":"number","minimum":0,"description":"Total building recoverable expenses in the base year, already grossed up, USD."}},"required":["type","base_year_expenses"],"description":"Tenant pays its share of the excess over base-year expenses."},{"type":"object","properties":{"type":{"type":"string","const":"expense_stop"},"stop_amount":{"type":"number","minimum":0,"description":"Building-level expense stop, USD per year."}},"required":["type","stop_amount"],"description":"Tenant pays its share of the excess over a fixed expense stop."}]},"cap":{"description":"Cap on the tenant's share of controllable expenses. Omit if the lease has no cap.","type":"object","properties":{"method":{"type":"string","enum":["compounding_from_base","simple_from_base","year_over_year"],"description":"compounding_from_base: reference × (1+rate)^years (often called cumulative, compounding). simple_from_base: reference × (1 + rate × years) (cumulative, non-compounding). year_over_year: prior year's capped amount × (1+rate) (non-cumulative). Map the lease language to one of these explicitly."},"rate":{"type":"number","description":"Annual cap as a decimal, e.g. 0.05. Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"reference_amount":{"type":"number","minimum":0,"description":"Tenant's share of controllable expenses in the reference year: the base year for *_from_base, or the prior year's capped amount for year_over_year, USD."},"years_elapsed":{"description":"Years since the base year (required for `*_from_base`).","type":"integer","minimum":0}},"required":["method","rate","reference_amount"]},"admin_fee":{"description":"Administrative fee the lease adds to the tenant's share. Omit if the lease has none.","type":"object","properties":{"rate":{"type":"number","description":"Administrative or management fee as a decimal of the fee base, e.g. 0.15 for 15%. The base is the tenant's share of recoverable lines with admin_fee_applies (after gross-up). Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"applied":{"default":"after_cap","description":"Fee on controllable lines computed on the tenant's share before the cap (before_cap) or on the capped amount (after_cap). Fees on uncontrollable lines are never capped. Irrelevant without a cap.","type":"string","enum":["before_cap","after_cap"]},"capped":{"default":false,"description":"True when the fee on controllable lines counts toward the controllable cap (controllable share plus fee may not exceed the cap limit); false adds it outside the cap.","type":"boolean"}},"required":["rate"]},"occupancy":{"description":"Partial-year occupancy: the tenant's share, cap limit, and base-year or stop deduction are prorated by occupied days ÷ period days (both inclusive), so a full-year cap and base are not applied to a part year. Omit for a full year.","type":"object","properties":{"move_in_date":{"description":"Date the tenant's share starts within the reconciliation period, YYYY-MM-DD (inclusive). Defaults to period_start_date.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"move_out_date":{"description":"Last day of the tenant's share within the period, YYYY-MM-DD (inclusive). Defaults to period_end_date.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"period_start_date":{"description":"First day of the reconciliation period, YYYY-MM-DD. Defaults to January 1 of year; set it for a lease year.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"period_end_date":{"description":"Last day of the reconciliation period, YYYY-MM-DD (at most 366 days after the start). Defaults to December 31 of year.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}}},"estimates_paid":{"default":0,"description":"Estimated CAM payments the tenant made during the year, USD (total for the year, not monthly).","type":"number","minimum":0},"excluded_categories":{"default":[],"description":"Expense categories this tenant's lease excludes, treated as recoverable: false for this tenant only. Each must match a category in expenses.","maxItems":1000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"admin_fee_excluded_categories":{"default":[],"description":"Expense categories this tenant's lease keeps out of the admin fee base, treated as admin_fee_applies: false for this tenant only. Each must match a category in expenses.","maxItems":1000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["name","pro_rata_share"]},"description":"Every tenant to reconcile (up to 500): each one's share, structure (base year or stop), cap, admin fee, occupancy, estimates paid, and lease-specific exclusions. Each statement equals calc_cam_reconciliation for that tenant."}},"required":["year","expenses","tenants"],"description":"The FactLot CAM input for one expense pool, exactly as calc_cam_reconciliation_batch takes it (the same pool, shares and lease terms you entered in the other system)."},"other":{"type":"object","properties":{"system":{"default":"other system","description":"Name of the system or file the results come from, echoed in the result, e.g. \"Yardi CAM recon export\" (free text).","type":"string","minLength":1,"maxLength":200},"pool":{"description":"The pool these results are for, e.g. \"CAM\", echoed in the result.","type":"string","minLength":1,"maxLength":200},"tenants":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"tenant":{"type":"string","minLength":1,"maxLength":200,"description":"Tenant as the other system names it; matched to cam.tenants[].name exactly, else ignoring case and punctuation."},"pool":{"description":"The other system's expense pool for this row, e.g. \"CAM\" (echoed; reconcile one pool per call).","type":"string","minLength":1,"maxLength":200},"pro_rata_share":{"description":"The other system's pro rata share for the tenant, 0 < share ≤ 1. Must be greater than 0.","type":"number","maximum":1,"minimum":0},"gross_up_applied":{"description":"Whether the other system grossed up variable expenses for this tenant.","type":"boolean"},"grossed_up_expenses":{"description":"The other system's pool after gross-up (the building amount before the tenant's share), USD.","type":"number","minimum":0},"cap_applied":{"description":"Whether a cap reduced the other system's charge.","type":"boolean"},"cap_limit":{"description":"The other system's cap limit on the tenant's controllable share, USD.","type":"number","minimum":0},"cap_reduction":{"description":"Amount the cap removed in the other system, USD.","type":"number","minimum":0},"admin_fee_applied":{"description":"Whether the other system charged an admin fee.","type":"boolean"},"admin_fee":{"description":"The other system's admin or management fee for the tenant, USD.","type":"number","minimum":0},"structure_deduction":{"description":"The other system's base-year or expense-stop deduction, USD.","type":"number","minimum":0},"billed_amount":{"type":"number","minimum":0,"description":"What the other system billed the tenant for the year before estimates (FactLot's tenant_charge), USD."},"estimates_paid":{"description":"Estimates (prior billings) the other system credits for the year, USD.","type":"number","minimum":0},"balance_due":{"description":"The other system's balance due (negative for a credit), USD.","type":"number"}},"required":["tenant","billed_amount"]},"description":"The other system's per-tenant results for this pool. Give whatever it reports; billed_amount is required."}},"required":["tenants"],"description":"What the other system reported for the same pool and year."},"tolerance":{"default":{"absolute":1,"relative":0,"share":1e-06},"description":"When two amounts agree: |FactLot − other| ≤ max(absolute, relative × |other|); shares within share. Default: 1.00 USD, 0, and 0.000001.","type":"object","properties":{"absolute":{"default":1,"description":"Largest difference, USD, still counted as agreeing (default 1.00).","type":"number","minimum":0},"relative":{"default":0,"description":"Largest difference as a share of the other system's amount still counted as agreeing, e.g. 0.0001; the larger of the two tolerances applies (default 0). Must be less than 1.","type":"number","minimum":0,"maximum":1},"share":{"default":1e-06,"description":"Largest pro rata share difference still counted as agreeing (default 0.000001). Must be less than 1.","type":"number","minimum":0,"maximum":1}}}},"required":["cam","other"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_reconcile_dcf","title":"Tie out a DCF against another system's annual lines","description":"Reconcile FactLot's DCF with another system's export (ARGUS or any other model; parity is not claimed and is untested against real ARGUS output): give the calc_dcf_pro_forma input plus the other system's annual lines {label, values: [year 1, …]}, optionally its value, unlevered IRR and sale price, a tolerance (absolute and relative) and your label mapping. Labels map to FactLot lines by your mapping, else by common CRE line names (Potential Base Rent, Absorption & Turnover Vacancy, Free Rent, Expense Reimbursements, General Vacancy, Credit Loss, Effective Gross Revenue, Operating Expenses, Net Operating Income, Tenant Improvements, Leasing Commissions, Capital Reserves, Cash Flow Before Debt Service); positive deductions are negated (sign_convention). Returns per line and year FactLot's amount, the other amount, the difference and whether it is within tolerance; unmapped labels; and for each differing line a likely_cause from FactLot's documented conventions, worded as a hypothesis to check: differences only in rollover years (fractional downtime and free rent), a rate on a different base (general vacancy), only the exit year, a one-year shift, management fee inside operating expenses, a growth rate, a constant factor or amount, rounding; and for the value FactLot rerun with mid-year or end-of-year discounting, the other exit NOI basis, or no selling costs. Deterministic: the same inputs always give the same result, with formula ID calc.reconcile_dcf@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"dcf":{"type":"object","properties":{"hold_years":{"type":"integer","minimum":1,"maximum":30,"description":"Holding period in years. The property is sold at the end of the last year; one more year is projected for the forward NOI."},"leases":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"Suite or tenant label, e.g. \"Suite 200\"."},"area_sf":{"type":"number","description":"Leased area, SF. Must be greater than 0.","minimum":0},"rent_psf_annual":{"type":"number","minimum":0,"description":"Current in-place base rent, USD/SF/yr (0 for space vacant at the start)."},"months_remaining":{"type":"integer","minimum":0,"maximum":600,"description":"Months left on the lease from the analysis start: the lease runs through this month (1 = expires at the end of month 1). 0 means the space is vacant at the start and is leased to a new tenant after downtime_months."},"escalation_rate":{"default":0,"description":"Annual bump in the in-place rent, e.g. 0.03, applied first in next_escalation_month and every 12 months after. Must be less than 1.","type":"number","minimum":0,"maximum":1},"next_escalation_month":{"default":13,"description":"Analysis month of the next in-place rent bump (default 13, the start of year 2). Use the lease's anniversary month.","type":"integer","minimum":1,"maximum":600},"free_rent_months_remaining":{"default":0,"description":"Months of in-place free base rent still to run from the analysis start (months 1 to this are abated).","type":"integer","minimum":0,"maximum":600},"recovery":{"default":"nnn","description":"In-place expense recovery: \"nnn\", \"gross\", or \"base_year\" (needs base_year_opex_psf_annual).","type":"string","enum":["nnn","gross","base_year"]},"base_year_opex_psf_annual":{"description":"Operating expenses in the lease's base year, USD/SF/yr: the tenant pays the excess above it. Required when recovery is base_year.","type":"number","minimum":0},"market_rent_psf_annual":{"type":"number","minimum":0,"description":"Market rent for this space today, USD/SF/yr. Grows at market_rent_growth_rate each analysis year."},"leasing":{"type":"object","properties":{"renewal_probability":{"type":"number","minimum":0,"maximum":1,"description":"Probability the tenant renews at expiration, 0 to 1 (e.g. 0.65). Blends the renewal and new-tenant assumptions below."},"lease_term_months":{"type":"integer","minimum":1,"maximum":240,"description":"Term of each lease signed at rollover (renewal or new tenant), months."},"downtime_months":{"type":"integer","minimum":0,"maximum":60,"description":"Months vacant before a new tenant starts paying (no downtime is assumed on renewal). Blended downtime = (1 − renewal_probability) × this, kept fractional, not rounded: the suite is vacant for the whole months and the rollover lease's first month collects 1 − the fraction of its rent and recoveries (0.45 months of downtime: the first month collects 55%)."},"renewal_rent_pct_of_market":{"type":"number","maximum":2,"description":"Renewal rent as a share of market rent, e.g. 0.95 for a 5% renewal discount; new tenants pay market rent. Must be greater than 0.","minimum":0},"rent_escalation_rate":{"type":"number","minimum":0,"description":"Annual bump in a rollover lease's base rent, compounding every 12 months from its start, e.g. 0.03. Must be less than 1.","maximum":1},"free_rent_months_new":{"type":"integer","minimum":0,"maximum":60,"description":"Months of free base rent for a new tenant at the start of its lease."},"free_rent_months_renewal":{"type":"integer","minimum":0,"maximum":60,"description":"Months of free base rent on a renewal. Blended free rent = p × this + (1 − p) × free_rent_months_new, kept fractional: the whole months are fully abated and the next month by the fraction."},"ti_psf_new":{"type":"number","minimum":0,"description":"Tenant improvement allowance for a new tenant, USD/SF in today's dollars (grown at market_rent_growth_rate to the lease start)."},"ti_psf_renewal":{"type":"number","minimum":0,"description":"Tenant improvement allowance on a renewal, USD/SF in today's dollars."},"lc_rate_new":{"type":"number","minimum":0,"description":"Leasing commission for a new tenant as a share of the base rent payable over the lease term after free rent, e.g. 0.06. Must be less than 1.","maximum":1},"lc_rate_renewal":{"type":"number","minimum":0,"description":"Leasing commission on a renewal, same basis, e.g. 0.03. Must be less than 1.","maximum":1},"recovery":{"type":"string","enum":["nnn","gross","base_year"],"description":"Expense recovery on rollover leases: \"nnn\" (tenant pays its share of operating expenses), \"gross\" (none), or \"base_year\" (expenses above the lease's first-year level)."}},"description":"Per-lease overrides of market_leasing (any subset of its fields)."}},"required":["name","area_sf","rent_psf_annual","months_remaining","market_rent_psf_annual"]},"description":"Rent roll: one entry per lease or vacant suite (at most 200). The building area is the sum of their areas."},"market_leasing":{"type":"object","properties":{"renewal_probability":{"type":"number","minimum":0,"maximum":1,"description":"Probability the tenant renews at expiration, 0 to 1 (e.g. 0.65). Blends the renewal and new-tenant assumptions below."},"lease_term_months":{"type":"integer","minimum":1,"maximum":240,"description":"Term of each lease signed at rollover (renewal or new tenant), months."},"downtime_months":{"type":"integer","minimum":0,"maximum":60,"description":"Months vacant before a new tenant starts paying (no downtime is assumed on renewal). Blended downtime = (1 − renewal_probability) × this, kept fractional, not rounded: the suite is vacant for the whole months and the rollover lease's first month collects 1 − the fraction of its rent and recoveries (0.45 months of downtime: the first month collects 55%)."},"renewal_rent_pct_of_market":{"default":1,"type":"number","maximum":2,"description":"Renewal rent as a share of market rent, e.g. 0.95 for a 5% renewal discount; new tenants pay market rent. Must be greater than 0.","minimum":0},"rent_escalation_rate":{"default":0,"type":"number","minimum":0,"description":"Annual bump in a rollover lease's base rent, compounding every 12 months from its start, e.g. 0.03. Must be less than 1.","maximum":1},"free_rent_months_new":{"default":0,"type":"integer","minimum":0,"maximum":60,"description":"Months of free base rent for a new tenant at the start of its lease."},"free_rent_months_renewal":{"default":0,"type":"integer","minimum":0,"maximum":60,"description":"Months of free base rent on a renewal. Blended free rent = p × this + (1 − p) × free_rent_months_new, kept fractional: the whole months are fully abated and the next month by the fraction."},"ti_psf_new":{"default":0,"type":"number","minimum":0,"description":"Tenant improvement allowance for a new tenant, USD/SF in today's dollars (grown at market_rent_growth_rate to the lease start)."},"ti_psf_renewal":{"default":0,"type":"number","minimum":0,"description":"Tenant improvement allowance on a renewal, USD/SF in today's dollars."},"lc_rate_new":{"default":0,"type":"number","minimum":0,"description":"Leasing commission for a new tenant as a share of the base rent payable over the lease term after free rent, e.g. 0.06. Must be less than 1.","maximum":1},"lc_rate_renewal":{"default":0,"type":"number","minimum":0,"description":"Leasing commission on a renewal, same basis, e.g. 0.03. Must be less than 1.","maximum":1},"recovery":{"default":"nnn","type":"string","enum":["nnn","gross","base_year"],"description":"Expense recovery on rollover leases: \"nnn\" (tenant pays its share of operating expenses), \"gross\" (none), or \"base_year\" (expenses above the lease's first-year level)."}},"required":["renewal_probability","lease_term_months","downtime_months"],"description":"Market leasing assumptions applied at every lease expiration (and to space vacant at the start). A lease's own `leasing` object overrides any of them."},"market_rent_growth_rate":{"default":0,"description":"Annual market rent growth, e.g. 0.03. Market rent and TI in analysis year y = today's × (1 + g)^(y − 1). Must be greater than -1. Must be less than 1.","type":"number","minimum":-1,"maximum":1},"operating_expenses_psf_annual":{"default":0,"description":"Year-1 recoverable operating expenses, USD/SF/yr over the whole building area.","type":"number","minimum":0},"non_recoverable_expenses_annual":{"default":0,"description":"Year-1 operating expenses no tenant reimburses, USD/yr.","type":"number","minimum":0},"expense_growth_rate":{"default":0,"description":"Annual growth of operating expenses and capital reserves, e.g. 0.03: year y = year 1 × (1 + g)^(y − 1). Must be greater than -1. Must be less than 1.","type":"number","minimum":-1,"maximum":1},"management_fee_rate":{"default":0,"description":"Management fee as a share of effective gross revenue, e.g. 0.03; not recovered. Must be less than 1.","type":"number","minimum":0,"maximum":1},"general_vacancy_rate":{"default":0,"description":"General vacancy allowance as a share of gross revenue (base rent after free rent, plus recoveries), on top of the downtime modelled at rollover. Must be less than 1.","type":"number","minimum":0,"maximum":1},"credit_loss_rate":{"default":0,"description":"Credit loss as a share of gross revenue, on top of general vacancy. Must be less than 1.","type":"number","minimum":0,"maximum":1},"capital_reserve_psf_annual":{"default":0,"description":"Year-1 capital reserve, USD/SF/yr over the building area, below NOI. Grows with expense_growth_rate.","type":"number","minimum":0},"exit_cap_rate":{"type":"number","description":"Exit (terminal) cap rate applied to the exit NOI, e.g. 0.07. Must be greater than 0. Must be less than 1.","minimum":0,"maximum":1},"exit_noi_basis":{"default":"forward","description":"\"forward\": the NOI of the year after the hold (the usual convention); \"trailing\": the NOI of the final hold year.","type":"string","enum":["forward","trailing"]},"selling_cost_rate":{"default":0,"description":"Selling costs as a share of the gross sale price, e.g. 0.02. Must be less than 1.","type":"number","minimum":0,"maximum":1},"discount_rate":{"type":"number","minimum":0,"description":"Annual unlevered discount rate, e.g. 0.08. The present value at this rate is the value. Must be less than 1.","maximum":1},"timing":{"default":"end_of_year","description":"\"end_of_year\": each year's cash flow is discounted (1 + r)^y (Excel NPV). \"mid_year\": operating cash flows at (1 + r)^(y − 0.5); the sale is always discounted at the end of the hold.","type":"string","enum":["end_of_year","mid_year"]},"purchase_price":{"description":"Price paid at the start, USD. Adds the NPV (value − price), the unlevered IRR and the going-in cap rate on price. Must be greater than 0.","type":"number","minimum":0}},"required":["hold_years","leases","market_leasing","exit_cap_rate","discount_rate"],"description":"The FactLot DCF input, exactly as calc_dcf_pro_forma takes it (the same rent roll and assumptions you entered in the other system)."},"other":{"type":"object","properties":{"system":{"default":"other system","description":"Name of the system or file the lines come from, echoed in the result, e.g. \"ARGUS export, Nov 2026\" (free text).","type":"string","minLength":1,"maxLength":200},"lines":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200,"description":"Line name as the other system prints it, e.g. \"Potential Base Rent\". Compared ignoring case and punctuation, \"&\" read as \"and\"."},"values":{"minItems":1,"maxItems":31,"type":"array","items":{"type":"number"},"description":"Annual amounts in USD, year 1 first, one per analysis year (the hold plus the year after it at most). Deductions may be negative or positive; see sign_convention."}},"required":["label","values"]},"description":"The other system's annual cash-flow lines (factlot.reconcile_files reads them from a CSV or XLSX)."},"value":{"description":"The other system's present value at the discount rate, USD.","type":"number"},"unlevered_irr":{"description":"The other system's unlevered IRR as a decimal (0.0825 for 8.25%). Compared only when dcf.purchase_price is given. Must be greater than -1.","type":"number","maximum":1,"minimum":-1},"gross_sale_price":{"description":"The other system's gross sale (reversion) price before selling costs, USD.","type":"number"},"net_sale_proceeds":{"description":"The other system's sale proceeds after selling costs, USD.","type":"number"}},"required":["lines"],"description":"What the other system reported for the same property."},"mapping":{"default":[],"description":"Your label mappings; they override the defaults (common CRE line names such as Potential Base Rent, General Vacancy, Net Operating Income, Cash Flow Before Debt Service).","maxItems":200,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":200,"description":"A label in other.lines (matched ignoring case and punctuation)."},"line":{"type":"string","enum":["potential_base_rent","free_rent","expense_recoveries","gross_revenue","general_vacancy","credit_loss","effective_gross_revenue","operating_expenses","management_fee","net_operating_income","tenant_improvements","leasing_commissions","capital_reserves","cash_flow_before_debt","turnover_vacancy","ignore"],"description":"FactLot line to compare it with. \"turnover_vacancy\" is a deduction compared together with potential_base_rent (FactLot's potential base rent already excludes rollover downtime); \"ignore\" leaves the line out. Several labels mapped to one line are summed."}},"required":["label","line"]}},"sign_convention":{"default":"auto","description":"FactLot reports deductions (free rent, vacancy, credit loss, expenses, fees, TI, commissions, reserves) as negative amounts. \"auto\": a deduction line whose amounts are all zero or positive is read as positive deductions and negated; \"as_reported\": compare as given; \"deductions_positive\": negate every deduction line.","type":"string","enum":["auto","as_reported","deductions_positive"]},"tolerance":{"default":{"absolute":1,"relative":0,"irr":0.0001},"description":"When two amounts agree: |FactLot − other| ≤ max(absolute, relative × |other|); the IRR within irr. Default: 1.00 USD, 0, and one basis point.","type":"object","properties":{"absolute":{"default":1,"description":"Largest difference, USD, still counted as agreeing (default 1.00).","type":"number","minimum":0},"relative":{"default":0,"description":"Largest difference as a share of the other system's amount still counted as agreeing, e.g. 0.0001; the larger of the two tolerances applies (default 0). Must be less than 1.","type":"number","minimum":0,"maximum":1},"irr":{"default":0.0001,"description":"Largest IRR difference still counted as agreeing, as a decimal (default 0.0001, one basis point). Must be less than 1.","type":"number","minimum":0,"maximum":1}}}},"required":["dcf","other"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_renew_vs_relocate","title":"Renew vs. relocate","description":"Compare renewing in place with moving over one horizon: NPV and discounted effective rent of each case (rent schedule with free rent, TI net of allowance, fees, moving, downtime, double rent, termination, and disruption costs), the starting rent at which they break even, and year-by-year cash flows. Deterministic: the same inputs always give the same result, with formula ID calc.renew_vs_relocate@2, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"horizon_months":{"type":"integer","maximum":600,"description":"Analysis horizon in months; both cases run for this term (e.g. 120 for a ten-year renewal versus a ten-year new lease).","minimum":1},"discount_rate_annual":{"default":0.08,"description":"Annual discount rate as a decimal, e.g. 0.08, applied to both cases (monthly rate = annual ÷ 12). Must be less than 1.","type":"number","minimum":0,"maximum":1},"current_rent_monthly":{"default":0,"description":"Total monthly rent under the existing lease, USD per month for the whole premises (not $/SF). Prices the double-rent overlap in the relocate case.","type":"number","minimum":0},"renew":{"type":"object","properties":{"schedule":{"type":"object","properties":{"commencement_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Rent commencement date, YYYY-MM-DD. Month n starts on this day-of-month (clamped to month end)."},"area_sf":{"type":"number","description":"Rentable square feet, or the quantity leased in unit (kW, MW, units, acres, keys, rooms, spaces) when unit is set. Must be greater than 0.","minimum":0},"starting_rent_psf_annual":{"type":"number","minimum":0,"description":"Year-one base rent in dollars per SF per year (annual, not monthly), e.g. 42.5; per unit per year when unit is set (a $/kW/month quote × 12)."},"escalation":{"default":{"type":"none"},"description":"How base rent escalates. Omit for flat rent.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"description":"Flat rent for the whole term."},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"rate":{"type":"number","description":"Bump as a decimal, e.g. 0.03 for 3%. Bumps compound. Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","rate"],"description":"Percentage bumps: rate_k = starting_rate × (1 + rate)^k."},{"type":"object","properties":{"type":{"type":"string","const":"fixed_psf"},"amount":{"type":"number","description":"Dollars per SF per year (or per unit per year when unit is set) added at each bump, e.g. 0.50."},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","amount"],"description":"Fixed $/SF bumps: rate_k = starting_rate + amount × k."}]},"abated_months":{"default":[],"description":"Fully abated (free) months, 1-based from commencement (e.g. [1,2,3] for three months free up front). Each listed month's base rent is zero.","maxItems":1200,"type":"array","items":{"type":"integer","minimum":1}},"round_rate_to_cents":{"default":false,"description":"Round each step's $/SF/yr to cents, as many lease rent tables do.","type":"boolean"}},"required":["commencement_date","area_sf","starting_rent_psf_annual"],"description":"Renewal rent terms: commencement date, area, starting $/SF/yr, escalation, and abated (free) months. The term is horizon_months."},"ti_cost":{"default":0,"description":"Refurbishment or TI the tenant would spend on the current premises at renewal, USD, before any allowance.","type":"number","minimum":0},"ti_allowance":{"default":0,"description":"Landlord renewal allowance, USD. Offsets ti_cost; any excess is not paid out.","type":"number","minimum":0},"renewal_fee":{"default":0,"description":"Fees to renew (legal, brokerage paid by tenant), USD.","type":"number","minimum":0}},"required":["schedule"],"description":"Stay and renew the existing lease."},"relocate":{"type":"object","properties":{"schedule":{"type":"object","properties":{"commencement_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Rent commencement date, YYYY-MM-DD. Month n starts on this day-of-month (clamped to month end)."},"area_sf":{"type":"number","description":"Rentable square feet, or the quantity leased in unit (kW, MW, units, acres, keys, rooms, spaces) when unit is set. Must be greater than 0.","minimum":0},"starting_rent_psf_annual":{"type":"number","minimum":0,"description":"Year-one base rent in dollars per SF per year (annual, not monthly), e.g. 42.5; per unit per year when unit is set (a $/kW/month quote × 12)."},"escalation":{"default":{"type":"none"},"description":"How base rent escalates. Omit for flat rent.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"description":"Flat rent for the whole term."},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"rate":{"type":"number","description":"Bump as a decimal, e.g. 0.03 for 3%. Bumps compound. Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","rate"],"description":"Percentage bumps: rate_k = starting_rate × (1 + rate)^k."},{"type":"object","properties":{"type":{"type":"string","const":"fixed_psf"},"amount":{"type":"number","description":"Dollars per SF per year (or per unit per year when unit is set) added at each bump, e.g. 0.50."},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","amount"],"description":"Fixed $/SF bumps: rate_k = starting_rate + amount × k."}]},"abated_months":{"default":[],"description":"Fully abated (free) months, 1-based from commencement (e.g. [1,2,3] for three months free up front). Each listed month's base rent is zero.","maxItems":1200,"type":"array","items":{"type":"integer","minimum":1}},"round_rate_to_cents":{"default":false,"description":"Round each step's $/SF/yr to cents, as many lease rent tables do.","type":"boolean"}},"required":["commencement_date","area_sf","starting_rent_psf_annual"],"description":"New-premises rent terms: commencement date, area, starting $/SF/yr, escalation, and abated (free) months. The term is horizon_months."},"buildout_cost":{"default":0,"description":"Total cost to build out the new premises, USD, before any allowance.","type":"number","minimum":0},"ti_allowance":{"default":0,"description":"Landlord TI allowance at the new premises, USD. Offsets buildout_cost; any excess is not paid out.","type":"number","minimum":0},"moving_cost":{"default":0,"description":"Moving, IT, cabling, signage, and stationery costs, USD.","type":"number","minimum":0},"downtime_months":{"default":0,"description":"Months the business runs at reduced capacity around the move.","type":"integer","minimum":0},"downtime_cost_monthly":{"default":0,"description":"Cost of a month of downtime (lost margin, temporary space), USD per month. Multiplied by downtime_months.","type":"number","minimum":0},"overlap_months":{"default":0,"description":"Months of double rent: the old premises are still paid (at current_rent_monthly) after the new lease starts.","type":"integer","minimum":0},"termination_cost":{"default":0,"description":"Early termination fee, holdover premium, or restoration obligation at the old premises, USD.","type":"number","minimum":0},"disruption_cost":{"default":0,"description":"Explicit one-time cost of business disruption beyond rent and downtime (lost customers, staff turnover), USD.","type":"number","minimum":0}},"required":["schedule"],"description":"Move to new premises."}},"required":["horizon_months","renew","relocate"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_rent_schedule","title":"Lease rent schedule","description":"Build a base-rent schedule from commencement date, term, area, starting $/SF/yr, escalations (percent or fixed $/SF), and abated months. Lease months run from the commencement day-of-month with no calendar proration (warns when commencement is mid-month). Returns rent steps, totals, expiration date, and a calculation trace. Optional unit (kw, mw, unit, acre, key, room, space) relabels area and $/SF for data-center, ground, yard, residential, hotel, or parking leases without changing any number. Deterministic: the same inputs always give the same result, with formula ID calc.rent_schedule@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"commencement_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Rent commencement date, YYYY-MM-DD. Month n starts on this day-of-month (clamped to month end)."},"term_months":{"type":"integer","maximum":1200,"description":"Lease term in months, e.g. 120 for ten years.","minimum":1},"area_sf":{"type":"number","description":"Rentable square feet, or the quantity leased in unit (kW, MW, units, acres, keys, rooms, spaces) when unit is set. Must be greater than 0.","minimum":0},"starting_rent_psf_annual":{"type":"number","minimum":0,"description":"Year-one base rent in dollars per SF per year (annual, not monthly), e.g. 42.5; per unit per year when unit is set (a $/kW/month quote × 12)."},"escalation":{"default":{"type":"none"},"description":"How base rent escalates. Omit for flat rent.","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"none"}},"required":["type"],"description":"Flat rent for the whole term."},{"type":"object","properties":{"type":{"type":"string","const":"percent"},"rate":{"type":"number","description":"Bump as a decimal, e.g. 0.03 for 3%. Bumps compound. Must be greater than -1. Must be less than 10.","minimum":-1,"maximum":10},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","rate"],"description":"Percentage bumps: rate_k = starting_rate × (1 + rate)^k."},{"type":"object","properties":{"type":{"type":"string","const":"fixed_psf"},"amount":{"type":"number","description":"Dollars per SF per year (or per unit per year when unit is set) added at each bump, e.g. 0.50."},"every_months":{"default":12,"description":"Months between bumps (12 = annual). The first bump takes effect in month every_months + 1.","type":"integer","minimum":1}},"required":["type","amount"],"description":"Fixed $/SF bumps: rate_k = starting_rate + amount × k."}]},"abated_months":{"default":[],"description":"Fully abated (free) months, 1-based from commencement (e.g. [1,2,3] for three months free up front). Each listed month's base rent is zero.","maxItems":1200,"type":"array","items":{"type":"integer","minimum":1}},"round_rate_to_cents":{"default":false,"description":"Round each step's $/SF/yr to cents, as many lease rent tables do.","type":"boolean"},"include_monthly":{"default":false,"description":"Include a month-by-month table (can be long).","type":"boolean"},"unit":{"description":"What area_sf and the per-SF fields measure: sf (default, square feet), kw or mw (data-center critical load), unit (apartment or other unit), acre (ground or yard lease), key or room (hotel), or space (parking). Every number is computed exactly as for square feet; the unit changes labels, steps, and warnings and adds unit and rate_unit to the result. Fields keep their _sf and _psf names: with unit kw, area_sf holds kW and starting_rent_psf_annual holds $/kW/yr. Omit for square feet.","type":"string","enum":["sf","kw","mw","unit","acre","key","room","space"]}},"required":["commencement_date","term_months","area_sf","starting_rent_psf_annual"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_tx_unequal_appraisal","title":"Texas unequal appraisal: median of adjusted comparables","description":"Evidence calculation only: not an appraisal or an opinion of value, not legal or tax advice, and not a substitute for the advice of an attorney. The arithmetic of Tex. Tax Code §41.43(b)(3) and §42.26(a)(3), the subject's value against the median appraised value of a reasonable number of comparable properties appropriately adjusted. Takes 3–200 comparables chosen by the caller, each with its roll value and the caller's adjustments (percent, USD amount, or $/SF, each with a reason); optionally normalizes each comparable to value per SF of improvement or land area times the subject's area; applies percentages summed or compounded, then amounts; and returns every comparable's normalized and adjusted value, the sorted list, the median (for an even count, the mean of the two middle values), and the subject's value minus the median in USD (subject_minus_median) and as a fraction of the median (subject_minus_median_pct: 0.1554 means 15.54%, a decimal like every rate in FactLot, not 0.1554%), with the statutes cited. Warns on mixed value bases, §42.26(d) and the §23.231 limitation, comparables in another county, fewer than 5 comparables, total adjustments over 25%, a comparable identical to the subject, no adjustments at all (the median is then unadjusted), and, with normalize_by none, a comparable whose area differs from the subject's by more than 25%. Each comparable row carries flags (code and sentence, facts about the inputs, never a reason the tool drops anything): value per SF more than twice or less than half the subject's, a land-to-improvement area ratio more than twice or less than half the subject's, an area the subject has but the comparable lacks. Optional label (up to 80 characters) and address (up to 120) on the subject and each comparable are echoed in the result (subject_label, subject_address, comparables[i].label and .address) for reports. registry_tx_equity_candidates returns calc_args, its candidates in this tool's input shape, for the caller to review and edit before calling this tool. It does not choose comparables, invent adjustments, or say whether to protest. Deterministic: the same inputs always give the same result, with formula ID calc.tx_unequal_appraisal@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"tax_year":{"type":"integer","minimum":1982,"maximum":2100,"description":"Tax year of the values compared, e.g. 2027. Decides which text of §42.26(d) applies."},"subject":{"type":"object","properties":{"id":{"description":"Identifier of the subject property, e.g. its FactLot parcel ID.","type":"string","minLength":1,"maxLength":200},"label":{"type":"string","minLength":1,"maxLength":80,"description":"A name to print for this property in reports (up to 80 characters), e.g. its street address or the caller's comp number. Echoed in the result; not used in the arithmetic."},"address":{"type":"string","minLength":1,"maxLength":120,"description":"The property's address as the caller wants it printed (up to 120 characters). Echoed in the result; not used in the arithmetic."},"county_fips":{"type":"string","pattern":"^[0-9]{3}$","description":"Texas county FIPS code, 3 digits, e.g. \"201\" for Harris. Optional; used only to warn when a comparable is in a different county (appraisal district) from the subject."},"value":{"type":"number","description":"The subject's value from the appraisal roll (or the value at issue), USD. Must be greater than 0.","minimum":0},"value_basis":{"type":"string","enum":["appraised","market"],"description":"Which roll value this is: \"appraised\" (after any limitation) or \"market\". Use the same basis for the subject and every comparable."},"improvement_area_sf":{"description":"Improvement (building) area, SF. Required when normalize_by is improvement_area_sf. Must be greater than 0.","type":"number","minimum":0},"land_area_sf":{"description":"Land area, SF. Required when normalize_by is land_area_sf. Must be greater than 0.","type":"number","minimum":0},"circuit_breaker_23_231":{"default":false,"description":"Whether the subject is subject to the §23.231 limitation on appraised value (the circuit breaker for non-homestead property). Only used for warnings about which value §42.26(d) compares.","type":"boolean"}},"required":["value","value_basis"],"additionalProperties":false,"description":"The property whose value is compared."},"normalize_by":{"default":"none","description":"\"none\" compares whole values. \"improvement_area_sf\" or \"land_area_sf\" converts each comparable to value per SF of that area and multiplies by the subject's same area before adjusting; the subject and every comparable must then have that area.","type":"string","enum":["none","improvement_area_sf","land_area_sf"]},"adjustment_combine":{"default":"sum","description":"\"sum\" adds a comparable's percentage adjustments and applies the total once (the usual adjustment grid); \"compound\" multiplies (1 + each percentage).","type":"string","enum":["sum","compound"]},"comparables":{"minItems":3,"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"description":"Identifier of the comparable, e.g. its FactLot parcel ID or account number. Must differ from the subject's and from every other comparable's.","type":"string","minLength":1,"maxLength":200},"label":{"type":"string","minLength":1,"maxLength":80,"description":"A name to print for this property in reports (up to 80 characters), e.g. its street address or the caller's comp number. Echoed in the result; not used in the arithmetic."},"address":{"type":"string","minLength":1,"maxLength":120,"description":"The property's address as the caller wants it printed (up to 120 characters). Echoed in the result; not used in the arithmetic."},"county_fips":{"type":"string","pattern":"^[0-9]{3}$","description":"Texas county FIPS code, 3 digits, e.g. \"201\" for Harris. Optional; used only to warn when a comparable is in a different county (appraisal district) from the subject."},"value":{"type":"number","description":"The comparable's value from the appraisal roll, USD. Must be greater than 0.","minimum":0},"value_basis":{"type":"string","enum":["appraised","market"],"description":"Which roll value this is: \"appraised\" (after any limitation) or \"market\". Use the same basis for the subject and every comparable."},"improvement_area_sf":{"description":"Improvement (building) area, SF. Required when normalize_by is improvement_area_sf. Must be greater than 0.","type":"number","minimum":0},"land_area_sf":{"description":"Land area, SF. Required when normalize_by is land_area_sf. Must be greater than 0.","type":"number","minimum":0},"citation":{"type":"object","properties":{"fact_id":{"description":"FactLot fact ID of the comparable's value, if it came from the registry.","type":"string","minLength":1,"maxLength":200},"document_id":{"description":"FactLot document ID of the source (e.g. the appraisal roll file).","type":"string","minLength":1,"maxLength":200},"locator":{"description":"Where in the source the value is: row, account number, page.","type":"string","minLength":1,"maxLength":500},"as_of":{"description":"Date the value was read or certified, YYYY-MM-DD.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"additionalProperties":false,"description":"Where the comparable's value comes from. Passed through to the output unchanged."},"adjustments":{"default":[],"description":"Adjustments to this comparable, each with a reason. Percentages are applied first (summed or compounded per adjustment_combine), then amounts and $/SF adjustments.","maxItems":20,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":100,"description":"What the adjustment is for, e.g. \"age\", \"size\", \"condition\"."},"kind":{"type":"string","enum":["percent","amount","psf"],"description":"\"percent\": a decimal share of the normalized value (0.05 for +5%, -0.02 for -2%); \"amount\": USD added to the value (negative to deduct); \"psf\": USD per SF of the normalizing area, multiplied by the subject's area (only with normalize_by other than \"none\")."},"value":{"type":"number","description":"The adjustment: a decimal between -1 and 1 for percent (0.05, not 5), else USD or USD/SF. Positive raises the comparable's value."},"reason":{"type":"string","minLength":1,"maxLength":300,"description":"Why the adjustment is made, in the caller's words (e.g. \"comp built 1998, subject 2006\"). Required: FactLot never invents an adjustment."}},"required":["label","kind","value","reason"],"additionalProperties":false}}},"required":["value","value_basis"],"additionalProperties":false},"description":"The comparable properties, 3 to 200, chosen by the caller. Values must be on the same basis as the subject's."}},"required":["tax_year","subject","comparables"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"calc_walt","title":"Weighted average lease term (WALT)","description":"Weighted average remaining lease term in years as of a date (actual days ÷ 365.25), weighted by each lease's area_sf (weight_by \"area\") or annual_rent (weight_by \"rent\"). Deterministic: the same inputs always give the same result, with formula ID calc.walt@1, every step, and any warnings.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"as_of":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Date to measure remaining term from, YYYY-MM-DD."},"weight_by":{"default":"area","description":"How each lease is weighted: \"area\" uses its area_sf, \"rent\" its annual_rent (that field is then required on every lease). Default \"area\".","type":"string","enum":["area","rent"]},"leases":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"id":{"description":"Your identifier for the lease (ideally a FactLot lease ID).","type":"string","maxLength":200},"expiration_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Lease expiration date, YYYY-MM-DD."},"area_sf":{"description":"Leased square feet (required when weight_by is area). Must be greater than 0.","type":"number","minimum":0},"annual_rent":{"description":"Current annual rent, USD per year (required when weight_by is rent). Must be greater than 0.","type":"number","minimum":0}},"required":["expiration_date"]},"description":"Leases in the portfolio or building."}},"required":["as_of","leases"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"doc_abstract_lease","title":"Lease abstract with amendments","description":"Current-state lease abstract from a lease and its amendments, with amendment precedence, as of as_of. Give each document's pages with the candidates you extracted (checked exactly as doc_verify_facts checks them), or the facts doc_verify_facts already returned for it (without pages only the value against its quote is rechecked, marked quote_on_page: false). Documents may come in any order: give the lease role original and each amendment role amendment with its effective_date (without a role the lease is inferred only when that is unambiguous, otherwise it is an input error; two or more amendments need effective dates). The original applies first, then amendments by effective_date; a later document's value for a predicate controls, and the earlier one moves to history and is linked through supersedes. An amendment effective after as_of is pending: its values are listed under pending and pending_facts with a warning and do not control. A rent schedule restated from a later date keeps the earlier steps before it (carried_forward). Each field gives its value, the controlling document, page, quote and fact, the superseded history, conflicts (two different values from one document, or from two documents of the same rank), pending values and open_items (a candidate for that predicate in the controlling or a later document that needs review or was rejected, so the value may not be final). FactLot only orders what you extracted: it does not find terms you missed, and an amendment that changes a term without restating it (\"extended by 24 months\") needs the resulting value extracted with that sentence as its quote, which the quote check will hold for review if the date is not written there.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"documents":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"role":{"description":"Give it. Without one, a document is the original only when no document is marked original and it is the only one without a role (or without a role and an effective_date); otherwise it is an amendment, and input that leaves the original unclear is an error. Input order is never used.","type":"string","enum":["original","amendment"]},"effective_date":{"description":"Amendment effective date (YYYY-MM-DD), required when there are two or more amendments: they apply in date order, and amendments effective the same day do not supersede each other (a different value is a conflict). An amendment effective after as_of is pending: its values are listed under pending and do not control the current abstract. Becomes valid_from on its facts.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"title":{"type":"string","maxLength":500,"description":"Document title for citations, e.g. \"First Amendment to Lease\"."},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Optional SHA-256 (lowercase hex) of the original file. When given, document_id is fl:document:sha256-<this>, the same ID id_document gives the file; FactLot cannot check that the pages came from that file. Without it, document_id is the SHA-256 of the pages joined by form feeds (\\f)."},"pages":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"string","maxLength":100000,"description":"The text of one page, exactly as extracted."},"description":"The document's text, one string per page in order: pages[0] is page 1. Send the text as extracted (from the PDF text layer or OCR), not a summary; quotes are matched against it."},"ocr_pages":{"maxItems":2000,"type":"array","items":{"type":"integer","minimum":1,"maximum":100000},"description":"Optional: pages (1-based) whose text came from OCR rather than the file's text layer (doc_read_pdf and factlot.read_pdf report them). Facts and citations on these pages carry ocr: true, so a reviewer checks the scan."},"candidates":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"predicate":{"type":"string","minLength":1,"maxLength":200,"description":"Dotted lower_snake predicate. Use an Ingest predicate (lease.expiration_date, lease.base_rent_schedule, ...) for its value-shape and quote rules; any other predicate gets the generic rules."},"value":{"description":"The value you read, in the predicate's shape: dates YYYY-MM-DD, money and areas as plain numbers (1250000, not \"$1.25M\"), shares and rates as decimals (0.03 for 3%)."},"quote":{"type":"string","maxLength":5000,"description":"Verbatim text from the page that states the value, at least 12 characters. Copy it exactly; only whitespace, line breaks, letter case and typographic quotes and dashes may differ."},"page":{"type":"integer","minimum":1,"maximum":100000,"description":"1-based page the quote is on."},"section":{"description":"Section or clause as written, e.g. \"§4.2(b)\".","type":"string","maxLength":200},"confidence":{"description":"Your confidence 0–1. Below 0.8 the candidate goes to needs_review even if it verifies.","type":"number","minimum":0,"maximum":1},"commencement":{"description":"Only for lease.base_rent_schedule written by lease year (steps {lease_years: [1, 5], annual_rent_psf}): the commencement date the step dates are derived from, with its own quote. FactLot checks it like a lease.commencement_date candidate and derives each step: Lease Year N runs from the (N−1)th anniversary of the commencement date to the day before the next. If it does not verify, the schedule stays in needs_review.","type":"object","properties":{"value":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"The commencement date (YYYY-MM-DD)."},"quote":{"type":"string","maxLength":5000,"description":"Verbatim text that states the commencement date, at least 12 characters."},"page":{"type":"integer","minimum":1,"maximum":100000,"description":"1-based page of this document the quote is on (it may differ from the rent table's page)."},"section":{"description":"Section, if any.","type":"string","maxLength":200}},"required":["value","quote","page"]},"confirmation":{"description":"A person's confirmation of the parts of the value no quote can prove (a true/false value, an enum such as a CAM cap method or kick-out party, a paraphrased summary). With it, a candidate whose only gaps are such parts is verified with method human_verified: the parts the quote confirmed are listed under checked and the rest under confirmed_by_person. It never overrides a quote that is not on the page, a number or date the quote does not state, or a confidence below 0.8.","type":"object","properties":{"by":{"type":"string","minLength":1,"maxLength":200,"description":"The name or role of the PERSON who read the clause and confirmed the value, e.g. \"J. Smith, lease administrator\". FactLot does not authenticate it. Only for a value a person has read: a confirmation by the extractor itself does not count as a confirmation by a person."},"at":{"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}],"description":"When the person confirmed it: YYYY-MM-DD, or an ISO 8601 timestamp with offset. A date is recorded on the fact as that day at 00:00 UTC."},"note":{"description":"What the person checked; returned with the result (the fact schema has no field for it).","type":"string","maxLength":1000}},"required":["by","at"]}},"required":["predicate","value","quote","page"]},"description":"Values you extracted, each with its quote and page."},"facts":{"description":"Facts doc_verify_facts already returned for this document. With pages, each is checked again; without pages (to stay under the request size limit), only its value against its quote is checked and the abstract marks it quote_on_page: false.","maxItems":500,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"A FactLot fact, as doc_verify_facts returned it."}}}},"description":"The lease and its amendments. Each needs pages with candidates or facts, or facts alone."},"as_of":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Date the facts are stated as of (YYYY-MM-DD), usually today."},"subject":{"type":"string","maxLength":500,"pattern":"^fl:[a-z]+:[^\\s:]+(?::[^\\s]+)?$","description":"FactLot URN the facts are about, e.g. your lease's fl:lease:… ID. Default: the document ID."}},"required":["documents","as_of"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"doc_check_use_conflict","title":"Check a proposed use against exclusives","description":"Check a proposed use (a description, plus an optional use category or 2022 NAICS code) against a center's verified lease.exclusive_use and lease.prohibited_uses facts (from doc_verify_facts or doc_abstract_lease; each must pass fact_validate). Deterministic and textual: a restriction is a potential conflict when it shares a use category with the proposed use (FactLot's published use-category vocabulary, matched on keywords, the category given and NAICS codes) or shares words with it (two or more, or every significant word of the restriction). Each hit is labelled \"potential conflict — needs human review\" and returns the controlling quote and citation, the categories and words that matched, and the exclusive's carve-outs, flagging those that mention the proposed use. FactLot does not interpret the lease, decide whether a carve-out applies, or give legal conclusions; an empty result does not mean there is no conflict. Superseded facts are ignored.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"facts":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"A FactLot fact, as doc_verify_facts or doc_abstract_lease returned it."},"description":"Verified lease.exclusive_use and lease.prohibited_uses facts for the center, from doc_verify_facts or doc_abstract_lease (each must pass fact_validate). Facts another fact supersedes are ignored; other predicates are skipped."},"proposed_use":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":2000,"description":"The proposed use as described, e.g. \"coffee shop selling espresso drinks and pastries\"."},"category":{"description":"Optional use category id from FactLot's vocabulary (spec/schemas/vocabularies/use-categories.json), e.g. coffee.","type":"string","maxLength":100},"naics":{"description":"Optional 2022 NAICS code, 2 to 6 digits; a shorter code matches every category under it (7225 matches restaurants and coffee shops).","type":"string","pattern":"^[0-9]{2,6}$"}},"required":["text"],"description":"The use to check."}},"required":["facts","proposed_use"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"doc_compare","title":"Compare asserted values with a lease","description":"Compare values another document asserts (an estoppel, rent roll or offering memo, mapped by you to predicates) with verified lease facts from doc_abstract_lease or doc_verify_facts. Each asserted value comes back match, mismatch (with the differing fields), not_in_lease, or ambiguous_in_lease (two current lease facts disagree), with the controlling lease citation (document, page, quote). Values compare exactly as JSON: numbers by value, strings exactly (a name written differently is a mismatch), and for an object only the fields you assert. Facts another fact supersedes are ignored. When the lease fact is an extracted fact whose quote does not confirm part of its value (a true/false value, an enum), the result lists those parts in lease_not_checked. The lease facts must pass fact_validate; FactLot does not re-read the lease, so pass the facts its document tools returned.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"lease_facts":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"A FactLot fact, as doc_verify_facts returned it."},"description":"Verified lease facts: the facts from doc_abstract_lease (or doc_verify_facts). Facts another fact supersedes are ignored."},"asserted":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"predicate":{"type":"string","minLength":1,"maxLength":200,"description":"Predicate of the asserted value, e.g. lease.expiration_date."},"value":{"description":"The asserted value in the predicate's shape (YYYY-MM-DD dates, plain numbers, decimal rates). For an object, only the fields given are compared."},"label":{"description":"Where it was asserted, e.g. \"Estoppel ¶3\".","type":"string","maxLength":200}},"required":["predicate","value"]},"description":"Values another document states (an estoppel, a rent roll, an OM), mapped to predicates."}},"required":["lease_facts","asserted"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"doc_predicates","title":"Lease predicate catalog","description":"Look up the lease predicates doc_verify_facts and doc_abstract_lease know (lease.expiration_date, lease.base_rent_schedule, lease.go_dark, ...) before extracting: for each, its value shape as JSON Schema, one valid example with a quote that states it (and whether that example verifies), which parts of the value are checked against the quote and how (number, ratio, date, verbatim name, as-written words, a worded enum, a number inside free text), which count as checked only when the quote writes them out (summaries, some enums), and which always need review (true/false values and enums no wording confirms, such as a CAM cap method or a kick-out party) unless a person confirms them. Generated from the same tables the checks use. Give predicate for one, prefix (e.g. lease.renewal) for a group, or neither for all. Also returns notes on statuses, paths, human confirmation and the generic rules for any other dotted predicate. Reads no document.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"predicate":{"description":"One predicate to describe, e.g. lease.go_dark. Omit both predicate and prefix for every lease predicate.","type":"string","minLength":1,"maxLength":200},"prefix":{"description":"Only predicates starting with this, e.g. \"lease.renewal\" or \"lease.\". Give predicate or prefix, not both.","type":"string","minLength":1,"maxLength":200}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"doc_spread_statement","title":"Spread an operating statement","description":"Spread a T-12, operating statement, budget or rent roll summary YOU read, onto FactLot's published chart of accounts (multifamily, commercial, or hotel after the USALI summary), deterministically; FactLot runs no model. Send the pages as text and one line per item: {label, amount, quote, page}, optionally your category, a period column, and for a subtotal the indexes of the lines it sums; give the statement's own totals (effective_gross_income, total_operating_expenses, net_operating_income, ebitda, ...) as lines with that total as category. Each line is checked: the quote is on the page (a quote under 12 characters, such as a short row, only where it stands as whole words), the amount (as a number, any common written form; (1,200) and -1,200 read as negative) and the label are written in it; a line that fails is excluded with the reason, and a stated total that does not foot names the lines left out. The label is mapped to the chart by keywords: your category is used when it is in the chart, and an exception flags it for review when the dictionary maps the label elsewhere; an ambiguous or unknown label without a category is excluded. Vacancy, concessions, credit loss and other contra lines are always subtracted. Returns per period the sections, the computed totals (EGI, operating expenses, NOI, capital items, net cash flow; for hotels departmental profit, GOP, EBITDA and NOI after the replacement reserve), whether each total and subtotal the statement states foots (within 0.5 per line added, or your tolerance), every line with its citation (document, page, quote, span) and status, statistics (units, occupancy, ADR), and exceptions to review. Not checked: whether the agent missed lines, and meaning beyond the written amount and label.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"document":{"type":"object","properties":{"pages":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"string","maxLength":100000,"description":"The text of one page, exactly as extracted."},"description":"The document's text, one string per page in order: pages[0] is page 1. Send the text as extracted (from the PDF text layer or OCR), not a summary; quotes are matched against it."},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Optional SHA-256 (lowercase hex) of the original file. When given, document_id is fl:document:sha256-<this>, the same ID id_document gives the file; FactLot cannot check that the pages came from that file. Without it, document_id is the SHA-256 of the pages joined by form feeds (\\f)."},"title":{"type":"string","maxLength":500,"description":"Document title for citations, e.g. \"First Amendment to Lease\"."},"ocr_pages":{"maxItems":2000,"type":"array","items":{"type":"integer","minimum":1,"maximum":100000},"description":"Optional: pages (1-based) whose text came from OCR rather than the file's text layer (doc_read_pdf and factlot.read_pdf report them). Facts and citations on these pages carry ocr: true, so a reviewer checks the scan."}},"required":["pages"],"description":"The statement's pages."},"property_type":{"type":"string","enum":["multifamily","commercial","hotel"],"description":"Which chart of accounts to use: multifamily, commercial (office, retail, industrial), or hotel (USALI summary)."},"statement_type":{"description":"What the document is; echoed back.","type":"string","enum":["t12","operating_statement","budget","rent_roll_summary","other"]},"period":{"description":"Default period label for lines that give none.","type":"string","maxLength":100},"lines":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":300,"description":"The line's label exactly as the statement writes it, e.g. \"Real Estate Taxes\". It must appear in the quote."},"amount":{"type":"number","description":"The amount as a plain number (245000, not \"$245K\"). Write a deduction as the statement shows it; vacancy, concessions and other contra lines are always subtracted."},"quote":{"type":"string","maxLength":5000,"description":"Verbatim text from the page with the label and the amount, e.g. \"Real Estate Taxes 245,000\". A row shorter than 12 characters (\"R&M 310,411\") is accepted where it appears on the page as whole words."},"page":{"type":"integer","minimum":1,"maximum":100000,"description":"1-based page the quote is on."},"category":{"description":"Your proposed category from the chart for property_type (spec/schemas/vocabularies/chart-of-accounts.json), e.g. real_estate_taxes, or a total such as net_operating_income for a total line. Without it, FactLot maps the label itself.","type":"string","maxLength":100},"period":{"description":"Period column the amount is from, e.g. \"T-12 Sep 2026\" or \"2025\". Lines are spread per period. Default: the statement's period.","type":"string","maxLength":100},"sums":{"description":"For a subtotal the statement prints (\"Total Utilities\"): the indexes (0-based) of the lines it adds up. FactLot checks that it foots.","minItems":1,"maxItems":1000,"type":"array","items":{"type":"integer","minimum":0,"maximum":999}}},"required":["label","amount","quote","page"]},"description":"The statement's lines as you read them: every income, expense and capital line, the statement's own subtotals (with sums) and totals (with a total category), and statistics such as units or occupancy."},"tolerance":{"description":"Largest difference, in the statement's units, at which a subtotal or total still foots. Default: 0.5 for each line added (rounding).","type":"number","minimum":0,"maximum":1000000000}},"required":["document","property_type","lines"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"doc_verify_claim","title":"Verify a claim against a document","description":"Check one claim against a document page: {predicate, value} (anything doc_verify_facts accepts) or a short claim sentence ({text} or a bare string), plus the verbatim quote and page it rests on. Returns supported (the quote is on the page and every checked number, date and name in the claim is written in it), contradicted (the quote is on the page and states other numbers or dates of the same kind, listed in quote_states), or unverifiable (the quote is not on the page, nothing in the claim can be checked, or the quote states no value of that kind), with the evidence (document_id, page, quote, span) and each part checked. Textual, not semantic: for a sentence only its numbers and dates are compared, never its meaning, and a quote that mentions the right number for a different term still supports it.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"document":{"type":"object","properties":{"pages":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"string","maxLength":100000,"description":"The text of one page, exactly as extracted."},"description":"The document's text, one string per page in order: pages[0] is page 1. Send the text as extracted (from the PDF text layer or OCR), not a summary; quotes are matched against it."},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Optional SHA-256 (lowercase hex) of the original file. When given, document_id is fl:document:sha256-<this>, the same ID id_document gives the file; FactLot cannot check that the pages came from that file. Without it, document_id is the SHA-256 of the pages joined by form feeds (\\f)."},"title":{"type":"string","maxLength":500,"description":"Document title for citations, e.g. \"First Amendment to Lease\"."},"ocr_pages":{"maxItems":2000,"type":"array","items":{"type":"integer","minimum":1,"maximum":100000},"description":"Optional: pages (1-based) whose text came from OCR rather than the file's text layer (doc_read_pdf and factlot.read_pdf report them). Facts and citations on these pages carry ocr: true, so a reviewer checks the scan."}},"required":["pages"],"description":"The document the quote is from."},"claim":{"anyOf":[{"type":"string","minLength":1,"maxLength":2000,"description":"A short claim sentence, read as {text: the sentence}; its numbers and dates are checked."},{"type":"object","properties":{"predicate":{"description":"Predicate of the claim, with value.","type":"string","minLength":1,"maxLength":200},"value":{"description":"Claimed value in the predicate's shape, with predicate."},"text":{"description":"Or a short claim sentence instead of predicate and value; its numbers and dates are checked.","type":"string","minLength":1,"maxLength":2000}},"description":"Either {predicate, value} or {text}."}]},"quote":{"type":"string","maxLength":5000,"description":"Verbatim text from the page that the claim rests on."},"page":{"type":"integer","minimum":1,"maximum":100000,"description":"1-based page the quote is on."}},"required":["document","claim","quote","page"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"doc_verify_facts","title":"Verify extracted document facts","description":"Check values YOU extracted from a document against its text, deterministically; FactLot runs no model. Send the pages as text and one candidate per value: {predicate, value, quote, page}. Each candidate is checked in order: (1) the value's shape (Ingest predicates such as lease.expiration_date YYYY-MM-DD, lease.pro_rata_share in (0, 1], ordered lease.base_rent_schedule steps; any other dotted predicate needs a non-empty value); (2) the quote, at least 12 characters, is on the cited page, where only whitespace, line breaks, letter case and typographic quotes and dashes may differ (a word hyphenated across a line must keep its hyphen; a quote found on exactly one other page is accepted with the page corrected); (3) every number, date and party name in the value is written in the quote, in any common form: 1250000 matches \"$1,250,000.00\", 0.03 matches \"3%\" or \"three percent\", 2031-06-30 matches \"June 30, 2031\" or \"6/30/2031\"; text the lease states as written (a prohibited use, a carve-out, a protected use) is written in it as words, ignoring case, punctuation and line breaks; (4) a confidence you give below 0.8 holds it for review; (5) every other part of the value must be confirmed by the quote too: a true/false value, an enum or a summary not written in the quote holds the candidate for review, named in the reason. Verified means every part of the value was found in the quote. Returns verified (FactLot facts: method extracted, citing document_id, page, quote and character span, plus which value parts were checked and as what), needs_review (the quote is on the page but does not state the value: check consistency; low confidence: confidence; a part FactLot cannot confirm from the quote, such as a boolean: coverage) and rejected (wrong shape; quote missing, too short, or on several pages), each with a reason to act on. Not checked: meaning (a quote stating the number in another context passes), and whether the pages came from the file whose sha256 you give.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"document":{"type":"object","properties":{"pages":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"string","maxLength":100000,"description":"The text of one page, exactly as extracted."},"description":"The document's text, one string per page in order: pages[0] is page 1. Send the text as extracted (from the PDF text layer or OCR), not a summary; quotes are matched against it."},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Optional SHA-256 (lowercase hex) of the original file. When given, document_id is fl:document:sha256-<this>, the same ID id_document gives the file; FactLot cannot check that the pages came from that file. Without it, document_id is the SHA-256 of the pages joined by form feeds (\\f)."},"title":{"type":"string","maxLength":500,"description":"Document title for citations, e.g. \"First Amendment to Lease\"."},"ocr_pages":{"maxItems":2000,"type":"array","items":{"type":"integer","minimum":1,"maximum":100000},"description":"Optional: pages (1-based) whose text came from OCR rather than the file's text layer (doc_read_pdf and factlot.read_pdf report them). Facts and citations on these pages carry ocr: true, so a reviewer checks the scan."}},"required":["pages"],"description":"The document the candidates were read from."},"candidates":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"predicate":{"type":"string","minLength":1,"maxLength":200,"description":"Dotted lower_snake predicate. Use an Ingest predicate (lease.expiration_date, lease.base_rent_schedule, ...) for its value-shape and quote rules; any other predicate gets the generic rules."},"value":{"description":"The value you read, in the predicate's shape: dates YYYY-MM-DD, money and areas as plain numbers (1250000, not \"$1.25M\"), shares and rates as decimals (0.03 for 3%)."},"quote":{"type":"string","maxLength":5000,"description":"Verbatim text from the page that states the value, at least 12 characters. Copy it exactly; only whitespace, line breaks, letter case and typographic quotes and dashes may differ."},"page":{"type":"integer","minimum":1,"maximum":100000,"description":"1-based page the quote is on."},"section":{"description":"Section or clause as written, e.g. \"§4.2(b)\".","type":"string","maxLength":200},"confidence":{"description":"Your confidence 0–1. Below 0.8 the candidate goes to needs_review even if it verifies.","type":"number","minimum":0,"maximum":1},"commencement":{"description":"Only for lease.base_rent_schedule written by lease year (steps {lease_years: [1, 5], annual_rent_psf}): the commencement date the step dates are derived from, with its own quote. FactLot checks it like a lease.commencement_date candidate and derives each step: Lease Year N runs from the (N−1)th anniversary of the commencement date to the day before the next. If it does not verify, the schedule stays in needs_review.","type":"object","properties":{"value":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"The commencement date (YYYY-MM-DD)."},"quote":{"type":"string","maxLength":5000,"description":"Verbatim text that states the commencement date, at least 12 characters."},"page":{"type":"integer","minimum":1,"maximum":100000,"description":"1-based page of this document the quote is on (it may differ from the rent table's page)."},"section":{"description":"Section, if any.","type":"string","maxLength":200}},"required":["value","quote","page"]},"confirmation":{"description":"A person's confirmation of the parts of the value no quote can prove (a true/false value, an enum such as a CAM cap method or kick-out party, a paraphrased summary). With it, a candidate whose only gaps are such parts is verified with method human_verified: the parts the quote confirmed are listed under checked and the rest under confirmed_by_person. It never overrides a quote that is not on the page, a number or date the quote does not state, or a confidence below 0.8.","type":"object","properties":{"by":{"type":"string","minLength":1,"maxLength":200,"description":"The name or role of the PERSON who read the clause and confirmed the value, e.g. \"J. Smith, lease administrator\". FactLot does not authenticate it. Only for a value a person has read: a confirmation by the extractor itself does not count as a confirmation by a person."},"at":{"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}],"description":"When the person confirmed it: YYYY-MM-DD, or an ISO 8601 timestamp with offset. A date is recorded on the fact as that day at 00:00 UTC."},"note":{"description":"What the person checked; returned with the result (the fact schema has no field for it).","type":"string","maxLength":1000}},"required":["by","at"]}},"required":["predicate","value","quote","page"]},"description":"Values you extracted, each with its quote and page."},"as_of":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","description":"Date the facts are stated as of (YYYY-MM-DD), usually today."},"subject":{"type":"string","maxLength":500,"pattern":"^fl:[a-z]+:[^\\s:]+(?::[^\\s]+)?$","description":"FactLot URN the facts are about, e.g. your lease's fl:lease:… ID. Default: the document ID."}},"required":["document","candidates","as_of"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"estoppel_prepare","title":"Prepare the statements of a tenant estoppel certificate","description":"Prepare the standard statements of a tenant estoppel certificate from verified lease facts, for a lender or buyer who wants the tenant to confirm the lease. Give the lease's facts (doc_abstract_lease or doc_verify_facts, each with its quote and page and passing fact_validate: parties, commencement and expiration, rentable area, base rent schedule, security deposit, free rent, TI allowance, renewal, expansion, termination and purchase options and their notice deadlines), the lease and amendment documents, the premises and as_of, and optionally what the landlord's own records say (rent paid through, deposit held). Returns numbered statements: the lease and amendment list with document fingerprints, commencement, expiration, premises, current base rent and the next step (annual and monthly, worked and shown), security deposit, free rent, TI allowance, each option, each carrying the source quote and page, with a superseded sentence shown as superseded when an amendment changed it; and statements only the tenant can know (no other agreements, deposit paid, rent paid through, no rent paid more than one month ahead, landlord obligations outstanding, no other options, no landlord default, no tenant default, no assignment or sublease), marked tenant to confirm with no lease source. Flags every gap (a term the facts do not supply) and every conflict between the lease and an amendment, and withholds that statement rather than guess. Also returns key figures, totals, package_facts and package_items ready for fact_package_send kind estoppel. Deterministic and no model: same facts, same statements; as_of is an input. These are facts and arithmetic, not legal advice, and the tenant's signature, not FactLot, is what makes a certificate an estoppel. Each statement carries its quote, for a person to review before anything is sent. On the hosted API the whole answer also carries attestation, the service's signature over the items, grades and figures that fact_package_send carries, so the FactLot record can show them as computed by FactLot and unchanged since; a service without a signing key returns none and says so. On the hosted API, callers without a Pro or Team key get the summary only (counts, statement titles and status, gaps and conflicts) and the answer says what is withheld. Each free, email-verified account (an fl_free_ key) gets one whole document in total across audit_expense_statement, estoppel_prepare and rent_roll_certify: that answer says so, and the report built from the same arguments is included for 24 hours; Pro and Team include every document with the monthly allowance.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"lease_facts":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":"The lease's verified facts, for the lease and every amendment (doc_abstract_lease's facts, or doc_verify_facts' verified[].fact), each with its quote and page and passing fact_validate. Read by predicate: lease.landlord, lease.tenant, lease.commencement_date, lease.expiration_date, lease.rentable_area_sf, lease.base_rent_schedule (dated steps {from, to, annual_rent_psf}), lease.security_deposit (USD), lease.free_rent {months, applies_to}, lease.ti_allowance (USD, or {amount, per_sf?}), lease.renewal_option {count, term_months, notice_months, rent}, lease.renewal_notice_deadline, lease.termination_option {effective_date, notice_months, fee}, lease.termination_notice_deadline, lease.expansion_option (text or {description}), lease.expansion_option_deadline, lease.rofr and lease.rofo {applies_to: space|purchase, description, response_days}, lease.purchase_option (text or {description, price?}). A fact another fact supersedes (supersedes) is history; a fact valid_from after as_of is pending and not used. A term no fact supplies is listed under gaps; nothing is guessed."},"parties":{"type":"object","properties":{"tenant":{"type":"object","properties":{"organisation":{"type":"string","minLength":1,"maxLength":120,"description":"The organisation's name as the lease or the certificate uses it."}},"required":["organisation"],"description":"The tenant that will sign the certificate."},"landlord":{"type":"object","properties":{"organisation":{"type":"string","minLength":1,"maxLength":120,"description":"The organisation's name as the lease or the certificate uses it."}},"required":["organisation"],"description":"The landlord the certificate is given about."},"requested_by":{"description":"The lender or buyer the certificate is for, if known. The tenant's answers are for it to rely on; it is not the sender.","type":"object","properties":{"organisation":{"type":"string","minLength":1,"maxLength":120,"description":"The organisation's name as the lease or the certificate uses it."},"role":{"type":"string","enum":["lender","buyer","other"],"description":"Why the certificate is wanted."}},"required":["organisation","role"]}},"required":["tenant","landlord"],"description":"The parties."},"premises":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":240,"description":"The premises in words: address and suite."}},"required":["label"],"description":"The leased premises."},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The date of the certificate, YYYY-MM-DD. The tool reads no clock: the current rent step and the next one are found from this date."},"documents":{"description":"Optional: which cited document is the lease and which are amendments. Without it, a document whose facts carry valid_from is an amendment and the one remaining is the lease; anything unclear is flagged, never guessed.","maxItems":50,"type":"array","items":{"type":"object","properties":{"document_id":{"type":"string","pattern":"^fl:document:sha256-[a-f0-9]{64}$","description":"The document's FactLot ID, as the facts cite it."},"role":{"type":"string","enum":["original","amendment"]},"title":{"type":"string","minLength":1,"maxLength":160},"effective_date":{"description":"For an amendment, the date it takes effect.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["document_id","role"]}},"landlord_records":{"description":"Optional figures from the landlord's own records. They have no lease source and are marked as the landlord's.","type":"object","properties":{"rent_paid_through":{"description":"The date through which the landlord's own ledger shows rent paid. It is not a lease term: it is shown to the tenant as the landlord's figure to confirm.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"security_deposit_held":{"description":"The deposit the landlord's ledger shows held, USD. Compared with the lease's figure; a difference is flagged. Must be greater than 0.","type":"number","minimum":0}}}},"required":["lease_facts","parties","premises","as_of"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"fact_package_create","title":"Create a fact package","description":"Bundle FactLot facts (each must pass fact_validate) into a fact package a counterparty can verify: canonical JSON (RFC 8785) of every fact, an RFC 6962 Merkle tree over the facts, the source documents the facts cite with their sha256 where known, and a digest over all of it. Returns the unsigned package, its digest, and signing_message, the exact text to sign. FactLot never holds private keys: to sign, the holder signs signing_message with their own Ed25519 key on their own machine (factlot.sign_fact_package in Python, signFactPackage in @factlot/tools, or fact_package_sign in the local MCP server). Deterministic: no clock time is added (pass created_at), and the same facts always give the same digest.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"facts":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"A FactLot fact (it must pass fact_validate)."},"description":"The facts to package, in order: verified facts from the doc_* tools or any facts that pass fact_validate."},"title":{"description":"A title for the package.","type":"string","maxLength":500},"created_at":{"description":"When the package was made (ISO 8601 with offset). FactLot adds no clock time, so the same input always gives the same package.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"created_by":{"description":"The organization making the package.","type":"string","maxLength":200},"documents":{"description":"Source documents to describe beyond what the facts cite (a title, the file's sha256). Every document a fact cites is listed automatically.","maxItems":50,"type":"array","items":{"type":"object","properties":{"document_id":{"type":"string","minLength":1,"maxLength":500,"description":"The document's ID as the facts cite it."},"sha256":{"description":"SHA-256 of the exact file, when known.","type":"string","pattern":"^[a-f0-9]{64}$"},"title":{"type":"string","maxLength":500}},"required":["document_id"]}}},"required":["facts"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"fact_package_send","title":"Send a fact package to a counterparty for confirmation","description":"Send a fact package to another firm for confirmation through the FactLot record, and get back a link for them. For an expense (CAM) reconciliation: the tenant's facts (lease terms and the landlord's statement figures, each with its quote and page, from doc_verify_facts or doc_abstract_lease) go in a package from fact_package_create, the arithmetic is calc_cam_reconciliation's output as calculation, and each line is an item: accept_theirs where the sender accepts the counterparty's figure, state_ours where the lease gives a different figure and the counterparty is asked to agree or dispute it. The counterparty opens the link on a plain web page (no account needed), sees every item with both figures, the quote, page and document fingerprint, and agrees or disputes each. Every accepted or agreed item is recorded as a reliance, citing the package digest. The FactLot record keeps each fact, its quote, the page and each document's SHA-256, never the documents. A send goes to an outside party and cannot be recalled. Refuses without approved_by, the full name of the person who reviewed every item, and approval_confirmed: true. Refuses a package that fails fact_package_verify's integrity checks, and an item whose fact_ids are not in the package. Real or test: a package is sent for real only through the hosted FactLot API with the subscription's own FactLot key (paid, or an email-confirmed free key) or a connection signed in with one; a real send records reliances between the named organisations at once. Every other call is a test (no key, a free connection without a key, a guest key, or a local or self-hosted FactLot): the counterparty can still open the link and answer, but nothing is recorded as a reliance or counted in the FactLot record's measure. The answer says which happened (recorded_as, test_mode, and message with the reason). Returns the package id, digest, link_for_counterparty, status_link_for_sender (private to the sender) and what was recorded. For a tenant estoppel (kind estoppel) the items are the statements from estoppel_prepare package_items, every one state_ours: the tenant confirms each, or states its own version, on the same page; the tenant gives the signer's full name and title and signs electronically on the same page (a consent statement ticked and the name typed): the FactLot record keeps the signer, the time in UTC, the consent wording's version and a SHA-256 over the answered statements, and no IP address. relying_parties gives a lender or buyer its own view link (links_for_relying_parties), which shows the statements, the tenant's answers, the signature and the document fingerprints and lets that firm record its own reliance, one per confirmed statement and never on a disputed one, and only after the tenant has signed; where any statement is disputed, the page lists each with the tenant's own version and the firm must acknowledge them first, and the reliance stores which statements were confirmed and which disputed at that moment. The relying firm must differ from the sender and the tenant. With attestation (from audit_expense_statement, estoppel_prepare or rent_roll_certify on the hosted API) the FactLot record checks the service's signature and that the items, grades, figures and facts are the ones the service computed, and records the package as attested; a package with none is recorded as unattested, and a package with an attestation that does not verify is refused. Where the FactLot record requires it, a real package of kind expense_reconciliation, estoppel or rent_roll must be attested; test packages need not be. The answer says which (attestation.status and its line). fact_package_status reads the answers and the reliers later.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"package":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"The package from fact_package_create (signed or not)."},"kind":{"type":"string","enum":["expense_reconciliation","fact_confirmation","estoppel","rent_roll"],"description":"What is being confirmed. estoppel: the statements from estoppel_prepare, answered by the tenant and then open to a lender or buyer through relying_parties. rent_roll: a certified rent roll from rent_roll_certify, asserted by the sender (no answer step) and open at once to the lender or buyer named in to, and to relying_parties, who record reliance on each line graded as matching."},"title":{"type":"string","minLength":1,"maxLength":160,"description":"A title the counterparty sees."},"subject":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":240,"description":"What it is about, in words (for example an address)."},"record_id":{"type":"string","pattern":"^par_[0-9A-Za-z]{13}$"},"urn":{"type":"string","maxLength":120,"pattern":"^fl:[a-z_]+:[A-Za-z0-9_.:-]+$"}},"required":["label"],"description":"The property or lease the facts are about."},"from":{"type":"object","properties":{"organisation":{"type":"string","minLength":1,"maxLength":120},"person":{"type":"string","minLength":1,"maxLength":120},"email":{"description":"Kept by FactLot to reach the person; never shown to the other party.","type":"string","maxLength":200}},"required":["organisation","person"],"description":"The sender: organisation, person, email."},"to":{"type":"object","properties":{"organisation":{"type":"string","minLength":1,"maxLength":120},"person":{"type":"string","maxLength":120},"email":{"description":"Kept by FactLot; never shown to anyone else.","type":"string","maxLength":200}},"required":["organisation"],"description":"The counterparty."},"items":{"minItems":1,"maxItems":60,"type":"array","items":{"type":"object","properties":{"key":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,60}$","description":"A short stable name for the item, unique in the package."},"label":{"type":"string","minLength":1,"maxLength":160,"description":"What the item is, in plain words the counterparty will read."},"value":{"anyOf":[{"type":"string","minLength":1,"maxLength":400},{"type":"number"}],"description":"The sender's figure. For accept_theirs it is the figure the sender accepts (the counterparty's own); for state_ours it is the figure the sender says is right."},"unit":{"description":"For example USD, SF, percent.","type":"string","maxLength":30},"position":{"type":"string","enum":["accept_theirs","state_ours"],"description":"accept_theirs: the sender accepts the counterparty's figure (recorded at once as relied on by the sender). state_ours: the sender states its own figure and asks the counterparty to agree or dispute it."},"their_value":{"description":"The counterparty's figure, when it differs (always give it for state_ours).","anyOf":[{"type":"string","minLength":1,"maxLength":400},{"type":"number"}]},"fact_ids":{"minItems":0,"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"description":"The ids of the facts in the package this item rests on. Each fact must carry a source quote, page and document sha256. Only an estoppel statement the tenant alone can confirm (tenant_to_confirm true) may have none."},"note":{"description":"A sentence on why, shown to the counterparty.","type":"string","maxLength":600},"number":{"description":"Estoppel: the statement's number in the certificate.","type":"integer","minimum":1,"maximum":200},"text":{"description":"Estoppel: the statement as the tenant reads and answers it (estoppel_prepare package_items[].text).","type":"string","minLength":1,"maxLength":700},"tenant_to_confirm":{"description":"Estoppel: true for a statement with no lease source that only the tenant can confirm. It has no fact_ids.","type":"boolean"},"needs_tenant_value":{"description":"Estoppel: true when the tenant must state the figure or date itself (for example the date rent is paid through); the tenant's answer then carries its own version.","type":"boolean"},"grade":{"description":"Rent roll: the line's grade from rent_roll_certify. Reliance is recorded only for matches_lease and matches_lease_confirmed_by_tenant.","type":"string","enum":["matches_lease","matches_lease_confirmed_by_tenant","differs","no_lease_supplied","not_checkable"]},"grade_label":{"description":"Rent roll: the grade in words, as rent_roll_certify gives it.","type":"string","maxLength":80},"differences":{"description":"Rent roll: the fields of the line that differ.","maxItems":12,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":40,"description":"The field that differs."},"label":{"type":"string","maxLength":80,"description":"The field in words."},"roll":{"anyOf":[{"anyOf":[{"type":"string","maxLength":200},{"type":"number"}]},{"type":"null"}],"description":"The roll's figure."},"against":{"anyOf":[{"anyOf":[{"type":"string","maxLength":200},{"type":"number"}]},{"type":"null"}],"description":"The figure it was compared with."},"against_label":{"type":"string","maxLength":20,"description":"What it was compared with: Lease, Tenant or Roll."},"difference":{"description":"Roll minus the figure compared with.","type":"number"}},"required":["field","label","roll","against","against_label"]}},"estoppel_package_id":{"description":"Rent roll: the estoppel package whose confirmed statements back a matches_lease_confirmed_by_tenant grade.","type":"string","maxLength":60},"estoppel_statements":{"description":"Rent roll: the keys of the estoppel statements the tenant agreed.","maxItems":60,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}}},"required":["key","label","value","position","fact_ids"]},"description":"The line items. The counterparty answers each state_ours item."},"calculation":{"description":"A calc tool's output (for example calc_cam_reconciliation) shown to the counterparty with every step.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"relying_parties":{"description":"Estoppel and rent_roll only: a label for each lender or buyer that is to get its own view link and token (for example the lender's name). Each can read the package and record its own reliance; none can answer for the tenant. For an estoppel with none given FactLot makes one link; for a rent roll the party named in to has a link already and these are additional.","maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"estoppel_links":{"description":"Rent roll only: the sender's status link (status_link_for_sender) of each estoppel that backs a matches_lease_confirmed_by_tenant line. The FactLot record opens each with its private token to check the tenant agreed the statements; the token is not stored.","maxItems":60,"type":"array","items":{"type":"string","maxLength":500}},"attestation":{"description":"The attestation that the hosted FactLot service returned with package_items from audit_expense_statement, estoppel_prepare or rent_roll_certify, passed unchanged. The FactLot record checks the service's signature and that the items, grades, figures and facts sent are the ones the service computed. Without it the package is recorded as unattested.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"approved_by":{"type":"string","minLength":1,"maxLength":120,"description":"The full name of the person at the sender who reviewed every item and approved sending this package. Recorded with the package and shown to the counterparty."},"approval_confirmed":{"type":"boolean","description":"Confirms that the person named in approved_by reviewed every item, both figures, the quote and page behind each, the calculation and the recipient, and approved sending. The tool refuses unless it is true."}},"required":["package","kind","title","subject","from","to","items","approved_by","approval_confirmed"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"fact_package_status","title":"Read a sent fact package's status and answers","description":"Read the status of a package sent with fact_package_send: for each item, whether the counterparty agreed or disputed it (with their reason and who answered), which items the sender accepted, the reliances recorded, and the package's integrity. For an estoppel it also gives the statement number and text, the tenant's own version where it gave one, the signer's name and title with the electronic signature record (time in UTC, consent wording version and text, SHA-256 of the signed statements, and whether they are unchanged), reliers (each lender or buyer that recorded reliance, its role, the statements and when), and for each relying-party link the first and last time it was opened and how many times, with the name, firm and role given once reliance is recorded and the statements confirmed and disputed at that moment. Give the sender's private status_link (or package_id with token). Needs no account and costs nothing; it reads only your own package, and the counterparty's link cannot read it. The answer also gives attestation (attested or unattested, with the line the pages show: computed by FactLot and unchanged since, or not verified) and package_signature (the outcome of checking the signature fact_package_create's holder made, when there is one). The answer says whether the package was sent in test mode (test_mode true: it does not count in the FactLot record's measure) or for real.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"status_link":{"description":"The sender's private status link from fact_package_send.","type":"string","maxLength":500},"package_id":{"type":"string","maxLength":60},"token":{"description":"The sender's private token (with package_id), if there is no link.","type":"string","maxLength":200}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"fact_package_verify","title":"Verify a fact package","description":"Verify a fact package from fact_package_create: recompute every fact's hash, the Merkle root and the digest from the content (any changed fact, title, date or document list shows as a mismatch); check each fact against fact_validate; check the Ed25519 signature, against the public_key you pass (base64url, the signer's key you trust) or, without one, only against the key inside the package (which proves nothing about who signed); and, given the source documents' pages, check every quote is on its cited page. Returns valid plus each check's details, checks_run and checks_not_run (what was and was not checked), and values_not_checked: the parts of extracted facts' values that their quotes do not confirm (a true/false value, an enum, a summary), which do not change valid. Not checked: that the pages you pass are the original files (pass sha256 to tie them to the file hash), or what the facts mean.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"package":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"A fact package from fact_package_create, signed or not."},"public_key":{"description":"The signer's Ed25519 public key you trust: 32 bytes as base64url (a JWK's x). With it the signature must verify for the package to be valid.","type":"string","maxLength":200},"documents":{"description":"Optional: the source documents' pages (with sha256 when the facts cite the file's hash). Each fact's quote is then checked on its cited page.","maxItems":50,"type":"array","items":{"type":"object","properties":{"pages":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"string","maxLength":100000,"description":"The text of one page, exactly as extracted."},"description":"The document's text, one string per page in order: pages[0] is page 1. Send the text as extracted (from the PDF text layer or OCR), not a summary; quotes are matched against it."},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Optional SHA-256 (lowercase hex) of the original file. When given, document_id is fl:document:sha256-<this>, the same ID id_document gives the file; FactLot cannot check that the pages came from that file. Without it, document_id is the SHA-256 of the pages joined by form feeds (\\f)."},"title":{"type":"string","maxLength":500,"description":"Document title for citations, e.g. \"First Amendment to Lease\"."},"ocr_pages":{"maxItems":2000,"type":"array","items":{"type":"integer","minimum":1,"maximum":100000},"description":"Optional: pages (1-based) whose text came from OCR rather than the file's text layer (doc_read_pdf and factlot.read_pdf report them). Facts and citations on these pages carry ocr: true, so a reviewer checks the scan."}},"required":["pages"]}}},"required":["package"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"fact_validate","title":"Validate a FactLot fact","description":"Check one FactLot fact against the published fact schema (spec/schemas/fact.json): subject URN, dotted predicate, as_of date, provenance, optional rights; unknown fields are rejected at every level. Rules: every fact except a computed one cites at least one source (an inferred fact cites the evidence it was inferred from); a computed fact names its formula or cites a source; valid_from is not after valid_to; a source span does not end before it starts. For Ingest predicates (lease.expiration_date, lease.rentable_area_sf, lease.base_rent_schedule, ...) the value must have the predicate's shape and every source quote must state the value, by the same written-form rules as doc_verify_facts (a quote saying \"2,500 square feet\" does not support 1000). Not checked: that the quote is in the document, that the document or sha256 exists, that supersedes IDs exist, and quotes for other predicates; doc_verify_facts with the document's pages checks the quote. Returns { valid, issues }. Meant for checking facts before they are stored or shared.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"fact":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"A FactLot fact: subject, predicate, value, as_of, provenance (with sources), optional rights."}},"required":["fact"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"fetch","title":"Fetch a FactLot knowledge document","description":"Fetch the full text of a FactLot knowledge document by the id returned from search. With a registry loaded, a registry fact's source document_id (fl:document:sha256-…) returns that source snapshot: publisher, dataset, URL, retrieval date, as-of date, licence, AI-use and redistribution rights, file name and size.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"id":{"type":"string","maxLength":200,"description":"Document id from search, e.g. tool:calc_cam_reconciliation, or a registry source snapshot's FactLot document ID (fl:document:sha256-…) when a registry is loaded."}},"required":["id"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"id_building","title":"FactLot building ID","description":"Deterministic FactLot ID for a building from its street address: county FIPS, ZIP code, and street line. Every condominium unit, suite, and floor at the address gets the same building ID, offline. id_space takes it for a suite, and registry_get shows the building's parcels.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"state_fips":{"type":"string","maxLength":16,"description":"2-digit state FIPS code, e.g. \"11\" for the District of Columbia."},"county_fips":{"type":"string","maxLength":16,"description":"3-digit county FIPS code, e.g. \"001\"."},"zip":{"type":"string","maxLength":16,"description":"5-digit ZIP code of the address, e.g. \"20002\" (ZIP+4 accepted)."},"street":{"type":"string","maxLength":300,"description":"Street line: house number and street, e.g. \"208 Massachusetts Ave NE\". A suite, unit or floor is ignored, and so is anything after a comma (city, state)."}},"required":["state_fips","county_fips","zip","street"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"id_document","title":"FactLot document ID","description":"Content-addressed FactLot ID (SHA-256) for a document such as a lease, amendment, or estoppel.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"content_base64":{"description":"Base64 of the exact file bytes (preferred: every party gets the same ID).","type":"string"},"text":{"description":"Document text, UTF-8 encoded before hashing. Use only when bytes are unavailable.","type":"string"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"id_entity","title":"FactLot legal-entity ID","description":"Deterministic FactLot ID for a legal entity (LLC, LP, corporation, trust) from its registry jurisdiction and file number, or from its LEI (an LEI whose ISO 17442 check digits do not match is rejected).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"jurisdiction":{"type":"string","maxLength":64,"description":"Registry jurisdiction, e.g. \"us-de\" for Delaware, or \"lei\" for a Legal Entity Identifier."},"registry_number":{"type":"string","maxLength":200,"description":"File number issued by that registry, or the 20-character LEI (its ISO 17442 check digits are verified)."}},"required":["jurisdiction","registry_number"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"id_parcel","title":"FactLot parcel ID","description":"Deterministic FactLot ID for a parcel from state FIPS, county FIPS, and the assessor's parcel number (APN). The same parcel always yields the same ID, offline. It serves as the join key across systems. APNs that differ only in where a separator falls (\"12-34\", \"1-234\") get different IDs; in a county with a documented fixed-width format the variants of one APN converge (NYC BBL \"3-1234-56\" = \"3012340056\").","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"state_fips":{"type":"string","maxLength":16,"description":"2-digit state FIPS code, e.g. \"06\" for California."},"county_fips":{"type":"string","maxLength":16,"description":"3-digit county FIPS code, e.g. \"037\" for Los Angeles County."},"apn":{"type":"string","maxLength":200,"description":"Assessor's parcel number exactly as the county prints it. Letter case and the separator characters are normalized; where a separator falls is kept, except in counties with a documented fixed-width format (NYC BBL, Los Angeles AIN, Cook County PIN, DC SSL)."}},"required":["state_fips","county_fips","apn"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"id_parse","title":"Parse a FactLot ID","description":"Validate a FactLot URN and return its kind, components, and short ID.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"urn":{"type":"string","maxLength":500,"description":"A FactLot URN to validate, e.g. fl:parcel:us-06037:5432001012."}},"required":["urn"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"id_space","title":"FactLot space (suite) ID","description":"FactLot ID for a suite or unit within a building, given the building's FactLot URN (from id_building). Suite designators are normalized: \"Suite 100\", \"Ste 100\" and \"#100\" agree, while \"1-20\" and \"120\" stay distinct.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"building_urn":{"type":"string","maxLength":500,"description":"FactLot building URN from id_building, e.g. fl:building:us-11001:20002:208-massachusetts-ave-ne (a minted fl:building:<26-character token> also works)."},"suite":{"type":"string","maxLength":200,"description":"Suite or unit as written (\"Suite 400\", \"STE 400\", \"#400\", \"3rd Floor\" all normalize)."}},"required":["building_urn","suite"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"lease_comp_search","title":"Search GSA lease comps (federal tenant)","description":"Search the 6,994 lease comps from the U.S. General Services Administration's Lease Inventory (October 2026 file, FactLot release lease-comps-gsa-2026-11-04), bundled with FactLot: works offline and on the hosted API, no registry needed. Caveat: the tenant in every one of these leases is the federal government (GSA, for an agency); they are not market comps for private tenants, and the rent is the current annual rent in GSA's file divided by the rentable SF, not the starting rent (no escalations, free rent, TI or commissions are known). Filter by state, 5-digit county FIPS, city, ZIP, a radius around a latitude/longitude (GSA's own coordinates; nothing is geocoded), rentable SF, commencement date, rent per SF, property type (office, industrial, other) and expense basis; sort; limit (default 25, at most 200). Each comp gives its FactLot lease ID, GSA lease number, address, county FIPS, building ID, landlord (organisations only; individuals are never stored), rentable SF, commencement, expiration, term, early-termination date, annual rent, rent per SF per year, property type, expense basis and the row of the GSA file it comes from. summary gives the count and the median, quartiles and range of rent per SF over every match, labelled as statistics of GSA leases. Every answer carries the caveat and the citation (GSA file URL, SHA-256 document ID, as-of and retrieval dates, licence: public domain). These are statistics of GSA leases, kept apart from market comps.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"state":{"description":"Two-letter state or territory code, e.g. \"TX\".","type":"string","pattern":"^[A-Za-z]{2}$"},"county_fips":{"description":"5-digit county FIPS code (state + county), e.g. \"48201\" for Harris County, Texas. Connecticut uses its planning regions (09110 to 09190).","type":"string","pattern":"^[0-9]{5}$"},"city":{"description":"City as GSA writes it, matched whole and ignoring case, e.g. \"Houston\".","type":"string","minLength":1,"maxLength":100},"zip":{"description":"5-digit ZIP code (ZIP+4 accepted), e.g. \"77002\".","type":"string","pattern":"^[0-9]{5}(-[0-9]{4})?$"},"near":{"description":"Comps within a radius of a point, by great-circle distance to the coordinates GSA's file gives for each lease (FactLot geocodes nothing; give the point's coordinates yourself). Comps without coordinates are left out and counted in warnings.","type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude, degrees."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude, degrees."},"radius_miles":{"type":"number","maximum":500,"description":"Radius in miles (at most 500). Must be greater than 0.","minimum":0}},"required":["latitude","longitude","radius_miles"]},"min_rentable_sf":{"description":"Smallest lease rentable area, SF.","type":"number","minimum":0},"max_rentable_sf":{"description":"Largest lease rentable area, SF.","type":"number","minimum":0},"commencement_from":{"description":"Earliest lease commencement (effective) date, YYYY-MM-DD.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"commencement_to":{"description":"Latest lease commencement (effective) date, YYYY-MM-DD.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"min_rent_psf_yr":{"description":"Lowest current rent, USD per rentable SF per year (GSA's current annual rent divided by the RSF).","type":"number","minimum":0},"max_rent_psf_yr":{"description":"Highest current rent, USD per rentable SF per year.","type":"number","minimum":0},"property_type":{"description":"office, industrial (GSA warehouse) or other (GSA special space): the largest use in the lease.","type":"string","enum":["office","industrial","other"]},"expense_basis":{"description":"full_service (GSA fully serviced) or not_full_service.","type":"string","enum":["full_service","not_full_service"]},"sort":{"description":"Order of results: distance_asc (the default with near; needs near), commencement_desc (the default otherwise), commencement_asc, expiration_asc, expiration_desc, rent_psf_desc, rent_psf_asc, rentable_sf_desc, rentable_sf_asc. Ties go by GSA lease number.","type":"string","enum":["commencement_desc","commencement_asc","expiration_asc","expiration_desc","rent_psf_desc","rent_psf_asc","rentable_sf_desc","rentable_sf_asc","distance_asc"]},"limit":{"default":25,"description":"Maximum comps returned (1–200, default 25); the summary covers every match.","type":"integer","minimum":1,"maximum":200}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"lease_comp_validate","title":"Validate a lease comp and derive its NER","description":"Check a lease comparable one firm shares with others, as a FactLot fact with predicate lease.comp, and derive its net effective rent. The fact goes through fact_validate (schema, citations, rights), then the comp's own rules: shape (spec/schemas/fact.json LeaseComp: area, commencement, term or expiration, starting or current rent, escalation, free rent, TI, leasing commissions, expense basis, confirming party, verification), an expiration after commencement, a term that matches the dates, free rent within the term, no email, phone or ID number in the text. A comp names no person or company. With the default share profile it also needs the deal's starting rent, escalations, free rent, TI, property type, an expense basis other than unknown, and stated rights. When valid and a starting rent is given, ner.fact is a computed lease.net_effective_rent fact (formula calc.net_effective_rent@1, straight-line and discounted at discount_rate_annual, on the comp's own expense basis; no conversion between full service and net). Returns { valid, issues, warnings, ner }. Meant for checking a comp before it is shared.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"fact":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"A FactLot fact with predicate lease.comp: subject (an fl:lease: URN), value (the comp), as_of, provenance (with at least one source: your own record is fine, cited by document_id or sha256 without sharing it), and rights (ai_use and redistribution)."},"profile":{"default":"share","description":"share (default): a comp offered to other firms: needs the deal's starting rent, escalations, free rent, TI, expense basis, property type, a term and stated rights. observed: a rent seen in a public record (current_rent_psf_yr is enough); no NER is derived without a starting rent.","type":"string","enum":["share","observed"]},"discount_rate_annual":{"default":0.08,"description":"Annual discount rate for the discounted NER (an assumption, not part of the comp). 0 gives the straight-line NER only. Must be less than 1.","type":"number","minimum":0,"maximum":1}},"required":["fact"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_coverage","title":"What the registry holds","description":"The counties (with parcel and building counts), entity registries, and crosswalk systems this FactLot Registry file holds, each with its sources and as-of dates. A miss outside these regions means not loaded, not absent. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"fields":{"description":"true: each county also carries fields, the share of its parcels with each fact group it holds and its roll years with their value types.","type":"boolean"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_get","title":"Get a registry record","description":"Everything the FactLot Registry knows about a parcel, legal entity, or building: status, current cited facts (owner of record, situs address, property category, areas, values), ownership links, external IDs, and for a parcel the building it belongs to (condominium units roll up into one building). value_history (parcels) lists market and appraised value by tax year from every snapshot, newest first, each value cited; a tax year two snapshots value differently appears once per value. as_of gives the facts as they stood on a date. A parcel's recorded sales and documents (transaction.sale, transaction.deed, debt.mortgage_recorded, debt.mortgage_satisfaction_recorded; one fact each, newest first) are kept to the newest 50 in facts and in history; when there are more, recorded_facts_truncated gives what was kept and the totals by predicate with the years left out, and registry_recorded_facts reads them all. warnings flags area facts that look wrong (building area above 40 times the land area, a land area of 0); the facts themselves are as the source publishes them. A building record can carry debt.cmbs_loan facts (one per CMBS trust holding a note of its loan: balance, rate, maturity, payment status, servicer, special-servicing dates, NOI, DSCR) and an entity record can carry entity.parent facts (the SEC registrant that lists it as a subsidiary in Exhibit 21), each cited to its SEC filing. A miss says whether the county or entity registry is loaded. On the hosted API, a call without a Pro or Team key gets the current roll year only in value_history and history, and of a parcel's recorded sales and documents only the newest sale or deed, with the count and years of the rest (the answer says so); a Pro or Team key gets every year and the newest 50 recorded facts. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"urn":{"type":"string","maxLength":500,"description":"FactLot URN of a parcel, entity, or building, e.g. fl:parcel:us-48201:0011440000001 (Harris County, Texas) or fl:parcel:us-36061:1000020002 (Manhattan: a New York City borough-block-lot)."},"include_history":{"default":false,"description":"Also return every fact from every snapshot, superseded ones included (history lists current facts too; a source loaded once has no superseded facts).","type":"boolean"},"as_of":{"description":"Date (YYYY-MM-DD): return the facts and ownership links current on that date, from the snapshots dated on or before it, instead of the latest. With include_history, history stops at that date. On the hosted API a dated lookup needs a Pro or Team key.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"required":["urn"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_lookup_batch","title":"Look up many parcels (batch)","description":"Up to 50 parcels in any loaded state in one call (a loan tape, a broker's list, a client's accounts), each item naming one parcel by exactly one of: urn (a FactLot parcel URN); apn with state_fips and county_fips (3 digits), or with a 5-digit county_fips alone (as registry_resolve_parcel takes them); or address with the optional place fields registry_search_address takes (state, city, postal_code, county_fips). ref, your own row id, is echoed back. Each item is answered as the single tools answer it: registry_get for a URN, registry_resolve_parcel for an account, registry_search_address (20 results) for an address, then registry_get on the URN found. results lists one entry per item in input order (index, ref, by: urn, account or address, status): found gives parcel, a compact row: urn, label, record_status, account, property_category, use_code, improvement_area_sf, year_built, value (the newest roll year's entry of registry_get's value_history: tax_year, market and appraised value, as_of, value types, file and each value's citation), owner_of_record (the owner of record fact exactly as registry_get gives it, with the entity linked to it, or null; organisations only, natural persons are never stored), citations (each field's fact id, document id, locator and as-of date), sources (each cited document with its title, URI, read date, licence, ai_use and redistribution) and warnings; an address item also gives match (exact, and how many parcels the search returned). not_found gives message and coverage exactly as the single tool's miss gives them (the reason: county or state not loaded, street or house number not held); a URN not in the registry also carries registry_get's NotFound as error, with the same coverage registry_resolve_parcel gives for that county. An address is found when exactly one search result is exact, or when the search returned one parcel and it is in the place the address names; exact means the same street address and unit (the label's street line, normalized as the address index normalizes it, 'Street' = 'St', is the query's, a unit written as a bare number after the street counting as the unit, and both name the same unit or neither does) in the place the address names (when it names a city or ZIP code, in its text or the city and postal_code fields, the label has that ZIP code or city). Otherwise it is ambiguous, with reason: several_places (the address names no city or ZIP code and the results are in more than one county; a parcel is never picked across counties), same_address (several parcels have the address exactly: separate accounts at one address), place_differs (the one parcel found is not shown in the place named) or no_exact_match; candidates lists up to 5 of the search's result cards (the exact ones first; never an owner), with matches and a message. error gives the item's own error, so it does not fail the others: a wrong combination of fields (two of urn, apn and address, a field another mode takes, a missing county), a malformed or non-parcel URN, or an item the registry could not answer (RegistryUnavailable; after 5 such items the rest are not sent and say not attempted, and when no item at all is answered the whole call fails with RegistryUnavailable). An item whose fields fail the input schema (a wrong type, an unknown field, an empty ref, a URN over 500 characters) fails the whole call with InputError, uncharged. summary counts items, found, not_found, ambiguous and errors. On the hosted API this batch tool needs a Pro or Team key, and each item counts as the one call that identifies its parcel would count on its own (registry_resolve_parcel for an account or a URN, registry_search_address for an address): a found or ambiguous item counts one registry lookup; an item that finds nothing inside loaded coverage, a URN not in the registry included, is an answer that finds nothing (not counted up to an hourly limit, counted past it); a miss outside loaded coverage and an item with an error count","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"items":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"ref":{"description":"Your own id for this row (a loan number, a client account), echoed back with its answer.","type":"string","minLength":1,"maxLength":200},"urn":{"description":"FactLot parcel URN, e.g. fl:parcel:us-48201:0011440000001.","type":"string","maxLength":500},"apn":{"description":"Parcel or account number as the county prints it (see registry_resolve_parcel), with state_fips and county_fips.","type":"string","maxLength":200},"state_fips":{"description":"With apn: 2-digit state FIPS, e.g. \"48\".","type":"string","maxLength":16},"county_fips":{"description":"With apn: 3-digit county FIPS with state_fips, or 5 digits alone (\"48201\"). With address: keeps the search to that county (5 digits, or 3 with state).","type":"string","maxLength":16},"address":{"description":"Street address, e.g. '1200 Main St, Houston, TX 77002', searched as registry_search_address searches it.","type":"string","maxLength":500},"state":{"description":"With address: state, two letters or full name; keeps the search to that state.","type":"string","maxLength":40},"city":{"description":"With address: city; orders the matches, never filters.","type":"string","maxLength":100},"postal_code":{"description":"With address: ZIP code; orders the matches, never filters.","type":"string","maxLength":10}}},"description":"The parcels (1–50), each by exactly one of urn, apn (with its county) or address."}},"required":["items"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_owned_by","title":"Parcels owned by an entity","description":"Commercial parcels currently linked to a legal entity as owner of record (inferred links carry a confidence), each with the building it belongs to, plus a per-building summary so condominium units count once per building. On the hosted API, a call without a Pro or Team key gets the first three parcels, with every row of each and their buildings (the answer says how many were left out in portfolio_withheld and portfolio_note); a Pro or Team key gets every parcel. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"entity_urn":{"type":"string","maxLength":500,"description":"FactLot entity URN, e.g. fl:entity:us-tx:0801111111."}},"required":["entity_urn"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_recorded_facts","title":"Recorded sales and documents of a parcel","description":"Every recorded sale and document of a parcel (transaction.sale, transaction.deed, debt.mortgage_recorded, debt.mortgage_satisfaction_recorded), newest first in registry_get's order, each a whole fact with its citation, a page at a time. registry_get keeps the newest 50 of them (on the hosted API without a Pro or Team key, the newest sale or deed only); when it holds more, its recorded_facts_truncated gives the totals, and this tool reads the rest. predicate limits the page to one of the four. Pass next_cursor back as cursor for the next page; next_cursor is null on the last. totals counts each predicate's facts. A price or amount is as recorded, zero or nominal included; the sources do not say whether a sale was at arm's length. Parties are organisations only. On the hosted API this tool needs a Pro or Team key. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"urn":{"type":"string","maxLength":500,"description":"FactLot parcel URN, e.g. fl:parcel:us-36061:1012920015."},"predicate":{"description":"Only this predicate's facts.","type":"string","enum":["transaction.sale","transaction.deed","debt.mortgage_recorded","debt.mortgage_satisfaction_recorded"]},"cursor":{"description":"next_cursor from the previous page; omit for the first page.","type":"string","maxLength":64},"limit":{"default":50,"description":"Facts per page (1 to 100).","type":"integer","minimum":1,"maximum":100}},"required":["urn"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_resolve_external","title":"Resolve an external ID","description":"Find the FactLot URN for an ID from another system, e.g. system \"sdat_account\" (a Maryland SDAT account number), \"hcad_account\" (a Harris CAD account number), \"nyc_bbl\" (a New York City borough-block-lot), \"la_ain\" (a Los Angeles County Assessor ID number), \"sf_parcel\", \"boston_pid\", \"denver_schednum\" or \"ct_cama_link\". registry_coverage lists the systems a registry holds. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"system":{"type":"string","maxLength":100,"description":"Crosswalk system name, e.g. \"sdat_account\" (Maryland), \"hcad_account\" (Harris County, Texas) or \"nyc_bbl\" (New York City)."},"external_id":{"type":"string","maxLength":200,"description":"The ID in that system."}},"required":["system","external_id"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_resolve_parcel","title":"Resolve a parcel in the registry","description":"Find a parcel's FactLot URN from state FIPS, county FIPS, and APN, if the registry holds it. A miss returns urn null with coverage: whether that county is loaded in this registry. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"state_fips":{"type":"string","maxLength":16,"description":"2-digit state FIPS, e.g. \"48\" for Texas, \"36\" for New York."},"county_fips":{"type":"string","maxLength":16,"description":"3-digit county FIPS, e.g. \"201\" for Harris County, Texas, or \"061\" for New York County (Manhattan)."},"apn":{"type":"string","maxLength":200,"description":"Parcel or account number as the county prints it: an appraisal district account number in Texas, a borough-block-lot (e.g. 1000020002) in New York City, an AIN in Los Angeles County, a parcel number in San Francisco, a PID in Boston, a schedule number in Denver, the CAMA link in Connecticut."}},"required":["state_fips","county_fips","apn"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_search_address","title":"Search parcels by address","description":"Find commercial parcels by situs address. Matches whole words of the street line (the part before the first comma), normalized: 'Street' = 'St', 'Northwest' = 'N.W.' = 'NW'; a suite, unit, '#' or floor is ignored. A numbered street matches however it is written ('Fifth Avenue' = '5th Ave' = '5 Avenue', 'Forty-Second St' = '42nd St'), and a house number matches a lot whose address is a range holding it ('350 5th Ave' finds '338-350 5 AVENUE'): a range whose ends are both odd or both even holds only the numbers of that parity, one side of the street, and one whose ends differ holds every number between. Give a house number ('1200 Main', '1200 Main St NW') or a street name with its type ('Main St'); a city or a part of a word alone matches nothing. Give the place after the first comma ('1200 Main St, Houston, TX 77002') or as state, city, postal_code and county_fips: a state named after a city (or given as state) keeps the answer to that state, and county_fips to that county, before the limit is applied; the ZIP code and the city only order the matches (same ZIP code first, then same city, then the rest) and never filter; a bare state with no city in the query, and suite, floor or box text, are ignored. Within each place group, matches of the street as written come first, then other spellings, then house-number ranges, an exact address first, then the parcel whose label names the unit the query names (a unit never filters), then by label; parcels sharing one label come largest improvement area first (a parcel the roll gives no improvement area after those it gives one), those the roll records as land only last, then in URN order. Each result carries what tells parcels at one address apart: the district's account or lot number, property category, use code, improvement area, land_only (true when the roll records an improvement area of 0, false when it records an improvement, null when it records neither), and the unit its label names; never an owner. When the query names a city or ZIP code, a result whose own label does not name it and whose county is outside every county that place lies in, in the result's state (from the US Census Bureau's city and ZIP code tables and the registry's own labels; a place the tables do not know there is not judged), carries place_differs: true, and when every result does, note says the matches are outside the counties the place lies in and place_counties lists them. No match returns coverage: what this registry holds (in the named state when there is one), and in reason and message why (a city or ZIP code that lies wholly in counties the registry does not hold is said first, with those counties and the ones held in that state; a city or ZIP code never filters, so that search still covered every county held): the state or county is not loaded, the street is not held, the house number is held but not with the query's other words, or the street is held but not that house number (with the nearest numbers held on it). Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"query":{"description":"Street address ('1200 Main St, Houston, TX 77002'), or a house number and street words, or a street name with its type; the city, state and ZIP code after the first comma narrow and order the matches. Give query or address, not both.","type":"string","minLength":1,"maxLength":500},"address":{"description":"The same as query (give one of the two).","type":"string","minLength":1,"maxLength":500},"state":{"description":"State, two letters or full name ('TX', 'Texas'): keeps the answer to that state, as a state after the city in the query does; it replaces one named there.","type":"string","minLength":2,"maxLength":40},"city":{"description":"City ('Houston'): matches in it come first; it never filters. Replaces a city named in the query.","type":"string","minLength":1,"maxLength":100},"postal_code":{"description":"5-digit ZIP code (or ZIP+4): matches with it come first; it never filters, since some rolls write ZIP codes wrongly. Replaces one named in the query.","type":"string","minLength":5,"maxLength":10},"county_fips":{"description":"County FIPS code, 5 digits ('48201') or 3 with state ('201'): keeps the answer to that county, read from each parcel's URN.","type":"string","minLength":3,"maxLength":5},"limit":{"default":20,"description":"Maximum results (1–100).","type":"integer","minimum":1,"maximum":100}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_search_entities","title":"Search legal entities by name","description":"Find registered business entities (LLCs, LPs, corporations) by name. Natural persons are not searchable. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Entity name or part of one."},"limit":{"default":20,"description":"Maximum results (1–100).","type":"integer","minimum":1,"maximum":100}},"required":["query"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_tx_equity_candidates","title":"Texas unequal-appraisal candidates","description":"Candidate comparable parcels for a Texas unequal-appraisal comparison (Tax Code §41.43(b)(3)), from one tax year of the subject's appraisal district roll (the newest year whose roll gives the subject a value, or tax_year), with every field of the subject and the candidates read from that year's roll only: same county and tax year, the same state property category code, improvement area within area_band of the subject's, year built within year_band years when both are known; parcels sharing the subject's neighborhood code first (when the roll gives one), then its ZIP code, then the rest of the county if fewer than min_matches. Optional narrowing, off by default: same_building_class, same_local_use_code, local_use_codes. Each candidate and the subject carry their roll fields: id, apn (the district's account number), value and value_basis, value_per_sf (that value divided by the improvement area, to the cent: the roll's figures and one division, not an opinion of value), market and appraised value, improvement and land area, year built, state property category, local use code, neighborhood code, building class, situs address, tax year, and the citation of the value fact; the subject adds its value history by tax year. Separate land and improvement values are not returned. calc_args gives the same subject and candidates with exactly calc_tx_unequal_appraisal's input fields (tax_year, subject, comparables; id = the FactLot URN, label = the situs address, nulls left out, no adjustments): the candidate list under the default rule, not a selection by FactLot, for the caller to review and edit (remove, add or adjust comparables, each adjustment with a reason) before passing it to calc_tx_unequal_appraisal. Order of operations: registry_tx_equity_candidates, then the person's review, then calc_tx_unequal_appraisal with the reviewed calc_args, then report_create. selection echoes the rule, the effective parameters, the tax year and roll sources used, the files the compared values come from (compared_files: as-of date, and whether the file is dated before July 25 of the tax year, the certification date in Tax Code §26.01(a)), the subject's category, class, use code and area (subject_summary), each narrowing parameter and whether it was applied, how many parcels each step of the rule left (steps), the candidates counted by building class and by local use code with the subject's own beside them (class_counts, use_code_counts), and which tier each candidate came from; selection_rule restates the parameters used (tax year, category, area band and year band with their bounds, the subject summary, the narrowing applied, the step counts, counts per tier) with a notice that the list is the default rule's output (the default rule with the narrowing listed, when a narrowing was applied). Each candidate's citation.document_id names its entry in sources, which gives that snapshot's license, attribution, ai_use and redistribution, which apply to that candidate. Candidates under FactLot's default rule, a design choice, not a legal standard; a person decides which, if any, to use. For evidence calculations only: FactLot does not represent property owners, file protests, or advise whether to protest. Not an appraisal or an opinion of value (Tex. Occ. Code §1103.003(1)); not legal or tax advice and not a substitute for the advice of an attorney. Never returns owner names, mailing addresses, or ownership facts: ownership is outside this comparison and is not needed for it. Texas parcels only. Tarrant County is not served by the hosted registry while the publisher's terms for AI use are unclear. On the hosted API, a call without a Pro or Team key gets the current roll year only in the subject's value_history (the answer says so); the candidates are unchanged. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"urn":{"description":"FactLot parcel URN of the subject, e.g. fl:parcel:us-48201:0011440000001. Give this, or county_fips and apn.","type":"string","maxLength":500},"state_fips":{"description":"With county_fips and apn: \"48\" (Texas), the only state served.","type":"string","maxLength":16},"county_fips":{"description":"3-digit Texas county FIPS, e.g. \"201\" for Harris County.","type":"string","maxLength":16},"apn":{"description":"Appraisal district account number as the district prints it.","type":"string","maxLength":200},"area_band":{"default":0.35,"description":"Improvement area band as a share of the subject's (0.35: within ±35%). Must be greater than 0.","type":"number","maximum":1,"minimum":0},"year_band":{"default":15,"description":"Year-built band in years, applied when both the subject's and the candidate's are known.","type":"integer","minimum":0,"maximum":100},"min_matches":{"default":10,"description":"Widen from the neighborhood and ZIP code tiers to the whole county when they hold fewer than this.","type":"integer","minimum":1,"maximum":200},"limit":{"default":50,"description":"Maximum candidates returned (1–200; a larger value is refused). Fewer are returned when fewer meet the rule, or when the neighborhood and ZIP code tiers hold at least min_matches, because the rest of the county is then not included; a warning gives the counts.","type":"integer","minimum":1,"maximum":200},"tax_year":{"description":"Roll year to compare in: the subject and every candidate are read from that year's roll files only (building class also from that year's buildings file, named in selection.building_class_sources); selection.compared_files lists the files the compared values are cited from. Default: the newest tax year whose roll gives the subject a positive value. A year whose files hold values but no category code or improvement area gives no candidates, with a warning naming the missing facts. On the hosted API, tax_year needs a Pro or Team key.","type":"integer","minimum":1900,"maximum":2100},"same_building_class":{"default":false,"description":"Only parcels whose building class (from the compared roll year) is exactly the subject's. Not applied, with a warning, when the subject has none. Default false: building class is not compared.","type":"boolean"},"same_local_use_code":{"default":false,"description":"Only parcels whose local use code (the district's own use or class code) is exactly the subject's. Not applied, with a warning, when the subject has none or local_use_codes is given. Default false.","type":"boolean"},"local_use_codes":{"description":"Only parcels whose local use code is one of these, compared exactly as the roll prints them (1–50 codes). Default: no use-code test.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"registry_tx_equity_candidates_batch","title":"Texas unequal-appraisal candidates (batch)","description":"registry_tx_equity_candidates for many subjects in one call (1–50, e.g. a consultant's client parcels): each subject's id (your label, echoed back) and its urn, or county_fips and apn, plus the rule parameters once for every subject (area_band, year_band, min_matches, limit, tax_year, same_building_class, same_local_use_code, local_use_codes). Each entry of results is that subject's answer from registry_tx_equity_candidates (subject, candidates, calc_args, selection, selection_rule, sources, warnings) or that subject's error (error, message, issues, and coverage on a miss), so one subject outside Texas, in Tarrant County, or not in the registry does not fail the others; the Texas-only and Tarrant checks apply to each subject. The selection rule and the notice appear once at the top (rule, notice) instead of in every answer; summary counts subjects, answered and errors. Candidates per subject only: this tool never runs calc_tx_unequal_appraisal and never picks comparables; a person decides, for each subject, which candidates (if any) to use, and only those go to calc_tx_unequal_appraisal (each subject's calc_args is its candidate list in that tool's input shape, for review and editing first). Each candidate's source rights are in that subject's sources. For evidence calculations only: FactLot does not represent property owners, file protests, or advise whether to protest. Not an appraisal or an opinion of value (Tex. Occ. Code §1103.003(1)); not legal or tax advice and not a substitute for the advice of an attorney. Never returns owner names, mailing addresses, or ownership facts: ownership is outside this comparison. On the hosted API each answered subject counts as one registry lookup, and subjects with an error are given back (a subject not in the registry inside loaded coverage as an answer that finds nothing, not counted up to an hourly limit and counted past it); this batch tool needs a Pro or Team key; registry_tx_equity_candidates, one subject per call, stays within the free daily lookups. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"subjects":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"description":"Your label for this subject (a client or account), echoed back with its answer. Unique within the batch."},"urn":{"description":"FactLot parcel URN of the subject, e.g. fl:parcel:us-48201:0011440000001. Give this, or county_fips and apn.","type":"string","maxLength":500},"state_fips":{"description":"With county_fips and apn: \"48\" (Texas), the only state served.","type":"string","maxLength":16},"county_fips":{"description":"3-digit Texas county FIPS, e.g. \"201\" for Harris County.","type":"string","maxLength":16},"apn":{"description":"Appraisal district account number as the district prints it.","type":"string","maxLength":200}},"required":["id"]},"description":"The subject parcels (1–50): each one's id and its urn, or county_fips and apn (with state_fips 48, or none)."},"area_band":{"default":0.35,"description":"Improvement area band as a share of the subject's (0.35: within ±35%). Must be greater than 0.","type":"number","maximum":1,"minimum":0},"year_band":{"default":15,"description":"Year-built band in years, applied when both the subject's and the candidate's are known.","type":"integer","minimum":0,"maximum":100},"min_matches":{"default":10,"description":"Widen from the neighborhood and ZIP code tiers to the whole county when they hold fewer than this.","type":"integer","minimum":1,"maximum":200},"limit":{"default":50,"description":"Maximum candidates returned (1–200; a larger value is refused). Fewer are returned when fewer meet the rule, or when the neighborhood and ZIP code tiers hold at least min_matches, because the rest of the county is then not included; a warning gives the counts.","type":"integer","minimum":1,"maximum":200},"tax_year":{"description":"Roll year to compare in: the subject and every candidate are read from that year's roll files only (building class also from that year's buildings file, named in selection.building_class_sources); selection.compared_files lists the files the compared values are cited from. Default: the newest tax year whose roll gives the subject a positive value. A year whose files hold values but no category code or improvement area gives no candidates, with a warning naming the missing facts. On the hosted API, tax_year needs a Pro or Team key.","type":"integer","minimum":1900,"maximum":2100},"same_building_class":{"default":false,"description":"Only parcels whose building class (from the compared roll year) is exactly the subject's. Not applied, with a warning, when the subject has none. Default false: building class is not compared.","type":"boolean"},"same_local_use_code":{"default":false,"description":"Only parcels whose local use code (the district's own use or class code) is exactly the subject's. Not applied, with a warning, when the subject has none or local_use_codes is given. Default false.","type":"boolean"},"local_use_codes":{"description":"Only parcels whose local use code is one of these, compared exactly as the roll prints them (1–50 codes). Default: no use-code test.","minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["subjects"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"rent_roll_certify","title":"Certify a rent roll against the leases, line by line","description":"Certify a commercial rent roll for a lender or buyer: check each line of the roll, given as verified facts (each value with its verbatim quote and page from the rent roll document), against the leases' verified facts (and, where there is one, the answers of a confirmed estoppel), and grade it. Compares per line the tenant name, suite, rentable area, lease start and expiration, current base rent (per year, per month and per SF, the lease's worked from its rent schedule and area), next rent step, security deposit, free rent outstanding, renewal options and recoveries structure, wherever both the roll and a lease fact state it. Each line is graded: matches lease; matches lease and confirmed by tenant (the tenant agreed the premises, expiration and base rent statements of an estoppel); differs (both figures, the dollar difference and the quotes); no lease supplied; or not checkable, with the reason. A field no lease fact covers is not checked, never assumed. Totals: occupied and vacant area, occupancy, annual base rent as stated against as the leases yield and the difference, WALT (calc_walt, by area and by rent), rollover by year and top-tenant concentration. Flags: leases expiring within 12 months, tenants on the roll with no lease, leases with no roll line, rent on the roll above the lease, the roll's own arithmetic. Returns package_items and package_calculation for fact_package_send kind rent_roll. Deterministic, no model, no clock (as_of is an input). Facts and arithmetic, not legal, appraisal or lending advice: the certifying party's certification, not FactLot, is what the lender or buyer relies on, and FactLot checked the roll against the documents supplied only. On the hosted API the whole answer also carries attestation, the service's signature over the items, grades and figures that fact_package_send carries, so the FactLot record can show them as computed by FactLot and unchanged since; a service without a signing key returns none and says so. On the hosted API, callers without a Pro or Team key get the summary only (totals, key figures, grade counts, flags) and the answer says what is withheld. Each free, email-verified account (an fl_free_ key) gets one whole document in total across audit_expense_statement, estoppel_prepare and rent_roll_certify: that answer says so, and the report built from the same arguments is included for 24 hours; Pro and Team include every document with the monthly allowance.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"property":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":240,"description":"The property in words: name and address."}},"required":["label"]},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The date of the rent roll, YYYY-MM-DD. The tool reads no clock: the current rent step, the leases expiring within 12 months and WALT are all measured from this date."},"parties":{"type":"object","properties":{"certifier":{"type":"object","properties":{"organisation":{"type":"string","minLength":1,"maxLength":120,"description":"The organisation's name as the documents use it."},"role":{"type":"string","enum":["borrower","seller","broker"],"description":"Who certifies the roll: the borrower or seller (or the broker acting for one). The certifier asserts the roll; the lender or buyer relies on the certifier's certification."}},"required":["organisation","role"],"description":"The party that certifies the rent roll."},"relying_party":{"description":"The lender or buyer the certification is for, if known.","type":"object","properties":{"organisation":{"type":"string","minLength":1,"maxLength":120,"description":"The organisation's name as the documents use it."},"role":{"type":"string","enum":["lender","buyer","other"]}},"required":["organisation","role"]}},"required":["certifier"],"description":"The parties."},"roll_document":{"description":"Optional: the rent roll document.","type":"object","properties":{"title":{"description":"The rent roll's title as printed, for the report.","type":"string","minLength":1,"maxLength":160}}},"building_area_sf":{"description":"Optional: the building's total rentable area. Vacant area is then the building area less the occupied area (stated as derived); with vacant lines on the roll as well, the two are compared and a difference is flagged. Must be greater than 0.","type":"number","minimum":0},"roll_lines":{"minItems":1,"maxItems":60,"type":"array","items":{"type":"object","properties":{"line_id":{"type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$","description":"Your stable id for the line (for example L1 or the suite); unique in the roll."},"occupancy":{"description":"occupied (default) or vacant. A vacant line needs only its suite and area facts and is not graded.","type":"string","enum":["occupied","vacant"]},"facts":{"minItems":1,"maxItems":40,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":"The line's verified facts from the rent roll document, each with its verbatim quote and page and passing fact_validate, one fact per predicate: rent_roll.tenant_name (text), rent_roll.suite (text), rent_roll.rentable_area_sf (SF), rent_roll.lease_start_date, rent_roll.lease_expiration_date, rent_roll.base_rent_monthly (USD per month), rent_roll.base_rent_annual (USD per year), rent_roll.base_rent_psf (USD per SF per year), rent_roll.next_rent_step {date, annual_rent_psf?, annual_rent?, monthly_rent?}, rent_roll.security_deposit (USD), rent_roll.free_rent_outstanding {months?, amount?}, rent_roll.renewal_option {count?, term_months?}, rent_roll.recoveries {structure: nnn|modified_gross|gross|base_year|other, base_year?}. A field the roll does not state is simply left out."}},"required":["line_id","facts"]},"description":"The rent roll's lines."},"leases":{"description":"The leases, one entry per tenant with the facts of the lease and its amendments.","maxItems":60,"type":"array","items":{"type":"object","properties":{"line_id":{"description":"The roll line this lease is for. Without it the lease is matched to the one occupied line whose tenant name is the same (ignoring case and punctuation); an unmatched lease is flagged, never guessed.","type":"string","pattern":"^[A-Za-z0-9_.-]{1,40}$"},"label":{"description":"A label for the lease, for the flags.","type":"string","minLength":1,"maxLength":160},"facts":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":"The lease's verified facts, with every amendment's (doc_abstract_lease, or doc_verify_facts), each with quote and page. Read by predicate: lease.tenant, lease.suite (text), lease.rentable_area_sf, lease.commencement_date, lease.expiration_date, lease.rent_commencement_date, lease.base_rent_schedule (steps {from, to, annual_rent_psf}), lease.security_deposit, lease.free_rent {months}, lease.renewal_option {count, term_months}, lease.recovery_structure {structure}, lease.operating_expense_base_year. A fact another fact supersedes is history; a fact with valid_from after as_of is pending and not used. A field no fact covers is not checked, never assumed."},"estoppel":{"description":"Optional: the tenant's answers to a confirmed estoppel for this lease (join estoppel_prepare's statement keys and codes with fact_package_status' answers). A line whose tenant, area, expiration and rent all match the lease is then graded confirmed by tenant only if the tenant agreed the premises, expiration and base rent statements and the estoppel speaks to the same rent step as the roll. A statement the tenant disputed makes the line differ. fact_package_send checks the estoppel with the FactLot record when the roll is sent.","type":"object","properties":{"package_id":{"type":"string","minLength":1,"maxLength":60,"description":"The estoppel package's id from fact_package_send (kind estoppel)."},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The date the estoppel statements are as of."},"statements":{"minItems":1,"maxItems":60,"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":60,"description":"The statement's key from estoppel_prepare (S01 ...)."},"code":{"type":"string","enum":["COMMENCEMENT","EXPIRATION","PREMISES","BASE_RENT","NEXT_RENT_STEP","SECURITY_DEPOSIT","FREE_RENT","OPTION_RENEWAL"],"description":"The statement's code from estoppel_prepare: COMMENCEMENT, EXPIRATION, PREMISES, BASE_RENT, NEXT_RENT_STEP, SECURITY_DEPOSIT, FREE_RENT or OPTION_RENEWAL."},"decision":{"type":"string","enum":["agreed","disputed"],"description":"The tenant's answer, as fact_package_status gives it."},"tenants_own_version":{"type":"string","maxLength":400}},"required":["key","code","decision"]}}},"required":["package_id","as_of","statements"]}},"required":["facts"]}},"tolerance":{"type":"object","properties":{"annual_usd":{"description":"A difference of annual base rent up to this many dollars is a match within rounding (monthly rent: one twelfth of it). Default 1.","type":"number","minimum":0,"maximum":100},"psf":{"description":"A difference of rent per SF up to this many dollars is a match within rounding. Default 0.01.","type":"number","minimum":0,"maximum":5}}}},"required":["property","as_of","parties","roll_lines"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"report_create","title":"Create a client-ready report (XLSX, PDF, ICS)","description":"Hosted FactLot tool (api.factlot.com only). Builds a client-ready document by code, with no model: tx_unequal_appraisal (calc_tx_unequal_appraisal: evidence packet PDF or adjustment-grid workbook with live formulas; send registry_tx_equity_candidates' sources as context.sources to print each cited source's as-of date, URL and rights, the rows of its subject and of the candidates used as comparables as context.candidates (value and improvement area must match the calculation) to print each property's account number, codes, land area and year built as sent, with value per SF computed by FactLot, and its selection_rule as context.selection_rule to print the candidate rule as applied), lease_abstract (doc_abstract_lease), cam_reconciliation (calc_cam_reconciliation or _batch), debt_sizing (calc_debt_sizing), asc842_schedule (calc_lease_remeasurement_asc842), compare_proposals (calc_compare_proposals), dcf_summary (calc_dcf_pro_forma), critical_dates (calc_critical_dates; also ics: a calendar with each notice window and deadline dated on its contractual day and a reminder 30 days before; dates before today are left out unless include_past is true), tx_protest_deadline (rules_tx_property_tax_protest_deadline on tax_year, notice_delivered_date?, as_of?, or the _batch rule when arguments has items: ics, one calendar with each notice's statutory filing deadline and conservative file-by date as all-day events, reminders 30 and 7 days before the file-by date, the rule's basis, status, warnings and notes in each description, and the rule's next_season dates when the requested year has passed; or pdf, a deadline sheet), expense_audit (audit_expense_statement: a PDF of a tenant's audit of a landlord's expense statement, each finding with its lease quote, page and calculation, the audit deadline and the checks that could not run; part of the paid plans, Pro and Team, when gating is on; a free, email-verified account's one free full document covers its report for 24 hours), expense_audit_portfolio (audit_expense_portfolio: a PDF or XLSX of a tenant's audit of up to 50 landlord expense statements at once: key figures, totals by landlord, the locations ranked by dollars at stake, dispute deadlines in date order, repeated issues and one short section per location; the XLSX has one row per location and one row per finding; part of the paid plans, Pro and Team, when gating is on, and the free account's one free full document does not cover it; it counts one report for each location audited in full, locations with invalid input are not counted and the answer's reports shows the month's use), estoppel_certificate (estoppel_prepare: a PDF tenant estoppel certificate, numbered statements each with its lease quote and page, the tenant's answer beside each when you send them as context.estoppel_answers and who has recorded reliance as context.estoppel_reliers, a signature block that says the tenant's signature, not FactLot, makes it an estoppel, and the document fingerprints; part of the paid plans, Pro and Team, when gating is on; a free, email-verified account's one free full document covers its report for 24 hours), rent_roll_certificate (rent_roll_certify: a PDF or XLSX rent roll certificate, each line with its grade, the roll and lease figures, quotes and pages, a differences section, the rollover schedule, WALT and the document fingerprints; send who has recorded reliance as context.rent_roll_reliers; the certifying party's certification, not FactLot, is what a lender or buyer relies on; part of the paid plans, Pro and Team, when gating is on; a free, email-verified account's one free full document covers its report for 24 hours), property_sheet (pdf or xlsx: one page for one parcel, arguments { urn } only, the parcel's FactLot ID from registry_search_address: FactLot runs registry_get on it as your own call, so it costs one lookup and is gated like any registry_get of yours (free: the current roll year only, with a line naming the earlier years a","inputSchema":{"type":"object","properties":{"kind":{"type":"string","enum":["tx_unequal_appraisal","lease_abstract","cam_reconciliation","debt_sizing","asc842_schedule","compare_proposals","dcf_summary","critical_dates","tx_protest_deadline","property_sheet","expense_audit","expense_audit_portfolio","estoppel_certificate","rent_roll_certificate"],"description":"Which report."},"format":{"type":"string","enum":["xlsx","pdf","ics"],"description":"xlsx, pdf, or ics (critical_dates and tx_protest_deadline). tx_protest_deadline comes as ics or pdf; property_sheet as pdf or xlsx."},"input":{"description":"lease_abstract only: the doc_abstract_lease result, used when arguments are not sent (each page then says the values are the caller's). For other kinds a result sent here is not used; the answer says whether it matches FactLot's run (result_mismatch).","type":"object"},"arguments":{"description":"The tool's arguments. Required for every kind but lease_abstract: FactLot runs the tool on them and builds the document from that run only. tx_protest_deadline: rules_tx_property_tax_protest_deadline's (tax_year, notice_delivered_date?, as_of?), or with items the _batch rule's (items: [{id, tax_year, notice_delivered_date?}], as_of?). property_sheet: { urn } only, a parcel's FactLot ID; FactLot runs registry_get on it for the caller (gated and counted as the caller's lookup).","type":"object"},"context":{"description":"Optional title, prepared-for line, and citations (text only).","type":"object","properties":{"title":{"description":"Report title shown on the cover, e.g. the property or lease name. Defaults to one from the result.","type":"string","minLength":1,"maxLength":120},"prepared_for":{"description":"Who the report is prepared for, printed under the title.","type":"string","minLength":1,"maxLength":120},"subject_citation":{"description":"tx_unequal_appraisal: where the subject's value comes from (document_id, locator, as_of, fact_id).","type":"object","properties":{"fact_id":{"type":"string","minLength":1,"maxLength":200},"document_id":{"type":"string","minLength":1,"maxLength":200},"locator":{"type":"string","minLength":1,"maxLength":200},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false},"comparable_citations":{"description":"tx_unequal_appraisal: citations by comparable id (or #1, #2 … for comparables without an id), for comparables whose result carries none. A citation in the result is kept; one here for the same comparable is listed beside it.","type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":200},"additionalProperties":{"type":"object","properties":{"fact_id":{"type":"string","minLength":1,"maxLength":200},"document_id":{"type":"string","minLength":1,"maxLength":200},"locator":{"type":"string","minLength":1,"maxLength":200},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false}},"sources":{"description":"tx_unequal_appraisal: the `sources` of registry_tx_equity_candidates (or registry_get) as returned: each cited document_id with its title, uri, as_of and rights (ai_use, redistribution, license, attribution). The packet's Sources and rights block prints each cited source with its as-of date, URL and rights; a source sent without rights, or a right of \"unknown\", is printed as not stated by the publisher.","maxItems":200,"type":"array","items":{"type":"object","properties":{"document_id":{"type":"string","minLength":1,"maxLength":200},"source_id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]},"uri":{"anyOf":[{"type":"string","maxLength":500,"pattern":"^https?:\\/\\/\\S+$"},{"type":"null"}]},"retrieved_at":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}]},"as_of":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"rights":{"anyOf":[{"type":"object","properties":{"ai_use":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"redistribution":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"license":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]},"attribution":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]}},"required":["document_id"],"additionalProperties":{}}},"candidates":{"description":"tx_unequal_appraisal: the rows of registry_tx_equity_candidates' `subject` and `candidates` for this calculation's subject and comparables only, as returned, matched by id. Each row's value and improvement_area_sf must equal that subject's or comparable's in the calculation, and every id must be one of them (InputError otherwise). The packet and workbook print the account number (apn), state property category, building class, local use code, land area and year built as sent, and value per SF computed from the calculation's value and area.","maxItems":201,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"apn":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9 ._\\-/#(),+=&]{1,64}$"},{"type":"null"}]},"state_property_category":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9 ._\\-/#(),+=&]{1,64}$"},{"type":"null"}]},"building_class":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9 ._\\-/#(),+=&]{1,64}$"},{"type":"null"}]},"local_use_code":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9 ._\\-/#(),+=&]{1,64}$"},{"type":"null"}]},"neighborhood_code":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9 ._\\-/#(),+=&]{1,64}$"},{"type":"null"}]},"improvement_area_sf":{"anyOf":[{"type":"number","minimum":0,"maximum":1000000000000},{"type":"null"}]},"land_area_sf":{"anyOf":[{"type":"number","minimum":0,"maximum":1000000000000},{"type":"null"}]},"year_built":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]},"value":{"anyOf":[{"type":"number","minimum":0,"maximum":1000000000000},{"type":"null"}]},"value_basis":{"anyOf":[{"type":"string","enum":["appraised","market"]},{"type":"null"}]},"tax_year":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]}},"required":["id"],"additionalProperties":{}}},"estoppel_answers":{"description":"estoppel_certificate: the tenant's answers as fact_package_status returns them (items[].answer with the item's key). The certificate prints each beside its statement as recorded, attributed to the tenant; FactLot did not re-read them.","maxItems":100,"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":60,"description":"The statement's key (S01, S02 ...) from estoppel_prepare."},"decision":{"type":"string","enum":["agreed","disputed"],"description":"The tenant's answer, as fact_package_status gives it."},"note":{"anyOf":[{"type":"string","maxLength":600},{"type":"null"}]},"tenants_own_version":{"anyOf":[{"type":"string","maxLength":400},{"type":"null"}]},"by":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"at":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}]}},"required":["key","decision"],"additionalProperties":false}},"estoppel_reliers":{"description":"estoppel_certificate: who has recorded reliance (fact_package_status reliers: who, role, statements, statements_disputed, at). Printed as a table in the back matter; a relying party that acknowledged disputed statements is shown with them.","maxItems":20,"type":"array","items":{"type":"object","properties":{"who":{"type":"string","minLength":1,"maxLength":260},"role":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}]},"statements":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":60}},"statements_disputed":{"anyOf":[{"maxItems":100,"type":"array","items":{"type":"string","maxLength":60}},{"type":"null"}]},"at":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}]}},"required":["who"],"additionalProperties":false}},"package_attestation":{"description":"expense_audit, estoppel_certificate and rent_roll_certificate: whether the sent package's figures were computed by FactLot and unchanged since, as fact_package_status returns it (attestation). The back matter then says so ('Computed by FactLot and unchanged since' with the tool, version, key and date, or 'Not verified'). Left out when the status is not known, and then nothing is printed about it.","type":"object","properties":{"status":{"type":"string","enum":["attested","unattested"]},"line":{"type":"string","maxLength":300},"tool":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}]},"tool_version":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}]},"key_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}]},"key_scope":{"anyOf":[{"type":"string","enum":["service","test"]},{"type":"null"}]},"issued_at":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}]},"checked_at":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}]},"items_checked":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"calculation_covered":{"type":"boolean"}},"required":["status"],"additionalProperties":false},"estoppel_signature":{"description":"estoppel_certificate: the tenant's electronic signature as fact_package_status returns it (signature). When signed, the certificate prints 'Signed electronically by name, title, date' in the signature block and, in the back matter, the signer, the time in UTC, the consent wording's version and text and the SHA-256 of the signed statements. The signer's name and title are business-contact data for the parties to the package.","type":"object","properties":{"signed":{"type":"boolean"},"signer_name":{"type":"string","maxLength":120},"signer_title":{"type":"string","maxLength":120},"signer_organisation":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"signed_at":{"type":"string","maxLength":40},"consent_version":{"type":"string","maxLength":80},"consent_text":{"type":"string","maxLength":2000},"content_sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"content_check":{"type":"string","enum":["unchanged","changed"]},"signed_line":{"type":"string","maxLength":400},"answered_without_signature":{"type":"boolean"},"signature_required":{"type":"boolean"}},"required":["signed"],"additionalProperties":false},"rent_roll_reliers":{"description":"rent_roll_certificate: who has recorded reliance (fact_package_status reliers: who, role, statements as lines, at). Printed as a table in the back matter.","maxItems":20,"type":"array","items":{"type":"object","properties":{"who":{"type":"string","minLength":1,"maxLength":260},"role":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}]},"lines":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":60}},"at":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}]}},"required":["who"],"additionalProperties":false}},"selection_rule":{"description":"tx_unequal_appraisal: the `selection_rule` of registry_tx_equity_candidates as returned. The packet and workbook print FactLot's default candidate rule with the parameters, narrowing, step counts and tier counts applied.","type":"object","properties":{"tax_year":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]},"state_property_category":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9 ._\\-/#(),+=&]{1,64}$"},{"type":"null"}]},"area_band":{"anyOf":[{"type":"object","properties":{"share":{"anyOf":[{"type":"number","minimum":0,"maximum":1000000000000},{"type":"null"}]},"min_sf":{"anyOf":[{"type":"number","minimum":0,"maximum":1000000000000},{"type":"null"}]},"max_sf":{"anyOf":[{"type":"number","minimum":0,"maximum":1000000000000},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]},"year_band":{"anyOf":[{"type":"object","properties":{"years":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]},"min":{"anyOf":[{"type":"number","minimum":0,"maximum":1000000000000},{"type":"null"}]},"max":{"anyOf":[{"type":"number","minimum":0,"maximum":1000000000000},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]},"min_matches":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]},"limit":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]},"narrowing":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"parameter":{"type":"string","enum":["same_building_class","same_local_use_code","local_use_codes"]},"applied":{"type":"boolean"},"value":{"anyOf":[{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9 ._\\-/#(),+=&]{1,64}$"},{"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9 ._\\-/#(),+=&]{1,64}$"}}]},{"type":"null"}]}},"required":["parameter","applied"],"additionalProperties":{}}},"steps":{"maxItems":6,"type":"array","items":{"type":"object","properties":{"step":{"type":"string","enum":["on the district's roll for the tax year, with exactly the subject's state property category code, a positive improvement area and an appraised or market value","improvement area within area_band of the subject's","year built within year_band years of the subject's, when both are known","building class exactly the subject's (same_building_class)","local use code exactly the subject's (same_local_use_code)","local use code one of local_use_codes"]},"left":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["step","left"],"additionalProperties":{}}},"tiers":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"tier":{"type":"string","enum":["neighborhood","zip","county"]},"key":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9 ._\\-/#(),+=&]{1,64}$"},{"type":"null"}]},"applied":{"type":"boolean"},"matched":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]},"returned":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]}},"required":["tier"],"additionalProperties":{}}},"widened_to_county":{"type":"boolean"},"matched":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]},"returned":{"anyOf":[{"type":"integer","minimum":0,"maximum":1000000000000},{"type":"null"}]}},"additionalProperties":{}}},"additionalProperties":false},"include_past":{"description":"ics only: also put dates before today in the calendar (critical_dates: today in UTC; tx_protest_deadline: today in US Central time, and the passed tax year's dates beside next season's). By default they are left out.","type":"boolean"},"inline":{"type":"boolean","default":false,"description":"Also return the file as base64 (an embedded resource) when it is under 1 MiB."}},"required":["kind","format"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"rules_tx_property_tax_protest_deadline","title":"Texas property tax protest deadline","description":"Deadline to file a Texas property tax protest with the appraisal review board: the later of May 15 or 30 days after the notice of appraised value was delivered, rolled past weekends and Texas legal holidays, plus a conservative file-by date (the last business day on or before the unadjusted deadline). status says where as_of (default: today in US Central time; echoed in as_of) falls: not_yet_open before January 1 of the tax year, open from then through the deadline, passed after it; days_remaining counts the days to the deadline (null once passed), and once passed next_season gives the same rule for the next tax year (May 15 basis). notes says what the rule does not cover (late protests, other §41.44 deadlines, §25.25 corrections) and which sections to read. Returns the statute citations, the rule's verification status and a disclaimer. Information about a statutory deadline: not legal or tax advice and not a substitute for the advice of an attorney. Verification status: verified. The answer carries rule rules.tx.property_tax_protest_deadline@2 and the statutes it rests on.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"tax_year":{"type":"integer","minimum":2000,"maximum":2100,"description":"Tax year being protested, e.g. 2026."},"notice_delivered_date":{"description":"Date the appraisal district's notice of appraised value was delivered (Tax Code §25.19), YYYY-MM-DD. A mailed notice is presumed delivered on the day it was deposited in the mail (§1.07(c)). Omit if unknown (May 15 is then the only basis).","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"as_of":{"description":"Date the status is measured from, YYYY-MM-DD. Default: the current date in US Central time (America/Chicago), when the call is answered; pass it to fix the date (for a report, or for El Paso and Hudspeth counties, which keep Mountain time).","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"required":["tax_year"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"rules_tx_property_tax_protest_deadline_batch","title":"Texas property tax protest deadlines (batch)","description":"Texas property tax protest deadlines for many notices in one call (1–200 items, e.g. a consultant's client list): each item's id, tax year and, if known, notice delivery date. Each result is exactly what rules_tx_property_tax_protest_deadline returns for that item under rule rules.tx.property_tax_protest_deadline@2 (deadline, unadjusted deadline, governing basis, conservative file-by date, skipped days, status, days_remaining, next_season, the item's warnings), echoed with its id; an item with invalid input carries its error and the others are still answered. One as_of (default: today in US Central time) applies to every item. summary counts the items per deadline, earliest first, with the earliest and latest deadline, and per status (by_status). The as_of used, the notes, the statute citations, the rule's verification status and the disclaimer appear once (value.as_of, value.notes, value.rule, value.disclaimer). A rules tool: never a registry lookup. Information about statutory deadlines: not legal or tax advice and not a substitute for the advice of an attorney; it does not say whether to protest. Verification status: verified. The answer carries rule rules.tx.property_tax_protest_deadline_batch@1 and the statutes it rests on.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"items":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"description":"Your label for this notice (a client, account or parcel number), echoed back with its result. Unique within the batch."},"tax_year":{"type":"integer","minimum":2000,"maximum":2100,"description":"Tax year being protested, e.g. 2026 (2000–2100). An invalid value is an error for this item only."},"notice_delivered_date":{"type":"string","format":"date","description":"Date the appraisal district's notice of appraised value was delivered (Tax Code §25.19), YYYY-MM-DD. A mailed notice is presumed delivered on the day it was deposited in the mail (§1.07(c)). Omit if unknown (May 15 is then the only basis). An invalid date is an error for this item only."}},"required":["id","tax_year"]},"description":"The notices to compute deadlines for (1–200): each one's id, tax year and, if known, notice delivery date. Each result equals rules_tx_property_tax_protest_deadline for that item."},"as_of":{"description":"Date the status is measured from, YYYY-MM-DD. Default: the current date in US Central time (America/Chicago), when the call is answered; pass it to fix the date (for a report, or for El Paso and Hudspeth counties, which keep Mountain time). One date for every item.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"required":["items"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"schema_get","title":"FactLot JSON Schemas","description":"Return the FactLot data model (Fact, Provenance, SourceRef, Rights, Relationship) as JSON Schema.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"search","title":"Search FactLot knowledge","description":"Search FactLot's knowledge base (tools, inputs, CRE predicates, ID and fact specifications). Returns matching document ids, titles, and URLs; call fetch for full text. A query on a subject the knowledge base does not cover returns no results and a note.","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"query":{"type":"string","maxLength":500,"description":"What you are looking for, e.g. 'CAM cap non-cumulative' or 'loan sizing DSCR'."}},"required":["query"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}],"resources":[{"uri":"factlot://coverage","name":"coverage","title":"Hosted registry coverage","description":"What the hosted FactLot registry serves, by place: counties, parcel and building counts, as-of dates, entity registries, what is withheld, and how value history works. No lookup is used.","mimeType":"application/json"},{"uri":"factlot://sources","name":"sources","title":"Source catalog","description":"Every reviewed public-record source: publisher, state, review status and whether the hosted registry serves it. Each source's recorded terms are at factlot://sources/{source_id}.","mimeType":"application/json"},{"uri":"factlot://markets","name":"markets","title":"Worked examples by market","description":"The hosted places with a worked example of the registry calls, the sources' terms and what each place does not hold.","mimeType":"application/json"},{"uri":"factlot://schemas/fact","name":"fact-schema","title":"FactLot fact model (JSON Schema)","description":"Fact, Provenance, SourceRef, Rights and Relationship as JSON Schema, the same as the schema_get tool.","mimeType":"application/json"},{"uri":"factlot://schemas/tools","name":"tool-schemas","title":"Tool list","description":"Every FactLot tool with its REST path and formula; factlot://schemas/tools/{tool} gives its input JSON Schema.","mimeType":"application/json"},{"uri":"factlot://spec/id","name":"id-spec","title":"FactLot ID specification (v0.3)","description":"URN and short-ID forms for parcels, entities, buildings, spaces, documents, leases and loans, and how each natural key is normalised (docs/id-spec.md). The id_* tools compute them.","mimeType":"text/markdown"},{"uri":"factlot://plans","name":"plans","title":"Plans and lookup counting","description":"The hosted plans' allowances and prices, what a Pro or Team key adds when paid gating is on, and how registry lookups are counted.","mimeType":"application/json"},{"title":"Coverage: Maryland","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/md","name":"coverage-md"},{"title":"Coverage: District of Columbia","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/dc","name":"coverage-dc"},{"title":"Coverage: Utah","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/ut","name":"coverage-ut"},{"title":"Coverage: Texas","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/tx","name":"coverage-tx"},{"title":"Coverage: New York City","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/nyc","name":"coverage-nyc"},{"title":"Coverage: Los Angeles County","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/la","name":"coverage-la"},{"title":"Coverage: San Francisco","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/sf","name":"coverage-sf"},{"title":"Coverage: The City of Boston","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/boston","name":"coverage-boston"},{"title":"Coverage: Denver","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/denver","name":"coverage-denver"},{"title":"Coverage: Connecticut","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/ct","name":"coverage-ct"},{"title":"Coverage: Sacramento County, California","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/county-06067","name":"coverage-county-06067"},{"title":"Coverage: DeKalb County, Georgia","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/county-13089","name":"coverage-county-13089"},{"title":"Coverage: Marion County, Indiana","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/county-18097","name":"coverage-county-18097"},{"title":"Coverage: Oakland County, Michigan","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/county-26125","name":"coverage-county-26125"},{"title":"Coverage: Wake County, North Carolina","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/county-37183","name":"coverage-county-37183"},{"title":"Coverage: Allegheny County, Pennsylvania","description":"One hosted place: each county with its parcels, buildings, as-of date, roll years (Texas) and sources.","mimeType":"application/json","uri":"factlot://coverage/county-42003","name":"coverage-county-42003"},{"title":"Worked example: New York City","description":"One hosted place: the example calls and what they returned, the ID system, the sources' recorded terms, limits and notices.","mimeType":"application/json","uri":"factlot://markets/new-york-city","name":"market-new-york-city"},{"title":"Worked example: Los Angeles County","description":"One hosted place: the example calls and what they returned, the ID system, the sources' recorded terms, limits and notices.","mimeType":"application/json","uri":"factlot://markets/los-angeles","name":"market-los-angeles"},{"title":"Worked example: San Francisco","description":"One hosted place: the example calls and what they returned, the ID system, the sources' recorded terms, limits and notices.","mimeType":"application/json","uri":"factlot://markets/san-francisco","name":"market-san-francisco"},{"title":"Worked example: The City of Boston","description":"One hosted place: the example calls and what they returned, the ID system, the sources' recorded terms, limits and notices.","mimeType":"application/json","uri":"factlot://markets/boston","name":"market-boston"},{"title":"Worked example: Denver","description":"One hosted place: the example calls and what they returned, the ID system, the sources' recorded terms, limits and notices.","mimeType":"application/json","uri":"factlot://markets/denver","name":"market-denver"},{"title":"Worked example: Connecticut","description":"One hosted place: the example calls and what they returned, the ID system, the sources' recorded terms, limits and notices.","mimeType":"application/json","uri":"factlot://markets/connecticut","name":"market-connecticut"}],"prompts":[{"name":"property_owner","title":"Who owns this property","description":"The owner of record of a commercial property from public records, cited: coverage check, parcel lookup, owner and entity facts."},{"name":"owner_portfolio","title":"An owner's portfolio","description":"The commercial parcels linked to a registered entity as owner of record, cited, within hosted coverage."},{"name":"parcel_value_history","title":"Value history of a parcel","description":"Market and appraised value by tax year for one parcel, each value cited; optionally as of a date."},{"name":"tx_unequal_appraisal_candidates","title":"Texas unequal-appraisal candidates","description":"Candidate parcels under FactLot's default rule for a Texas subject parcel, for the person to review; then the arithmetic on the reviewed list. Candidates only: not advice and not an appraisal."},{"name":"lease_abstract_check","title":"Lease abstract check","description":"Verify a lease's terms against its pages: extract with quotes, verify with doc_verify_facts or doc_abstract_lease, report what is verified and what needs review."},{"name":"expense_statement_audit","title":"Audit a landlord's expense statement","description":"A tenant's audit of a CAM statement: abstract the lease, verify the statement, run audit_expense_statement, show every finding with its quote and calculation, get the named person's approval, then send the dispute."},{"name":"expense_portfolio_audit","title":"Audit many expense statements at once","description":"A tenant's audit of many landlords' CAM statements: verify each location's lease and statement, run audit_expense_portfolio, show the totals, ranking, deadlines and repeated issues, then each location's findings, the portfolio report, and one dispute package per landlord."},{"name":"estoppel_certificate","title":"Prepare a tenant estoppel certificate","description":"A tenant estoppel from a lease: abstract the lease and amendments, run estoppel_prepare, show every statement with its quote, get the named person's approval, send to the tenant with a link for the lender or buyer, read the answers and reliance, then the certificate."},{"name":"rent_roll_certification","title":"Certify a rent roll against the leases","description":"A commercial rent roll certified for a lender or buyer: verify each roll line and each lease, run rent_roll_certify, show every grade and difference with its quote, get the named person's approval, send to the lender or buyer who records reliance on the lines graded as matching, then the certificate."},{"name":"deal_math","title":"Deal maths with the calculators","description":"Net effective rent, proposal comparison, debt sizing, NPV/IRR, DCF, direct cap, waterfalls and more through the calc_* tools, with formula IDs and warnings."}]}