feat(appkit): update tool/mcp API

Signed-off-by: Hubert Zub <hubert.zub@databricks.com>

Author: hubertzub-db

apps/dev-playground/server/index.ts

@@ -43,8 +43,8 @@ createApp({
   ],
   ...(process.env.APPKIT_E2E_TEST && { client: createMockClient() }),
 }).then(async (appkit) => {
-  // Add tools (and optionally MCP servers) after app creation
-  await appkit.agent.addCapabilities({ tools: [demoTools.timeTool] });
+  // Add tools after app creation
+  await appkit.agent.addTools([demoTools.timeTool]);
 
   appkit.server
     .extend((app) => {

docs/docs/api/appkit/Class.StandardAgent.md

@@ -0,0 +1,74 @@
+# Class: StandardAgent
+
+Contract that agent implementations must fulfil.
+
+The plugin calls `invoke()` for non-streaming requests and `stream()` for
+SSE streaming. Implementations are responsible for translating their SDK's
+output into Responses API types.
+
+## Implements
+
+- [`AgentInterface`](Interface.AgentInterface.md)
+
+## Constructors
+
+### Constructor
+
+```ts
+new StandardAgent(agent: LangGraphAgent, systemPrompt: string): StandardAgent;
+```
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `agent` | `LangGraphAgent` |
+| `systemPrompt` | `string` |
+
+#### Returns
+
+`StandardAgent`
+
+## Methods
+
+### invoke()
+
+```ts
+invoke(params: InvokeParams): Promise<ResponseOutputItem[]>;
+```
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `params` | [`InvokeParams`](Interface.InvokeParams.md) |
+
+#### Returns
+
+`Promise`\<[`ResponseOutputItem`](TypeAlias.ResponseOutputItem.md)[]\>
+
+#### Implementation of
+
+[`AgentInterface`](Interface.AgentInterface.md).[`invoke`](Interface.AgentInterface.md#invoke)
+
+***
+
+### stream()
+
+```ts
+stream(params: InvokeParams): AsyncGenerator<ResponseStreamEvent>;
+```
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `params` | [`InvokeParams`](Interface.InvokeParams.md) |
+
+#### Returns
+
+`AsyncGenerator`\<[`ResponseStreamEvent`](TypeAlias.ResponseStreamEvent.md)\>
+
+#### Implementation of
+
+[`AgentInterface`](Interface.AgentInterface.md).[`stream`](Interface.AgentInterface.md#stream)

docs/docs/api/appkit/Function.createInvokeHandler.md

@@ -0,0 +1,18 @@
+# Function: createInvokeHandler()
+
+```ts
+function createInvokeHandler(getAgent: () => AgentInterface): RequestHandler;
+```
+
+Create an Express handler that invokes the agent via the AgentInterface
+and streams/returns the response in Responses API format.
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `getAgent` | () => [`AgentInterface`](Interface.AgentInterface.md) |
+
+## Returns
+
+`RequestHandler`

docs/docs/api/appkit/Function.isFunctionTool.md

@@ -0,0 +1,15 @@
+# Function: isFunctionTool()
+
+```ts
+function isFunctionTool(t: unknown): t is FunctionTool;
+```
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `t` | `unknown` |
+
+## Returns
+
+`t is FunctionTool`

docs/docs/api/appkit/Function.isHostedTool.md

@@ -0,0 +1,15 @@
+# Function: isHostedTool()
+
+```ts
+function isHostedTool(t: unknown): t is HostedTool;
+```
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `t` | `unknown` |
+
+## Returns
+
+`t is HostedTool`

docs/docs/api/appkit/Interface.AgentInterface.md

@@ -22,7 +22,7 @@ invoke(params: InvokeParams): Promise<ResponseOutputItem[]>;
 
 #### Returns
 
-`Promise`\<`ResponseOutputItem`[]\>
+`Promise`\<[`ResponseOutputItem`](TypeAlias.ResponseOutputItem.md)[]\>
 
 ***
 

docs/docs/api/appkit/Interface.CustomMcpServerTool.md

@@ -0,0 +1,32 @@
+# Interface: CustomMcpServerTool
+
+## Properties
+
+### custom\_mcp\_server
+
+```ts
+custom_mcp_server: {
+  app_name: string;
+  app_url: string;
+};
+```
+
+#### app\_name
+
+```ts
+app_name: string;
+```
+
+#### app\_url
+
+```ts
+app_url: string;
+```
+
+***
+
+### type
+
+```ts
+type: "custom_mcp_server";
+```

docs/docs/api/appkit/Interface.ExternalMcpServerTool.md

@@ -0,0 +1,25 @@
+# Interface: ExternalMcpServerTool
+
+## Properties
+
+### external\_mcp\_server
+
+```ts
+external_mcp_server: {
+  connection_name: string;
+};
+```
+
+#### connection\_name
+
+```ts
+connection_name: string;
+```
+
+***
+
+### type
+
+```ts
+type: "external_mcp_server";
+```

docs/docs/api/appkit/Interface.GenieTool.md

@@ -0,0 +1,31 @@
+# Interface: GenieTool
+
+OpenResponses-style hosted tool definitions for Databricks services.
+
+These types follow the OpenResponses convention of discriminating on `type`.
+Internally, each hosted tool is resolved to a DatabricksMCPServer instance
+so the agent can call managed MCP endpoints on the workspace.
+
+## Properties
+
+### genie\_space
+
+```ts
+genie_space: {
+  id: string;
+};
+```
+
+#### id
+
+```ts
+id: string;
+```
+
+***
+
+### type
+
+```ts
+type: "genie";
+```

docs/docs/api/appkit/Interface.IAgentConfig.md

@@ -49,16 +49,6 @@ Max tokens to generate (default 2000). Ignored when `agentInstance` is provided.
 
 ***
 
-### mcpServers?
-
-```ts
-optional mcpServers: DatabricksMCPServer[];
-```
-
-MCP servers for Databricks tool integration. Ignored when `agentInstance` is provided.
-
-***
-
 ### model?
 
 ```ts
@@ -121,8 +111,10 @@ Sampling temperature (0.0-1.0, default 0.1). Ignored when `agentInstance` is pro
 optional tools: AgentTool[];
 ```
 
-Tools to register with the agent. Accepts OpenResponses-aligned FunctionTool
-objects or LangChain StructuredToolInterface instances.
+Tools to register with the agent. Accepts:
+- OpenResponses-aligned `FunctionTool` objects (local tool with execute handler)
+- Databricks hosted tools (`genie`, `vector_search_index`, `custom_mcp_server`, `external_mcp_server`)
+
 Ignored when `agentInstance` is provided.
 
 ***