Skip to content

feat(sdk-java): full feature parity with Python and TypeScript SDKs#32

Merged
senamakel merged 9 commits intotinyhumansai:mainfrom
oxoxDev:feat/sdk-java-feature-parity
Mar 25, 2026
Merged

feat(sdk-java): full feature parity with Python and TypeScript SDKs#32
senamakel merged 9 commits intotinyhumansai:mainfrom
oxoxDev:feat/sdk-java-feature-parity

Conversation

@oxoxDev
Copy link
Contributor

@oxoxDev oxoxDev commented Mar 24, 2026

Summary

  • Adds 14 new endpoint methods to the Java SDK, achieving full parity with the Python and TypeScript SDKs
  • Migrates existing endpoint paths from /v1/memory/... to /memory/... to match Python/TS conventions
  • Adds X-Model-Id header support and modelId constructor parameter
  • Adds internal sendGet/sendDelete methods for GET and DELETE HTTP support
  • Zero-dependency design preserved (custom JSON parser, no Jackson/Gson)

New endpoints

Chat: chatMemory, chatMemoryContext
Interactions: interactMemory, recordInteractions
Advanced Recall: recallThoughts, queryMemoryContext
Documents: insertDocument, insertDocumentsBatch, listDocuments, getDocument, deleteDocument
Admin/Utility: getGraphSnapshot, getIngestionJob, waitForIngestionJob

Changes

  • TinyHumansMemoryClient.java — Added modelId field, 3-arg constructor, X-Model-Id header, sendGet/sendDelete, 14 new public methods, migrated 5 paths
  • New params classes: ChatMemoryParams, InteractMemoryParams, RecallThoughtsParams, QueryMemoryContextParams, InsertDocumentParams, InsertDocumentsBatchParams, ListDocumentsParams,
    GetDocumentParams, GraphSnapshotParams, WaitForIngestionJobOptions
  • TinyHumansMemoryClientTest.java — Added tests for all new methods, modelId, GET/DELETE support
  • IntegrationTest.java — Updated with all new endpoints
  • ExampleUsage.java — Expanded with demos for all 19 methods
  • README.md — Full API reference table

Test plan

  • All unit tests passing (./gradlew test)
  • Integration tested against staging (https://staging-api.alphahuman.xyz)
  • Verified: insert, recall, recallMemories, insertDocument, insertDocumentsBatch, listDocuments, interactMemory, recordInteractions, recallThoughts
  • Known staging-side failures (not SDK): /memory/query and /memory/queries return "anonymous access" error, /memory/admin/delete returns 500

oxoxDev and others added 9 commits March 24, 2026 11:34
Aligns Java SDK with Python and TS SDKs which use /memory/ prefix.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…endDelete

Adds model ID support with neocortex-mk1 default, and internal
GET/DELETE methods needed for document and admin endpoints.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
POST /memory/chat and POST /memory/conversations for chat with
DeltaNet memory cache and memory context.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
POST /memory/interact and POST /memory/interactions for entity
interaction signals.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
POST /memory/memories/thoughts and POST /memory/queries for
reflective thought generation and context querying.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
insertDocument, insertDocumentsBatch, listDocuments, getDocument,
deleteDocument for POST/GET/DELETE /memory/documents.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
getGraphSnapshot, getIngestionJob, waitForIngestionJob for
GET /memory/admin/graph-snapshot and /memory/ingestion/jobs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Expands example with demos for all 19 methods and updates README
with complete API reference table.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Tests all new methods against staging. Wraps server-side errors
in try-catch for endpoints with staging permission restrictions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@senamakel senamakel merged commit 859b948 into tinyhumansai:main Mar 25, 2026
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.

2 participants