[PLT-2917] feat: expose toolkit trigger declarations

[TheMostlyGreat]

Summary

• add validated trigger declaration models to arcade-core
• serve declarations from the authenticated GET /worker/triggers endpoint
• discover <toolkit>.trigger_types.trigger_types automatically
• carry declarations through ToolCatalog into the integrated MCP worker
• preserve compatibility for toolkits and workers without trigger support

Verification

• 150 focused core/catalog/worker tests pass
• Ruff passes on changed files
• MyPy passes on changed source files
• clean Python 3.10 wheel smoke test exposes servicetitan.job.completed through /worker/triggers

Tracks the SDK/worker portion of Arcade monorepo ticket J95ZCA.

---

Note

Medium Risk
New worker API surface and load-time validation can block toolkit startup on bad trigger declarations or slug collisions across toolkits; auth behavior on /worker/triggers must match other worker routes.

Overview
Adds toolkit-declared trigger types end to end: a new TriggerType model in arcade-core (webhook/poll metadata, JSON Schema validation for config/payload, duplicate-slug checks at load time) plus optional auto-load from <package>.trigger_types.

ToolCatalog now merges trigger types when toolkits are registered, rejects duplicate slugs as ToolkitLoadError, and skips trigger accumulation when a toolkit is disabled via ARCADE_DISABLED_TOOLKITS (disabled-toolkit matching now uses toolkit.name instead of str(toolkit)).

arcade-serve exposes authenticated GET /worker/triggers (default empty list for workers that do not override get_trigger_types). The integrated MCP worker forwards catalog.trigger_types after startup. Package bumps: arcade-core 4.11.1 (+ jsonschema), arcade-serve 3.4.3, arcade-mcp-server 1.26.1.

^{Reviewed by Cursor Bugbot for commit 900c42b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[codecov]

Codecov Report

❌ Patch coverage is 96.19048% with 4 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
libs/arcade-core/arcade_core/toolkit.py	80.00%	4 Missing ⚠️

Files with missing lines	Coverage Δ
libs/arcade-core/arcade_core/catalog.py	91.66% <100.00%> (+0.47%)	⬆️
libs/arcade-core/arcade_core/triggers.py	100.00% <100.00%> (ø)
libs/arcade-mcp-server/arcade_mcp_server/worker.py	68.22% <100.00%> (+0.14%)	⬆️
libs/arcade-serve/arcade_serve/core/base.py	97.91% <100.00%> (+1.40%)	⬆️
libs/arcade-serve/arcade_serve/core/common.py	86.95% <100.00%> (+1.95%)	⬆️
libs/arcade-serve/arcade_serve/core/components.py	100.00% <100.00%> (ø)
libs/arcade-core/arcade_core/toolkit.py	65.02% <80.00%> (+1.18%)	⬆️

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[greptile-apps]

Greptile Summary

The PR adds validated toolkit trigger declarations and exposes them through the authenticated worker API while preserving compatibility with workers that do not support triggers.

• Discovers and validates toolkit trigger declarations, including both configuration and payload schemas.
• Aggregates declarations through ToolCatalog and registers them with the integrated MCP worker.
• Adds GET /worker/triggers and an empty-envelope fallback for older worker implementations.
• Bumps package versions and inter-library dependency floors to versions containing the new APIs.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
libs/arcade-core/arcade_core/triggers.py	Defines trigger declaration models and validates both configuration and payload JSON schemas, completing the prior schema-validation fix.
libs/arcade-core/arcade_core/toolkit.py	Discovers conventional toolkit trigger declaration modules and converts their entries into validated models.
libs/arcade-core/arcade_core/catalog.py	Aggregates toolkit trigger declarations while rejecting duplicate slugs.
libs/arcade-serve/arcade_serve/core/base.py	Registers validated trigger declarations and exposes them through the worker interface.
libs/arcade-serve/arcade_serve/core/components.py	Adds the worker trigger-declaration endpoint component.
libs/arcade-mcp-server/arcade_mcp_server/worker.py	Carries catalog trigger declarations into the integrated worker.
libs/arcade-mcp-server/pyproject.toml	Raises dependency floors to package versions containing the trigger APIs, completing the prior compatibility fix.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
    A[Toolkit trigger_types.py] --> B[Toolkit discovery and validation]
    B --> C[ToolCatalog aggregation]
    C --> D[Integrated MCP worker registration]
    D --> E[Authenticated GET /worker/triggers]
    F[Worker without trigger support] --> G[Empty trigger_types envelope]

Loading

_{Reviews (2): Last reviewed commit: "style(triggers): format declaration load..." | Re-trigger Greptile}

[TheMostlyGreat]

Addressed all three review findings in 38c8d09: both JSON Schemas now validate at load time, trigger imports use the resolved package name, and all changed libraries have publishable patch versions with dependency floors matching the new APIs. Added regression coverage; 99 focused tests, Ruff, and mypy pass locally.

[greptile-apps]

Your trial has ended. Reactivate Greptile to resume code reviews.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 30fe91c. Configure here.}

[greptile-apps]

Your trial has ended. Reactivate Greptile to resume code reviews.

[github-actions]

This pull request has been automatically marked as stale because it has had no activity for 14 days. It will be closed in 14 days if no further activity occurs. If this is still relevant, please leave a comment or remove the stale label.