@dbx-tools/appkit-mastra 0.3.14 → 0.3.16

package/package.json

@@ -27,22 +27,22 @@
     "@opentelemetry/api": "^1.9.1",
     "pg": "^8.22.0",
     "zod": "^4.3.6",
-    "@dbx-tools/appkit": "0.3.14",
-    "@dbx-tools/databricks": "0.3.14",
-    "@dbx-tools/genie": "0.3.14",
-    "@dbx-tools/core": "0.3.14",
-    "@dbx-tools/model": "0.3.14",
-    "@dbx-tools/shared-core": "0.3.14",
-    "@dbx-tools/shared-model": "0.3.14",
-    "@dbx-tools/shared-mastra": "0.3.14",
-    "@dbx-tools/shared-genie": "0.3.14"
+    "@dbx-tools/appkit": "0.3.16",
+    "@dbx-tools/core": "0.3.16",
+    "@dbx-tools/genie": "0.3.16",
+    "@dbx-tools/shared-core": "0.3.16",
+    "@dbx-tools/model": "0.3.16",
+    "@dbx-tools/shared-mastra": "0.3.16",
+    "@dbx-tools/shared-model": "0.3.16",
+    "@dbx-tools/shared-genie": "0.3.16",
+    "@dbx-tools/databricks": "0.3.16"
   },
   "main": "index.ts",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.14",
+  "version": "0.3.16",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/agents.ts

@@ -11,6 +11,8 @@
  * When no agents are registered the plugin falls back to a single
  * built-in analyst so the bare `mastra()` call still mounts a working
  * streamable agent for demos.
+ *
+ * @module
  */
 
 import type { AgentConfig, ToolsInput } from "@mastra/core/agent";

package/src/chart.ts

@@ -23,6 +23,8 @@
  * Wire-format schemas live in `@dbx-tools/shared-mastra` so
  * the demo client and any other UI consumer share the exact same
  * shape this module reads and writes.
+ *
+ * @module
  */
 
 import { CacheManager } from "@databricks/appkit";

package/src/config.ts

@@ -3,6 +3,8 @@
  *
  * Kept in a leaf module so `plugin.ts`, `server.ts`, `model.ts`, and
  * `memory.ts` can import them without creating a cycle.
+ *
+ * @module
  */
 
 import type { BasePluginConfig } from "@databricks/appkit";

package/src/filesystems.ts

@@ -9,6 +9,8 @@
  * Path helpers ({@link normalizeDatabricksBasePath}, {@link isDbfsPath}, …)
  * are exported for tests and callers that need to reason about Databricks
  * paths without constructing a filesystem.
+ *
+ * @module
  */
 
 import { getExecutionContext } from "@databricks/appkit";

package/src/genie.ts

@@ -32,6 +32,8 @@
  * {@link GENIE_INSTRUCTIONS}; compose it into the agent's own
  * `instructions` when you want the canonical "how to drive the
  * Genie tools" guidance.
+ *
+ * @module
  */
 
 import { CacheManager, genie } from "@databricks/appkit";

package/src/history.ts

@@ -14,6 +14,8 @@
  * `MASTRA_THREAD_ID_KEY` and `MASTRA_RESOURCE_ID_KEY` by the time
  * the handler runs - no cookie or user lookups happen here, and the
  * session-cookie logic stays the single source of truth in `server.ts`.
+ *
+ * @module
  */
 
 import type {

package/src/mcp.ts

@@ -8,6 +8,8 @@
  * `Mastra` instance via `mcpServers`, which makes `@mastra/express`
  * serve the stock MCP routes under the plugin's base path; the plugin
  * never registers a bespoke MCP route of its own.
+ *
+ * @module
  */
 
 import type { Agent } from "@mastra/core/agent";

package/src/memory.ts

@@ -25,6 +25,8 @@
  * Plugin-level `config.storage` / `config.memory` act as the baseline
  * (auto-defaulted to `true` in `plugin.ts` when the `lakebase` plugin
  * is registered); per-agent settings cascade on top of that.
+ *
+ * @module
  */
 
 import { getUsernameWithApiLookup } from "@databricks/appkit";

package/src/mlflow.ts

@@ -15,6 +15,8 @@
  * asynchronous, so the just-finished trace may not exist in MLflow yet
  * when the user reacts; the log call retries briefly on "not found"
  * before giving up softly.
+ *
+ * @module
  */
 
 import { feedback } from "@dbx-tools/shared-mastra";

package/src/model.ts

@@ -19,6 +19,8 @@
  * the resolved id in the OpenAI-compatible provider config Mastra
  * expects. Catalogue fetches fail loud: network / auth errors
  * propagate so callers see the real SDK message.
+ *
+ * @module
  */
 
 import { getExecutionContext } from "@databricks/appkit";

package/src/observability.ts

@@ -29,6 +29,8 @@
  * When `OTEL_EXPORTER_OTLP_ENDPOINT` is unset the bridge is not
  * registered at all (unless `observability: true` forces it on), so
  * Mastra does not emit `[OtelBridge] No OTEL span found` warnings.
+ *
+ * @module
  */
 
 import { Observability } from "@mastra/observability";

package/src/pagination.ts

@@ -3,6 +3,8 @@
  * (`history` / `threads`). Each route keeps its own page-size default
  * and hard cap and passes them in, so the coercion rules stay in one
  * place without collapsing the routes' distinct sizing.
+ *
+ * @module
  */
 
 /** Bounds for {@link clampPerPage}. */

package/src/plugin.ts

@@ -37,6 +37,8 @@
  *   instance via `mcpServers`, so `@mastra/express` serves the stock
  *   MCP transport routes (`/mcp/<serverId>/...`) under the mount. See
  *   `./mcp.js`.
+ *
+ * @module
  */
 
 import {

package/src/processors.ts

@@ -10,6 +10,8 @@
  * - An **output** processor ({@link ResultProcessor}) that trims the
  *   bulky, redundant payload fields off targeted outbound stream frames
  *   before they're serialized to the SSE client.
+ *
+ * @module
  */
 
 import { log } from "@dbx-tools/shared-core";

package/src/server.ts

@@ -3,6 +3,8 @@
  * stamps the per-request `RequestContext`, and a route-patch middleware
  * that lets the plugin's custom API routes (e.g. `historyRoute`) work
  * behind an Express mount point.
+ *
+ * @module
  */
 
 import { getExecutionContext } from "@databricks/appkit";

package/src/serving.ts

@@ -7,6 +7,8 @@
  * Mastra plugin: pulling a per-request model override off an HTTP
  * request (header / query / body) and projecting the plugin config
  * onto the knobs `buildModel` and the `/models` route share.
+ *
+ * @module
  */
 
 import { override } from "@dbx-tools/shared-mastra";

package/src/statement.ts

@@ -15,6 +15,8 @@
  * which producer (Genie, a tool, a notebook, etc.) submitted the
  * query. Co-located here so consumers can fetch / cap / handle
  * 404s without reaching into the Genie tool module.
+ *
+ * @module
  */
 
 import { WorkspaceClient } from "@databricks/sdk-experimental";

package/src/summarize.ts

@@ -15,6 +15,8 @@
  * Mirrors the chart-planner wiring in `chart.ts`: a per-config cached
  * `Agent` on the fast tier, invoked via `agent.generate(...)` inside
  * the active `asUser` scope so tokens stay user-scoped.
+ *
+ * @module
  */
 
 import { model } from "@dbx-tools/shared-model";

package/src/threads.ts

@@ -17,6 +17,8 @@
  * cookie) on `RequestContext` by the time a handler runs. Resource
  * scoping lives here so a caller can only ever see, rename, or delete
  * its own threads; no cookie or user lookups happen in this module.
+ *
+ * @module
  */
 
 import {

package/src/workspaces.ts

@@ -6,6 +6,8 @@
  * OBO client on {@link MASTRA_USER_KEY}. Optional mount resolver
  * contributions merge extra filesystems and skill scan roots; built-in
  * Assistant skill trees are toggled with `assistantSkills` (on by default).
+ *
+ * @module
  */
 
 import type { WorkspaceClient } from "@databricks/sdk-experimental";

package/src/writer.ts

@@ -8,6 +8,8 @@
  * the most likely culprit when events go missing client-side) but
  * swallowed so a cancelled request or a client that navigated
  * away can't crash a tool mid-flight.
+ *
+ * @module
  */
 
 import type { MastraWriter } from "@dbx-tools/shared-mastra";