Skip to content

feat(appkit): add createAgent wrapper, agent-app, and API docs#286

Draft
MarioCadenas wants to merge 1 commit intoagent/3-plugin-contextfrom
agent/4-createagent-apps
Draft

feat(appkit): add createAgent wrapper, agent-app, and API docs#286
MarioCadenas wants to merge 1 commit intoagent/3-plugin-contextfrom
agent/4-createagent-apps

Conversation

@MarioCadenas
Copy link
Copy Markdown
Collaborator

@MarioCadenas MarioCadenas commented Apr 16, 2026

Summary

PR 5 of 5 in the agent plugin stack.

  • createAgent(): high-level convenience wrapper around createApp with agent() + server() pre-wired. Normalizes single adapter to { assistant }. Returns AgentHandle with registerAgent, addTools, getTools, getThreads, and plugins.
  • agent-app: standalone reference application with React frontend, Databricks deployment config (databricks.yml), and TailwindCSS
  • dev-playground: adds an agent route with chat UI
  • API reference docs for all agent-related exports (createAgent, AgentHandle, adapters, tools, etc.)
  • Deploy script for agent-app to Databricks workspace

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 — feat(appkit): add PluginContext mediator for inter-plugin communication #285
  5. createAgent + apps + docs (this PR)

Test plan

  • 1678 tests pass
  • Typecheck clean
  • Biome lint clean

Add the final layer for building agent apps end-to-end:

- createAgent(): declarative one-call API that composes server + agent
  plugins, registers code-defined agents and tools, and starts the HTTP
  server with its REST API and SSE streaming.
- agent-app/: example app demonstrating createAgent with config-driven
  agents, function tools, and custom MCP servers.
- Use tool() and mcpServer() helpers in agent-app/server.ts:
  tool() with Zod schemas replaces the hand-written JSON Schema, and
  mcpServer(name, url) replaces the verbose custom_mcp_server wrapper.
- Regenerated typedoc API reference for the new public exports.
- Docs and guides for the agent plugin, tools, and adapter pattern.

Signed-off-by: MarioCadenas <MarioCadenas@users.noreply.github.com>
@MarioCadenas MarioCadenas force-pushed the agent/4-createagent-apps branch from 1df3849 to a681394 Compare April 17, 2026 11:32
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