@thenavidm/slipway 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 What changed in Slipway, newest first.
 
+## 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.
+
+## 0.1.14, 2026-10-05: what Buffer needed
+
+- **`which` and the search surface read what a tool takes.** Argument names count for a little less than the title and more than the description, and camelCase is split, so `channelId` reads as "channel" and `createPost` as "create post". Buffer's "schedule a post to a channel" never listed `create-post`, whose description says neither word but whose `channelId` and `schedulingType` say both; a Codex run that asked `which` then read the whole command list as well.
+
 ## 0.1.13, 2026-10-05: what Beehiiv needed
 
 - **`jsonSchema(schema, { shareRepeats: true })` writes each repeated part of a contract schema once.** A schema generated from an API contract often spells one definition out everywhere it is used. Beehiiv's post body repeats its block styling in each of 33 block types and carries the body twice, as its own fields and as `payload`, so its create-post tool advertised 387 KB. With each repeated part under `$defs` and referred to with `$ref`, it is 40 KB, and Beehiiv's 117 tools together go from 1,684 KB to 308 KB. Nothing is lost: each part reads the same once the references are followed, Claude Code and Codex both read fields that appear only under `$defs`, and validation accepts and refuses the same arguments. Definitions take the name of the property or block type they came from, such as `paragraph` or `visual_settings`, and parts under 200 bytes stay inline. The work is linear in the schema's size and happens when the tool is first listed. `shareRepeats()` is exported for a schema built some other way.

package/README.md

@@ -575,17 +575,24 @@ See [CHANGELOG.md](CHANGELOG.md).
 | Server | Package | Covers |
 | --- | --- | --- |
 | [Apple Podcasts](https://github.com/thenavidm/apple-podcasts-mcp-cli) | [`@thenavidm/apple-podcasts-mcp-cli`](https://www.npmjs.com/package/@thenavidm/apple-podcasts-mcp-cli) 2.0.0 | The catalog, charts per country, reviews and feeds, your library on this Mac with its transcript excerpts, and analytics for a show you own |
+| [Bannerbear](https://github.com/thenavidm/bannerbear-mcp-cli) | [`@thenavidm/bannerbear-mcp-cli`](https://www.npmjs.com/package/@thenavidm/bannerbear-mcp-cli) 3.0.0 | Templates, image and animation renders, media jobs, workflows, assets, webhooks and Instant URLs, across private workspaces |
+| [Beehiiv](https://github.com/thenavidm/beehiiv-mcp-cli) | [`@thenavidm/beehiiv-mcp-cli`](https://www.npmjs.com/package/@thenavidm/beehiiv-mcp-cli) 3.0.0 | Publications, posts and drafts, subscribers, segments, automations, custom fields, tiers, polls, referrals and webhooks |
 | [Bluesky](https://github.com/thenavidm/bluesky-mcp-cli) | [`@thenavidm/bluesky-mcp-cli`](https://www.npmjs.com/package/@thenavidm/bluesky-mcp-cli) 2.0.0 | Posting, threads, replies, the timeline, search, feeds, lists, notifications and the social graph |
-| [Meta Ad Library](https://github.com/thenavidm/facebook-ad-library-mcp-cli) | [`@thenavidm/facebook-ad-library-mcp-cli`](https://www.npmjs.com/package/@thenavidm/facebook-ad-library-mcp-cli) 0.6.0 | Every ad running on Facebook, Instagram and Threads for any advertiser: copy, creatives, how long each has run, what changed, and EU spend and reach |
+| [Brandfetch](https://github.com/thenavidm/brandfetch-mcp-cli) | [`@thenavidm/brandfetch-mcp-cli`](https://www.npmjs.com/package/@thenavidm/brandfetch-mcp-cli) 3.0.0 | Any brand's logos, colors, fonts and company context, brand comparisons, transaction enrichment and approved logo downloads |
+| [Buffer](https://github.com/thenavidm/buffer-mcp-cli) | [`@thenavidm/buffer-mcp-cli`](https://www.npmjs.com/package/@thenavidm/buffer-mcp-cli) 3.0.0 | Scheduling and publishing posts across channels, ideas, content items, tags, templates and posting limits, through Buffer's GraphQL API |
+| [Calendly](https://github.com/thenavidm/calendly-mcp-cli) | [`@thenavidm/calendly-mcp-cli`](https://www.npmjs.com/package/@thenavidm/calendly-mcp-cli) 3.0.0 | Scheduled events and invitees, event types and availability, booking, contacts, routing forms, recaps and webhooks |
+| [Circle](https://github.com/thenavidm/circle-mcp-cli) | [`@thenavidm/circle-mcp-cli`](https://www.npmjs.com/package/@thenavidm/circle-mcp-cli) 3.0.0 | Spaces, posts, comments, members and access groups, courses, events, payments and refunds, through the Admin API |
+| [Cloudflare](https://github.com/thenavidm/cloudflare-mcp-cli) | [`@thenavidm/cloudflare-mcp-cli`](https://www.npmjs.com/package/@thenavidm/cloudflare-mcp-cli) 3.0.0 | Zones, DNS records with reviewed batches, cache purges, rulesets, page rules, Workers and analytics, across accounts |
 | [Google Photos](https://github.com/thenavidm/google-photos-mcp-cli) | [`@thenavidm/google-photos-mcp-cli`](https://www.npmjs.com/package/@thenavidm/google-photos-mcp-cli) 2.0.0 | The photo picker, uploads, albums and their captions, places and maps, and media this server uploaded, across several Google accounts |
 | [Mastodon](https://github.com/thenavidm/mastodon-mcp-cli) | [`@thenavidm/mastodon-mcp-cli`](https://www.npmjs.com/package/@thenavidm/mastodon-mcp-cli) 2.0.0 | Posting, editing, threads, timelines, search, lists, notifications and following, on any instance |
+| [Meta Ad Library](https://github.com/thenavidm/facebook-ad-library-mcp-cli) | [`@thenavidm/facebook-ad-library-mcp-cli`](https://www.npmjs.com/package/@thenavidm/facebook-ad-library-mcp-cli) 0.6.0 | Every ad running on Facebook, Instagram and Threads for any advertiser: copy, creatives, how long each has run, what changed, and EU spend and reach |
 | [Midjourney](https://github.com/thenavidm/midjourney-mcp-cli) | [`@thenavidm/midjourney-mcp-cli`](https://www.npmjs.com/package/@thenavidm/midjourney-mcp-cli) 2.0.0 | Generating images and video, following jobs, downloads, moodboards, the account's library and the explore feeds, through a signed-in browser |
 | [Podcast Index](https://github.com/thenavidm/podcastindex-mcp-cli) | [`@thenavidm/podcastindex-mcp-cli`](https://www.npmjs.com/package/@thenavidm/podcastindex-mcp-cli) 2.0.0 | The open podcast directory, with the transcripts and chapters it links to fetched and read, guest histories, feed health and value-for-value |
 | [Substack](https://github.com/thenavidm/substack-mcp-cli) | [`@thenavidm/substack-mcp-cli`](https://www.npmjs.com/package/@thenavidm/substack-mcp-cli) 3.0.0 | Drafts, publishing and scheduling, Notes, subscribers, analytics, tags, comments and researching other publications |
 | [Teachable](https://github.com/thenavidm/teachable-mcp-cli) | [`@thenavidm/teachable-mcp-cli`](https://www.npmjs.com/package/@thenavidm/teachable-mcp-cli) 3.0.0 | Courses, users, enrollments, pricing, coupons and transactions |
 | [Threads](https://github.com/thenavidm/threads-mcp-cli) | [`@thenavidm/threads-mcp-cli`](https://www.npmjs.com/package/@thenavidm/threads-mcp-cli) 2.0.0 | Posting, threads, carousels, replies and reply approvals, insights and keyword search |
-| [TikTok](https://github.com/thenavidm/tiktok-mcp-cli) | [`@thenavidm/tiktok-mcp-cli`](https://www.npmjs.com/package/@thenavidm/tiktok-mcp-cli) 2.0.0 | Your own account's profile and videos, ranked by any metric, posting and drafts, through TikTok's official API |
 | [ThriveCart](https://github.com/thenavidm/thrivecart-mcp-cli) | [`@thenavidm/thrivecart-mcp-cli`](https://www.npmjs.com/package/@thenavidm/thrivecart-mcp-cli) 3.0.0 | Products and pricing, transactions and revenue, customers, subscriptions and affiliates, across several carts |
+| [TikTok](https://github.com/thenavidm/tiktok-mcp-cli) | [`@thenavidm/tiktok-mcp-cli`](https://www.npmjs.com/package/@thenavidm/tiktok-mcp-cli) 2.0.0 | Your own account's profile and videos, ranked by any metric, posting and drafts, through TikTok's official API |
 | [WordPress](https://github.com/thenavidm/wordpress-mcp-cli) | [`@thenavidm/wordpress-mcp-cli`](https://www.npmjs.com/package/@thenavidm/wordpress-mcp-cli) 2.0.0 | Posts, pages, custom post types, media, terms, users and comments across several sites, plus Elementor, Rank Math, redirects and bulk edits through a helper plugin |
 | [YouTube](https://github.com/thenavidm/youtube-mcp-cli) | [`@thenavidm/youtube-mcp-cli`](https://www.npmjs.com/package/@thenavidm/youtube-mcp-cli) 3.0.1 | Transcripts of any public video, channel research against each channel's own median, and your own channels' videos, comments and analytics |
 

package/dist/cli/help.js

@@ -232,8 +232,10 @@ export function renderGeneralHelp(app, bin) {
             : []),
         [app.bins.mcp, "the MCP server; --http [--port N] serves HTTP"],
     ];
-    // Tuning keeps a working default, so it is named on one line with Slipway's own settings past
-    // the two safety switches; agent-context says what each does.
+    // Tuning keeps a working default, so it is counted on one line with Slipway's own settings past
+    // the two safety switches and --http's four; agent-context names each and says what it does.
+    // The general help is the first thing an agent reads, and carries it through every later step:
+    // fourteen names cost a 14-tool server more than its whole command list.
     const tuning = [
         ...(app.definition.settings ?? []).filter((setting) => setting.tuning).map((setting) => setting.env),
         names.surface,
@@ -257,8 +259,8 @@ export function renderGeneralHelp(app, bin) {
             : []),
         // With no tagged tool every tool is always on, so the switch would do nothing.
         ...(app.allTools.some((tool) => tool.tags.length > 0) ? [[`${names.toolsets}=a,b`, "only these toolsets, or all"]] : []),
-        [`${app.envPrefix}_HTTP_PORT / _HOST / _TOKEN / _ALLOWED_ORIGINS`, "for --http"],
     ];
+    const more = tuning.length + 4;
     // The list formats appear in the help of the commands that list; flags that cannot apply
     // here (jobs, the cache) are left out. agent-context lists every one.
     const flags = GLOBAL_FLAGS.map(([flag]) => flag).filter((flag) => flag !== "--agent" &&
@@ -282,7 +284,7 @@ export function renderGeneralHelp(app, bin) {
         ``,
         `Settings:`,
         ...settings.map(settingRow),
-        `  Also: ${tuning.join(", ")}, described in agent-context.`,
+        `  And ${more} more, for tuning and --http: agent-context describes each.`,
         ``,
         `Exit codes: ${EXIT.ok} ok, ${EXIT.error} unexpected, ${EXIT.usage} usage or refused, ${EXIT.notFound} not found, ${EXIT.auth} auth, ${EXIT.api} API, ${EXIT.rateLimited} rate limited, ${EXIT.notConfigured} not configured`,
         ``,

package/dist/search.js

@@ -12,6 +12,8 @@ const STOP_WORDS = new Set([
 ]);
 function words(text) {
     return text
+        // camelCase splits, so `channelId` reads as "channel id" and `createPost` as "create post".
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
         .toLowerCase()
         .split(/[^a-z0-9]+/)
         .filter((word) => word.length > 1)
@@ -91,11 +93,13 @@ export function searchTools(tools, query, limit = 10, synonyms = {}) {
         const title = words(tool.title);
         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".
+        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, description, extra);
+            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);
             if (got > 0)
                 matched++;
             score += got;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thenavidm/slipway",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "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",