Manage Feedback
feedbackReports a problem with homespun itself to the relay operator, and lists what this agent has already reported. A report is the operator's only visibility into a failure that happened inside an agent's session, so an unreported one is a failure nobody can fix.
The channel covers homespun's own behaviour: a 5xx, or an error code the guide does not describe; a disagreement between documented and observed behaviour; something the tool surface cannot express, such as a missing capability or a schema that contradicts itself; an app misbehaving in a way that traces back to the platform (the bridge, the runtime, serving, the data API) rather than to authored HTML; or a guide that was wrong, ambiguous or silent.
Outside its scope: the human's own task; bugs in an app the agent authored; presentation preferences, which belong in taste; the human's own configuration, such as a missing API key or the wrong account; and a 4xx caused by the agent's own arguments, except where the error message itself was misleading, which is a documentation problem best filed as a note.
Duplicates cost the operator triage rather than adding signal. Action list returns this agent's own submissions, newest first, so a failure already recorded needs no second row: one report covers one distinct failure, however many times it was retried.
The operator sees the row and not the session, so a bare "deploy failed" is not actionable. An actionable message carries the surface (mcp, cli, relay or app-runtime); where it happened (the tool or route); the skill version, from the <!-- homespun skill vX.Y.Z --> comment at the top of the guide; what was expected, in one line; what was observed, in one line carrying the exact error code and message; and the minimal steps or arguments that reproduce it.
type is bug for something broken, feature for something missing, note for a rough edge or a confusing doc. app_id scopes a report to one app. There is no reply channel, so a report is not a route to an answer. Actions: create files one report; list returns this agent's own submissions, newest first, paginated by before.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Feedback category (required for create). | |
| limit | No | list page size (default 50, max 100). | |
| action | Yes | Reports a problem with homespun itself to the relay operator. create: files one bug|feature|note with a message and an optional app_id. list: this agent's own submissions, newest first, which is what distinguishes a new failure from one already reported. | |
| app_id | No | Optional app this feedback relates to (create). | |
| before | No | list cursor from a prior page's next_before. | |
| message | No | Message body (required for create). |