@thenavidm/slipway 0.1.15 → 0.1.17

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 What changed in Slipway, newest first.
 
+## 0.1.17, 2026-10-05: what Google Photos needed
+
+- **`which` reads an argument by its own words, not through a synonym.** Since 0.1.14 a tool's argument names count toward finding it, and a synonym reached them too. Google Photos says "photos" means media, so `get_media_item`, which takes a `media_item_id`, drew level with the photo picker for "let me choose photos" and was listed first. An argument now counts only for the words it is made of, so the picker is first again. Buffer's "schedule a post to a channel" still reads `channelId` and `schedulingType`, and the first answer to every task measured on the other servers is unchanged.
+
+## 0.1.16, 2026-10-05: what Flodesk needed
+
+- **`which` says a title once.** Each answer line printed a tool's title and then the first sentence of its description, and many descriptions open with the title itself: 24 of Flodesk's 32 tools, 10 of Firefly's 14, and nearly every tool on Beehiiv, Calendly and Circle. Where the sentence opens with the title's words, the line now prints the sentence alone. Flodesk's answer to `which add a subscriber to a segment` goes from 52 tokens to 36 and Firefly's to `which image model 5` from 90 to 77, and an agent carries that answer through each step after it. A description that adds something new still follows its title.
+
 ## 0.1.15, 2026-10-05: what Adobe Firefly needed
 
 - **The general help counts the tuning settings instead of naming them.** An agent reads `--help` first and carries it through every later step, so its length is paid again on each one. Firefly's help named 14 settings on its last line, and with only 14 commands its whole command list was shorter; its Codex CLI task cost 370 more input tokens on Slipway than on its own 2.x CLI. The line now says how many more settings there are and that `agent-context` describes each, the `--http` settings join that count, and the safety switches and the settings an app marks as setup are still named. Every server's help is shorter by the names it had on that line.

package/dist/cli/help.d.ts

@@ -14,5 +14,5 @@ export declare function renderList(app: App, tools: readonly Tool[], bin: string
 export declare function exampleCommand(bin: string, tool: Tool, args: Record<string, unknown>): string;
 export declare function renderToolHelp(tool: Tool, bin: string, aliases?: Readonly<Record<string, string>>): string;
 export declare function renderGeneralHelp(app: App, bin: string): string;
-/** One line per tool, for search results and listings. */
+/** One line per tool, for search results: the title, then what the description adds to it. */
 export declare function toolLine(tool: Tool): string;

package/dist/cli/help.js

@@ -293,7 +293,15 @@ export function renderGeneralHelp(app, bin) {
         lines.push(app.definition.links.repository, ``);
     return lines.join("\n");
 }
-/** One line per tool, for search results and listings. */
+/** One line per tool, for search results: the title, then what the description adds to it. */
 export function toolLine(tool) {
-    return `${riskMark(tool)} ${tool.command}  ${tool.title}: ${firstSentence(tool.description, 80)}`;
+    const sentence = firstSentence(tool.description, 80);
+    // Many descriptions open by saying the title again, which an agent would read twice.
+    const what = !sentence ? tool.title : restates(sentence, tool.title) ? sentence : `${tool.title}: ${sentence}`;
+    return `${riskMark(tool)} ${tool.command}  ${what}`;
+}
+/** Whether a sentence opens with a title's words, whatever the case and punctuation. */
+function restates(sentence, title) {
+    const words = (text) => text.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
+    return words(sentence).startsWith(words(title));
 }

package/dist/search.js

@@ -94,12 +94,14 @@ export function searchTools(tools, query, limit = 10, synonyms = {}) {
         const tags = tool.tags.flatMap(words);
         const description = words(tool.description);
         // What a tool takes says what it is for: `channelId` and `schedulingType` find the post tool for "schedule a post to a channel".
+        // Only the words themselves count there. Through a synonym, Google Photos' "photos" read as `media_item_id`
+        // and put get_media_item level with the picker for "let me choose photos".
         const args = Object.keys(tool.jsonSchema.properties ?? {}).filter((key) => key !== "confirm").flatMap(words);
         let score = 0;
         let matched = 0;
         for (const term of terms) {
             // A term that is the tool's name is not a hint, it is the answer.
-            const got = (named(tool, term) ? 20 : 0) + hits(term, name, extra) * 5 + hits(term, title, extra) * 4 + hits(term, tags, extra) * 3 + hits(term, args, extra) * 2 + hits(term, description, extra);
+            const got = (named(tool, term) ? 20 : 0) + hits(term, name, extra) * 5 + hits(term, title, extra) * 4 + hits(term, tags, extra) * 3 + exact(term, args) * 2 + hits(term, description, extra);
             if (got > 0)
                 matched++;
             score += got;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thenavidm/slipway",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Slipway, the TypeScript framework for MCP servers and agent-native CLIs. One tool definition ships an MCP server and a CLI, with write safety, typed results and release checks built in.",
   "type": "module",
   "license": "Apache-2.0",