delonix serve node-api

O contrato de nó (gRPC + HTTP/JSON do delonix.node.v1) num socket unix.

The node contract (gRPC + HTTP/JSON of delonix.node.v1) on a unix socket.

O contrato versionado proto/delonix/node/v1 servido pelo binário delonix-node-api (ADR-0040 P5): gRPC e HTTP/JSON dos MESMOS ficheiros, num socket unix local, só para o próprio uid. Hoje serve NodeService.ListProviders — GET /v1/providers[?kind=] devolve os mesmos providers e capacidades que delonix provider ls -o json (ADR-0050 D5); os restantes RPCs do serviço respondem UNIMPLEMENTED a nomear o passo do ADR-0042 que os traz. O OpenAPI gerado está em docs/api/openapi.yaml.

The versioned contract proto/delonix/node/v1 served by the delonix-node-api binary (ADR-0040 P5): gRPC and HTTP/JSON from the SAME files, on a local unix socket, for the owning uid only. Today it serves NodeService.ListProviders — GET /v1/providers[?kind=] returns the same providers and capabilities as delonix provider ls -o json (ADR-0050 D5); the service's other RPCs answer UNIMPLEMENTED naming the ADR-0042 step that brings them. The generated OpenAPI is docs/api/openapi.yaml.

📄 Implementação real em Rust: cmd/serve.rs

Usage: delonix serve node-api [OPTIONS]

Options:
      --addr <ADDR>
          Socket address (default: `$DELONIX_NODE_API_ADDR` or `unix:///run/delonix-node.sock`)

      --l18n <en|pt>
          Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand

  -h, --help
          Print help (see a summary with '-h')

EXAMPLES:
  # the node contract on the default unix socket — gRPC and HTTP/JSON of
  # delonix.node.v1
  delonix serve node-api

  # a socket of your own, then read the providers as JSON
  delonix serve node-api --addr unix:///tmp/delonix-node.sock

SEE ALSO:
  delonix serve api · delonix provider ls · delonix system info

  delonix › serve › node-api