Authenticate against the BOQ backend and store the JWT for this session.

Must be called before any other tool unless BOQ_API_TOKEN was provided.

Return the currently authenticated user's profile.

List all projects visible to the authenticated user.

List chapters of a project.

List sections of a chapter.

List items of a section.

Return the full project hierarchy (chapters -> sections -> items).

Use this before adding data so you don't create duplicate chapters/sections.

Create a new project. Only name is required.

status: draft|active|on_hold|completed|cancelled. currency: ILS|USD|EUR|JOD|SAR.

Update project fields (name, description, status, budget, currency, etc.).

Create a chapter under a project. code is exactly 2 digits (e.g. '03').

Create a section under a chapter. code is exactly 2 digits (e.g. '10').

Create a BOQ item under a section.

code is exactly 2 digits (e.g. '01') — the full path code is composed up the chapter/section/item tree. unit must be one of: m, m2, m3, unit, kg, ton, lm, ls, No., set.

Create many items under one section in a single call.

Each item dict needs: code (2 digits), name, unit (+ optional quantity, unit_price, description, order, notes). section_id is applied to all.

Add a quantity calculation line to an item (count x dim_1 x dim_2 x dim_3 - deduction).

Create a contractor. name_en required. contractor_type: main|sub|supplier|consultant.

Create a contract linking a contractor to a project.

contract_type: lump_sum|unit_price|cost_plus|time_materials.

Create a bill against a contract. bill_type: progress|final|variation|retention_release.

Add a material cost line to an item's price breakdown.

Return the full price breakdown (materials/labor/equipment/subcontracting) for an item.