@databricks/appkit 0.76.0 → 0.77.0

package/docs/api/appkit/Interface.PluginManifest.md

@@ -57,6 +57,24 @@ schema: JSONSchema7;
 
 ***
 
+### deprecated?[​](#deprecated "Direct link to deprecated?")
+
+```ts
+optional deprecated: boolean;
+
+```
+
+When true, the plugin is deprecated. It still ships and functions, but tooling (e.g. `appkit plugin list`) may hide or flag it. The recommended replacement is noted in the plugin description.
+
+#### Inherited from[​](#inherited-from-1 "Direct link to Inherited from")
+
+```ts
+Omit.deprecated
+
+```
+
+***
+
 ### description[​](#description "Direct link to description")
 
 ```ts
@@ -66,7 +84,7 @@ description: string;
 
 Brief description of what the plugin does
 
-#### Inherited from[​](#inherited-from-1 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-2 "Direct link to Inherited from")
 
 ```ts
 Omit.description
@@ -84,7 +102,7 @@ optional devOnly: boolean;
 
 When true, this plugin is only registered when NODE\_ENV === "development". In any other environment createApp skips it entirely (not constructed, no routes, resources not validated). Use for dev-only tooling that must never run in a deployed app.
 
-#### Inherited from[​](#inherited-from-2 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-3 "Direct link to Inherited from")
 
 ```ts
 Omit.devOnly
@@ -102,7 +120,7 @@ displayName: string;
 
 Human-readable display name for UI and CLI
 
-#### Inherited from[​](#inherited-from-3 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-4 "Direct link to Inherited from")
 
 ```ts
 Omit.displayName
@@ -120,7 +138,7 @@ optional hidden: boolean;
 
 When true, this plugin is excluded from the template plugins manifest (appkit.plugins.json) during sync.
 
-#### Inherited from[​](#inherited-from-4 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-5 "Direct link to Inherited from")
 
 ```ts
 Omit.hidden
@@ -138,7 +156,7 @@ optional keywords: string[];
 
 Keywords for plugin discovery
 
-#### Inherited from[​](#inherited-from-5 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-6 "Direct link to Inherited from")
 
 ```ts
 Omit.keywords
@@ -156,7 +174,7 @@ optional license: string;
 
 SPDX license identifier
 
-#### Inherited from[​](#inherited-from-6 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-7 "Direct link to Inherited from")
 
 ```ts
 Omit.license
@@ -192,7 +210,7 @@ optional onSetupMessage: string;
 
 Message displayed to the user after project initialization. Use this to inform about manual setup steps (e.g. environment variables, resource provisioning).
 
-#### Inherited from[​](#inherited-from-7 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-8 "Direct link to Inherited from")
 
 ```ts
 Omit.onSetupMessage
@@ -210,7 +228,7 @@ optional repository: string;
 
 URL to the plugin's source repository
 
-#### Inherited from[​](#inherited-from-8 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-9 "Direct link to Inherited from")
 
 ```ts
 Omit.repository
@@ -296,7 +314,7 @@ optional should: string[];
 
 ```
 
-#### Inherited from[​](#inherited-from-9 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-10 "Direct link to Inherited from")
 
 ```ts
 Omit.scaffolding
@@ -314,7 +332,7 @@ optional stability: "beta" | "ga";
 
 Plugin stability level. Beta plugins may have breaking API changes between minor releases but are on a path to GA. GA (general availability) plugins follow semver strictly.
 
-#### Inherited from[​](#inherited-from-10 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-11 "Direct link to Inherited from")
 
 ```ts
 Omit.stability
@@ -332,7 +350,7 @@ optional version: string;
 
 Plugin version (semver format)
 
-#### Inherited from[​](#inherited-from-11 "Direct link to Inherited from")
+#### Inherited from[​](#inherited-from-12 "Direct link to Inherited from")
 
 ```ts
 Omit.version

package/docs/plugins/agents.md

@@ -34,6 +34,8 @@ await createApp({
 
 That alone gives you a live HTTP server with `POST /invocations` (and its alias `POST /responses`) wired to a markdown-driven agent. Use `POST /chat` instead when you want the streaming, HITL-capable surface.
 
+> **Optional dependencies.** Two opt-in features load their heavy dependencies lazily, so they are declared as optional peer dependencies and are *not* installed with AppKit by default: agent tracing to an MLflow experiment needs `@mlflow/core` (`npm i @mlflow/core`), and the eval judges below need `autoevals` (`npm i autoevals`). Skip them and agents still run — tracing simply stays off and `t.judge.*` reports the missing package.
+
 ## Level 1: drop a markdown agent package[​](#level-1-drop-a-markdown-agent-package "Direct link to Level 1: drop a markdown agent package")
 
 Each agent lives in its own folder under `server/agents/` with entry file `agent.md`. A folder is an agent only if it holds an entry file (`agent.md` or `agent.ts`); a folder without one is skipped, so per-agent asset folders sit beside the entry — notably a `skills/` folder holding [Skills](#skills) (on-demand instruction packs the agent loads by name). A shared `server/agents/skills/` folder holds skills available to any agent.
@@ -760,7 +762,7 @@ Call `t.skip("reason")` to skip an eval, and read `t.reply`, `t.toolCalls`, and
 
 ### LLM-as-judge[​](#llm-as-judge "Direct link to LLM-as-judge")
 
-`t.judge.*` scores the last reply with an LLM judge (via `autoevals` pointed at a Databricks serving endpoint). Each judge returns a scored assertion (0..1) that **gates by default** — a miss fails the eval. Chain `.atLeast(n)` to set the pass threshold, or `.soft()` to track it only. Judges require a judge model: pass `--judge-model <endpoint>` (or set `APPKIT_JUDGE_MODEL`) plus Databricks auth; without one, `t.judge.*` throws with a clear message.
+`t.judge.*` scores the last reply with an LLM judge (via `autoevals` pointed at a Databricks serving endpoint). Each judge returns a scored assertion (0..1) that **gates by default** — a miss fails the eval. Chain `.atLeast(n)` to set the pass threshold, or `.soft()` to track it only. Judges require a judge model: pass `--judge-model <endpoint>` (or set `APPKIT_JUDGE_MODEL`) plus Databricks auth; without one, `t.judge.*` throws with a clear message. `autoevals` is an optional peer dependency — install it (`npm i autoevals`) to use the judges.
 
 ```ts
 async test(t) {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@databricks/appkit",
   "type": "module",
-  "version": "0.76.0",
+  "version": "0.77.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
     "appkit": "./bin/appkit.js"
   },
-  "packageManager": "pnpm@10.21.0",
+  "packageManager": "pnpm@11.0.8",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -58,7 +58,6 @@
     "@ast-grep/napi": "0.37.0",
     "@databricks/lakebase": "0.6.0",
     "@databricks/sdk-experimental": "0.17.0",
-    "@mlflow/core": "0.4.0",
     "@opentelemetry/api": "1.9.0",
     "@opentelemetry/api-logs": "0.219.0",
     "@opentelemetry/auto-instrumentations-node": "0.77.0",
@@ -76,7 +75,6 @@
     "@opentelemetry/semantic-conventions": "1.38.0",
     "@types/semver": "7.7.1",
     "apache-arrow": "21.1.0",
-    "autoevals": "0.3.0",
     "dotenv": "16.6.1",
     "drizzle-orm": "0.45.2",
     "express": "4.22.2",
@@ -97,14 +95,23 @@
     "yaml": "2.8.2"
   },
   "peerDependencies": {
+    "@mlflow/core": "0.4.0",
+    "autoevals": "0.3.0",
     "vitest": ">=3"
   },
   "peerDependenciesMeta": {
+    "@mlflow/core": {
+      "optional": true
+    },
+    "autoevals": {
+      "optional": true
+    },
     "vitest": {
       "optional": true
     }
   },
   "devDependencies": {
+    "@mlflow/core": "0.4.0",
     "@opentelemetry/context-async-hooks": "2.8.0",
     "@types/express": "4.17.25",
     "@types/js-yaml": "4.0.9",
@@ -112,6 +119,7 @@
     "@types/pg": "8.16.0",
     "@types/ws": "8.18.1",
     "@vitejs/plugin-react": "5.1.1",
+    "autoevals": "0.3.0",
     "vitest": "3.2.4"
   },
   "overrides": {