feat(distribution): agent guardrails quickstarts and registry listings - #123
Merged
Conversation
Get agent developers to the engine where they already look: - server.json for the official MCP registry (validated against the 2025-12-11 schema; cli/package.json gains the matching mcpName) - Claude Desktop extension manifest (extensions/mcpb) - smithery.yaml starts on the focused core tool profile - npm discovery keywords for @stateset/cli and @stateset/embedded - four runnable guardrails quickstarts (Vercel AI SDK, LangChain, OpenAI tool calls, custom runtime): a governed agent attempts a $250 refund of a $100 payment and receives a sealed kernel receipt with commerce.refund.exceeds_captured, then a legitimate refund succeeds; wired into scripts/ci/check_engine_examples.mjs - README + docs/src/ai-agents.md point at the quickstarts Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Mqdi6x4EceXLbvDnVko4Qb
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.
Why
Issue #30: the engine is built but agent developers can't find it. This PR puts StateSet where they look and gives them a 60-second proof of the core property.
Summary
cli/package.jsongains the matchingmcpNamefor npm ownership validation. Publishing needs a one-timemcp-publisherGitHub auth.extensions/mcpb/manifest.json) wrappingstateset-mcpvia npx with user-configurable db path and tool profile.coretool profile.@stateset/cliand@stateset/embedded(mcp, ai-agents, vercel-ai, langchain, …).examples/agents/: a kernel-governed agent attempts to refund $250 of a $100 payment and gets a sealed receipt withcommerce.refund.exceeds_captured; a legitimate $40 refund then succeeds. Vercel AI SDK, LangChain, OpenAI tool calls, and generic/custom-runtime surfaces.scripts/ci/check_engine_examples.mjs(Node Bindings job), including the exact invariant code.docs/src/ai-agents.mdlink the quickstarts.Verification
node scripts/ci/check_engine_examples.mjs --js-only→ all examples incl. 4 guardrails passserver.jsonvalidates against the registry schema (ajv)🤖 Generated with Claude Code
https://claude.ai/code/session_01Mqdi6x4EceXLbvDnVko4Qb