Worke

Get full details of a single inquiry by ID: text, status and type (with labels), address, the responsible salesperson (owner), the subscribed colleagues, the contract it became, if any, and — when rejected — why, when and by whom.

The inquiry (poptávka) funnel over a period: how many were created in it, how many of those now sit in each status type by their current status (opened, confirmed, in_process, closed, rejected; "other" for a status of no known type), how many became contracts (counted apart from any status), and the same by month — for the whole company or for one salesperson. Answer "how many leads did we get / convert" from this, never by paging list_inquiries.

Get the current attendance status for the logged-in user — which event types are allowed next based on their last event (e.g. if last event was arrival, only break_start or departure are allowed). Always call this BEFORE record_my_attendance to avoid recording an invalid event.

For ONE supplier-document material line, get the pairing engine's scored stock-inbound candidates (best-first). Use as a SECOND OPINION when a line is ambiguous and you want to cross-check your own judgement — not as the decision-maker. Returns candidates[] with stock_item_id, property_name, quantity, purchased_at, score (0..1; name 70% + quantity 30%) and supplier_matches (true when the candidate inbound shares the document's supplier). High score + supplier_matches + matching quantity is a strong signal; trust your reading of names/quantities over the raw score when they disagree.

Get full details of a property including category, unit, available quantity (the company total; with more than one warehouse also by_warehouse and minimums_by_warehouse, and stock is then null), unit price, and type-specific fields (lifetime, insurance, service date, license expiry).

Get details of a single property category by its ID.

Load BOTH sides of the purchase-pairing queue (Párování nákupů) in one call: supplier-document material lines awaiting pairing, and stock-inbound items awaiting a price. Use this FIRST for any pairing request ("spáruj faktury s příjemkami", "co mám nespárováno"). Returns documents[] (each with lines[]: paper_item_id, description, quantity, unit_price, amount) and inbounds[] (each with items[]: stock_item_id, property_name, quantity, note). Both are pre-filtered to the pairing-eligible scope (material / minor equipment, last 180 days, supplier documents already submitted for approval). paper_item_id and stock_item_id are internal handles for pair_purchase_items — NEVER show them to the user; refer to lines by material name, supplier, quantity and date. May return error="permission_denied".

How a salesperson (obchodník) — or, with role="project_manager", a project manager (projektový manažer) — is doing over a period: the contracts they are responsible for (count, by status, agreed price, costs, invoiced, profit, margin, labor hours, the top ten contracts by price), the inquiries a salesperson handled (received, converted, win rate; none for a project manager), and both by month. Pass the person's name as the user said it (first name, surname or both) or their id from list_people. Contracts count into the period by their start (actual, else planned, else creation). Answer "how good / how busy is X" from this, never from a count of list_contracts. Response may include error="permission_denied" — relay it.

List calendar events within a date range. By default shows events from all accessible calendars. An event planned from an inquiry is a CONTACT with a customer: it carries a contact type (call / email / meeting / other), the customer's name and phone, and belongs to the calendar of the user who handled it. Use type "call" for "s kým jsem volal / komu jsem volal / kdo mi volal". First person ("já", "mi", "jsem") = owner "me" — without it a user who sees every calendar gets the whole company's calls. Owner set to a name = that colleague's calendar; only calendars the current user may see are searched, and the result says when no accessible calendar matched. Only contacts PLANNED on an inquiry carry a type — an empty result means no planned call is recorded, never that nobody called.

List all calendars accessible to the current user (own + shared). Returns calendar ID, name, and owner. Use calendar IDs to filter events.

List contacts from the address book. Returns id, full_name, email, tel, company, IC. Optionally filter with search (matches name, company, IČ, email or phone). Returns one page of at most 50, newest first — the response carries has_more, offset and a note with the next offset; when has_more is true, page further by calling list_contacts again with offset increased by 50, and do NOT claim a total.

List contracts (zakázky) with name, customer, status, owner (the salesperson responsible — obchodník), project_manager (the person who runs the job — projektový manažer), work teams, planned dates, and price (price is omitted when the user may not view contract finances). For one job's health, costs or margin call get_contract_overview; for a salesperson's numbers get_salesperson_performance; for a customer's history get_customer_overview. Optionally filter by status and/or search by name. Statuses: "opened" = running, "pending_close" = close requested and being verified, "closed" = finished, "cancelled" = stornovaná. Filter by owner (salesperson) or project_manager to answer questions like "how many open contracts does Jan Novák have" — combine it with status="opened". The response ALWAYS carries total_matching — the exact number of contracts matching the filters, independent of paging. Answer every counting question from total_matching, never by counting the rows in front of you. Returns one page of at most 50 matches, newest first; has_more only means you have not SEEN them all, never that the total is unknown. To read further rows call list_contracts again with offset increased by 50 and the SAME filters. Each result includes contract_url — when citing a contract in your reply, render it as a markdown link like [name](url) so the user can click through. Response may include error="permission_denied" — relay that to the user, do NOT speculate about alternatives.

List inquiries (poptávky) with the responsible salesperson (owner) and the contract each one became, if any. Returns id, name, email, phone, status, type, owner, contract_id/contract_name, creation date and — for rejected ones — rejection_reason (answer "why do we lose inquiries" from it, filtered by status_type "rejected"). Filter by owner to answer "which leads is Karel handling" and combine with created_from/created_to for a period; an inquiry with contract_id set has converted. The response ALWAYS carries total_matching — the exact number of inquiries matching the filters, independent of paging; answer counting questions from it, never by counting rows. One page of at most 50, newest first; page further with offset increased by 50 and the SAME filters.

List available inquiry statuses with their types (opened, confirmed, in_process, closed, rejected).

List available inquiry types (e.g., "Rekonstrukce koupelny", "Montáž klimatizace"). Use these IDs when creating inquiries.

List property and vehicle loans (zápůjčky) — who currently has which tool, machine, material, or vehicle borrowed. Covers both property loans (tools, machinery, materials) and vehicle loans in one call. By default returns only currently active loans (not yet returned). Set include_returned=true to also include past/returned loans (historical view) — only do this when the user explicitly asks about past or historical loans. Optionally filter by user_id to see what a specific person has (or had) borrowed. Each result includes item_url (item detail page) and borrower_url (user detail page) — when citing items or borrowers in your reply, render them as markdown links like [name](url) so the user can click through. Response may include error="permission_denied" if user lacks ACL on loans — relay that to the user, do NOT speculate about alternatives. Response includes accessible_sections (subset of ["property","vehicle"]) — if a section is missing, it was filtered by ACL, not absent; tell the user that part is not visible to them rather than claiming nothing exists.

List contracts the logged-in user is subscribed to or assigned via a work team. Use this to offer a contract picker when the user wants to attribute attendance (especially arrival) to a specific contract.

The company's people: id, full name, position, whether active, whether counted as overhead (office) rather than field, whether they may lead a site. Use it to resolve a name to an id for get_salesperson_performance or list_loans, and to answer "who works here". Complete unless truncated is true (200 at most — narrow with search). No rates, no pay.

List properties (assets, materials, tools, software). Returns name, type, available quantity (the company total; with more than one warehouse also by_warehouse), category. Returns one page of at most 50, newest first — the response carries has_more, offset and a note with the next offset; when has_more is true, page further by calling list_properties again with offset increased by 50 and the same type/search, and do NOT claim a total.

List all property categories. Optional filter by property type. Each category returns: id, name, id_properties_type, default_lifetime_months.

List recently committed invoice↔receipt pairings, newest first — for REVIEW ("zkontroluj párování", "nespároval jsem něco blbě?"). Each entry has the paper line (paper_description, amount, document_supplier_name, document_number) and the paired stock side (property_name, inbound_supplier_name, inbound_purchased_at), plus paper_item_id (internal handle for unpair_purchase_items). Look for anomalies: document supplier ≠ inbound supplier, material name vs line description divergence, implausible amount/quantity. Flag suspicious ones and offer to unpair. Paged, newest first: the response carries has_more, offset and a note with the next offset — to review older pairings, call again with offset increased by the page size (limit).

List available stock/warehouse locations.

List available measurement units for properties. Returns id, name, and decimal precision.