Skip to content

feat(appkit): add PluginContext mediator for inter-plugin communication#285

Closed
MarioCadenas wants to merge 1 commit intoagent/2b-plugin-corefrom
agent/3-plugin-context
Closed

feat(appkit): add PluginContext mediator for inter-plugin communication#285
MarioCadenas wants to merge 1 commit intoagent/2b-plugin-corefrom
agent/3-plugin-context

Conversation

@MarioCadenas
Copy link
Copy Markdown
Collaborator

@MarioCadenas MarioCadenas commented Apr 16, 2026

Summary

Introduces a PluginContext class that mediates all inter-plugin communication:

  • Route buffering: addRoute() buffers until the server registers via registerAsRouteTarget(), then flushes via addExtension() — eliminates plugin ordering fragility
  • ToolProvider registry: typed, live discovery replacing duck-typed config.plugins snapshot
  • executeTool(): user-scoped tool execution with automatic telemetry (context-owned span, 30s timeout)
  • Lifecycle hooks: setup:complete, server:ready, shutdown coordination

Migrates the agent plugin from config.plugins to context methods. Migrates the server plugin from config.plugins to context.getPlugins(). Removes the deprecated plugins extraData.

PR Stack

  1. Shared types + Adapters — feat(appkit): add shared agent types and LLM adapter implementations #282
  2. Tool types + MCP client — feat(appkit): add FunctionTool, HostedTool types and MCP client #283
  3. Agent plugin core + ToolProvider implementations — feat(appkit): add agent plugin core and ToolProvider implementations #284
  4. PluginContext mediator (this PR)
  5. createAgent + agent-app + docs (v1) — feat(appkit): add createAgent wrapper, agent-app, and API docs #286
  6. Plugin context-binding separation — refactor(appkit): separate plugin context binding from plugin construction #293
  7. agents() plugin + createAgent(def) + .toolkit()feat(appkit): add agents() plugin, createAgent() factory, and .toolkit() #294
  8. agent-app + docs migrated to agents()feat(appkit): migrate agent-app and docs to the new agents() plugin #295
  9. Relocate shared agent utilities — refactor(appkit): relocate shared agent utilities into plugins/agents #296
  10. preparePlugins forwards eager instance — refactor(appkit): forward eager plugin instance through preparePlugins #297
  11. fromPlugin() API — feat(appkit): add fromPlugin() for referencing plugin tools in code-defined agents #298
  12. Retire deprecated agent() + createAgentAppchore(appkit): remove deprecated agent() plugin and createAgentApp shortcut #299
  13. Retire toPluginWithInstance + bug fixes — refactor(appkit): retire toPluginWithInstance; consolidate on fromPlugin + fix schema/routing bugs #300

Test plan

  • 1668 tests pass (24 new for PluginContext)
  • Typecheck clean
  • Biome lint clean

Introduce a PluginContext class that the AppKit core creates and passes
to every plugin, mediating all inter-plugin communication:

- Route buffering: addRoute() buffers until server registers via
  registerAsRouteTarget(), then flushes via addExtension()
- ToolProvider registry: typed, live discovery (not frozen snapshots)
- executeTool(): user-scoped tool execution with automatic telemetry
- Lifecycle hooks: setup:complete, server:ready, shutdown coordination

Migrates agent plugin from config.plugins to context methods.
Updates layered prompt to use context.getPluginNames() for base prompt.
Migrates server plugin from config.plugins to context.getPlugins().
Removes the deprecated plugins extraData for deferred plugins.

Signed-off-by: MarioCadenas <MarioCadenas@users.noreply.github.com>
@MarioCadenas
Copy link
Copy Markdown
Collaborator Author

Superseded by the v2 6-PR stack:

  1. Shared agent types + LLM adapters — feat(appkit): shared agent types and LLM adapter implementations #301
  2. Tool primitives + ToolProvider surfaces — feat(appkit): tool primitives and ToolProvider surfaces on core plugins #302
  3. Plugin infrastructure (attachContext + PluginContext) — feat(appkit): plugin infrastructure — attachContext + PluginContext mediator #303
  4. agents() plugin + createAgent(def) + markdown-driven agents — feat(appkit): agents() plugin, createAgent(def), and markdown-driven agents #304
  5. fromPlugin() DX + runAgent plugins arg + toolkit-resolver — feat(appkit): fromPlugin() DX, runAgent plugins arg, shared toolkit-resolver #305
  6. Reference app + dev-playground + docs — feat(appkit): reference agent-app, dev-playground chat UI, docs, and template #306

The v2 stack reorganizes the same work so no PR ships API that a later PR deletes. Start at #301 for the new entry point. Branches from this older stack are preserved unchanged.

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.

1 participant