Skip to content

[transforms] Add a transform pipeline for the tool catalog : Issue #61 - #84

Closed
Shreyavemana wants to merge 34 commits into
nitrocloudofficial:developfrom
Shreyavemana:feat/61-transform-pipeline-clean
Closed

Shreyavemana wants to merge 34 commits into
nitrocloudofficial:developfrom
Shreyavemana:feat/61-transform-pipeline-clean

Conversation

@Shreyavemana

Copy link
Copy Markdown
Collaborator

Summary

Adds a transform pipeline for the tool catalog, allowing tools/list and tools/call to be rewritten through an ordered chain of transforms.

Changes

  • Added the nitrostack/transforms/ package with McpTransform, McpTransformBase, CatalogTransform, TransformPipeline, and TransformContext.
  • Added @mcp_app(transforms=[...]) support. List transforms execute in declared order, and resolve_tool supports chaining through next.
  • Added re-entrancy support: a synthetic tool can call a real tool through ctx.call_tool(..., caller=name). The issuing transform is skipped, while guards and argument validation are applied to the real tool.
  • Unified argument validation through validate_tool_arguments for normal and re-entrant calls.
  • Transform exceptions are mapped to JSON-RPC errors without stopping the server.
  • Added transform disposal through dispose() during shutdown.
  • Skips the transform pipeline when no transforms are configured.

Tests

  • Pipeline tests: ordering, next chaining, unknown tools, error mapping, disposal order, and duplicate names.
  • Re-entrancy tests: transform skipping and scoped tool calls.
  • App-level tests: tools/list byte-for-byte parity against a pre-change baseline across legacy, auto, and modern protocol eras; transform composition; failing transforms; and shutdown behavior.
  • Targeted test results: 16 passed across test_transforms_pipeline.py, test_transforms_reentrancy.py, and test_transformsapp.py.
  • Full-suite status: one failure remains in tests/test_readme_examples.py::test_building_blocks_run. The AuditLog receives A1 twice instead of once. This appears to be a duplicate event/listener invocation and still needs investigation. Full-suite parity with main has not yet been established.

Dependency

Depends on #22.

manish-wekan and others added 30 commits September 10, 2026 18:05
…ase PR.

Keep pyproject.toml and uv.lock in sync, skip a bump while a version is still unpublished, and only hit the PyPI environment when an upload will actually run.
Bring the bump/publish workflows in line with develop (via main) so the PR can merge.
…ure/release-automation

Automate version bumps and PyPI publishes from main
.env values were written over os.environ unconditionally, so the PORT=3000
that `nitrostack init` puts in .env overrode the PORT a host passes when
starting the server. NitroStudio starts a second project on 3001; it bound
3000 anyway and died with "address already in use" (NITSTD-222).

Keys already in the process environment are now kept, as with
python-dotenv and Node's dotenv. .env still fills keys the process
doesn't set, and defaults stay lowest.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…process-env-wins-over-dotenv

ConfigService: process environment wins over .env
publish.yml only uploads through PyPI trusted publishing, which has never
run here, and the Bump version workflow can't open its release PR (the org
doesn't allow GitHub Actions to create pull requests). The script covers
both: optionally makes release/<next> from origin/main (--bump), checks the
branch matches origin, the lockfile matches and the version is new, runs the
tests, builds, twine-checks, uploads after asking, verifies a clean install
from PyPI, and opens the release PR. `--tag` tags origin/main after the merge.
`--dry-run` stops before anything leaves the machine.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Run from a temp copy: --bump switches branches, which can rewrite the
  script while bash is still reading it.
- --bump plans from origin/main's files in a scratch folder and checks
  everything before switching, so a failed check no longer leaves you on a
  detached origin/main.
- Only a 404 counts as "not on PyPI"; offline or PyPI errors stop the run
  instead of passing the "version is new" check.
- No terminal and no --yes means "no" instead of a silent exit.
- Tag the uploaded commit right after the upload (no separate step that
  could tag later, unreleased merges on main). --tag stays for catching up
  untagged releases and prefers the release branch head.
- A failed PR creation after the upload prints the manual step.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The README is the PyPI project page. Rewrite it for 0.4.x: building
blocks (tools, resources, prompts, guards, auth, caching, rate limits,
tasks, events, health), env precedence, templates, clients.

tests/test_readme_examples.py compiles every python block, checks every
nitrostack import exists, and runs the Quick Start and Building Blocks
examples through the testing harness so the page can't drift.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…e/release-script

Add scripts/release.sh for releasing to PyPI by hand
…/readme-refresh

docs: refresh README (PyPI page) for the current SDK
`nitrostack-py upgrade` failed on every project `init` creates: the
dependency pattern also matched `nitrostack = { path = "vendor/nitrostack" }`
in [tool.uv.sources] and produced an invalid pyproject.toml. Spec rewrites
are now limited to [project].dependencies, and the pattern skips paths
ending in /nitrostack.

Fixing that alone isn't enough: a vendored project runs vendor/nitrostack
whatever spec it declares, and uv accepts a spec the vendored copy doesn't
satisfy. For vendored projects, upgrade now replaces vendor/nitrostack
with the target release (copied from the running CLI when it is that
release, otherwise the PyPI wheel, checked against its sha256). The new
tree is built beside the old one and swapped in, so a failed download
leaves the project as it was.

init's next steps said NitroStudio can't open Python projects; it can.
The pizzaz open-shops hint is printed only for the pizzaz template.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…upgrade-vendored

Fix upgrade on vendored projects; correct init's NitroStudio note
`init` vendors the SDK into vendor/nitrostack. `validate` walked it as
project code, and nitrostack/testing applies @mcp_app to a class defined
inside a function, so every vendored project that imported
nitrostack.testing failed with "uses @mcp_app but no decorated
application class was found after import". Compose's typecheck runs
`validate`, so a NitroStudio build could not get past it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…validate-skip-vendored-sdk

validate: skip the vendored SDK
Align Python pack with the TypeScript CLI: optional inclusion of .env
files in the wheel, with a warning that lists paths without printing values.
…/pack-include-env

pack: add --include-env
…/producthunt-badge

docs: add Product Hunt featured badge to README
…/producthunt-top-post-badge

docs: update Product Hunt badge to nitrocloudofficial#1 Product of the Day top-post badge
@Shreyavemana
Shreyavemana changed the base branch from develop to main October 23, 2026 16:33
@Shreyavemana
Shreyavemana changed the base branch from main to develop October 23, 2026 16:33
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.

4 participants