Skip to content

Add materialization_embeddings option to materialization API#83

Merged
jfrench9 merged 1 commit intomainfrom
feature/materialize-embeddings
Apr 8, 2026
Merged

Add materialization_embeddings option to materialization API#83
jfrench9 merged 1 commit intomainfrom
feature/materialize-embeddings

Conversation

@jfrench9
Copy link
Copy Markdown
Member

@jfrench9 jfrench9 commented Apr 8, 2026

Summary

This PR introduces a new materialization_embeddings option to the materialization pipeline, allowing clients to control whether embeddings are materialized as part of a materialization request.

Key Changes

  • MaterializationOptions: Added a new materialization_embeddings boolean field (defaulting to False) to the options model, giving users fine-grained control over embedding materialization behavior.
  • MaterializeRequest: Extended the request model with the corresponding materialization_embeddings parameter, ensuring it is properly propagated through the request payload.
  • MaterializationClient: Updated the client extension to pass the materialization_embeddings option from MaterializationOptions into the MaterializeRequest construction, wiring the full flow end-to-end.

Breaking Changes

None. The new field defaults to False, preserving existing behavior for all current consumers. This is a purely additive, backwards-compatible change.

Testing Notes

  • Verify that existing materialization requests continue to work without specifying the new option (default False behavior).
  • Test that setting materialization_embeddings=True in MaterializationOptions correctly includes the flag in the outgoing MaterializeRequest payload.
  • Validate the serialized request body against the expected API contract to ensure the new field is properly included when set.

Infrastructure Considerations

  • The backend/API must already support the materialization_embeddings field in the materialization endpoint; otherwise, the parameter may be silently ignored or cause validation errors depending on the server's strictness.
  • No new dependencies or environment changes are required.

🤖 Generated with Claude Code

Branch Info:

  • Source: feature/materialize-embeddings
  • Target: main
  • Type: feature

Co-Authored-By: Claude noreply@anthropic.com

…aterializeRequest

- Introduced a new boolean field `materialize_embeddings` in `MaterializationOptions` to control the inclusion of embedding columns during materialization.
- Updated `MaterializeRequest` to support the new `materialize_embeddings` field, allowing for the creation of HNSW vector indexes in the graph database when set to true.
- Adjusted the `to_dict` and `from_dict` methods in `MaterializeRequest` to handle the new field appropriately.

These changes enhance the materialization process by providing more control over embedding data handling.
@jfrench9 jfrench9 merged commit e31c0d8 into main Apr 8, 2026
1 check passed
@jfrench9 jfrench9 deleted the feature/materialize-embeddings branch April 8, 2026 05:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant