Repository navigation
Read-only desk tools for agents: queues, counts and review status #2591
Copy link
Copy link
Closed
Labels
area:deskReview desk (DSK)Review desk (DSK)type:featureNew capabilityNew capabilityv2FluentCMS v2 (v2 branch)FluentCMS v2 (v2 branch)
Milestone
Description
Part of #2422 (F-DSK). Sixth slice: the read-only desk tools for agents (MCP-01: "DSK (read-only for review decisions)"), on the tool conventions from #2508. It fills the DSK row of McpCoverageTests.
Scope
- Core (
FluentCMS.Core.Builtin.Tools),DeskTools, anIToolProviderwith three read-only tools:get_desk_counts: how many sets or facts each queue holds, fromIDeskQueues.CountAsync.list_desk_queue: one page of a queue, newest or oldest first as the desk orders it. The queues areawaiting_review,checks_failed,stale_facts,recently_publishedandreverted. Awaiting me is a person's queue and is not offered to agents. Optionalpageandlimit(1 to 200, 50 by default). A set is listed with its id, rationale, initiator, state, item count, the set it reverts and its times. A stale fact is listed aslist_stale_factsshows it. The result says how to read a set further.get_change_set_review: where a set stands in review and who decided what. It gives the state, when the set entered it, the rejection reason, the set it reverts, and each move in order with who made it and when, from the set's audit events.
- Core (
FluentCMS.Core.ChangeSets):ChangeSetMoves.Operations, the audit operations of opening a set and of each move, in one place.ChangeSetListsand the set view use it instead of their own copies. - Arguments are read with
ToolArgumentsReaderbefore any service, and refusals areToolResultfailures with hints, as the other tools do. No tool approves, rejects, publishes or reverts (MCP-06). DeskToolsConformanceTestsand the DSK row ofMcpCoverageTests.
Out of scope
- Writing review decisions: people only (MCP-06).
- Which change sets an agent may read (still open on F-MCP F-MCP: MCP server, agent credentials, scopes and caps #2423). The desk tools read like
get_change_set. - Security events for agents: SEC-08 puts them on the desk for people.
Acceptance
- An agent lists each queue and gets the same sets in the same order as the desk, with paging and the total.
get_desk_countsmatches the desk's counts.get_change_set_reviewon a rejected set gives the reason and the person who rejected it. On an unknown set it fails withchange_set_not_foundand a hint.- A bad queue name, page or limit is refused before any read, and every tool is marked read-only and appends no event.
- Conformance and coverage tests pass, and the tools work over MCP on SQLite and PostgreSQL.
Metadata
Metadata
Assignees
Labels
area:deskReview desk (DSK)Review desk (DSK)type:featureNew capabilityNew capabilityv2FluentCMS v2 (v2 branch)FluentCMS v2 (v2 branch)
Activity