Skip to main content
← Back to list
01Issue
BugShippedSwamp CLIPublic
Assigneesstack72

Relationships

#3819 behavior type describe <installed extension name> suggests a registry search instead of the type it provides

Opened by kagarmoe · 10/23/2026· Shipped 10/23/2026

Description

When you pass an extension's name to swamp behavior type describe and that extension is installed, the error suggests searching the registry for it. It doesn't point to the type the installed extension actually provides:

$ swamp behavior type describe @swamp/vercel/deployments
Error: Behavior type not found: @swamp/vercel/deployments

This type may be available as an extension:
  Search:  swamp extension search vercel/deployments

But @swamp/vercel/deployments v2026.10.13.1 is installed (swamp extension list shows it), and the type it provides is @swamp/vercel/deployments/deployments. An earlier version printed Install: swamp extension pull @swamp/vercel/deployments, which was even more misleading.

Extension names and type names look alike, so this is an easy mistake. swamp behavior type search results also list extension names, which reinforces it.

Steps to reproduce

  1. swamp extension pull @swamp/vercel/deployments
  2. swamp behavior type describe @swamp/vercel/deployments → the error above

Expected

When the requested name matches an installed extension, say so and list the types it provides, e.g. Did you mean @swamp/vercel/deployments/deployments? (provided by installed extension @swamp/vercel/deployments).

Environment

swamp 20261022.211048.0

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 6 MOREPR_LINKED+ 2 MORESESSION_SUMMARIZED

Shipped

10/23/2026, 11:50:52 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack7210/23/2026, 11:04:27 AM
Editable. Press Enter to edit.

stack72 commented 10/23/2026, 11:51:44 AM

@kagarmoe thanks for reporting this, and for spelling out the message you expected — that's what the fix uses. When you pass an installed extension's name to swamp behavior type describe, the error now names the types that extension provides instead of telling you to search the registry and pull it again:

Error: Behavior type not found: @swamp/vercel/deployments

Did you mean @swamp/vercel/deployments/deployments? (provided by installed extension @swamp/vercel/deployments)

If the extension provides several types, the error lists them all. This works with --json, under swamp model type describe, and without the leading @. Names that don't match an installed extension still get the registry search hint. It's merged in https://github.com/swamp-club/swamp/pull/3324 and will be in the next release.

Sign in to post a ripple.