> ## Documentation Index
> Fetch the complete documentation index at: https://botmesh.afaya.com.co/llms.txt
> Use this file to discover all available pages before exploring further.

# HandoffOptions

> Interface exported by @botmesh/core.

Defined in: [gates/handoff.ts:81](https://github.com/andresayac/botmesh/blob/main/packages/core/src/gates/handoff.ts#L81)

Options for `bot.handoff()` / `ctx.handoff()`.

## Properties

### reason?

```ts theme={null}
reason?: string;
```

Defined in: [gates/handoff.ts:83](https://github.com/andresayac/botmesh/blob/main/packages/core/src/gates/handoff.ts#L83)

Free-form reason, forwarded to the `'handoff'` event and persisted.

***

### meta?

```ts theme={null}
meta?: Record<string, unknown>;
```

Defined in: [gates/handoff.ts:85](https://github.com/andresayac/botmesh/blob/main/packages/core/src/gates/handoff.ts#L85)

Host-defined, JSON-serializable metadata (agent id, ticket id, …). Persisted.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.