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".