Package com.tnsai.intelligence.rag.graph

Interface GraphStoreProvider

All Known Implementing Classes:
InMemoryGraphStoreProvider, KnowledgeToolsGraphStoreProvider, Neo4jGraphStoreProvider
public interface GraphStoreProvider
Service-provider contract for graph database and graph corpus adapters.

Providers are discovered with ServiceLoader. An adapter registers this interface in META-INF/services/com.tnsai.intelligence.rag.graph.GraphStoreProvider.

Since:
0.13.0

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static final record 
    GraphStoreProvider.Request
    Graph binding request.

  • Method Summary

    Modifier and Type
    Method
    Description
    default boolean
    frameworkDefault()
    Framework-bundled fallback adapter.
    String
    name()
    Stable provider name used in retrieval provenance.
    Optional<GraphStore>
    open(GraphStoreProvider.Request request)
    Opens a graph store for the requested Role and source fence.

  • Method Details

    • name

      String name()
      Stable provider name used in retrieval provenance.
      Returns:
      non-blank provider name

    • open

      Optional<GraphStore> open(GraphStoreProvider.Request request)
      Opens a graph store for the requested Role and source fence.

      Return Optional.empty() when this provider is not configured for the Role. Providers should not widen the requested source set.

      Parameters:
      request - Role and source selection
      Returns:
      a configured store, or empty when unsupported

    • frameworkDefault

      default boolean frameworkDefault()
      Framework-bundled fallback adapter.

      When a non-default provider also claims the Role, the registry drops every default so an explicit consumer adapter wins. Defaults still serve a Role that no other provider claims.

      Returns:
      true for the bundled KnowledgeTools adapter
      Since:
      0.14.0