🧪 Testing

To try out this version of the SDK:

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

Expires at: Mon, 08 Jun 2026 04:06:56 GMT
Updated at: Sat, 09 May 2026 04:06:56 GMT

🐤 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

🐤 Canary Proposed Tests

No testable user journeys found for this PR.

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.

EntelligenceAI PR Summary

Releases v0.38.0 of the Hyperspell Python SDK with new integrations, API changes, and internal improvements.

• Added granola, fathom, and linear as supported integration/source/provider types across all relevant models, resources, and type params
• Introduced HYPERSPELL_CUSTOM_HEADERS env var support for injecting custom HTTP headers in both sync and async clients
• Replaced deepcopy_minimal with the new path-aware deepcopy_with_paths utility in _files.py and updated memories.py accordingly
• Added array_format parameter to extract_files for configurable multipart file field name serialization (brackets, indices, repeat, comma)
• Refactored MemorySearchParams.effort from int to Literal['minimal','low','medium','high'] string enum
• Added optional date param to memory.update and optional recency_half_life_days to memory.search options
• Added requires_channel_selection to IntegrationListResponse and selected_count to ConnectionListResponse
• Added folder_ancestors field to the shared Resource model
• Relocated ArrayFormat/NestedFormat type aliases from _qs.py to _types.py
• Bumped @stdy/cli from 0.20.2 to 0.22.1 in mock/test scripts; fixed unbound variable in bootstrap script

Confidence Score: 3/5 - Review Recommended

Likely safe but review recommended — this PR ships a well-scoped release (v0.38.0) adding granola, fathom, and linear integrations plus HYPERSPELL_CUSTOM_HEADERS env var support and the deepcopy_with_paths utility refactor, all of which appear to be straightforward extensions. However, a pre-existing unresolved concern in src/hyperspell/_utils/_utils.py around the flattened_key / _array_suffix interaction (L140-L151) remains open: when flattened_key is None and the format yields an empty string, the recursive call receives flattened_key="" instead of None, which is a correctness deviation that could silently produce malformed keys in certain serialization paths. That issue was not introduced by this PR but is still unresolved, and it touches a utility used broadly enough to warrant attention before shipping.

Key Findings:

• The unresolved comment on _utils.py L140-L151 describes a real correctness issue: passing flattened_key="" (empty string) instead of None to the recursive call when _array_suffix returns "" for repeat/comma formats could produce keys with unexpected leading separators (e.g. .child instead of child), silently corrupting multipart form serialization for nested structures.
• The deepcopy_with_paths refactor in _files.py and memories.py is a targeted internal improvement; without reviewing the full implementation of deepcopy_with_paths it is hard to confirm full correctness, and it was only partially covered (15/34 files reviewed), leaving some risk in the path-aware deep-copy logic.
• Addition of HYPERSPELL_CUSTOM_HEADERS env var support is a common extension pattern and the approach (injecting headers in both sync/async clients) is standard, representing low risk if header parsing is not overly permissive.
• New integration types (granola, fathom, linear) appear to be additive enum/literal expansions and model field additions — typically low-risk changes that compose well with existing validation patterns.

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

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