General-purpose NATS transport for swamp — exec, upload, wait for agent connection. Pairs with swamp-nats-agent (https://github.com/retr0h/swamp-nats-agent).
@adam/cfgmgmt drop-in compat: exports match adam's _lib/ssh.ts byte-for-byte (exec, execSudo, writeFile, writeFileAs, scpFile, scpFileAs, shellEscape, closeAll). nats_host globalArgs mirror cfgmgmt's GlobalArgsSchema (nodeHost, nodeUser, nodePort, nodeIdentityFile, become, becomeUser, becomePassword). Sudo moves from method args to globalArgs.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| nodeHost | string | Target hostname (maps to NATS subject suffix) |
| nodeUser | string | Agent-side user (SSH-era field, advisory) |
| nodePort | number | SSH port (ignored by NATS transport) |
| nodeIdentityFile? | string | SSH private key path (ignored by NATS transport) |
| become | boolean | Run commands with sudo on the agent |
| becomeUser | string | User to become when sudo is true |
| becomePassword? | string | Password for sudo -S (piped via stdin) |
| natsUrl | string | NATS server URL (nats://host:port) |
| natsSubjectPrefix | string | Subject prefix for multi-tenant namespace isolation |
| timeoutMs | number | Per-request timeout (ms) |
| natsUser? | string | NATS user/pass auth — username |
| natsPass? | string | NATS user/pass auth — password |
| natsToken? | string | NATS static token auth |
| natsCredsPath? | string | Path to NATS creds file (user JWT + nkey, recommended) |
| natsNKeySeed? | string | NATS nkey seed (alternative to creds file) |
| natsTlsCaFile? | string | mTLS — CA certificate file |
| natsTlsCertFile? | string | mTLS — client certificate file |
| natsTlsKeyFile? | string | mTLS — client key file |
| Argument | Type | Description |
|---|---|---|
| command | string | Command to execute |
| timeout | number | Enforced timeout in seconds (agent cancels via AbortSignal) |
| stdin? | string | Data to pipe to the command's stdin |
| Argument | Type | Description |
|---|---|---|
| dest | string | Remote destination path |
| content | string | File content — UTF-8 string or base64-encoded bytes |
| contentEncoding | enum | Encoding of content |
| mode? | string | File mode (octal, e.g. 0644) |
| owner? | string | File owner |
| group? | string | File group |
| Argument | Type | Description |
|---|---|---|
| timeout | number | Timeout in seconds |
Resources
Initial release — NATS (JetStream) transport for swamp, pairs with swamp-nats-agent
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.