Skip to content

sessions_start_sign_in

Opens the sign-in sheet. Credentials never pass through the agent.

NavigationSessions pages only

When to use it

  • When any viewer tool reports SIGN_IN_REQUIRED.

  • Before offering to look up someone’s bookings or passes.

Parameters

This tool takes no arguments.

Returns

Every tool returns two things: text for the model to read, and a structuredContent object beside it for code that would rather branch on a field.

Confirmation that the sign-in sheet is open. No password, email or one-time code ever passes through the agent — the person completes sign-in themselves.

Example

Run this from any agent or script executing in the page.

javascript
const tools =
  await document.modelContext.getTools();

const tool = tools.find(
  (t) => t.name === 'sessions_start_sign_in',
);

const result = await document.modelContext
  .executeTool(tool);
content
Opened the sign-in sheet on the page. The person
signs in themselves — no password, email or code
passes through you.
structuredContent
{
  "awaitingUserConfirmation": true
}

What the agent is told

The description the model reads when deciding whether to call this. It is the only thing that decides whether the tool fires at the right moment, so it is worth knowing what it says.

sessions_start_sign_in
Opens the sign-in sheet on the page. The person completes sign-in themselves — you never see or supply a password, an email, or a one-time code. Afterwards the viewer tools work. Call this when a viewer tool reports SIGN_IN_REQUIRED.

See also