Nats

@retr0h/natsv2026.04.21.1· 1mo agoMODELS·SKILLS

Security Notice

This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.

01README

General-purpose NATS transport for swamp — exec, upload, wait for agent connection. Pairs with swamp-nats-agent (https://github.com/retr0h/swamp-nats-agent).

02Release Notes

@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.

03Models1

@retr0h/nats/hostv2026.04.21.1nats_host.ts

Global Arguments

Argument	Type	Required	Description
nodeHost	string	yes	Target hostname (maps to NATS subject suffix)
nodeUser	string	yes	Agent-side user (SSH-era field, advisory)
nodePort	number	yes	SSH port (ignored by NATS transport)
nodeIdentityFile?	string	no	SSH private key path (ignored by NATS transport)
become	boolean	yes	Run commands with sudo on the agent
becomeUser	string	yes	User to become when sudo is true
becomePassword?	string	no	Password for sudo -S (piped via stdin)
natsUrl	string	yes	NATS server URL (nats://host:port)
natsSubjectPrefix	string	yes	Subject prefix for multi-tenant namespace isolation
timeoutMs	number	yes	Per-request timeout (ms)
natsUser?	string	no	NATS user/pass auth — username
natsPass?	string	no	NATS user/pass auth — password
natsToken?	string	no	NATS static token auth
natsCredsPath?	string	no	Path to NATS creds file (user JWT + nkey, recommended)
natsNKeySeed?	string	no	NATS nkey seed (alternative to creds file)
natsTlsCaFile?	string	no	mTLS — CA certificate file
natsTlsCertFile?	string	no	mTLS — client certificate file
natsTlsKeyFile?	string	no	mTLS — client key file

fn exec(command: string, timeout: number, stdin?: string)

Run a command on the remote host via swamp-nats-agent. Returns stdout/stderr/exitCode without throwing on non-zero exit.

Argument	Type	Required	Description
command	string	yes	Command to execute
timeout	number	yes	Enforced timeout in seconds (agent cancels via AbortSignal)
stdin?	string	no	Data to pipe to the command's stdin

fn upload(dest: string, content: string, contentEncoding: enum, mode?: string, owner?: string, group?: string)

Write file content to a remote path via swamp-nats-agent. Supports UTF-8 and base64 encoded content; atomic write under sudo via install(1).

Argument	Type	Required	Description
dest	string	yes	Remote destination path
content	string	yes	File content — UTF-8 string or base64-encoded bytes
contentEncoding	enum	yes	Encoding of content
mode?	string	no	File mode (octal, e.g. 0644)
owner?	string	no	File owner
group?	string	no	File group

fn waitForConnection(timeout: number)

Poll the swamp-nats-agent on the target host until it replies or timeout elapses.

Argument	Type	Required	Description
timeout	number	yes	Timeout in seconds

Resources

result(infinite)— NATS operation result

04Skills1

nats1 file

05Previous Versions1

2026.04.20.1Apr 21, 2026

Initial release — NATS (JetStream) transport for swamp, pairs with swamp-nats-agent

06Stats

Downloads

Archive size

85.6 KB

Not yet scored.

A score will be generated the next time this extension is published. The owner can also trigger scoring manually.

Repository

https://github.com/retr0h/swamp-nats

07Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

08Labels

#nats #jetstream #transport #messaging #remote-execution