Repository navigation
v1.3.0 — V1 Plugin Pro upgrade-prompt envelope + 5 new MCP tools surfaced
Companion plugin release to AxonFlow agent v7.7.0. Surfaces the V1
Plugin Pro structured upgrade envelope to the operator on Community
SaaS rate-limit hits and documents 5 new agent-callable MCP tools.
Added
-
V1 Plugin Pro upgrade-prompt envelope handling in both
pre-tool-check.sh(PreToolUse-equivalent) andpost-tool-audit.sh
(PostToolUse-equivalent) hooks. When the agent returns a 429
(daily-quota) or 403 (graduated / Pro-only) with the structured
envelope shape, the plugin:- Parses
upgrade.wording+upgrade.buy_urland prints a single-line
nudge to stderr (e.g.[AxonFlow] Daily limit reached on Free tier (200 events). Pro raises this to 2,000/day. Resets at midnight UTC.).
Surfaced at most once per UTC day so it doesn't spam every hook. - Honours
Retry-After/resets_atby stamping a back-off file at
${XDG_CACHE_HOME:-~/.cache}/axonflow/throttle-until. Subsequent hook
fires fall open locally without re-hammering the agent until the
deadline passes. Prevents the silent-retry pattern (581 retries in
18h pre-envelope) that motivated this work.
- Parses
-
References to the 5 new agent-callable MCP tools in the README.
The agent can answer"what's my tenant ID?","what would I get on Pro?", and related questions directly via:axonflow_get_tenant_id— Free + Pro, no gate.axonflow_list_pro_features— Free + Pro, locked feature list.axonflow_request_approval— Free 1/7d rolling, Pro unlimited.axonflow_create_tenant_policy— Free 2 active max, Pro unlimited.axonflow_get_cost_estimate— Pro-only, hidden from Freetools/list.
Auto-discovered via the existing MCP HTTP transport — no client-side
registration needed.
Changed
- README "Pro tier license token" section corrected to the locked V1
numbers: 2,000 events/day (was 1,000), unlimited custom policies,
unlimited HITL approvals, and the LLM cost pre-flight feature added. - README MCP-tools section renumbered from "10 MCP tools" to "15 MCP
tools" to include the new V1 Pro tier-identity / tier-capability tools. pro-tier-statusskill — prefer the local
scripts/recover.sh statusover the MCP tool for tenant_id / tier
queries. The local script reads state directly and answers without
an agent round-trip. Faster, works offline, and works exactly when
the user typically asks ("the agent isn't reachable, what's my
tenant ID for Stripe Checkout?"). The MCP tool stays as a
documented fallback for the rare cases where server-truth matters
(revocation, clock skew, server-side overrides). Same flip applied
to claude / cursor sister plugins.
Internal
runtime-e2e/v1_pro_envelope_surface/— drives a fresh Free-tier
tenant past the 200/day cap ontry.getaxonflow.com, asserts the
plugin's envelope helper prints the locked V1 wording to stderr
and stamps a throttle deadline.- Added
tests/test-upgrade-prompt.sh— 21 unit assertions across 8
scenarios for every branch of the envelope handler. - Added
tests/test-skill-status-prefers-local.sh— 4 content assertions
locking the local-first SKILL.md ordering in; wired into
.github/workflows/test.yml. The sisteraxonflow-claude-plugin
ships the runtime proof that the wording flip changes downstream
LLM behaviour (structurally identical wording across the three
plugins).