Unix Socket Bridge

Unix domain socket communication with configurable servers

Unix Socket Bridge

AI-generated

Summary

Sends a command as a JSON request to a Unix domain socket server and returns the server response for each input item. Choose a discovered command or enter one manually, then optionally add typed parameters and configure response parsing and metadata.

Inputs

  • Socket Path (required) — Path to the Unix domain socket file; defaults to /tmp/socket-bridge/service.sock.
  • Auto-Discover Commands — When enabled, load commands from the server for selection. When disabled, use the Manual Command field, which defaults to the incoming item's command value or status.
  • Available Commands / Manual Command — Select a server command in discovery mode, or enter its name in manual mode. The discovery placeholder and empty selection are rejected during execution.
  • Parameters — Add named values to send with the command. Choose Auto-Detect (parses valid JSON, otherwise keeps text), String, Number, Boolean, or JSON; entries without a name or with an empty value are skipped.
  • Timeout (ms) — Socket connection timeout; defaults to 5000 ms (UI range 1000–30000 ms).
  • Response Format — Auto-Detect parses valid JSON and otherwise returns text; JSON requires valid JSON; Text keeps the response as text.
  • Options — Continue On Fail controls whether execution errors produce an error item and continue. Max Response Size limits received data (default 1 MiB). Include Metadata defaults to true and controls whether socket path, command, request, success, and timestamp accompany the response.

Output shape

One output item per input item, each containing a JSON object.

With metadata enabled, the object includes socketPath, command, request, response, success, and timestamp; when a parsed object has a success field, the node also extracts fields such as output, error, returncode, and parsedOutput. With metadata disabled, it returns the parsed server object when it has a success field, or wraps the result as { "response": ... }. Continue On Fail emits an error object for failed items; otherwise execution errors are thrown.

Links

Discussion