title: Group fallback when message tool is unavailable

scenario:
  id: group-message-tool-unavailable-fallback
  surface: channel
  coverage:
    primary:
      - channels.group-visible-replies
    secondary:
      - channels.qa-channel
      - tools.message
  objective: Reproduce the group-visible-reply bug class where message_tool mode selected tool-only delivery even though group tool policy removed the message tool.
  gatewayConfigPatch:
    messages:
      groupChat:
        visibleReplies: message_tool
    channels:
      qa-channel:
        groups:
          qa-fallback-room:
            tools:
              allow:
                - read
  successCriteria:
    - The group policy removes the message tool for this room.
    - The mock provider returns a normal final answer with the marker.
    - OpenClaw falls back to automatic delivery and posts the marker to the same group.
  docsRefs:
    - docs/channels/groups.md
    - docs/channels/qa-channel.md
  codeRefs:
    - src/auto-reply/reply/dispatch-from-config.ts
    - extensions/qa-channel/src/inbound.ts
  execution:
    kind: flow
    summary: Verify message_tool visible replies degrade to automatic delivery when the active group policy removes message.
    config:
      requiredChannelDriver: qa-channel
      conversationId: qa-fallback-room
      promptSnippet: qa group message unavailable fallback check
      prompt: "@openclaw qa group message unavailable fallback check. exact marker: `QA-GROUP-FALLBACK-OK`"
      expectedMarker: QA-GROUP-FALLBACK-OK

flow:
  steps:
    - name: falls back to final-answer delivery when message is not available
      actions:
        - call: waitForGatewayHealthy
          args:
            - ref: env
            - 60000
        - call: waitForQaChannelReady
          args:
            - ref: env
            - 60000
        - call: reset
        - set: requestCountBefore
          value:
            expr: "env.mock ? (await fetchJson(`${env.mock.baseUrl}/debug/requests`)).length : 0"
        - sendInbound:
            conversation:
              id:
                expr: config.conversationId
              kind: group
              title: QA Fallback Room
            senderId: alice
            senderName: Alice
            text:
              expr: config.prompt
        - call: waitForOutboundMessage
          saveAs: outbound
          args:
            - ref: state
            - lambda:
                params: [candidate]
                expr: "candidate.conversation.id === config.conversationId && candidate.conversation.kind === 'group' && !candidate.threadId && candidate.text.includes(config.expectedMarker)"
            - expr: liveTurnTimeoutMs(env, 180000)
        - set: matchingOutbound
          value:
            expr: "state.getSnapshot().messages.filter((message) => message.direction === 'outbound' && message.conversation.id === config.conversationId && message.conversation.kind === 'group' && String(message.text ?? '').includes(config.expectedMarker))"
        - assert:
            expr: matchingOutbound.length === 1
            message:
              expr: "`expected exactly one fallback group reply, saw ${matchingOutbound.length}`"
        - set: scenarioRequests
          value:
            expr: "env.mock ? (await fetchJson(`${env.mock.baseUrl}/debug/requests`)).slice(requestCountBefore).filter((request) => String(request.allInputText ?? '').includes(config.promptSnippet)) : []"
        - assert:
            expr: "!env.mock || scenarioRequests.length > 0"
            message: expected mock request evidence for fallback scenario
        - assert:
            expr: "!env.mock || scenarioRequests.every((request) => request.plannedToolName !== 'message')"
            message:
              expr: "`message tool should not be planned when group policy removes it, saw ${JSON.stringify(scenarioRequests.map((request) => request.plannedToolName ?? null))}`"
      detailsExpr: "`${outbound.conversation.kind}:${outbound.conversation.id}:${outbound.text}`"