@databricks/appkit 0.71.0 → 0.73.0

package/dist/plugins/database/types.d.ts

@@ -1,22 +1,36 @@
 import { Schema } from "../../database/schema-builder/types.js";
+import { EntityMutationHooks } from "./hooks.js";
 
 //#region src/plugins/database/types.d.ts
 /** Table names declared by one finalized schema. */
 type SchemaTableName<TSchema extends Schema> = Extract<keyof TSchema["$tables"], string>;
+/** Generated HTTP write operations. */
+type DatabaseApiWriteOperation = "create" | "update" | "delete";
+/** All writes by default; false keeps reads only, and an object narrows writes. */
+type DatabaseApiWritesConfig<TSchema extends Schema> = boolean | {
+  /** Tables that remain writable. Defaults to every exposed table. */readonly tables?: readonly SchemaTableName<TSchema>[]; /** Operations that remain enabled. Defaults to create, update, and delete. */
+  readonly operations?: readonly DatabaseApiWriteOperation[];
+};
 /**
- * Generated read exposure: off by default, every table, or an explicit list.
+ * Full generated CRUD for every declared table by default. Set false to disable
+ * all generated routes, or use an object to restrict tables and writes.
+ * Keyed routes require a public primary key; upsert stays programmatic.
+ * Route names must start with a letter, contain only letters, digits, `_`, or
+ * `-`, be at most 64 characters, and be unique ignoring case. Invalid names
+ * fail setup; exclude internal tables with `api.tables` or use `api: false`.
  *
- * Reads run as the app's service principal and apply no per-user filter, so an
- * enabled table is readable by anyone the app admits. Enabling a table also
- * makes it includable from its neighbours; a relation whose target stays off
- * cannot be included, which keeps one table's data behind one decision.
+ * Routes run as the app's service principal and apply no per-user filter, so
+ * anyone the app admits receives every enabled operation. An exposed table
+ * also becomes includable from its neighbours; a relation whose target
+ * stays off cannot be included.
  *
  * Text filters accept caller-supplied `like`/`ilike` patterns; a server-side
  * `statement_timeout` cancels a pattern that would otherwise hold its pooled
  * connection to completion.
  */
-type CrudRoutesConfig<TSchema extends Schema> = boolean | {
-  readonly tables: readonly SchemaTableName<TSchema>[];
+type DatabaseApiConfig<TSchema extends Schema> = boolean | {
+  /** Tables that remain exposed. Defaults to every declared table. */readonly tables?: readonly SchemaTableName<TSchema>[]; /** All writes by default. Set false for read-only routes. */
+  readonly writes?: DatabaseApiWritesConfig<TSchema>;
 };
 /** Which entity and generated operation produced the row being shaped. */
 interface ReadSerializerContext {
@@ -29,14 +43,28 @@ interface ReadSerializerContext {
  * serializers run inside the response path and must not add latency there.
  */
 type ReadSerializer = (row: Record<string, unknown>, context: ReadSerializerContext) => Record<string, unknown>;
+/** Response shaping and mutation lifecycle declared for one table. */
+type EntityHooks<TTable extends string = string> = EntityMutationHooks<TTable> & {
+  readonly serialize?: ReadSerializer;
+};
 /** Configuration for one schema-bound DatabasePlugin instance. */
 type IDatabaseConfig<TSchema extends Schema> = {
   readonly schema: TSchema;
-  readonly crudRoutes?: CrudRoutesConfig<TSchema>;
-  readonly hooks?: { readonly [TTable in SchemaTableName<TSchema>]?: {
-    readonly serialize?: ReadSerializer;
-  } };
+  /**
+   * Generated HTTP CRUD is enabled for all tables by default, using the app's
+   * service principal. Every admitted caller receives the enabled operations;
+   * no per-user or per-row authorization is applied. This plugin does not
+   * support OBO. Use custom routes for application-specific authorization.
+   *
+   * Set `false` to disable routes, `{ writes: false }` for reads only, or
+   * `{ tables: ["notes"] }` to expose only selected tables. To disable delete,
+   * use `{ writes: { operations: ["create", "update"] } }`.
+   *
+   * @defaultValue true
+   */
+  readonly api?: DatabaseApiConfig<TSchema>;
+  readonly hooks?: { readonly [TTable in SchemaTableName<TSchema>]?: EntityHooks<TTable> };
 };
 //#endregion
-export { IDatabaseConfig };
+export { DatabaseApiConfig, DatabaseApiWriteOperation, DatabaseApiWritesConfig, EntityHooks, IDatabaseConfig, ReadSerializer, ReadSerializerContext };
 //# sourceMappingURL=types.d.ts.map

package/dist/plugins/database/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/plugins/database/types.ts"],"mappings":";;;;KAGY,eAAA,iBAAgC,MAAA,IAAU,OAAA,OAC9C,OAAA;AADR;;;;;;;;;;;;AAAA,KAiBY,gBAAA,iBAAiC,MAAA;EAAA,SAE9B,MAAA,WAAiB,eAAA,CAAgB,OAAA;AAAA;;UAG/B,qBAAA;EAAA,SACN,MAAA;EAAA,SACA,SAAA;AAAA;;;;;;KAQC,cAAA,IACV,GAAA,EAAK,MAAA,mBACL,OAAA,EAAS,qBAAA,KACN,MAAA;;KAGO,eAAA,iBAAgC,MAAA;EAAA,SACjC,MAAA,EAAQ,OAAA;EAAA,SACR,UAAA,GAAa,gBAAA,CAAiB,OAAA;EAAA,SAC9B,KAAA,yBACa,eAAA,CAAgB,OAAA;IAAA,SACzB,SAAA,GAAY,cAAA;EAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/plugins/database/types.ts"],"mappings":";;;;;KAIY,eAAA,iBAAgC,MAAA,IAAU,OAAA,OAC9C,OAAA;AADR;AAAA,KAMY,yBAAA;;KAGA,uBAAA,iBAAwC,MAAA;EAR5C,6EAYO,MAAA,YAAkB,eAAA,CAAgB,OAAA,KAbY;EAAA,SAe9C,UAAA,YAAsB,yBAAA;AAAA;;;;;;AATrC;;;;;AAGA;;;;;;;KA0BY,iBAAA,iBAAkC,MAAA;EApBgB,6EAwB/C,MAAA,YAAkB,eAAA,CAAgB,OAAA,KA9BG;EAAA,SAgCrC,MAAA,GAAS,uBAAA,CAAwB,OAAA;AAAA;;UAI/B,qBAAA;EAAA,SACN,MAAA;EAAA,SACA,SAAA;AAAA;AAZX;;;;;AAAA,KAoBY,cAAA,IACV,GAAA,EAAK,MAAA,mBACL,OAAA,EAAS,qBAAA,KACN,MAAA;;KAGO,WAAA,mCACV,mBAAA,CAAoB,MAAA;EAAA,SACT,SAAA,GAAY,cAAA;AAAA;;KAOb,eAAA,iBAAgC,MAAA;EAAA,SACjC,MAAA,EAAQ,OAAA;EA9BJ;;;;;AAIf;;;;;AAUA;;EAde,SA2CJ,GAAA,GAAM,iBAAA,CAAkB,OAAA;EAAA,SACxB,KAAA,yBACa,eAAA,CAAgB,OAAA,KAAY,WAAA,CAAY,MAAA;AAAA"}

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

@@ -30,6 +30,7 @@ console.error(error.toJSON()); // Safe for logging, sensitive values redacted
 * [`AuthenticationError`](./docs/api/appkit/Class.AuthenticationError.md)
 * [`ConfigurationError`](./docs/api/appkit/Class.ConfigurationError.md)
 * [`ConnectionError`](./docs/api/appkit/Class.ConnectionError.md)
+* [`DatabaseValidationError`](./docs/api/appkit/Class.DatabaseValidationError.md)
 * [`ExecutionError`](./docs/api/appkit/Class.ExecutionError.md)
 * [`InitializationError`](./docs/api/appkit/Class.InitializationError.md)
 * [`ServerError`](./docs/api/appkit/Class.ServerError.md)

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

@@ -0,0 +1,191 @@
+# Class: DatabaseValidationError
+
+Deliberate validation failure raised by a database mutation hook. Generated routes answer `422` and echo only the issues naming a public column; every other failure raised inside a hook stays an opaque server error.
+
+## Extends[​](#extends "Direct link to Extends")
+
+* [`AppKitError`](./docs/api/appkit/Class.AppKitError.md)
+
+## Constructors[​](#constructors "Direct link to Constructors")
+
+### Constructor[​](#constructor "Direct link to Constructor")
+
+```ts
+new DatabaseValidationError(message: string, issues: readonly DatabaseValidationIssue[]): DatabaseValidationError;
+
+```
+
+#### Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                                                                  | Default value |
+| --------- | ----------------------------------------------------------------------------------------------------- | ------------- |
+| `message` | `string`                                                                                              | `undefined`   |
+| `issues`  | readonly [`DatabaseValidationIssue`](./docs/api/appkit/Interface.DatabaseValidationIssue.md)\[] | `[]`          |
+
+#### Returns[​](#returns "Direct link to Returns")
+
+`DatabaseValidationError`
+
+#### Overrides[​](#overrides "Direct link to Overrides")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`constructor`](./docs/api/appkit/Class.AppKitError.md#constructor)
+
+## Properties[​](#properties "Direct link to Properties")
+
+### \_clientMessage?[​](#_clientmessage "Direct link to _clientMessage?")
+
+```ts
+protected readonly optional _clientMessage: string;
+
+```
+
+Client-safe error message. When set, callers serializing the error to a client (SSE, HTTP body) MUST prefer `clientMessage` over `message` — `message` may contain raw upstream / SDK text including statement fragments, internal object names, and correlation IDs.
+
+Subclasses can set this in their constructor for a fixed sanitized string. When unset, `clientMessage` defaults to a generic per-code string (see the getter), and the raw `message` is kept server-side only.
+
+#### Inherited from[​](#inherited-from "Direct link to Inherited from")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`_clientMessage`](./docs/api/appkit/Class.AppKitError.md#_clientmessage)
+
+***
+
+### cause?[​](#cause "Direct link to cause?")
+
+```ts
+readonly optional cause: Error;
+
+```
+
+Optional cause of the error
+
+#### Inherited from[​](#inherited-from-1 "Direct link to Inherited from")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`cause`](./docs/api/appkit/Class.AppKitError.md#cause)
+
+***
+
+### code[​](#code "Direct link to code")
+
+```ts
+readonly code: "DATABASE_VALIDATION_ERROR" = "DATABASE_VALIDATION_ERROR";
+
+```
+
+Error code for programmatic error handling
+
+#### Overrides[​](#overrides-1 "Direct link to Overrides")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`code`](./docs/api/appkit/Class.AppKitError.md#code)
+
+***
+
+### context?[​](#context "Direct link to context?")
+
+```ts
+readonly optional context: Record<string, unknown>;
+
+```
+
+Additional context for the error
+
+#### Inherited from[​](#inherited-from-2 "Direct link to Inherited from")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`context`](./docs/api/appkit/Class.AppKitError.md#context)
+
+***
+
+### isRetryable[​](#isretryable "Direct link to isRetryable")
+
+```ts
+readonly isRetryable: false = false;
+
+```
+
+Whether this error type is generally safe to retry
+
+#### Overrides[​](#overrides-2 "Direct link to Overrides")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`isRetryable`](./docs/api/appkit/Class.AppKitError.md#isretryable)
+
+***
+
+### issues[​](#issues "Direct link to issues")
+
+```ts
+readonly issues: readonly DatabaseValidationIssue[];
+
+```
+
+***
+
+### statusCode[​](#statuscode "Direct link to statusCode")
+
+```ts
+readonly statusCode: 422 = 422;
+
+```
+
+HTTP status code suggestion (can be overridden)
+
+#### Overrides[​](#overrides-3 "Direct link to Overrides")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`statusCode`](./docs/api/appkit/Class.AppKitError.md#statuscode)
+
+## Accessors[​](#accessors "Direct link to Accessors")
+
+### clientMessage[​](#clientmessage "Direct link to clientMessage")
+
+#### Get Signature[​](#get-signature "Direct link to Get Signature")
+
+```ts
+get clientMessage(): string;
+
+```
+
+Sanitized message safe to forward to clients. Override in subclasses if a more specific default is appropriate.
+
+##### Returns[​](#returns-1 "Direct link to Returns")
+
+`string`
+
+#### Inherited from[​](#inherited-from-3 "Direct link to Inherited from")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`clientMessage`](./docs/api/appkit/Class.AppKitError.md#clientmessage)
+
+## Methods[​](#methods "Direct link to Methods")
+
+### toJSON()[​](#tojson "Direct link to toJSON()")
+
+```ts
+toJSON(): Record<string, unknown>;
+
+```
+
+Convert error to JSON for logging/serialization. Sensitive values in context are automatically redacted.
+
+#### Returns[​](#returns-2 "Direct link to Returns")
+
+`Record`<`string`, `unknown`>
+
+#### Inherited from[​](#inherited-from-4 "Direct link to Inherited from")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`toJSON`](./docs/api/appkit/Class.AppKitError.md#tojson)
+
+***
+
+### toString()[​](#tostring "Direct link to toString()")
+
+```ts
+toString(): string;
+
+```
+
+Create a human-readable string representation
+
+#### Returns[​](#returns-3 "Direct link to Returns")
+
+`string`
+
+#### Inherited from[​](#inherited-from-5 "Direct link to Inherited from")
+
+[`AppKitError`](./docs/api/appkit/Class.AppKitError.md).[`toString`](./docs/api/appkit/Class.AppKitError.md#tostring)

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

@@ -0,0 +1,103 @@
+# Class: MlflowClient
+
+A thin client over the Databricks workspace REST API, owning the host + bearer token so callers (eval-run creation, assessment writes, the judge's serving endpoint) don't each re-derive URLs or re-attach auth. The host is normalized once at construction.
+
+## Constructors[​](#constructors "Direct link to Constructors")
+
+### Constructor[​](#constructor "Direct link to Constructor")
+
+```ts
+new MlflowClient(host: string, token: string): MlflowClient;
+
+```
+
+#### Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type     |
+| --------- | -------- |
+| `host`    | `string` |
+| `token`   | `string` |
+
+#### Returns[​](#returns "Direct link to Returns")
+
+`MlflowClient`
+
+## Properties[​](#properties "Direct link to Properties")
+
+### baseUrl[​](#baseurl "Direct link to baseUrl")
+
+```ts
+readonly baseUrl: string;
+
+```
+
+Normalized workspace base URL (scheme guaranteed, no trailing slash).
+
+## Methods[​](#methods "Direct link to Methods")
+
+### post()[​](#post "Direct link to post()")
+
+```ts
+post<T>(path: string, body: unknown): Promise<T>;
+
+```
+
+POST JSON to an MLflow REST endpoint. Returns the parsed JSON body, or throws with the status + response text so callers can surface a precise error. Use for calls whose failure should abort (e.g. `runs/create`).
+
+The thrown message embeds up to 500 chars of the upstream response body to aid debugging. That is fine for the dev-facing eval CLI, but do NOT relay it into an end-user HTTP response if this client is reused in a request handler — the body can carry workspace-internal detail.
+
+#### Type Parameters[​](#type-parameters "Direct link to Type Parameters")
+
+| Type Parameter | Default type |
+| -------------- | ------------ |
+| `T`            | `unknown`    |
+
+#### Parameters[​](#parameters-1 "Direct link to Parameters")
+
+| Parameter | Type      |
+| --------- | --------- |
+| `path`    | `string`  |
+| `body`    | `unknown` |
+
+#### Returns[​](#returns-1 "Direct link to Returns")
+
+`Promise`<`T`>
+
+***
+
+### postResult()[​](#postresult "Direct link to postResult()")
+
+```ts
+postResult(path: string, body: unknown): Promise<PostResult>;
+
+```
+
+POST JSON without throwing: returns `{ ok, status, error }` so best-effort writes (e.g. per-trace assessments) can be collected and reported without aborting the run.
+
+`error` embeds up to 500 chars of the upstream body — same caveat as [post](#post): fine to log for the dev CLI, don't relay it to end users.
+
+#### Parameters[​](#parameters-2 "Direct link to Parameters")
+
+| Parameter | Type      |
+| --------- | --------- |
+| `path`    | `string`  |
+| `body`    | `unknown` |
+
+#### Returns[​](#returns-2 "Direct link to Returns")
+
+`Promise`<[`PostResult`](./docs/api/appkit/Interface.PostResult.md)>
+
+***
+
+### servingEndpointsUrl()[​](#servingendpointsurl "Direct link to servingEndpointsUrl()")
+
+```ts
+servingEndpointsUrl(): string;
+
+```
+
+OpenAI-compatible base URL for Databricks Model Serving, used as the judge's `OPENAI_BASE_URL`. Same workspace host + token as the MLflow REST calls.
+
+#### Returns[​](#returns-3 "Direct link to Returns")
+
+`string`

package/docs/api/appkit/Function.buildAssessments.md

@@ -0,0 +1,16 @@
+# Function: buildAssessments()
+
+```ts
+function buildAssessments(result: EvalResult): Assessment[];
+
+```
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                            |
+| --------- | --------------------------------------------------------------- |
+| `result`  | [`EvalResult`](./docs/api/appkit/Interface.EvalResult.md) |
+
+## Returns[​](#returns "Direct link to Returns")
+
+[`Assessment`](./docs/api/appkit/Interface.Assessment.md)\[]

package/docs/api/appkit/Function.configureJudge.md

@@ -0,0 +1,18 @@
+# Function: configureJudge()
+
+```ts
+function configureJudge(config: JudgeConfig): Promise<void>;
+
+```
+
+Configure the judge once. Sets the OpenAI-compatible client env autoevals reads and the default judge model. No-op-safe: on failure, judging stays disabled and [isJudgeConfigured](./docs/api/appkit/Function.isJudgeConfigured.md) returns false.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                              |
+| --------- | ----------------------------------------------------------------- |
+| `config`  | [`JudgeConfig`](./docs/api/appkit/Interface.JudgeConfig.md) |
+
+## Returns[​](#returns "Direct link to Returns")
+
+`Promise`<`void`>

package/docs/api/appkit/Function.createHttpDriver.md

@@ -0,0 +1,18 @@
+# Function: createHttpDriver()
+
+```ts
+function createHttpDriver(options: HttpDriverOptions): EvalDriver;
+
+```
+
+Drives an agent by POSTing to a running app's chat endpoint and parsing the SSE response. Keeps the thread id across `send`s so multi-turn evals share a conversation. Agent/stream errors surface as `succeeded: false` rather than throwing, so `t.succeeded()` can assert on them.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                                          |
+| --------- | ----------------------------------------------------------------------------- |
+| `options` | [`HttpDriverOptions`](./docs/api/appkit/Interface.HttpDriverOptions.md) |
+
+## Returns[​](#returns "Direct link to Returns")
+
+[`EvalDriver`](./docs/api/appkit/Interface.EvalDriver.md)

package/docs/api/appkit/Function.defineEval.md

@@ -0,0 +1,35 @@
+# Function: defineEval()
+
+```ts
+function defineEval(def: EvalDefinition): EvalDefinition;
+
+```
+
+Define an agent eval. Default-export the result from a `server/agents/<id>/evals/*.eval.ts` file.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                                    |
+| --------- | ----------------------------------------------------------------------- |
+| `def`     | [`EvalDefinition`](./docs/api/appkit/Interface.EvalDefinition.md) |
+
+## Returns[​](#returns "Direct link to Returns")
+
+[`EvalDefinition`](./docs/api/appkit/Interface.EvalDefinition.md)
+
+## Example[​](#example "Direct link to Example")
+
+```ts
+import { defineEval, includes } from "@databricks/appkit/beta";
+
+export default defineEval({
+  description: "Weather agent basic coverage",
+  async test(t) {
+    await t.send("What's the weather in Brooklyn?");
+    t.succeeded();
+    t.calledTool("get_weather");
+    t.check(t.reply, includes("Sunny"));
+  },
+});
+
+```

package/docs/api/appkit/Function.defineSchema.md

@@ -5,7 +5,7 @@ function defineSchema<TTables>(builder: (context: SchemaBuilderContext) => TTabl
 
 ```
 
-Compile one declared schema. The returned type keeps the table names the builder returned, so `crudRoutes` and `hooks` can name only real tables.
+Compile one declared schema. The returned type keeps the table names the builder returned, so `api.tables` and `hooks` can name only real tables.
 
 ## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
 

package/docs/api/appkit/Function.discoverEvalFiles.md

@@ -0,0 +1,18 @@
+# Function: discoverEvalFiles()
+
+```ts
+function discoverEvalFiles(rootDir: string): DiscoveredEval[];
+
+```
+
+Discover evals under `<rootDir>/server/agents/<agent>/evals/` — co-located with each agent's `agent.{md,ts}` (same folder-per-agent layout the agents plugin discovers). The agent id is the folder name; the eval id is the file path relative to that evals dir with `.eval.ts` stripped. Sorted + stable.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type     |
+| --------- | -------- |
+| `rootDir` | `string` |
+
+## Returns[​](#returns "Direct link to Returns")
+
+[`DiscoveredEval`](./docs/api/appkit/Interface.DiscoveredEval.md)\[]

package/docs/api/appkit/Function.equals.md

@@ -0,0 +1,18 @@
+# Function: equals()
+
+```ts
+function equals(expected: string): Matcher;
+
+```
+
+Passes when the value equals `expected` exactly.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter  | Type     |
+| ---------- | -------- |
+| `expected` | `string` |
+
+## Returns[​](#returns "Direct link to Returns")
+
+[`Matcher`](./docs/api/appkit/TypeAlias.Matcher.md)

package/docs/api/appkit/Function.evalGlyph.md

@@ -0,0 +1,18 @@
+# Function: evalGlyph()
+
+```ts
+function evalGlyph(result: EvalResult): string;
+
+```
+
+Status glyph for a single eval result.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                            |
+| --------- | --------------------------------------------------------------- |
+| `result`  | [`EvalResult`](./docs/api/appkit/Interface.EvalResult.md) |
+
+## Returns[​](#returns "Direct link to Returns")
+
+`string`

package/docs/api/appkit/Function.formatEvalDetail.md

@@ -0,0 +1,18 @@
+# Function: formatEvalDetail()
+
+```ts
+function formatEvalDetail(result: EvalResult): string[];
+
+```
+
+Indented detail lines for a failing eval (error + failing assertions).
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                            |
+| --------- | --------------------------------------------------------------- |
+| `result`  | [`EvalResult`](./docs/api/appkit/Interface.EvalResult.md) |
+
+## Returns[​](#returns "Direct link to Returns")
+
+`string`\[]

package/docs/api/appkit/Function.formatEvalHeadline.md

@@ -0,0 +1,18 @@
+# Function: formatEvalHeadline()
+
+```ts
+function formatEvalHeadline(result: EvalResult): string;
+
+```
+
+The one-line header for a single eval result (no failure detail).
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                            |
+| --------- | --------------------------------------------------------------- |
+| `result`  | [`EvalResult`](./docs/api/appkit/Interface.EvalResult.md) |
+
+## Returns[​](#returns "Direct link to Returns")
+
+`string`

package/docs/api/appkit/Function.formatEvalResults.md

@@ -0,0 +1,18 @@
+# Function: formatEvalResults()
+
+```ts
+function formatEvalResults(results: EvalResult[]): string;
+
+```
+
+Render all results as a human-readable console report (non-streaming).
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                               |
+| --------- | ------------------------------------------------------------------ |
+| `results` | [`EvalResult`](./docs/api/appkit/Interface.EvalResult.md)\[] |
+
+## Returns[​](#returns "Direct link to Returns")
+
+`string`

package/docs/api/appkit/Function.formatSummaryLine.md

@@ -0,0 +1,18 @@
+# Function: formatSummaryLine()
+
+```ts
+function formatSummaryLine(results: EvalResult[]): string;
+
+```
+
+The final PASS/FAIL summary line.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter | Type                                                               |
+| --------- | ------------------------------------------------------------------ |
+| `results` | [`EvalResult`](./docs/api/appkit/Interface.EvalResult.md)\[] |
+
+## Returns[​](#returns "Direct link to Returns")
+
+`string`

package/docs/api/appkit/Function.includes.md

@@ -0,0 +1,18 @@
+# Function: includes()
+
+```ts
+function includes(substring: string): Matcher;
+
+```
+
+Passes when the value contains `substring`.
+
+## Parameters[​](#parameters "Direct link to Parameters")
+
+| Parameter   | Type     |
+| ----------- | -------- |
+| `substring` | `string` |
+
+## Returns[​](#returns "Direct link to Returns")
+
+[`Matcher`](./docs/api/appkit/TypeAlias.Matcher.md)

package/docs/api/appkit/Function.isJudgeConfigured.md

@@ -0,0 +1,10 @@
+# Function: isJudgeConfigured()
+
+```ts
+function isJudgeConfigured(): boolean;
+
+```
+
+## Returns[​](#returns "Direct link to Returns")
+
+`boolean`