@dbx-tools/appkit-mastra 0.1.4 → 0.1.12

package/index.ts

@@ -13,7 +13,9 @@ export * from "./src/plugin.js";
 export * from "@dbx-tools/appkit-mastra-shared";
 export * from "./src/config.js";
 export * from "./src/agents.js";
+export * from "./src/chart.js";
 export * from "./src/genie.js";
+export * from "./src/tools/email.js";
 export {
   clearServingEndpointsCache,
   extractModelOverride,

package/package.json

@@ -1,6 +1,6 @@
 {
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "source": "./index.ts",
@@ -8,32 +8,13 @@
       "default": "./dist/index.js"
     }
   },
-  "files": [
-    "dist",
-    "index.ts",
-    "src"
-  ],
-  "license": "Apache-2.0",
-  "homepage": "https://github.com/reggie-db/dbx-tools-appkit#readme",
-  "bugs": {
-    "url": "https://github.com/reggie-db/dbx-tools-appkit/issues"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/reggie-db/dbx-tools-appkit.git",
-    "directory": "packages/mastra"
-  },
   "name": "@dbx-tools/appkit-mastra",
-  "version": "0.1.4",
-  "module": "index.ts",
+  "version": "0.1.12",
   "type": "module",
+  "module": "index.ts",
   "dependencies": {
-    "@dbx-tools/appkit-shared": "0.1.3",
-    "@dbx-tools/appkit-mastra-shared": "0.1.3",
+    "@dbx-tools/appkit-mastra-shared": "0.1.12",
+    "@dbx-tools/appkit-shared": "0.1.12",
     "@mastra/ai-sdk": "^1.3",
     "@mastra/core": "^1.32",
     "@mastra/express": "^1.3",
@@ -51,5 +32,20 @@
     "@types/express": "^5",
     "@types/pg": "^8",
     "express": "^5"
+  },
+  "files": [
+    "dist",
+    "index*.ts",
+    "src"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/reggie-db/dbx-tools-appkit#readme",
+  "bugs": {
+    "url": "https://github.com/reggie-db/dbx-tools-appkit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reggie-db/dbx-tools-appkit.git",
+    "directory": "packages/mastra"
   }
 }

package/src/agents.ts

@@ -21,10 +21,12 @@ import { createTool } from "@mastra/core/tools";
 import type { Tool } from "@mastra/core/tools";
 import type { PgVectorConfig, PostgresStoreConfig } from "@mastra/pg";
 
+import { buildRenderDataTool } from "./chart.js";
 import type { MastraPluginConfig } from "./config.js";
 import { buildGenieProvider } from "./genie.js";
 import type { MemoryBuilder } from "./memory.js";
 import { buildModel } from "./model.js";
+import { stripStaleChartsProcessor } from "./processors/strip-stale-charts.js";
 
 /**
  * Tool record accepted by every Mastra `Agent.tools` field and by the
@@ -121,8 +123,8 @@ export interface AppKitToolOptions {
 /**
  * Build a deterministic Mastra tool id from a description.
  * Delegates to {@link stringUtils.toUniqueSlug}: slug + always-on
- * SHA-1 suffix so two tools with the same leading words don't
- * collide in traces. Stable across runs.
+ * 6-char FNV-1a base-32 suffix so two tools with the same leading
+ * words don't collide in traces. Stable across runs.
  */
 function deriveToolId(description: string): string {
   return stringUtils.toUniqueSlug(description, { fallbackPrefix: "tool" });
@@ -344,16 +346,21 @@ Rules:
  * Override globally via {@link MastraPluginConfig.styleInstructions}
  * (pass `false` to disable entirely, or a string to replace).
  */
-export const DEFAULT_STYLE_INSTRUCTIONS = `Output style:
-
-- Plain prose. Use hyphens (-) only. Never use em dashes (—) or en dashes (–).
-- Never use emojis.
-- Skip openers like "Great question", "Absolutely", "I'd be happy to help".
-- Skip closers like "Let me know if you have any questions".
-- Skip self-disclaimers ("I should mention", "It's important to note").
-- Answer directly. No preamble before the actual answer.
-- Use lists and headers only when they clarify a multi-part answer; not for short replies.
-- Quote numbers, code, identifiers, and tool output verbatim. Never paraphrase them.`;
+export const DEFAULT_STYLE_INSTRUCTIONS = [
+  "Output style:",
+  "",
+  "Use markdown formatting, including headings, lists, and code blocks.",
+  "Avoid lists and headers for short replies.",
+  "Plain prose.",
+  "Use hyphens (-) only. Never use em dashes or en dashes.",
+  "Never use emojis.",
+  "Skip openers like 'Great question', 'Absolutely', and 'I'd be happy to help'.",
+  "Skip closers like 'Let me know if you have any questions'.",
+  "Skip self-disclaimers like 'I should mention' and 'It's important to note'.",
+  "Answer directly.",
+  "Do not include a preamble before the actual answer.",
+  "Use lists and headers only when they clarify a multi-part answer.",
+].join("\n");
 
 /**
  * Resolve the style block to append to every agent's instructions.
@@ -364,6 +371,7 @@ function resolveStyleInstructions(config: MastraPluginConfig): string | null {
   if (typeof config.styleInstructions === "string") {
     return config.styleInstructions;
   }
+
   return DEFAULT_STYLE_INSTRUCTIONS;
 }
 
@@ -371,10 +379,7 @@ function resolveStyleInstructions(config: MastraPluginConfig): string | null {
  * Join an agent's bespoke instructions with the resolved style block.
  * Returns the bespoke text unchanged when the style block is disabled.
  */
-function composeInstructions(
-  agentInstructions: string,
-  style: string | null,
-): string {
+function composeInstructions(agentInstructions: string, style: string | null): string {
   if (!style) return agentInstructions;
   return `${agentInstructions.trimEnd()}\n\n${style}`;
 }
@@ -403,9 +408,23 @@ export async function buildAgents(opts: {
   const ids = Object.keys(definitions);
   const defaultAgentId = config.defaultAgent ?? ids[0] ?? FALLBACK_AGENT_ID;
 
-  const plugins = buildPluginsMap(context);
-  const ambientTools = config.tools ?? {};
+  const plugins = buildPluginsMap(config, context);
+  // System-default ambient tools every agent gets out of the box.
+  // Currently just `render_data` for inline visualizations; the
+  // user can shadow it by including a same-named tool in their own
+  // `config.tools` or per-agent `tools`. Order in {@link resolveTools}
+  // is `system -> user-ambient -> per-agent`, last write wins.
+  const systemTools: MastraTools = {
+    render_data: buildRenderDataTool(config),
+  };
+  const ambientTools = { ...systemTools, ...(config.tools ?? {}) };
   const style = resolveStyleInstructions(config);
+  // Default-on protection against the model copying turn-scoped
+  // chartIds from prior assistant tool results into the new
+  // turn's `[[chart:<id>]]` markers. Opt out per-plugin via
+  // `config.stripStaleCharts: false`.
+  const inputProcessors =
+    config.stripStaleCharts === false ? [] : [stripStaleChartsProcessor];
   const agents: Record<string, Agent> = {};
 
   for (const [id, def] of Object.entries(definitions)) {
@@ -419,6 +438,7 @@ export async function buildAgents(opts: {
       model: resolveModel(config, def.model),
       tools,
       ...(memory ? { memory } : {}),
+      ...(inputProcessors.length > 0 ? { inputProcessors } : {}),
     });
   }
 
@@ -569,6 +589,7 @@ async function resolveTools(
  * time instead of staring at a spinner for the full Genie round-trip.
  */
 function buildPluginsMap(
+  config: MastraPluginConfig,
   context: pluginUtils.PluginContextLike | undefined,
 ): MastraPlugins {
   const cache = new Map<string, MastraPluginToolkitProvider | null>();
@@ -576,7 +597,7 @@ function buildPluginsMap(
     get(_target, propName) {
       if (typeof propName !== "string") return undefined;
       if (cache.has(propName)) return cache.get(propName) ?? undefined;
-      const provider = resolveProvider(context, propName);
+      const provider = resolveProvider(config, context, propName);
       cache.set(propName, provider);
       return provider ?? undefined;
     },
@@ -587,16 +608,20 @@ function buildPluginsMap(
  * Pick the right {@link MastraPluginToolkitProvider} for a sibling
  * plugin lookup. Returns the streaming-aware Genie adapter when the
  * caller asks for `genie`; falls back to the generic AppKit
- * `ToolProvider` adapter for every other plugin name.
+ * `ToolProvider` adapter for every other plugin name. `config` is
+ * threaded through so Genie's tool can run the chart planner
+ * inline against the same model resolver / fallback ladder the
+ * agents use.
  */
 function resolveProvider(
+  config: MastraPluginConfig,
   context: pluginUtils.PluginContextLike | undefined,
   propName: string,
 ): MastraPluginToolkitProvider | null {
   if (propName === "genie") {
     const geniePlugin = pluginUtils.instance(context, genie);
     if (!geniePlugin) return null;
-    return buildGenieProvider(geniePlugin) as MastraPluginToolkitProvider;
+    return buildGenieProvider(geniePlugin, { config }) as MastraPluginToolkitProvider;
   }
   const plugin = context?.getPlugins().get(propName);
   return adaptPluginToolkit(plugin);