From 1ba4eb146de55899d4a8f4a57b396c648fb8ee50 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sat, 14 Nov 2026 12:55:59 +0000 Subject: [PATCH 1/2] Rank /browse?task= and /api/agents?task= organically; stop linking archived GPT Pilot (2.11.1) Co-authored-by: assaf.barnir --- CHANGELOG.md | 13 ++++++++++++- app/api/agents/route.ts | 6 ++++-- app/changelog/page.tsx | 6 ++++-- docs/API.md | 2 +- e2e/tests/46-tasks.spec.mjs | 3 ++- lib/search.test.ts | 14 +++++++++++++- lib/search.ts | 7 +++++-- package.json | 2 +- tests/organic-pages.test.ts | 28 +++++++++++++++++++++++++++- 9 files changed, 69 insertions(+), 12 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index bf064bc..cd9802a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,17 @@ Every release of [Agent Switchboard](https://agentswitchboard.dev), newest first Versions follow MAJOR.MINOR.PATCH: a minor version adds features, a patch fixes or adjusts. Versions before 2.2.0 were assigned afterwards, reconstructed from the git history. "Directory" lines summarize catalog changes since the previous release; the full log of every listing added, updated or removed is on [/changelog](https://agentswitchboard.dev/changelog), and batch by batch on [/drops](https://agentswitchboard.dev/drops). From 2.2.0 on, each minor release opens with its highlights, what you can do now with a link to try it, which [/whats-new](https://agentswitchboard.dev/whats-new) also shows. +## [2.11.1] - 2026-11-14 - Browsing by task ranks on fit alone + +### Highlights +- Browsing by task ranks tools on how well they fit the job and nothing else, in the same order as the task page: a Featured listing no longer moves up, even on a tie. [Try it](https://agentswitchboard.dev/browse?task=query-a-database) + +### Changed +- [/browse?task=](https://agentswitchboard.dev/browse?task=query-a-database) and `GET /api/agents?task=` rank best fit first and A→Z on a tie, as each task page and `GET /api/tasks/` have since 2.10.5, instead of putting featured listings first among equals. Plain /browse and `GET /api/agents` without a task still list Featured first. ([#PR](https://github.com/assafbar2/agentswitchboard.dev/pull/PR)) + +### Fixed +- [/changelog](https://agentswitchboard.dev/changelog) names a listing that has since been archived without linking it, instead of linking a page that is gone, and the 2.10.1 notes no longer link GPT Pilot, archived in 2.9.6. ([#PR](https://github.com/assafbar2/agentswitchboard.dev/pull/PR)) + ## [2.11.0] - 2026-11-14 - The homepage starts from the job ### Highlights @@ -72,7 +83,7 @@ Versions follow MAJOR.MINOR.PATCH: a minor version adds features, a patch fixes ### Directory - The [Nov 13 drop](https://agentswitchboard.dev/drops/2026-11-13): the weekly run added 56 listings, 14 of them Official, updated 2 and archived 1, with [Ship a web app with your agent](https://agentswitchboard.dev/stacks/ship-a-web-app-with-your-agent) as the stack of the week. With the same day's corrections below, the drop comes to 56 added, 6 updated and 2 archived. ([#395](https://github.com/assafbar2/agentswitchboard.dev/pull/395)) -- [elizaOS](https://agentswitchboard.dev/agents/eliza), [GPT Pilot](https://agentswitchboard.dev/agents/gpt-pilot) and [MobileBuildMCP](https://agentswitchboard.dev/agents/xcodebuild-mcp) go by their projects' own names. Corrected the same day, they count among the Nov 13 drop's updates. ([#390](https://github.com/assafbar2/agentswitchboard.dev/pull/390)) +- [elizaOS](https://agentswitchboard.dev/agents/eliza), GPT Pilot and [MobileBuildMCP](https://agentswitchboard.dev/agents/xcodebuild-mcp) go by their projects' own names. Corrected the same day, they count among the Nov 13 drop's updates. ([#390](https://github.com/assafbar2/agentswitchboard.dev/pull/390)) - [Windsurf is Devin Desktop](https://agentswitchboard.dev/agents/codeium-windsurf) now, by Cognition AI, and its listing and comparison say "formerly Windsurf". ZCode is archived while a privacy report on it is unresolved. Both count in the Nov 13 drop. ([#398](https://github.com/assafbar2/agentswitchboard.dev/pull/398)) ## [2.10.0] - 2026-11-13 - Every task page compares its top tools diff --git a/app/api/agents/route.ts b/app/api/agents/route.ts index 2c1288b..a008256 100644 --- a/app/api/agents/route.ts +++ b/app/api/agents/route.ts @@ -12,7 +12,8 @@ * featured } ] } * * `task` (a slug from GET /api/tasks) keeps the listings that fit the task, - * best fit first, as /browse?task= does; an unknown one is a 400. + * best fit first and A→Z on a tie, featured ignored, as /browse?task= and + * GET /api/tasks/ do; an unknown one is a 400. * `access` takes api | mcp | cli | browser-extension (comma-separate to require * several); `extension` is accepted as an alias of `browser-extension`. * `auth` takes none | apiKey | oauth2 | bearer (comma-separate to accept any). @@ -116,7 +117,8 @@ export async function GET(req: Request): Promise { } const everyAgent = await getEveryAgent(); - const catalog = wantsOrganic(searchParams) ? organicOrder(everyAgent) : everyAgent; + // A task ranks on fit alone, as GET /api/tasks/ and the task page do. + const catalog = task || wantsOrganic(searchParams) ? organicOrder(everyAgent) : everyAgent; const agents = filterAgents(task ? taskMatches(catalog, task) : catalog, { category, official, diff --git a/app/changelog/page.tsx b/app/changelog/page.tsx index 241048f..2405177 100644 --- a/app/changelog/page.tsx +++ b/app/changelog/page.tsx @@ -4,7 +4,7 @@ import Link from '@/components/Link'; import { Suspense } from 'react'; import type { Metadata, ResolvingMetadata } from 'next'; import { pageMetadata } from '@/lib/metadata'; -import { getAllCategories, getListingCategories } from '@/lib/catalog'; +import { getAllCategories, getEveryAgent, getListingCategories } from '@/lib/catalog'; import { getReleases, releaseAnchor } from '@/lib/changelog'; import { NEW_DAYS } from '@/lib/freshness'; import { inlineMarkdownToText } from '@/lib/inline-markdown'; @@ -37,6 +37,8 @@ export default async function ChangelogPage() { const releases = getReleases(); const listingCategories = await getListingCategories(); const categoriesOf = (slug: string) => listingCategories.get(slug) ?? []; + // An archived listing has no page, so its older entries name it without a link. + const listed = new Set((await getEveryAgent()).map((a) => a.slug)); const counts = logCounts(entries, categoriesOf); const categories = (await getAllCategories()) .filter((c) => counts[c.slug]) @@ -142,7 +144,7 @@ export default async function ChangelogPage() { data-cats={categoriesOf(e.slug).join(' ') || undefined} >
- {e.action === 'removed' ? ( + {e.action === 'removed' || !listed.has(e.slug) ? ( {e.name} ) : ( diff --git a/docs/API.md b/docs/API.md index 18ef5a9..6eb1984 100644 --- a/docs/API.md +++ b/docs/API.md @@ -53,7 +53,7 @@ handshake (e.g. wiring into a connector platform). | Param | Type | Default | Notes | |---|---|---|---| | `q` | string | `""` | Free-text over name, description, skills, categories, tags, provider. Empty = list all (relevance falls back to catalog order). | -| `task` | string | — | A task slug from [`GET /api/tasks`](#rest-tasks--get-apitasks), e.g. `query-a-database`: keeps only the listings that do that job. With no `q`, best fit first. An unknown slug is a `400` with `{ "error": "unknown_task", "message": "…" }`. | +| `task` | string | — | A task slug from [`GET /api/tasks`](#rest-tasks--get-apitasks), e.g. `query-a-database`: keeps only the listings that do that job. With no `q`, best fit first and A→Z on a tie, as `GET /api/tasks/{slug}` lists them; featured never moves one up. An unknown slug is a `400` with `{ "error": "unknown_task", "message": "…" }`. | | `category` | string | — | Category slug, e.g. `content-media`. See `list_categories` / [`content/categories.json`](../content/categories.json). | | `access` | string | — | One or more of `api`, `mcp`, `cli`, `browser-extension` (`extension` is accepted as an alias). Comma-separate to **require all** (`access=api,mcp`). Unknown values are ignored, not rejected. | | `official` | boolean | `false` | `true` (or `1`) returns only [official listings](#official-listings): first-party products from major vendors. Combines with `category`, `access`, and `q`. | diff --git a/e2e/tests/46-tasks.spec.mjs b/e2e/tests/46-tasks.spec.mjs index 8c3866a..f8ad8ef 100644 --- a/e2e/tests/46-tasks.spec.mjs +++ b/e2e/tests/46-tasks.spec.mjs @@ -562,7 +562,8 @@ test.describe('common jobs on the homepage', () => { test('the text-only view lists the same tasks with how many fit', async ({ page }) => { await page.addInitScript(() => { try { localStorage.setItem('viewMode', 'agent'); } catch {} }); await page.goto('/'); - const rows = page.locator('.agent-only a.agent-row[href^="/browse?task="]'); + // A release highlight above them may also try a task; its rows stack. + const rows = page.locator('.agent-only a.agent-row:not(.agent-row-stack)[href^="/browse?task="]'); expect(await hrefs(rows)).toEqual(chipHrefs()); for (const [i, t] of TASKS.slice(0, CHIPS).entries()) await expect(rows.nth(i)).toContainText(`${t.count} fit`); }); diff --git a/lib/search.test.ts b/lib/search.test.ts index 5ae8fa8..814d427 100644 --- a/lib/search.test.ts +++ b/lib/search.test.ts @@ -454,11 +454,23 @@ describe('taskScore and taskMatches', () => { it('on /browse, picks the task listings first, then filters and searches them', () => { const slugs = (state: BrowseState) => browseMatches(agents, state).map((a) => a.slug); - expect(slugs({ ...none, task })).toEqual(['everywhere', 'named', 'named-too', 'in-category']); + expect(slugs({ ...none, task })).toEqual(['everywhere', 'named-too', 'named', 'in-category']); expect(slugs({ ...none, task, access: ['mcp'] })).toEqual(['in-category']); expect(slugs({ ...none, task, query: 'kit' })).toEqual(['named']); }); + it('on /browse, ranks a task A→Z on a tie, so a featured listing first in the catalog never moves up', () => { + const named = agents.find((a) => a.slug === 'named')!; + const featuredFirst = [{ ...named, featured: true }, ...agents.filter((a) => a !== named)]; + expect(browseMatches(featuredFirst, { ...none, task }).map((a) => a.slug)).toEqual([ + 'everywhere', + 'named-too', + 'named', + 'in-category', + ]); + expect(browseMatches(featuredFirst, none).map((a) => a.slug)[0]).toBe('named'); + }); + it('writes the task first in a /browse URL', () => { expect(browseStateHref({ ...none, task })).toBe('/browse?task=query-data'); expect(browseStateHref({ ...none, task, query: 'kit', access: ['mcp'] }, 'newest')).toBe( diff --git a/lib/search.ts b/lib/search.ts index 99cf4bc..1f2ca4e 100644 --- a/lib/search.ts +++ b/lib/search.ts @@ -1,3 +1,4 @@ +import { organicOrder } from './organic'; import type { Agent } from './types'; /** Canonical access method labels for display */ @@ -180,10 +181,12 @@ export interface BrowseState { /** * The listings a /browse view shows, before sorting. A task picks its * listings from all of `agents` before the filters apply, so a filter keeps - * the same listings the breakdown line counted for it. + * the same listings the breakdown line counted for it. A task ranks on fit + * alone, in organic order (lib/organic.ts) as its task page does, so Featured + * never moves a listing up it; without a task the catalog's order stands. */ export function browseMatches(agents: Agent[], state: BrowseState): Agent[] { - const narrowed = filterAgents(state.task ? taskMatches(agents, state.task) : agents, { + const narrowed = filterAgents(state.task ? taskMatches(organicOrder(agents), state.task) : agents, { category: state.category, official: state.official || !!state.vendor, vendor: state.vendor, diff --git a/package.json b/package.json index aa954f1..538c1df 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "agentswitchboard.dev", - "version": "2.11.0", + "version": "2.11.1", "private": true, "scripts": { "dev": "next dev", diff --git a/tests/organic-pages.test.ts b/tests/organic-pages.test.ts index b4dbd4e..c199e36 100644 --- a/tests/organic-pages.test.ts +++ b/tests/organic-pages.test.ts @@ -39,12 +39,13 @@ vi.mock('fs', async (importOriginal) => { }); const { getEveryAgent, getOrganicAgents } = await import('@/lib/catalog'); -const { taskMatches } = await import('@/lib/search'); +const { browseMatches, taskMatches } = await import('@/lib/search'); const { getTasks } = await import('@/lib/tasks'); const { putThrough } = await import('@/lib/operator'); const { OPERATOR_EXAMPLES } = await import('@/lib/request-parts'); const tasksRoute = await import('@/app/api/tasks/route'); const taskRoute = await import('@/app/api/tasks/[slug]/route'); +const agentsRoute = await import('@/app/api/agents/route'); afterAll(() => { placement.on = false; @@ -102,6 +103,31 @@ describe('task pages and the Operator rank organically', () => { expect(placed).toEqual(organic); }); + it('/browse?task= lists each task as its task page does, from the featured-first catalog, whatever is placed', async () => { + const browse = (t: ReturnType[number], catalog: Awaited>) => + slugs(browseMatches(catalog, { query: '', task: t, category: '', official: false, vendor: '', verified: false, auth: [], access: [] })); + const { organic, placed } = await both(async () => { + const catalog = await getEveryAgent(); + return getTasks().map((t) => browse(t, catalog)); + }); + expect(placed).toEqual(organic); + const organicCatalog = await getOrganicAgents(); + expect(organic).toEqual(getTasks().map((t) => slugs(taskMatches(organicCatalog, t)))); + }); + + it('GET /api/agents?task= lists as GET /api/tasks/ does, whatever is placed', async () => { + const slug = getTasks()[0].slug; + const { organic, placed } = await both(async () => { + const search = await (await agentsRoute.GET(new Request(`http://localhost/api/agents?task=${slug}&limit=50`))).json(); + return slugs(search.agents); + }); + expect(placed).toEqual(organic); + const one = await ( + await taskRoute.GET(new Request(`http://localhost/api/tasks/${slug}`), { params: Promise.resolve({ slug }) }) + ).json(); + expect(organic).toEqual(slugs(one.agents).slice(0, 50)); + }); + it('the task pages, the Operator and their cards read the organic catalog', () => { const files = [ 'app/tasks/page.tsx', From 766af7f91cf2207a84277efc0f682e23c6350afb Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sat, 14 Nov 2026 12:56:13 +0000 Subject: [PATCH 2/2] Changelog: link #414 Co-authored-by: assaf.barnir --- CHANGELOG.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index cd9802a..14994e9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,10 +10,10 @@ Versions follow MAJOR.MINOR.PATCH: a minor version adds features, a patch fixes - Browsing by task ranks tools on how well they fit the job and nothing else, in the same order as the task page: a Featured listing no longer moves up, even on a tie. [Try it](https://agentswitchboard.dev/browse?task=query-a-database) ### Changed -- [/browse?task=](https://agentswitchboard.dev/browse?task=query-a-database) and `GET /api/agents?task=` rank best fit first and A→Z on a tie, as each task page and `GET /api/tasks/` have since 2.10.5, instead of putting featured listings first among equals. Plain /browse and `GET /api/agents` without a task still list Featured first. ([#PR](https://github.com/assafbar2/agentswitchboard.dev/pull/PR)) +- [/browse?task=](https://agentswitchboard.dev/browse?task=query-a-database) and `GET /api/agents?task=` rank best fit first and A→Z on a tie, as each task page and `GET /api/tasks/` have since 2.10.5, instead of putting featured listings first among equals. Plain /browse and `GET /api/agents` without a task still list Featured first. ([#414](https://github.com/assafbar2/agentswitchboard.dev/pull/414)) ### Fixed -- [/changelog](https://agentswitchboard.dev/changelog) names a listing that has since been archived without linking it, instead of linking a page that is gone, and the 2.10.1 notes no longer link GPT Pilot, archived in 2.9.6. ([#PR](https://github.com/assafbar2/agentswitchboard.dev/pull/PR)) +- [/changelog](https://agentswitchboard.dev/changelog) names a listing that has since been archived without linking it, instead of linking a page that is gone, and the 2.10.1 notes no longer link GPT Pilot, archived in 2.9.6. ([#414](https://github.com/assafbar2/agentswitchboard.dev/pull/414)) ## [2.11.0] - 2026-11-14 - The homepage starts from the job