@databricks/appkit 0.31.0 → 0.33.0

package/dist/shared/src/agent.d.ts

@@ -1,8 +1,39 @@
 import { JSONSchema7 } from "json-schema";
 
 //#region ../shared/src/agent.d.ts
+/**
+ * Semantic hint for what the tool does to the world. Drives both the
+ * agents-plugin approval gate and the client's approval-card styling.
+ *
+ * - `read` — observes only; never needs approval.
+ * - `write` — creates or appends new state (e.g. saving a new view). Approval
+ *   required by default. Rendered as a low-severity "writes" card.
+ * - `update` — mutates existing state in place (e.g. renaming, toggling).
+ *   Approval required. Rendered as a medium-severity "updates" card.
+ * - `destructive` — deletes or irreversibly mutates (e.g. dropping a view).
+ *   Approval required. Rendered as a high-severity "destructive" card.
+ *
+ * Prefer this over the legacy `readOnly`/`destructive` booleans: it lets the
+ * UI distinguish "captured a screenshot" from "deleted a dashboard", both of
+ * which today are lumped under a single red "destructive" label.
+ */
+type ToolEffect = "read" | "write" | "update" | "destructive";
 interface ToolAnnotations {
+  /**
+   * Preferred semantic label. When set, drives both the approval gate (fires
+   * for `write`/`update`/`destructive`) and the approval-card styling.
+   */
+  effect?: ToolEffect;
+  /**
+   * @deprecated Prefer {@link effect}. Retained for backward compatibility
+   * with tools authored against the original flags and for MCP interop.
+   */
   readOnly?: boolean;
+  /**
+   * @deprecated Prefer {@link effect} with value `"destructive"`. Retained
+   * so existing annotations continue to force the approval gate, and so
+   * MCP-style consumers that only read `destructive` still see the hint.
+   */
   destructive?: boolean;
   idempotent?: boolean;
   requiresUserContext?: boolean;
@@ -13,6 +44,10 @@ interface AgentToolDefinition {
   parameters: JSONSchema7;
   annotations?: ToolAnnotations;
 }
+interface ToolProvider {
+  getAgentTools(): AgentToolDefinition[];
+  executeAgentTool(name: string, args: unknown, signal?: AbortSignal): Promise<unknown>;
+}
 interface Message {
   id: string;
   role: "user" | "assistant" | "system" | "tool";
@@ -25,6 +60,30 @@ interface ToolCall {
   id: string;
   name: string;
   args: unknown;
+  /**
+   * Vendor-opaque "thought signature" blob attached by Vertex AI / Gemini
+   * 2.x models to every function call they emit. Resumed threads must
+   * echo this back verbatim on the next request or Vertex rejects with
+   * `INVALID_ARGUMENT: function call X is missing a thought_signature`.
+   * Stored here so adapters can preserve it across persistence
+   * boundaries. Non-Gemini endpoints leave this undefined.
+   * See https://docs.cloud.google.com/vertex-ai/generative-ai/docs/thought-signatures
+   */
+  thoughtSignature?: string;
+}
+interface Thread {
+  id: string;
+  userId: string;
+  messages: Message[];
+  createdAt: Date;
+  updatedAt: Date;
+}
+interface ThreadStore {
+  create(userId: string): Promise<Thread>;
+  get(threadId: string, userId: string): Promise<Thread | null>;
+  list(userId: string): Promise<Thread[]>;
+  addMessage(threadId: string, userId: string, message: Message): Promise<void>;
+  delete(threadId: string, userId: string): Promise<boolean>;
 }
 type AgentEvent = {
   type: "message_delta";
@@ -52,6 +111,21 @@ type AgentEvent = {
 } | {
   type: "metadata";
   data: Record<string, unknown>;
+} | {
+  /**
+   * Emitted by the agents plugin (not adapters) when a mutating tool call
+   * is awaiting human approval — fires for tools annotated with
+   * `effect: "write" | "update" | "destructive"` (preferred) or the
+   * legacy `destructive: true` boolean. Clients should render an approval
+   * prompt and POST to `/chat/approve` with the matching `approvalId` and
+   * a `decision` of `approve` or `deny`.
+   */
+  type: "approval_pending";
+  approvalId: string;
+  streamId: string;
+  toolName: string;
+  args: unknown;
+  annotations?: ToolAnnotations;
 };
 interface AgentInput {
   messages: Message[];
@@ -68,5 +142,5 @@ interface AgentAdapter {
   run(input: AgentInput, context: AgentRunContext): AsyncGenerator<AgentEvent, void, unknown>;
 }
 //#endregion
-export { AgentAdapter, AgentEvent, AgentInput, AgentRunContext, AgentToolDefinition, Message, ToolAnnotations, ToolCall };
+export { AgentAdapter, AgentEvent, AgentInput, AgentRunContext, AgentToolDefinition, Message, Thread, ThreadStore, ToolAnnotations, ToolCall, ToolEffect, ToolProvider };
 //# sourceMappingURL=agent.d.ts.map

package/dist/shared/src/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","names":[],"sources":["../../../../shared/src/agent.ts"],"mappings":";;;UAMiB,eAAA;EACf,QAAA;EACA,WAAA;EACA,UAAA;EACA,mBAAA;AAAA;AAAA,UAGe,mBAAA;EACf,IAAA;EACA,WAAA;EACA,UAAA,EAAY,WAAA;EACZ,WAAA,GAAc,eAAA;AAAA;AAAA,UAgBC,OAAA;EACf,EAAA;EACA,IAAA;EACA,OAAA;EACA,UAAA;EACA,SAAA,GAAY,QAAA;EACZ,SAAA,EAAW,IAAA;AAAA;AAAA,UAGI,QAAA;EACf,EAAA;EACA,IAAA;EACA,IAAA;AAAA;AAAA,KA2BU,UAAA;EACN,IAAA;EAAuB,OAAA;AAAA;EACvB,IAAA;EAAiB,OAAA;AAAA;EACjB,IAAA;EAAmB,MAAA;EAAgB,IAAA;EAAc,IAAA;AAAA;EAEjD,IAAA;EACA,MAAA;EACA,MAAA;EACA,KAAA;AAAA;EAEA,IAAA;EAAkB,OAAA;AAAA;EAElB,IAAA;EACA,MAAA;EACA,KAAA;AAAA;EAEA,IAAA;EAAkB,IAAA,EAAM,MAAA;AAAA;AAAA,UA0Gb,UAAA;EACf,QAAA,EAAU,OAAA;EACV,KAAA,EAAO,mBAAA;EACP,QAAA;EACA,MAAA,GAAS,WAAA;AAAA;AAAA,UAGM,eAAA;;EAEf,WAAA,GAAc,IAAA,UAAc,IAAA,cAAkB,OAAA;EAC9C,MAAA,GAAS,WAAA;AAAA;AAAA,UAGM,YAAA;EACf,GAAA,CACE,KAAA,EAAO,UAAA,EACP,OAAA,EAAS,eAAA,GACR,cAAA,CAAe,UAAA;AAAA"}
+{"version":3,"file":"agent.d.ts","names":[],"sources":["../../../../shared/src/agent.ts"],"mappings":";;;;;AAsBA;;;;;AAEA;;;;;;;;;KAFY,UAAA;AAAA,UAEK,eAAA;EAkBI;AAGrB;;;EAhBE,MAAA,GAAS,UAAA;EAiBT;;;;EAZA,QAAA;EAec;;;AAGhB;;EAZE,WAAA;EACA,UAAA;EACA,mBAAA;AAAA;AAAA,UAGe,mBAAA;EACf,IAAA;EACA,WAAA;EACA,UAAA,EAAY,WAAA;EACZ,WAAA,GAAc,eAAA;AAAA;AAAA,UAGC,YAAA;EACf,aAAA,IAAiB,mBAAA;EACjB,gBAAA,CACE,IAAA,UACA,IAAA,WACA,MAAA,GAAS,WAAA,GACR,OAAA;AAAA;AAAA,UAOY,OAAA;EACf,EAAA;EACA,IAAA;EACA,OAAA;EACA,UAAA;EACA,SAAA,GAAY,QAAA;EACZ,SAAA,EAAW,IAAA;AAAA;AAAA,UAGI,QAAA;EACf,EAAA;EACA,IAAA;EACA,IAAA;EANA;;;;AAGF;;;;;EAaE,gBAAA;AAAA;AAAA,UAGe,MAAA;EACf,EAAA;EACA,MAAA;EACA,QAAA,EAAU,OAAA;EACV,SAAA,EAAW,IAAA;EACX,SAAA,EAAW,IAAA;AAAA;AAAA,UAOI,WAAA;EACf,MAAA,CAAO,MAAA,WAAiB,OAAA,CAAQ,MAAA;EAChC,GAAA,CAAI,QAAA,UAAkB,MAAA,WAAiB,OAAA,CAAQ,MAAA;EAC/C,IAAA,CAAK,MAAA,WAAiB,OAAA,CAAQ,MAAA;EAC9B,UAAA,CAAW,QAAA,UAAkB,MAAA,UAAgB,OAAA,EAAS,OAAA,GAAU,OAAA;EAChE,MAAA,CAAO,QAAA,UAAkB,MAAA,WAAiB,OAAA;AAAA;AAAA,KAOhC,UAAA;EACN,IAAA;EAAuB,OAAA;AAAA;EACvB,IAAA;EAAiB,OAAA;AAAA;EACjB,IAAA;EAAmB,MAAA;EAAgB,IAAA;EAAc,IAAA;AAAA;EAEjD,IAAA;EACA,MAAA;EACA,MAAA;EACA,KAAA;AAAA;EAEA,IAAA;EAAkB,OAAA;AAAA;EAElB,IAAA;EACA,MAAA;EACA,KAAA;AAAA;EAEA,IAAA;EAAkB,IAAA,EAAM,MAAA;AAAA;EA1BN;;;;;;;;EAoClB,IAAA;EACA,UAAA;EACA,QAAA;EACA,QAAA;EACA,IAAA;EACA,WAAA,GAAc,eAAA;AAAA;AAAA,UA+HH,UAAA;EACf,QAAA,EAAU,OAAA;EACV,KAAA,EAAO,mBAAA;EACP,QAAA;EACA,MAAA,GAAS,WAAA;AAAA;AAAA,UAGM,eAAA;;EAEf,WAAA,GAAc,IAAA,UAAc,IAAA,cAAkB,OAAA;EAC9C,MAAA,GAAS,WAAA;AAAA;AAAA,UAGM,YAAA;EACf,GAAA,CACE,KAAA,EAAO,UAAA,EACP,OAAA,EAAS,eAAA,GACR,cAAA,CAAe,UAAA;AAAA"}

package/dist/shared/src/index.d.ts

@@ -1,4 +1,4 @@
-import { AgentAdapter, AgentEvent, AgentInput, AgentRunContext, AgentToolDefinition, Message, ToolAnnotations, ToolCall } from "./agent.js";
+import { AgentAdapter, AgentEvent, AgentInput, AgentRunContext, AgentToolDefinition, Message, Thread, ThreadStore, ToolAnnotations, ToolCall, ToolEffect, ToolProvider } from "./agent.js";
 import { ResourceFieldEntry } from "./schemas/plugin-manifest.generated.js";
 import { BasePlugin, BasePluginConfig, HttpMethod, IAppRequest, IAppResponse, IAppRouter, PluginConstructor, PluginData, PluginEndpointMap, PluginExports, PluginManifest, PluginMap, PluginPhase, ResourceRequirement, RouteConfig, TelemetryOptions, ToPlugin, WithAsUser } from "./plugin.js";
 import { CacheConfig, CacheEntry, CacheStorage } from "./cache.js";

package/dist/shared/src/plugin.d.ts

@@ -13,6 +13,14 @@ interface BasePlugin {
   getSkipBodyParsingPaths?(): ReadonlySet<string>;
   exports?(): unknown;
   clientConfig?(): Record<string, unknown>;
+  /**
+   * Binds runtime dependencies (telemetry, cache, plugin context) after the
+   * plugin has been constructed. Called by the AppKit core before `setup()`.
+   */
+  attachContext?(deps: {
+    context?: unknown;
+    telemetryConfig?: TelemetryOptions;
+  }): void;
 }
 /** Base configuration interface for AppKit plugins */
 interface BasePluginConfig {

package/dist/shared/src/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../../../shared/src/plugin.ts"],"mappings":";;;;;;UAYiB,UAAA;EACf,IAAA;EAEA,qBAAA;EAEA,KAAA,IAAS,OAAA;EAET,YAAA,CAAa,MAAA,EAAQ,OAAA,CAAQ,MAAA;EAE7B,YAAA,IAAgB,iBAAA;EAEhB,uBAAA,KAA4B,WAAA;EAE5B,OAAA;EAEA,YAAA,KAAiB,MAAA;AAAA;;UAIF,gBAAA;EACf,IAAA;EACA,IAAA;EAAA,CAEC,GAAA;EAMD,SAAA,GAAY,gBAAA;AAAA;AAAA,KAGF,gBAAA;EAGN,MAAA;EACA,OAAA;EACA,IAAA;AAAA;AAAA,KAQM,WAAA;AA1BZ;;;;AAAA,KAgCY,iBAAA,KACN,gBAAA,YACM,UAAA,GAAa,UAAA,UAEvB,MAAA,EAAQ,CAAA,KACL,CAAA;EACH,cAAA,GAAiB,MAAA;EACjB,KAAA,GAAQ,WAAA;EA7BR;;;;EAkCA,QAAA,EAAU,cAAA;EA/BgB;;;;EAoC1B,uBAAA,EAAyB,MAAA,EAAQ,CAAA,GAAI,mBAAA;AAAA;;;AAvBvC;;;;;AAMA;;UA6BiB,cAAA,wCACP,IAAA,CACN,gBAAA;EAGF,IAAA,EAAM,KAAA;EACN,SAAA;IACE,QAAA,EAAU,IAAA,CAAK,mBAAA;IACf,QAAA,EAAU,IAAA,CAAK,mBAAA;EAAA;EAEjB,MAAA;IACE,MAAA,EAAQ,WAAA;EAAA;AAAA;;;;;;;;;UAYK,mBAAA,SAA4B,qBAAA;EAC3C,MAAA,EAAQ,MAAA,SAAe,kBAAA;EACvB,QAAA;AAAA;;;;;;KAoCU,aAAA,WAAwB,UAAA,IAClC,CAAA,sCAAqC,CAAA,GAAI,MAAA;;;;;;;;KAS/B,UAAA,QAAkB,GAAA,cAAgB,IAAA,mBAC1C,GAAA,GACA,GAAA;EAlEU;;;;;EAwER,MAAA,GAAS,GAAA,EAAK,WAAA,KAAgB,GAAA;AAAA;;;;AAxDpC;;;;;KAmEY,SAAA,oBACS,UAAA,CAAW,iBAAA,gCAExB,CAAA,YAAa,CAAA,WAAY,UAAA,CAC7B,aAAA,CAAc,YAAA,CAAa,CAAA;;KAKnB,UAAA;EAAwB,MAAA,EAAQ,CAAA;EAAG,MAAA,EAAQ,CAAA;EAAG,IAAA,EAAM,CAAA;AAAA;;KAEpD,QAAA,4BACV,MAAA,GAAS,CAAA,KACN,UAAA,CAAW,CAAA,EAAG,CAAA,EAAG,CAAA;;KAGV,UAAA,GAAa,OAAA,CAAQ,MAAA;AAAA,KACrB,YAAA,GAAe,OAAA,CAAQ,QAAA;AAAA,KACvB,WAAA,GAAc,OAAA,CAAQ,OAAA;AAAA,KAEtB,UAAA;AAAA,KAEA,WAAA;EAlDqC,+DAoD/C,IAAA;EACA,MAAA,EAAQ,UAAA;EACR,IAAA;EACA,OAAA,GAAU,GAAA,EAAK,WAAA,EAAa,GAAA,EAAK,YAAA,KAAiB,OAAA,QAvDb;EAyDrC,eAAA;AAAA;;KAIU,iBAAA,GAAoB,MAAA"}
+{"version":3,"file":"plugin.d.ts","names":[],"sources":["../../../../shared/src/plugin.ts"],"mappings":";;;;;;UAYiB,UAAA;EACf,IAAA;EAEA,qBAAA;EAEA,KAAA,IAAS,OAAA;EAET,YAAA,CAAa,MAAA,EAAQ,OAAA,CAAQ,MAAA;EAE7B,YAAA,IAAgB,iBAAA;EAEhB,uBAAA,KAA4B,WAAA;EAE5B,OAAA;EAEA,YAAA,KAAiB,MAAA;EAQmB;;;;EAFpC,aAAA,EAAe,IAAA;IACb,OAAA;IACA,eAAA,GAAkB,gBAAA;EAAA;AAAA;;UAKL,gBAAA;EACf,IAAA;EACA,IAAA;EAAA,CAEC,GAAA;EAMD,SAAA,GAAY,gBAAA;AAAA;AAAA,KAGF,gBAAA;EAGN,MAAA;EACA,OAAA;EACA,IAAA;AAAA;AAAA,KAQM,WAAA;;;;;KAMA,iBAAA,KACN,gBAAA,YACM,UAAA,GAAa,UAAA,UAEvB,MAAA,EAAQ,CAAA,KACL,CAAA;EACH,cAAA,GAAiB,MAAA;EACjB,KAAA,GAAQ,WAAA;EA7BoB;;AAG9B;;EA+BE,QAAA,EAAU,cAAA;EA/BgB;;;;EAoC1B,uBAAA,EAAyB,MAAA,EAAQ,CAAA,GAAI,mBAAA;AAAA;AAvBvC;;;;;AAMA;;;;AANA,UAmCiB,cAAA,wCACP,IAAA,CACN,gBAAA;EAGF,IAAA,EAAM,KAAA;EACN,SAAA;IACE,QAAA,EAAU,IAAA,CAAK,mBAAA;IACf,QAAA,EAAU,IAAA,CAAK,mBAAA;EAAA;EAEjB,MAAA;IACE,MAAA,EAAQ,WAAA;EAAA;AAAA;;;;;;;;;UAYK,mBAAA,SAA4B,qBAAA;EAC3C,MAAA,EAAQ,MAAA,SAAe,kBAAA;EACvB,QAAA;AAAA;;;;;;KAoCU,aAAA,WAAwB,UAAA,IAClC,CAAA,sCAAqC,CAAA,GAAI,MAAA;;;;;;;;KAS/B,UAAA,QAAkB,GAAA,cAAgB,IAAA,mBAC1C,GAAA,GACA,GAAA;EAjEA;;;;;EAuEE,MAAA,GAAS,GAAA,EAAK,WAAA,KAAgB,GAAA;AAAA;;AAxDpC;;;;;;;KAmEY,SAAA,oBACS,UAAA,CAAW,iBAAA,gCAExB,CAAA,YAAa,CAAA,WAAY,UAAA,CAC7B,aAAA,CAAc,YAAA,CAAa,CAAA;;KAKnB,UAAA;EAAwB,MAAA,EAAQ,CAAA;EAAG,MAAA,EAAQ,CAAA;EAAG,IAAA,EAAM,CAAA;AAAA;;KAEpD,QAAA,4BACV,MAAA,GAAS,CAAA,KACN,UAAA,CAAW,CAAA,EAAG,CAAA,EAAG,CAAA;;KAGV,UAAA,GAAa,OAAA,CAAQ,MAAA;AAAA,KACrB,YAAA,GAAe,OAAA,CAAQ,QAAA;AAAA,KACvB,WAAA,GAAc,OAAA,CAAQ,OAAA;AAAA,KAEtB,UAAA;AAAA,KAEA,WAAA;EAnDwB,+DAqDlC,IAAA;EACA,MAAA,EAAQ,UAAA;EACR,IAAA;EACA,OAAA,GAAU,GAAA,EAAK,WAAA,EAAa,GAAA,EAAK,YAAA,KAAiB,OAAA,QAvDH;EAyD/C,eAAA;AAAA;;KAIU,iBAAA,GAAoB,MAAA"}

package/docs/api/appkit/Class.AppKitMcpClient.md

@@ -0,0 +1,157 @@
+# Class: AppKitMcpClient
+
+Lightweight MCP client for Databricks-hosted MCP servers.
+
+Uses raw fetch() with JSON-RPC 2.0 over HTTP — no @modelcontextprotocol/sdk or LangChain dependency. Supports the Streamable HTTP transport only (POST with JSON-RPC request, single JSON-RPC response). Implements exactly four methods: `initialize`, `notifications/initialized`, `tools/list`, `tools/call`. No prompts/resources/completion/sampling.
+
+All outbound URLs are gated by an McpHostPolicy: unallowlisted hosts are rejected before the first byte is sent, and workspace credentials are only forwarded to the same-origin workspace. See `mcp-host-policy.ts`.
+
+Rationale for hand-rolling JSON-RPC instead of `@modelcontextprotocol/sdk`: see the file-level comment at the top of this module.
+
+## Constructors[​](#constructors "Direct link to Constructors")
+
+### Constructor[​](#constructor "Direct link to Constructor")
+
+```ts
+new AppKitMcpClient(
+   workspaceHost: string, 
+   authenticate: () => Promise<Record<string, string>>, 
+   policy: McpHostPolicy, 
+   options: {
+  dnsLookup?: DnsLookup;
+  fetchImpl?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+}): AppKitMcpClient;
+
+```
+
+#### Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter            | Type                                                                                                                                     |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `workspaceHost`      | `string`                                                                                                                                 |
+| `authenticate`       | () => `Promise`<`Record`<`string`, `string`>>                                                                                            |
+| `policy`             | `McpHostPolicy`                                                                                                                          |
+| `options`            | { `dnsLookup?`: `DnsLookup`; `fetchImpl?`: (`input`: `string` \| `URL` \| `Request`, `init?`: `RequestInit`) => `Promise`<`Response`>; } |
+| `options.dnsLookup?` | `DnsLookup`                                                                                                                              |
+| `options.fetchImpl?` | (`input`: `string` \| `URL` \| `Request`, `init?`: `RequestInit`) => `Promise`<`Response`>                                               |
+
+#### Returns[​](#returns "Direct link to Returns")
+
+`AppKitMcpClient`
+
+## Methods[​](#methods "Direct link to Methods")
+
+### callTool()[​](#calltool "Direct link to callTool()")
+
+```ts
+callTool(
+   qualifiedName: string, 
+   args: unknown, 
+   authHeaders?: Record<string, string>, 
+callerSignal?: AbortSignal): Promise<string>;
+
+```
+
+#### Parameters[​](#parameters-1 "Direct link to Parameters")
+
+| Parameter       | Type                         |
+| --------------- | ---------------------------- |
+| `qualifiedName` | `string`                     |
+| `args`          | `unknown`                    |
+| `authHeaders?`  | `Record`<`string`, `string`> |
+| `callerSignal?` | `AbortSignal`                |
+
+#### Returns[​](#returns-1 "Direct link to Returns")
+
+`Promise`<`string`>
+
+***
+
+### canForwardWorkspaceAuth()[​](#canforwardworkspaceauth "Direct link to canForwardWorkspaceAuth()")
+
+```ts
+canForwardWorkspaceAuth(serverName: string): boolean;
+
+```
+
+Whether the named MCP server may receive workspace-scoped auth headers (e.g., an OBO bearer token from an end-user request). Callers should gate auth-forwarding decisions on this to prevent credential exfiltration to non-workspace hosts.
+
+#### Parameters[​](#parameters-2 "Direct link to Parameters")
+
+| Parameter    | Type     |
+| ------------ | -------- |
+| `serverName` | `string` |
+
+#### Returns[​](#returns-2 "Direct link to Returns")
+
+`boolean`
+
+***
+
+### close()[​](#close "Direct link to close()")
+
+```ts
+close(): Promise<void>;
+
+```
+
+#### Returns[​](#returns-3 "Direct link to Returns")
+
+`Promise`<`void`>
+
+***
+
+### connect()[​](#connect "Direct link to connect()")
+
+```ts
+connect(endpoint: McpEndpointConfig): Promise<void>;
+
+```
+
+#### Parameters[​](#parameters-3 "Direct link to Parameters")
+
+| Parameter  | Type                |
+| ---------- | ------------------- |
+| `endpoint` | `McpEndpointConfig` |
+
+#### Returns[​](#returns-4 "Direct link to Returns")
+
+`Promise`<`void`>
+
+***
+
+### connectAll()[​](#connectall "Direct link to connectAll()")
+
+```ts
+connectAll(endpoints: McpEndpointConfig[]): Promise<McpConnectAllResult>;
+
+```
+
+Connects every endpoint in parallel and returns a structured summary so callers can distinguish "all connected" from "some failed".
+
+Returning the result instead of throwing is deliberate: one misconfigured MCP server should not take down the entire agents plugin at boot, and the agents plugin uses the summary to warn at startup with the failed-endpoint names. Errors are also logged here so a caller that ignores the return still gets per-endpoint diagnostics.
+
+#### Parameters[​](#parameters-4 "Direct link to Parameters")
+
+| Parameter   | Type                   |
+| ----------- | ---------------------- |
+| `endpoints` | `McpEndpointConfig`\[] |
+
+#### Returns[​](#returns-5 "Direct link to Returns")
+
+`Promise`<[`McpConnectAllResult`](./docs/api/appkit/Interface.McpConnectAllResult.md)>
+
+`connected` lists the endpoint names that initialised successfully; `failed` carries `{ name, error }` for the rest.
+
+***
+
+### getAllToolDefinitions()[​](#getalltooldefinitions "Direct link to getAllToolDefinitions()")
+
+```ts
+getAllToolDefinitions(): AgentToolDefinition[];
+
+```
+
+#### Returns[​](#returns-6 "Direct link to Returns")
+
+[`AgentToolDefinition`](./docs/api/appkit/Interface.AgentToolDefinition.md)\[]

package/docs/api/appkit/Class.DatabricksAdapter.md

@@ -0,0 +1,151 @@
+# Class: DatabricksAdapter
+
+Adapter that talks directly to Databricks Model Serving `/invocations` endpoint.
+
+No dependency on the Vercel AI SDK or LangChain. Uses raw `fetch()` to POST OpenAI-compatible payloads and parses the SSE stream itself. Calls `authenticate()` per-request so tokens are always fresh.
+
+Handles both structured `tool_calls` responses and text-based tool call fallback parsing for models that output tool calls as text.
+
+## Examples[​](#examples "Direct link to Examples")
+
+```ts
+import { createApp, createAgent, agents } from "@databricks/appkit";
+import { DatabricksAdapter } from "@databricks/appkit/beta";
+import { WorkspaceClient } from "@databricks/sdk-experimental";
+
+const adapter = DatabricksAdapter.fromServingEndpoint({
+  workspaceClient: new WorkspaceClient({}),
+  endpointName: "my-endpoint",
+});
+
+await createApp({
+  plugins: [
+    agents({
+      agents: {
+        assistant: createAgent({
+          instructions: "You are a helpful assistant.",
+          model: adapter,
+        }),
+      },
+    }),
+  ],
+});
+
+```
+
+```ts
+const adapter = new DatabricksAdapter({
+  endpointUrl: "https://host/serving-endpoints/my-endpoint/invocations",
+  authenticate: async () => ({ Authorization: `Bearer ${token}` }),
+});
+
+```
+
+## Implements[​](#implements "Direct link to Implements")
+
+* [`AgentAdapter`](./docs/api/appkit/Interface.AgentAdapter.md)
+
+## Constructors[​](#constructors "Direct link to Constructors")
+
+### Constructor[​](#constructor "Direct link to Constructor")
+
+```ts
+new DatabricksAdapter(options: DatabricksAdapterOptions): DatabricksAdapter;
+
+```
+
+#### Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                       |
+| --------- | -------------------------- |
+| `options` | `DatabricksAdapterOptions` |
+
+#### Returns[​](#returns "Direct link to Returns")
+
+`DatabricksAdapter`
+
+## Methods[​](#methods "Direct link to Methods")
+
+### run()[​](#run "Direct link to run()")
+
+```ts
+run(input: AgentInput, context: AgentRunContext): AsyncGenerator<AgentEvent, void, unknown>;
+
+```
+
+#### Parameters[​](#parameters-1 "Direct link to Parameters")
+
+| Parameter | Type                                                                      |
+| --------- | ------------------------------------------------------------------------- |
+| `input`   | [`AgentInput`](./docs/api/appkit/Interface.AgentInput.md)           |
+| `context` | [`AgentRunContext`](./docs/api/appkit/Interface.AgentRunContext.md) |
+
+#### Returns[​](#returns-1 "Direct link to Returns")
+
+`AsyncGenerator`<[`AgentEvent`](./docs/api/appkit/TypeAlias.AgentEvent.md), `void`, `unknown`>
+
+#### Implementation of[​](#implementation-of "Direct link to Implementation of")
+
+[`AgentAdapter`](./docs/api/appkit/Interface.AgentAdapter.md).[`run`](./docs/api/appkit/Interface.AgentAdapter.md#run)
+
+***
+
+### fromModelServing()[​](#frommodelserving "Direct link to fromModelServing()")
+
+```ts
+static fromModelServing(endpointName?: string, options?: ModelServingOptions): Promise<DatabricksAdapter>;
+
+```
+
+Creates a DatabricksAdapter from a Model Serving endpoint name. Auto-creates a WorkspaceClient internally. Reads the endpoint name from the argument or the `DATABRICKS_SERVING_ENDPOINT_NAME` env var.
+
+#### Parameters[​](#parameters-2 "Direct link to Parameters")
+
+| Parameter       | Type                  |
+| --------------- | --------------------- |
+| `endpointName?` | `string`              |
+| `options?`      | `ModelServingOptions` |
+
+#### Returns[​](#returns-2 "Direct link to Returns")
+
+`Promise`<`DatabricksAdapter`>
+
+#### Example[​](#example "Direct link to Example")
+
+```ts
+// Reads endpoint from DATABRICKS_SERVING_ENDPOINT_NAME env var
+const adapter = await DatabricksAdapter.fromModelServing();
+
+// Explicit endpoint
+const adapter = await DatabricksAdapter.fromModelServing("my-endpoint");
+
+// With options
+const adapter = await DatabricksAdapter.fromModelServing("my-endpoint", {
+  maxSteps: 5,
+  maxTokens: 2048,
+});
+
+```
+
+***
+
+### fromServingEndpoint()[​](#fromservingendpoint "Direct link to fromServingEndpoint()")
+
+```ts
+static fromServingEndpoint(options: ServingEndpointOptions): Promise<DatabricksAdapter>;
+
+```
+
+Creates a DatabricksAdapter for a Databricks Model Serving endpoint.
+
+Routes through the shared `connectors/serving/stream` helper, which delegates to the SDK's `apiClient.request({ raw: true })`. That gives the adapter centralised URL encoding + authentication with the rest of the serving surface — no bespoke `fetch()` + `authenticate()` plumbing.
+
+#### Parameters[​](#parameters-3 "Direct link to Parameters")
+
+| Parameter | Type                     |
+| --------- | ------------------------ |
+| `options` | `ServingEndpointOptions` |
+
+#### Returns[​](#returns-3 "Direct link to Returns")
+
+`Promise`<`DatabricksAdapter`>