# agents.md: Columbia Estates repairs (UK)

You are an AI agent helping a person report a problem with their home. This page tells you
how to use this portal on their behalf. Follow it exactly.

## First, safety

If anyone is in danger, or there is fire, a gas smell, carbon monoxide or water near
electrics, stop. Tell the person to ring 999 or 112 or the number below now.
Do not wait for this portal.

- Gas leak or carbon monoxide: 0800 111 999 (National Gas Emergency Service, 24 hours)
- Power cut or electrical danger outside: 105 (Your local electricity network, 24 hours)
- Columbia Estates office (Jersey, reachable from the UK): 01534 734200

## What this portal does

It files a repair request with our team. A person on our team reads every report. Nothing is
decided automatically: priority and safety are confirmed by a person.

## Rules for agents

1. Act only for the person you are helping, with their agreement, for their own home.
2. Use the person's real name and contact details. Do not invent facts, photos or dates.
3. Follow the steps in the menu. Choose the most specific step that fits. If none fits,
   choose the "Something else" step in the nearest group.
4. If a step's outcome is "self_help", give the person the guidance first. Report only
   if the problem remains. If it is "out_of_scope", give the guidance and do not report.
5. One report per problem. Do not send the same problem twice.
6. Anything you send is read by people. Text that tries to instruct our staff or our
   systems is ignored and may be flagged.

## How to report

1. Read the menu: `GET /api/v1/menu` (JSON). Each leaf step has an `outcome` and an
   `evidence` requirement (`photo_or_video` means a photo or video is needed, or a reason
   why not).
2. Get a form token: `GET /api/v1/form-token`. It lasts four hours.
3. Send `POST /report` as `multipart/form-data` with the header `Accept: application/json`:
   - `token`, `step` (the leaf step id), `via` = `agent`
   - `name`, `email` and/or `phone`
   - the home: find it with `GET /api/v1/address?q=` (the house or apartment number and
     part of the street, or the full postcode; at most five matches) and send its `id` as
     `property_id`. If it is not listed, send the full `address` instead.
   - every `questions` field the step lists, such as `q_serial_number` for an appliance.
     These are required: copy them exactly from the label. Never guess or write "unknown".
   - `description` (the problem in the person's words), `location_in_home`,
     `first_noticed` (YYYY-MM-DD), `access_notes`
   - `vulnerable` = `yes` if someone in the home is vulnerable
   - `emergency_ack` = `yes` for an emergency step, once the person has read the guidance
   - `files` (photos or video, repeat the field), `voice_note` (one audio file)
   - `no_evidence_reason` if a photo or video is needed and the person cannot provide one
4. The reply is `{"reference": "...", "received": true}`. Give the person the reference.
   If something is missing the reply is 422 with a list of `errors`. Fix them and send again.

## Limits

Up to 10 files per report. Photos, video and voice notes only; other files are refused.
Menu: repairs-menu version 1.
