sutura: ports and adapters

Point at a crate, or move to it with Tab, to show its connections.

sutura: ports and adapters sutura crates: transports, the service, the domain ports and the adapters behind them. AI agent · MCP client · Architecture component AI agent MCP client HTTP client · app or script · Architecture component HTTP client app or script Identity provider · issues access tokens · Architecture component Identity provider issues access tokens sutura-mcp · tool surface · One binary: sutura-cli wires adapters into ports sutura-mcp tool surface sutura-http · /v1 API, OpenAPI · One binary: sutura-cli wires adapters into ports sutura-http /v1 API, OpenAPI sutura-app · service, Surface port · One binary: sutura-cli wires adapters into ports sutura-app service, Surface port sutura-semantic · question to plan · One binary: sutura-cli wires adapters into ports sutura-semantic question to plan sutura-domain · SemanticCatalog, Warehouse, CredentialBroker · One binary: sutura-cli wires adapters into ports · ports sutura-domain SemanticCatalog, Warehouse, CredentialBroker ports sutura-catalog-* · metadata adapters · One binary: sutura-cli wires adapters into ports sutura-catalog-* metadata adapters sutura-exec-* · data-system adapters · One binary: sutura-cli wires adapters into ports sutura-exec-* data-system adapters sutura-sql · plan to SQL dialect · One binary: sutura-cli wires adapters into ports sutura-sql plan to SQL dialect Metadata sources · DataHub, OpenMetadata, Cube, files · Architecture component Metadata sources DataHub, OpenMetadata,Cube, files Data systems · BigQuery, ClickHouse, Oracle, PostgreSQL, DuckDB · Architecture component Data systems BigQuery, ClickHouse,Oracle, Postgres, DuckDB MCP HTTPS key set key set question question compile calls ports implements implements render read snapshot run plan One binary: sutura-cli wires adapters into ports Legend Frontend Backend Database Security External

Closed question

  • A question names metrics, dimensions, a grain and a time range.
  • No tool takes SQL, a table name or a filter.

Pinned definitions

  • A catalog loads without the caller's identity.
  • The snapshot digest goes with every answer.

Identity

  • sutura verifies the caller's token (leg 1).
  • BigQuery, ClickHouse and Oracle can run as the caller (leg 2).
  • Other data systems run as one declared identity.