# RemoteHands Worker Gig Agent Guide

This file is for AI assistants helping unauthenticated workers discover public
RemoteHands gigs in Bangkok and submit interest leads. The public worker-gig
contract is no-auth and English-only.

Canonical site:

- Production: https://remotehands.live
- Bangkok public gigs: https://remotehands.live/gigs/bangkok
- Public gig OpenAPI schema: https://remotehands.live/agent-actions/openapi.json
- Manual worker signup: https://remotehands.live/signup?signup_type=worker

## Scope

Assistants may:

- Search venue-published public Bangkok gigs.
- Read one public gig by slug.
- Explain gig options using only public fields.
- Collect a person's name, at least one contact method, optional notes, and
  explicit consent for RemoteHands to contact them.
- Submit an interest lead after explicit confirmation.
- Return the RemoteHands signup URL from the lead receipt.

Assistants must not:

- Create an account.
- Apply to a shift.
- Confirm a booking.
- Claim that a lead guarantees work.
- Contact venues or workers outside RemoteHands.
- Request or expose private venue setup notes, street addresses, lead contact
  data, applicant lists, assignments, identity documents, operational logs, or
  admin state.
- Use MCP, OAuth, worker tokens, venue tokens, cookies, or authenticated
  RemoteHands workflows for this public worker-gig flow.

## English-Only Protocol

The agent-to-RemoteHands protocol is English-only. Human users may speak Thai or
another language with their assistant, but the assistant must translate the
user's intent into the English public API contract before calling RemoteHands.

Keep these fields and values in English:

- API field names.
- Enum values such as `staffing`, `entertainer`, and `pay_at_venue`.
- Contact-consent values.
- OpenAPI descriptions and examples.
- Receipts and error messages returned to the assistant.
- Agent instruction text.

## Public Operations

Use the OpenAPI schema at `/agent-actions/openapi.json`.

`searchPublicGigs`

- Method: `GET /api/public/gigs/`
- No authentication.
- Filters: `city`, `worker_type`, `date_from`, `date_to`, `limit`.
- Default city is Bangkok when no city is provided.
- Results include only public, visible, requestable gigs with remaining spots.

`getPublicGig`

- Method: `GET /api/public/gigs/{slug}/`
- No authentication.
- Reads the sanitized public gig details and lead/signup state.
- Public payloads do not include private worksite street addresses or private
  venue setup notes.

`createPublicGigLead`

- Method: `POST /api/public/gigs/{slug}/leads/`
- No authentication.
- Consequential action. Always ask for explicit confirmation before calling.
- Requires `name`, `consent_to_contact: true`, and at least one of `phone`,
  `line_id`, or `email`.
- Optional fields: `experience_note`, `availability_note`, `source`.
- Creates an interest lead only. It does not create an account, application, or
  confirmed booking.
- Return the `signup_url` from the receipt so the person can finish signup in
  RemoteHands.

## Confirmation Script

Before `createPublicGigLead`, confirm these facts with the user:

- The selected gig title and venue.
- The contact method RemoteHands may use.
- Any optional experience or availability notes to submit.
- That RemoteHands may contact them about this gig.
- That submitting interest is not an application or confirmed booking.

Good confirmation wording:

> I can submit your interest to RemoteHands for this public gig. RemoteHands may
> contact you using the contact details you provided. This creates an interest
> lead only, not an account, application, or confirmed booking. Should I submit
> it now?

## After Submission

After a successful lead receipt:

- Tell the user the lead was submitted to RemoteHands.
- Tell the user it is only an interest lead.
- Provide the `signup_url`.
- Ask the user to complete signup on RemoteHands to continue the worker flow.

If the API returns a closed, full, not found, or validation error:

- Explain the error in plain language.
- Do not retry with invented details.
- Offer to search for other public gigs or direct the user to
  https://remotehands.live/gigs/bangkok.