Skip Turn

const sessionConfig = {
  // rest of config...
  system_tools: [{ name: "skip_turn", enabled: true }],
};

const sessionConfig = {
  // rest of config...
  system_tools: [
    {
      name: "skip_turn",
      description: "<override default description of skip_turn tool>",
      parameter_descriptions: {
        reason: "<override default description of reason parameter of skip_turn tool>",
      },
    },
  ],
};

// User singing
Agent would call: skip_turn({ reason: "singing song" })

// User talking to someone else
Agent would call: skip_turn({ reason: "talking to someone else" })

// Background conversation
Agent would call: skip_turn({ reason: "background conversation" })

// User talking to themselves
Agent would call: skip_turn({ reason: "not addressing bot" })

tool_def = FunctionDefinition(
    name="skip_turn",
    description="Call this when the user is not directly addressing you or when no response is needed. Skip if the user is: singing, talking to someone else, having background conversation, talking to themselves, or saying something unrelated to our conversation. Use conversation context to decide. If genuinely unsure whether they're addressing you, ask for clarification instead of skipping.",
    parameters=FunctionParameters(
        type="object",
        properties={
            "reason": FunctionProperty(
                type="string",
                description="Brief reason for skipping this turn (e.g., 'singing song', 'talking to someone else', 'background conversation', 'not addressing bot')",
            ),
        },
        required=["reason"],
    ),
)