Feedbacks List

[MODE:OVERSEER] Read-only, idempotent. Tier: brownfield.

Lists feedback records attached to the current Agent (read from FIBE_AGENT_ID env) through GET /api/agents/:agent_id/feedbacks. Filterable by source, playground, and date range.

When to use

• After completing a meaningful task — check whether the Player commented on outputs.
• At least once per response when running as an Agent (per system.md).
• Before deciding whether to retry/rework an Artefact.

Inputs

Field	Type	Notes
query	string	Substring search across comment, selected_text, context
source_type	string	Artefact or AgentMutter
source_id	string	Restrict to one source's feedback (used with source_type)
playground_id_or_name	string	Playground ID or name (resolved to numeric)
created_after / created_before	ISO date	Date range
sort	string	created_at (desc default)
page / per_page	int	Standard pagination

agent_id is NOT an input — it's read from FIBE_AGENT_ID env. Without that env var, the tool errors fast.

Output

Standard paginated envelope:

{
  "data": [
    {
      "id": 1,
      "source_type": "Artefact",
      "source_id": 7,
      "selection_start": 0,
      "selection_end": 120,
      "selected_text": "...",
      "comment": "Player comment...",
      "line_text": "...",
      "context": "...",
      "playground_id_or_name": 42,
      "player_id": 11,
      "created_at": "...",
      "updated_at": "..."
    }
  ],
  "meta": { "page":1, "per_page":25, "total":<N> }
}

Gotchas

• Requires FIBE_AGENT_ID env to be set (it's set automatically inside Agent containers).
• Cross-Agent search isn't supported here — use fibe_resource_list(resource:"feedback") if/when added in your env.
• A feedback's source_id doesn't auto-link — pair with fibe_resource_get(resource:"artefact", id:<source_id>) to see what the Player commented on.

Related

• fibe_feedbacks_get — full single feedback record.
• fibe_mutters_get — when feedback's source_type:"AgentMutter".
• fibe_resource_get(resource:"artefact") — when source_type:"Artefact".