Skip to content

feat(appkit): add shared agent types and LLM adapter implementations#282

Closed
MarioCadenas wants to merge 1 commit intomainfrom
agent/1-shared-types-adapters
Closed

feat(appkit): add shared agent types and LLM adapter implementations#282
MarioCadenas wants to merge 1 commit intomainfrom
agent/1-shared-types-adapters

Conversation

@MarioCadenas
Copy link
Copy Markdown
Collaborator

@MarioCadenas MarioCadenas commented Apr 16, 2026

Summary

  • Adds foundational shared types: AgentAdapter, AgentEvent, ResponseStreamEvent, ThreadStore, Message, Thread, ToolProvider, AgentToolDefinition
  • Implements three LLM adapters: DatabricksAdapter (raw fetch + SSE), VercelAIAdapter (AI SDK wrapper), LangChainAdapter (streamEvents v2)
  • Adds subpath exports (@databricks/appkit/agents/databricks, etc.) and optional peer deps
  • Comprehensive test coverage for all adapters

PR Stack

  1. Shared types + Adapters (this PR)
  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 + 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

  • 1585 tests pass
  • Typecheck clean
  • Biome lint clean

Add the foundational types and adapter layer for the agent plugin:

- AgentAdapter interface: async generator contract for LLM backends
- AgentEvent/ResponseStreamEvent: internal and wire protocol types
- ThreadStore/Message/Thread: conversation persistence contracts
- ToolProvider: interface for plugins that expose tools to agents
- DatabricksAdapter: raw fetch to /invocations with SSE parsing
- DatabricksAdapter.fromModelServing(): zero-boilerplate factory that
  auto-creates WorkspaceClient and reads endpoint from env var
- VercelAIAdapter: streamText wrapper for the Vercel AI SDK
- LangChainAdapter: streamEvents v2 wrapper for LangChain Runnables

System prompts are NOT on adapters — adapters are pure transport.
Prompt composition is handled by the agent plugin (see later PRs).

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