Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/<slug>` 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. ([#414](https://github.com/assafbar2/agentswitchboard.dev/pull/414))

## [2.11.0] - 2026-11-14 - The homepage starts from the job

### Highlights
Expand Down Expand Up @@ -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
Expand Down
6 changes: 4 additions & 2 deletions app/api/agents/route.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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/<slug> 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).
Expand Down Expand Up @@ -116,7 +117,8 @@ export async function GET(req: Request): Promise<Response> {
}

const everyAgent = await getEveryAgent();
const catalog = wantsOrganic(searchParams) ? organicOrder(everyAgent) : everyAgent;
// A task ranks on fit alone, as GET /api/tasks/<slug> and the task page do.
const catalog = task || wantsOrganic(searchParams) ? organicOrder(everyAgent) : everyAgent;
const agents = filterAgents(task ? taskMatches(catalog, task) : catalog, {
category,
official,
Expand Down
6 changes: 4 additions & 2 deletions app/changelog/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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';
Expand Down Expand Up @@ -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])
Expand Down Expand Up @@ -142,7 +144,7 @@ export default async function ChangelogPage() {
data-cats={categoriesOf(e.slug).join(' ') || undefined}
>
<div className="log-row">
{e.action === 'removed' ? (
{e.action === 'removed' || !listed.has(e.slug) ? (
<span className="log-name">{e.name}</span>
) : (
<Link href={`/agents/${e.slug}`} className="log-name">
Expand Down
2 changes: 1 addition & 1 deletion docs/API.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`. |
Expand Down
3 changes: 2 additions & 1 deletion e2e/tests/46-tasks.spec.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -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`);
});
Expand Down
14 changes: 13 additions & 1 deletion lib/search.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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(
Expand Down
7 changes: 5 additions & 2 deletions lib/search.ts
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
import { organicOrder } from './organic';
import type { Agent } from './types';

/** Canonical access method labels for display */
Expand Down Expand Up @@ -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,
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "agentswitchboard.dev",
"version": "2.11.0",
"version": "2.11.1",
"private": true,
"scripts": {
"dev": "next dev",
Expand Down
28 changes: 27 additions & 1 deletion tests/organic-pages.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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;
Expand Down Expand Up @@ -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<typeof getTasks>[number], catalog: Awaited<ReturnType<typeof getEveryAgent>>) =>
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/<slug> 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',
Expand Down
Loading