@dbx-tools/appkit-mastra 0.1.93 → 0.1.94

package/dist/index.d.ts

@@ -17,6 +17,7 @@ import { Memory } from "@mastra/memory";
 import { PgVectorConfig, PostgresStore, PostgresStoreConfig } from "@mastra/pg";
 import { Pool } from "pg";
 import { MastraServer } from "@mastra/express";
+import { Workspace } from "@mastra/core/workspace";
 import * as _mastra_core_workflows0 from "@mastra/core/workflows";
 import * as _mastra_core_vector0 from "@mastra/core/vector";
 import * as _mastra_core_tts0 from "@mastra/core/tts";
@@ -764,6 +765,8 @@ interface MastraPluginToolkitProvider {
 type MastraPlugins = Record<string, MastraPluginToolkitProvider>;
 /** Function form of {@link MastraAgentDefinition.tools}. */
 type MastraToolsFn = (plugins: MastraPlugins) => MastraTools | Promise<MastraTools>;
+/** Function form of {@link MastraAgentDefinition.workspace}. */
+type MastraAgentWorkspaceResolver = () => Workspace | undefined;
 /**
  * A code-defined Mastra agent. Mirrors the shape AppKit's `agents`
  * plugin uses for `AgentDefinition`. The registry key under
@@ -825,6 +828,16 @@ interface MastraAgentDefinition {
    *   `PostgresStore` config (custom schema, connection, etc.).
    */
   storage?: boolean | MastraStorageConfigOverride;
+  /**
+   * Mastra {@link Workspace} for this agent. When it exposes skills,
+   * Mastra injects `<available_skills>` metadata each turn and mounts
+   * `skill` / `skill_search` / `skill_read` at runtime.
+   *
+   * Use a zero-arg function so resolution happens at agent registration
+   * (for example `skillWorkspace` from `@dbx-tools/appkit-skills`
+   * after `aiDevKit()` has primed the cache).
+   */
+  workspace?: Workspace | MastraAgentWorkspaceResolver;
 }
 /**
  * Distributive `Omit` so unions in `PostgresStoreConfig` /
@@ -1404,4 +1417,4 @@ declare function buildSummarizeTool(config: MastraPluginConfig): _mastra_core_to
   maxWords?: number | undefined;
 }, unknown, unknown, unknown, _mastra_core_tools0.ToolExecutionContext<unknown, unknown, unknown>, "summarize", unknown>;
 //#endregion
-export { AppKitToolOptions, BuiltAgents, ChartPlannerRequest, DEFAULT_AGENT_MAX_STEPS, DEFAULT_GENIE_ALIAS, DEFAULT_STYLE_INSTRUCTIONS, FALLBACK_AGENT_ID, FetchChartOptions, GENIE_INSTRUCTIONS, GenieSpaceConfig, GenieSpacesConfig, MASTRA_MODEL_OVERRIDE_KEY, MASTRA_REQUEST_ID_KEY, MASTRA_USER_EMAIL_KEY, MASTRA_USER_KEY, MASTRA_USER_NAME_KEY, MastraAgentDefinition, MastraMcpConfig, MastraMemoryConfig, MastraMemoryConfigOverride, MastraPlugin, MastraPluginConfig, MastraPluginToolkitProvider, MastraPlugins, MastraStorageConfigOverride, MastraTools, MastraToolsFn, type ModelOverrideRequest, PrepareChartOptions, ResolvedMcp, type SummarizeOptions, TRACE_REQUEST_CONTEXT_KEYS, ToolkitOptions, User, approvalGatedToolIds, buildAgents, buildGenieToolkitProvider, buildGenieTools, buildMcpServer, buildRenderDataTool, buildSummarizeTool, chartPlannerRequestSchema, collectSpaceSuggestions, createAgent, createTool, extractModelOverride, fetchChart, mastra, normalizeGenieSpaces, prepareChart, resolveGenieSpaces, summarizeText, tool };
+export { AppKitToolOptions, BuiltAgents, ChartPlannerRequest, DEFAULT_AGENT_MAX_STEPS, DEFAULT_GENIE_ALIAS, DEFAULT_STYLE_INSTRUCTIONS, FALLBACK_AGENT_ID, FetchChartOptions, GENIE_INSTRUCTIONS, GenieSpaceConfig, GenieSpacesConfig, MASTRA_MODEL_OVERRIDE_KEY, MASTRA_REQUEST_ID_KEY, MASTRA_USER_EMAIL_KEY, MASTRA_USER_KEY, MASTRA_USER_NAME_KEY, MastraAgentDefinition, MastraAgentWorkspaceResolver, MastraMcpConfig, MastraMemoryConfig, MastraMemoryConfigOverride, MastraPlugin, MastraPluginConfig, MastraPluginToolkitProvider, MastraPlugins, MastraStorageConfigOverride, MastraTools, MastraToolsFn, type ModelOverrideRequest, PrepareChartOptions, ResolvedMcp, type SummarizeOptions, TRACE_REQUEST_CONTEXT_KEYS, ToolkitOptions, User, approvalGatedToolIds, buildAgents, buildGenieToolkitProvider, buildGenieTools, buildMcpServer, buildRenderDataTool, buildSummarizeTool, chartPlannerRequestSchema, collectSpaceSuggestions, createAgent, createTool, extractModelOverride, fetchChart, mastra, normalizeGenieSpaces, prepareChart, resolveGenieSpaces, summarizeText, tool };

package/dist/index.js

@@ -2257,6 +2257,7 @@ async function buildAgents(opts) {
 	const approvalGatedByAgent = [];
 	for (const [id, def] of Object.entries(definitions)) {
 		const tools = await resolveTools(def.tools, plugins, ambientTools);
+		const workspace = resolveAgentWorkspace(def.workspace);
 		const gated = approvalGatedToolIds(tools);
 		if (gated.length > 0) approvalGatedByAgent.push({
 			agentId: id,
@@ -2272,6 +2273,7 @@ async function buildAgents(opts) {
 			defaultOptions: { maxSteps: config.agentMaxSteps ?? DEFAULT_AGENT_MAX_STEPS },
 			tools,
 			...memory ? { memory } : {},
+			...workspace ? { workspace } : {},
 			inputProcessors,
 			outputProcessors
 		});
@@ -2441,6 +2443,10 @@ async function resolveTools(defTools, plugins, ambientTools) {
 		...resolved
 	};
 }
+function resolveAgentWorkspace(workspace) {
+	if (!workspace) return void 0;
+	return typeof workspace === "function" ? workspace() : workspace;
+}
 /**
 * Build the {@link MastraPlugins} runtime proxy handed to
 * `tools(plugins)` callbacks.

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@dbx-tools/appkit-mastra",
-  "version": "0.1.93",
+  "version": "0.1.94",
   "dependencies": {
     "@databricks/sdk-experimental": "^0.17",
-    "@dbx-tools/appkit-mastra-shared": "0.1.93",
-    "@dbx-tools/genie": "0.1.93",
-    "@dbx-tools/genie-shared": "0.1.93",
-    "@dbx-tools/model": "0.1.93",
-    "@dbx-tools/shared": "0.1.93",
+    "@dbx-tools/appkit-mastra-shared": "0.1.94",
+    "@dbx-tools/genie": "0.1.94",
+    "@dbx-tools/genie-shared": "0.1.94",
+    "@dbx-tools/model": "0.1.94",
+    "@dbx-tools/shared": "0.1.94",
     "@mastra/ai-sdk": "^1",
     "@mastra/core": "^1",
     "@mastra/express": "^1",