@skyelight/mcp 0.7.2 → 0.8.0

package/CHANGELOG.md

@@ -11,6 +11,23 @@ keeps working. A **patch** is a fix or a wording change. A **major** would be
 removing a tool or an argument, or changing what an existing field means, and
 there has not been one.
 
+## 0.8.0 — 2026-10-08
+
+### Added
+
+- **`list_items` filters by hand-off.** A new `task` argument (`investigate`,
+  `plan`, `fix`, or `none`) returns only the items a person handed to an agent
+  with that task in the app, or only those with none. Each row in the list now
+  names its hand-off, so an agent can choose its work without fetching every
+  item.
+
+## 0.7.3 — 2026-10-08
+
+### Changed
+
+- **Docs.** The README opens with a picture of Skyelight. No change to the
+  tools.
+
 ## 0.7.2 — 2026-10-08
 
 ### Changed

package/README.md

@@ -1,5 +1,9 @@
 # @skyelight/mcp
 
+<!-- A full URL, not a relative path, so the npm page shows it too. The
+     image lives in the public repo (assets/), not in the npm package. -->
+![Skyelight: feedback pinned to the element, with the source behind it, for your coding agent](https://raw.githubusercontent.com/plastrlab/skyelight-mcp/main/assets/skyelight.png)
+
 [npm](https://www.npmjs.com/package/@skyelight/mcp) ·
 [source](https://github.com/plastrlab/skyelight-mcp) ·
 [docs](https://skyelight.ai/docs/mcp)
@@ -111,7 +115,7 @@ agent calls `list_projects` first rather than guess.
 | --------------------- | ------------------------------------------------------------------------------------ |
 | `list_workspaces`     | Which workspaces this credential can reach, and who you are.                         |
 | `list_projects`       | The projects inside them, with the ids the other tools take.                         |
-| `list_items`          | What is outstanding. Filter by page, type, status, assignee.                         |
+| `list_items`          | What is outstanding. Filter by page, type, status, assignee, hand-off.               |
 | `search_items`        | Find items whose thread mentions some text, replies included.                        |
 | `get_item`            | Everything needed to work one item: thread, page, anchor, code, images.              |
 | `post_update`         | Report back on the thread the feedback came from.                                    |
@@ -151,6 +155,11 @@ stubs; `get_item` is where the thread and the anchor live.
 `list_items` takes `assignee: "me"`, so the most ordinary question anyone asks
 an agent needs no id looked up by hand.
 
+**"What was I asked to fix."** A person can hand a thread to an agent in the
+app (Hand off: Investigate, Plan or Fix). `list_items` takes `task` with one of
+those, or `"none"`, and each row names its hand-off. With `assignee: "me"` it
+is your own queue of fixes.
+
 **Merged duplicates do not appear twice.** When somebody merges five reports of
 one problem in the web app, the duplicates leave the list and the item they were
 merged into says `5 reports`. A list that shows all five reads as five bugs.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyelight/mcp",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "MCP server for Skyelight — read feedback items from your project as an agent",
   "mcpName": "io.github.plastrlab/skyelight-mcp",
   "type": "module",

package/src/tools.js

@@ -100,6 +100,13 @@ export function toolDefinitions(opts = {}) {
               'A user id, "me" for whoever this connection belongs to, or ' +
               '"none" for unassigned items.',
           },
+          task: {
+            type: "string",
+            enum: ["investigate", "plan", "fix", "none"],
+            description:
+              "Only items a person handed to an agent with this task (Hand off in the app), " +
+              'or "none" for items with no hand-off. Combine with assignee to find your own.',
+          },
           limit: { type: "number", description: "Max items (default 50)." },
         },
       },
@@ -551,6 +558,8 @@ export function renderList(result, { searched } = {}) {
     const bits = [i.type ?? "unsorted", i.status, i.page];
     if (i.assignee) bits.push(`assigned to ${i.assignee}`);
     else bits.push("unassigned");
+    // The standing ask, so an agent can pick its work from the list.
+    if (i.agentTask) bits.push(`hand-off: ${i.agentTask}`);
     if (i.replyCount > 0) bits.push(plural(i.replyCount, "reply", "replies"));
     // How many people hit this, once merging has told us they are the same
     // thing. Silent at 1, which is almost every row — a list where every line
@@ -886,6 +895,7 @@ export async function callTool(name, args, { client, config }) {
       type: args.type,
       status: args.status,
       assignee: args.assignee,
+      task: args.task,
       limit: args.limit,
     });
     return { text: renderList(result), data: result };

package/src/version.js

@@ -12,4 +12,4 @@
  * filesystem there. `test/server.test.js` asserts the two agree, so the pair
  * cannot drift again without a test going red.
  */
-export const VERSION = "0.7.2";
+export const VERSION = "0.8.0";