Evolve from scenario registry to full example showcase service#1
Merged
ajit-zer07 merged 1 commit intomainfrom Mar 27, 2026
Merged
Evolve from scenario registry to full example showcase service#1ajit-zer07 merged 1 commit intomainfrom
ajit-zer07 merged 1 commit intomainfrom
Conversation
Add example-agent hosting, control-plane integration, and end-to-end
example run flow so the service can demonstrate complete MACP scenarios
(compile → bootstrap agents → submit to control plane) from a single
API call.
Key changes:
- Add POST /examples/run endpoint for full showcase flow
- Extract compiler and template-resolver into src/compiler/ module
- Add example-agents catalog (fraud, growth, risk) with framework metadata
- Add hosting layer with pluggable ExampleAgentHostProvider (default: in-memory)
- Add control-plane HTTP client for /runs/validate and /runs
- Add ApiKeyGuard middleware and rate limiting (Throttler, 100 req/min)
- Extend registry contracts with runtime selection, payload envelopes,
kickoff kinds, execution metadata, and participant transport identities
- Add CORS wildcard pattern support for Vercel preview URLs
- Add Dockerfile HEALTHCHECK, Railway deploy config, and CI workflow
- Add CLAUDE.md, SECURITY.md, and docs/ (architecture, API ref, authoring guide)
- Update README to reflect new showcase-oriented architecture
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
/examples/runendpoint that orchestrates the full showcase flow: compile anExecutionRequest from scenario inputs, bootstrap example agents with transport identities,
and optionally validate/submit the run to the MACP control plane.
src/launch/into its ownsrc/compiler/module — same AJVvalidation and
{{ inputs.* }}template resolution logic, now with richer contract support(payload envelopes, kickoff kinds, execution metadata, runtime selection).
growth/LangChain, risk/custom) with a pluggable
ExampleAgentHostProviderinterface. Thedefault
InMemoryExampleAgentHostProvidergenerates manifest-only bootstrap results; swapit in
AppModuleto wire a real agent runtime.src/control-plane/) for validating and submitting runs to anexternal MACP control plane via HTTP.
ApiKeyGuard(optional, viaAUTH_API_KEYS),@nestjs/throttlerrate limiting (100 req/min), CORS wildcard pattern matching,
GlobalExceptionFilter.HEALTHCHECK,railway.jsondeploy config, GitHub ActionsCI workflow (lint, build, unit tests, E2E).
CLAUDE.md,SECURITY.md,docs/architecture.md,docs/api-reference.md,docs/scenario-authoring.md.RuntimeSelectionTemplate,PayloadEnvelope,KickoffKind,executionblock, participanttransportIdentity/metadata, andpolicyVersion/initiatorParticipantIdon launch config.Test plan
npm test— 117 unit tests pass (includes new specs for compiler, hosting, example-agentcatalog, control-plane client, ApiKeyGuard, correlation-id and request-logger middleware)
npm run test:e2e— 13 E2E tests pass (includes new/examples/runand updated/launch/compiletests)npm run lint && npm run build— no lint errors, clean TypeScript compilationdocker compose -f docker-compose.dev.yml up— service starts, healthcheck passes/examples/runwithsubmitToControlPlane: falsereturns compiled resultand hosted agent manifests without requiring a running control plane