Skip to content

feat: add proxyLLMCall and deprecate executeQuery#57

Merged
saurabhjain1592 merged 2 commits into
mainfrom
feat/proxy-llm-call-rename
Jan 23, 2026
Merged

feat: add proxyLLMCall and deprecate executeQuery#57
saurabhjain1592 merged 2 commits into
mainfrom
feat/proxy-llm-call-rename

Conversation

@saurabhjain1592

Copy link
Copy Markdown
Member

Summary

Add proxyLLMCall() as the primary method for Proxy Mode with improved documentation.

executeQuery() remains as a @Deprecated wrapper that logs a warning in debug mode. It will be removed in v3.0.0.

Changes

  • Added proxyLLMCall() and proxyLLMCallAsync() with comprehensive Javadoc explaining:
    • Proxy Mode behavior (AxonFlow makes the LLM call)
    • When to use vs Gateway Mode
  • executeQuery() and executeQueryAsync() are now deprecated wrappers
  • Deprecation warning logged in debug mode

Motivation

Part of Gateway Phase 3 work to clarify SDK semantics:

  • Proxy Mode: proxyLLMCall() - AxonFlow acts as intermediary
  • Gateway Mode: getPolicyApprovedContext() + auditLLMCall() - you control the LLM call

Breaking Changes

None - executeQuery() still works but is deprecated.

Test plan

  • Java compiles without errors
  • Deprecation annotation present

Add proxyLLMCall() as the primary method for Proxy Mode with improved
documentation explaining when to use Proxy Mode vs Gateway Mode.

executeQuery() remains as a @deprecated wrapper that logs a warning
in debug mode. It will be removed in v3.0.0.

This is part of the Gateway Phase 3 work to clarify SDK semantics:
- proxyLLMCall(): Proxy Mode - AxonFlow makes the LLM call
- getPolicyApprovedContext() + auditLLMCall(): Gateway Mode - you make the LLM call
@saurabhjain1592 saurabhjain1592 merged commit 9d3ad05 into main Jan 23, 2026
9 checks passed
@saurabhjain1592 saurabhjain1592 deleted the feat/proxy-llm-call-rename branch January 27, 2026 10:44
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