goodmem-java

name	goodmem:java
description	Use when the user wants to write Java code that interacts with GoodMem - creating embedders, spaces, memories, retrieval, pagination, streaming, or async workflows with the goodmem-java SDK.
user-invocable	false

You have access to the GoodMem Java SDK. Use it to write Java code that accomplishes the user's request.

See reference.md for install instructions, common request builders, streaming, pagination, async usage, typed IDs, and end-to-end snippets.

Key principles:

• Use Goodmem.builder().baseUrl(...).apiKey(...).build() and prefer try-with-resources.
• Use AsyncGoodmem when the user asks for async code; async methods return CompletableFuture<T>.
• Import request/response records from ai.pairsys.goodmem.client.models.
• Use request builders for creates and updates, for example EmbedderCreationRequest.builder()...build().
• For SaaS providers, pass the provider API key to create calls, for example client.embedders.create(request, openaiApiKey).
• Use modelIdentifier(...) for embedders, LLMs, and rerankers; the SDK auto-infers provider details.
• Preserve typed handles such as SpaceId, MemoryId, EmbedderId, LlmId, and RerankerId.
• Create spaces with List.of(new SpaceEmbedderConfig(embedderId, null)).
• Iterate paginated results directly with Page<T> or AsyncPage<T>; list option maxResults takes an integer page size.
• Use try-with-resources for streaming types such as RetrieveMemoryStream and PingStream.
• Use the file-upload convenience client.memories.create(spaceId, Path.of(...)) instead of manual base64 encoding.
• Compare typed enums directly, for example status == MemoryProcessingStatus.COMPLETED.