Skip to content

chore: release v0.3.0#10

Merged
mgoldsborough merged 1 commit into
mainfrom
release/v0.3.0
May 23, 2026
Merged

chore: release v0.3.0#10
mgoldsborough merged 1 commit into
mainfrom
release/v0.3.0

Conversation

@mgoldsborough
Copy link
Copy Markdown
Contributor

Cuts the first synapse-research release that can anchor research on a workspace file via the `ai.nimblebrain/host-resources` extension (Phase 2c).

What ships in v0.3.0

  • New: `seed_uri` parameter on `start_research` — agent passes a `files://` URI; the server reads it via the host-resources extension. Preferred path on hosts that advertise the capability — keeps the agent's context budget free of file bytes.
  • New: `seed_data` parameter on `start_research` — agent passes raw text inline. Universal fallback that works on every host. Required for hosts without the extension.
  • Mutually exclusive: passing both is rejected as ambiguous.
  • Capability- or scheme-missing errors carry the Level-C retry hint ("pass `seed_data` inline") so agents have an actionable recovery path.
  • Seeds above 400 KB are truncated with a visible marker; empty text resources surface a distinct error from binary; the `research_run` entity records `seed_content_chars`.
  • Drive-by: manifest `briefing.priority` corrected from `"normal"` to `"medium"` (was never valid against the platform's host schema enum; blocked install on current platform main).

Closes the original production bug where the agent couldn't anchor a research run on an uploaded workspace file.

Dependency change

  • Adds `nimblebrain-bundle-sdk>=0.1.0` (now on PyPI).

Test plan

  • `uv run pytest tests/` green — 54 passing (43 existing + 11 in `test_seed_uri.py`).
  • Validated end-to-end on a local platform: uploaded a 2,558-byte CSV, called `start_research` with `seed_uri`, confirmed seed content reached the gpt-researcher prompt and `seed_content_chars: 2554` landed on the entity.
  • After merge: create GitHub Release `v0.3.0`. The `Release MCPB Bundle` workflow auto-builds linux-amd64, linux-arm64, darwin-arm64 `.mcpb` bundles and attaches them to the release.
  • Confirm bundles publish to mpak.

Known follow-ups (not blockers)

  • `synapse-research#9` — `start_research` dispatched inline rather than task-augmented; bundle's worker finishes but the agent surfaces a 3-minute timeout. Pre-existing, surfaced during local validation.
  • `upjack#30` — log spam on every `validate_entity` call. Pre-existing.

Minor bump for the seed_uri + seed_data feature add merged in #8
(Phase 2c host-resources SDK adoption). Cuts the first synapse-research
release that can anchor research on a workspace file.

See the GitHub release notes on v0.3.0 for user-visible changes; this
commit only touches manifest.json / pyproject.toml / __init__.py via
`make bump`.
@mgoldsborough mgoldsborough merged commit e0661da into main May 23, 2026
2 checks passed
@mgoldsborough mgoldsborough deleted the release/v0.3.0 branch May 23, 2026 18:09
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