release: 0.38.0

[stainless-app]

Automated Release PR

0.38.0 (2026-04-22)

Full Changelog: v0.37.0...v0.38.0

Features

• api: api update (7a8e495)
• api: manual updates (23c9221)

Performance Improvements

• client: optimize file structure copying in multipart requests (c28640c)

Chores

• tests: bump steady to v0.22.1 (7d67d91)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

[stainless-app]

🧪 Testing

To try out this version of the SDK:

pip install 'https://pkg.stainless.com/s/hyperspell-python/23c9221674f7d4d4d563b3e8d80d55c0b884114a/hyperspell-0.37.0-py3-none-any.whl'

Expires at: Fri, 22 May 2026 19:39:28 GMT
Updated at: Wed, 22 Apr 2026 19:39:28 GMT

[canaries-inc]

🐤 Canary Summary

This PR is a Python SDK release with no UI/UX changes affecting end users:

• Version bump to 0.38.0 across all configuration files
• Added date parameter to memories API for backend ranking/filtering
• Updated API type definitions and test coverage
• No user-facing UI components or changes present

---

---

View PR tests on Canary

[canaries-inc]

🐤 Canary Proposed Tests

No testable user journeys found for this PR.

[entelligence-ai-pr-reviews]

---

Confidence Score: 5/5 - Safe to Merge

Safe to merge — this PR is a release bump to version 0.38.0 and the automated review found no issues across the reviewed files. No logic changes, security concerns, or correctness problems were identified, and there are no unresolved pre-existing comments to carry forward. The PR appears to be a standard version release with clean diffs.

Key Findings:

• No review comments were generated by the automated analysis, indicating no detectable logic, security, or correctness issues in the changed files.
• Zero critical, significant, or medium-severity issues were flagged by the heuristic analysis, consistent with a version bump or release preparation PR.
• Coverage of 3/8 changed files leaves some files unreviewed, but for a release PR this is a low-risk gap — typically release commits touch changelogs, version files, and lock files which are low-risk by nature.

[entelligence-ai-pr-reviews]

EntelligenceAI PR Summary

Release v0.38.0 adds a date field to the memories update API and replaces deepcopy_minimal with a new deepcopy_with_paths utility for optimized multipart file copying.

• Added optional date: Union[str, datetime] parameter to MemoryUpdateParams TypedDict and both sync/async update methods in memories.py
• Introduced deepcopy_with_paths in src/hyperspell/_files.py for targeted shallow copying of only dict/list containers along specified key paths
• Removed deepcopy_minimal from src/hyperspell/_utils/_utils.py and its re-export in __init__.py
• Updated memories.py upload methods to use deepcopy_with_paths with [['file']] paths instead of deepcopy_minimal
• Updated README MCP badge URLs to scoped package name @hyperspell/hyperspell-mcp
• Bumped @stdy/cli from 0.20.2 to 0.22.1 in scripts/mock and scripts/test
• Deleted tests/test_deepcopy.py; added 8 new test cases in tests/test_files.py for deepcopy_with_paths
• Version bumped to 0.38.0 in pyproject.toml, _version.py, and .release-please-manifest.json

---

Confidence Score: 4/5 - Mostly Safe

Safe to merge with minor caveats — this release PR cleanly adds an optional date: Union[str, datetime] parameter to MemoryUpdateParams and both sync/async update methods in memories.py, and replaces deepcopy_minimal with the new deepcopy_with_paths utility in src/hyperspell/_files.py for more targeted container copying along specified key paths. No logic bugs, security issues, or runtime regressions were identified in the reviewed files. Coverage is partial (8/16 changed files reviewed), so there is a small residual risk in unreviewed files, but the changes are scoped and well-bounded. The PR reads like a clean, backward-compatible API surface expansion with an internal utility refactor.

Key Findings:

• The new deepcopy_with_paths in src/hyperspell/_files.py is a targeted replacement for deepcopy_minimal; as long as all call sites previously using deepcopy_minimal have been updated to deepcopy_with_paths with correct path arguments, there is no regression risk — the removal of the old function should be verified across all consumers.
• The optional date: Union[str, datetime] parameter in MemoryUpdateParams is additive and backward-compatible, posing no risk to existing callers that omit the field.
• Only 8 of 16 changed files were reviewed, leaving half the diff unverified; while the changes appear scoped, unreviewed files could contain edge cases in path handling or type coercion for the new date field.
• No critical, significant, or medium-severity issues were flagged by automated review, and no pre-existing unresolved comments were carried into this PR.

Files requiring special attention

• src/hyperspell/_files.py
• src/hyperspell/resources/memories.py

[entelligence-ai-pr-reviews]

Releases v0.38.0 with a new date field on the memories update endpoint and a targeted deep copy utility replacing the previous full-copy approach in multipart requests.

• Added date: str | datetime | None parameter to sync/async memories.update() and MemoryUpdateParams
• Introduced deepcopy_with_paths in src/hyperspell/_files.py for selective container deep copying along specified key paths
• Removed deepcopy_minimal from src/hyperspell/_utils/_utils.py and its export from src/hyperspell/_utils/__init__.py
• Updated src/hyperspell/resources/memories.py to use deepcopy_with_paths with ['file'] path in both sync and async upload methods
• Added 8 new tests in tests/test_files.py covering deepcopy_with_paths and mutation-safety with extract_files
• Removed tests/test_deepcopy.py along with the deprecated utility
• Version bumped in pyproject.toml, _version.py, and .release-please-manifest.json; OpenAPI spec hash refreshed in .stats.yml

[entelligence-ai-pr-reviews]

Releases hyperspell v0.38.0 with an API enhancement, a deep copy performance improvement, and a test dependency update.

• Added optional date field (Union[str, datetime], ISO 8601) to MemoryUpdateParams and sync/async update methods in memories.py
• Replaced deepcopy_minimal (removed from _utils/_utils.py and _utils/__init__.py) with the new deepcopy_with_paths utility in _files.py, which shallow-copies only containers along specified key paths
• Updated memories.py upload methods to use deepcopy_with_paths imported from _files instead of _utils
• Bumped @stdy/cli from 0.20.2 to 0.22.1 in scripts/mock and scripts/test
• Updated OpenAPI spec URL/hash in .stats.yml
• Removed tests/test_deepcopy.py; added TestDeepcopyWithPaths tests in tests/test_files.py
• Version bumped to 0.38.0 in pyproject.toml, _version.py, and .release-please-manifest.json