add_job_update
ChatGPTSave an ordinary job update with optimistic concurrency. Never sends, orders, or pays.
add_measurement
ChatGPTSave a provisional or confirmed field measurement.
correct_helper_time
ChatGPTCorrect or void one dated shift with a reason and revision. Voiding an accidental duplicate removes it from totals; genuine separate shifts stay separate.
create_job
ChatGPTCreate a job with optional original scope.
create_material_list
ChatGPTSave a concise material list. This never places an order.
draft_invoice
ChatGPTGenerate a private shareable PDF invoice draft. This never sends or marks it paid.
draft_invoice_from_quote
ChatGPTDraft a private invoice PDF using the exact approved quote lines, price, exclusions and deposit/payment terms. No sending or money movement.
find_jobs
ChatGPTFind jobs by customer, title, address, or alias. Automatically use one clear match. If several match, show each title, customer, and address and ask the user to select one before saving. For native ChatGPT attachments, use save_chatgpt_files_to_job with the resolved job ID; do not open a picker.
get_job_status
ChatGPTRetrieve the latest durable job state.
get_material_counter_list
ChatGPTRead a concise supplier-counter list from persisted quantities. Still needed uses max(picked up, delivered), avoiding double-counting the same boards in both stages, and adds recorded returns.
get_my_account
ChatGPTRead your authenticated identity, tenant, and membership role. No identity or tenant arguments are accepted.
get_pilot_daily_report
ChatGPTRead one saved aggregate ContractorOS pilot report through an explicit aggregate-only access grant. This never grants access to the subject tenant's jobs, customers, photos, conversations, Gmail, or calendar.
get_workspace_usage_report
ChatGPTRead current stored totals and observed activity for a specifically authorized pilot workspace. Requires a separate detail grant naming the subject identity; an aggregate report grant is insufficient. Reviewer reads are excluded from subject telemetry.
list_jobs
ChatGPTList up to 100 jobs in your authenticated tenant, with title, customer, and address. Reports truncation; never infer a job outside this list.
prepare_invoice_download
ChatGPTCreate a five-minute download access grant for the exact saved invoice PDF. Does not regenerate, send, charge, or change the invoice.
prepare_job_photo_upload
ChatGPTFallback only: prefer save_chatgpt_files_to_job for native ChatGPT attachments. Use this card when direct attachment transfer is unavailable and the user chooses the fallback, or explicitly asks to select new files in a card. Explain the direct-transfer failure first; never silently request a second selection. After resolving the exact job, prepare a five-minute private upload card for its authenticated job ID. If several jobs matched, require the user's explicit selection first. Set maxFiles to 10 for a photo batch. A new card revokes earlier cards for this member. The card confirms job and customer; it never records expenses or payments.
propose_scope_change
ChatGPTRecord a proposed change without approving it.
record_customer_approval
ChatGPTOnly on explicit instruction, record actual customer approval of a scope or quote with the customer approval reference. A draft is not approval.
record_customer_payment
ChatGPTRecord a customer payment only after explicit authorization. A check photo alone is never payment.
record_helper_time
ChatGPTRecord helper hours and amount owed, separate from customer receivables.
record_material_progress
ChatGPTRecord explicitly reported quantities ordered, picked up, delivered or returned. Link a receipt as evidence; no receipt total is added as a second expense.
resolve_job
ChatGPTFind candidate jobs for a description. If needs_clarification, show every candidate title, customer, and address and ask the user to select one explicitly. Automatically use one matching job, including a unique customer or alias match. For native ChatGPT attachments, use the chosen job ID for save_chatgpt_files_to_job without another picker. Use prepare_job_photo_upload only as an explicitly chosen fallback when direct transfer is unavailable.
revise_material_list
ChatGPTRevise needed quantities or known unit costs in an existing list with revision guard and before/after history. Does not place orders.
save_chatgpt_files_to_job
ChatGPTSave all requested original attachments already supplied in ChatGPT only when its format, connected user, tenant and exact job are enabled. Up to 10 files, maximum 15 MiB combined; return and report a result for every requested file. Originals are not converted. JPEG, static PNG, passive PDF and macro-free DOCX validation is available in this controlled candidate; format approval is required. HEIC is unsupported. Some complex documents and animated PNGs are rejected. Use real authorized file objects, independently verify saved bytes, and report exact failures without substituting browser uploads.
save_quote_version
ChatGPTSave a proposed quote. First version requires every document field. Later versions patch only explicitly changed fields and preserve omitted terms; approval does not carry to revised versions.
test_chatgpt_attachment_access
ChatGPTRun a one-photo diagnostic inside ChatGPT. The widget requests a fresh temporary URL and attempts an in-memory browser read. It does not save, upload to ContractorOS, inspect the photo, create evidence, or retain the file ID or URL. Use only when the user explicitly requests this diagnostic.
verify_job_evidence
ChatGPTIndependently reopen saved evidence bytes for the exact job and verify size and SHA-256. Use after saving or in a fresh conversation to confirm the files remain retrievable. No picker, upload or browser page.