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

Relationships

#1950 model type describe reports arguments: {} for models that define a full args schema

Opened by randybias · 9/2/2026· Shipped 9/2/2026

swamp model type describe <type> --json reports arguments: {} for methods that define a full Zod argument schema in source. The method works; only its introspected contract is empty.

Measured, twice, 2026-09-02

model args defined in source describe reports
@mirantis/mircloud-probe-cluster-access (probeClusterAccess) 6 0
@mirantis/mircloud-verify-node-safe-to-disrupt (verifyNodeSafeToDisrupt) 6 0
@mirantis/mircloud-lab-cert (6 methods) 7 per method 55 total — correct
@mirantis/mircloud-resolve-control-vm-host (resolveControlVmHost) 4 4 — correct

Source counts are the field count of the const ...ArgsSchema = z.object({...}) each method passes as its arguments. All four models are repo-local (extensions/models/*.ts), and all four declare arguments: <NamedSchema> in the same way — so this is neither a repo-local limitation nor a declaration-style difference. swamp doctor extensions reports OVERALL: PASS, and doctor --repair --dry-run plans only the removal of 5 orphaned bundle files, which is unrelated.

Why it matters

describe is the documented way to learn a method's contract — the repo's own guidance is to run it before wiring a step. An empty arguments: {} is indistinguishable from "this method takes no arguments", and that is a materially different design conclusion: it implies the call target can only be carried in the model INSTANCE name. That is the reasoning it nearly produced here, on a method with six arguments.

Expected

describe reports the declared argument schema, or reports that it could not introspect one — an empty object should not be the representation of both "no arguments" and "unknown".

Environment

swamp 20260822.011157.0-sha.06b61472.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 40 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

9/2/2026, 10:01:50 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack729/2/2026, 6:35:11 PM
Editable. Press Enter to edit.

stack72 commented 9/2/2026, 10:02:04 PM

Thanks @randybias for reporting this! The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.