@mastra/client-js 1.10.0-alpha.2 → 1.10.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @mastra/client-js
 
+## 1.10.0-alpha.3
+
+### Patch Changes
+
+- Add optional `?path=` query param to workspace skill routes for disambiguating same-named skills. ([#14430](https://github.com/mastra-ai/mastra/pull/14430))
+
+  Skill routes continue to use `:skillName` in the URL path (no breaking change). When two skills share the same name (e.g. from different directories), pass the optional `?path=` query parameter to select the exact skill:
+
+  ```
+  GET /workspaces/:workspaceId/skills/:skillName?path=skills/brand-guidelines
+  ```
+
+  `SkillMetadata` now includes a `path` field, and the `list()` method returns all same-named skills for disambiguation. The client SDK's `getSkill()` accepts an optional `skillPath` parameter for disambiguation.
+
+- Updated skill search result types and query parameters to use `skillName`/`skillNames` instead of `skillPath`/`skillPaths` for consistency with the name-based public API. ([#14430](https://github.com/mastra-ai/mastra/pull/14430))
+
+- Added storage type detection to the Metrics Dashboard. The `/system/packages` endpoint now returns `observabilityStorageType`, identifying the observability storage backend. The dashboard shows an empty state when the storage does not support metrics (e.g. PostgreSQL, LibSQL), and displays a warning when using in-memory storage since metrics are not persisted across server restarts. Also added a docs link button to the Metrics page header. ([#14620](https://github.com/mastra-ai/mastra/pull/14620))
+
+  ```ts
+  import { MastraClient } from '@mastra/client-js';
+
+  const client = new MastraClient();
+  const system = await client.getSystemPackages();
+
+  // system.observabilityStorageType contains the class name of the observability store:
+  // - 'ObservabilityInMemory' → metrics work but are not persisted across restarts
+  // - 'ObservabilityPG', 'ObservabilityLibSQL', etc. → metrics not supported
+
+  if (system.observabilityStorageType === 'ObservabilityInMemory') {
+    console.warn('Metrics are not persisted — data will be lost on server restart.');
+  }
+
+  const SUPPORTED = new Set(['ObservabilityInMemory']);
+  if (!SUPPORTED.has(system.observabilityStorageType ?? '')) {
+    console.error('Metrics require in-memory observability storage.');
+  }
+  ```
+
+- Updated dependencies [[`423aa6f`](https://github.com/mastra-ai/mastra/commit/423aa6fd12406de6a1cc6b68e463d30af1d790fb), [`47358d9`](https://github.com/mastra-ai/mastra/commit/47358d960bb2b931321de7e798f341ab0df81f44), [`4bb5adc`](https://github.com/mastra-ai/mastra/commit/4bb5adc05c88e3a83fe1ea5ecb9eae6e17313124), [`4bb5adc`](https://github.com/mastra-ai/mastra/commit/4bb5adc05c88e3a83fe1ea5ecb9eae6e17313124)]:
+  - @mastra/core@1.16.0-alpha.3
+  - @mastra/schema-compat@1.2.7-alpha.1
+
 ## 1.10.0-alpha.2
 
 ### Patch Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-client-js
 description: Documentation for @mastra/client-js. Use when working with @mastra/client-js APIs, configuration, or implementation.
 metadata:
   package: "@mastra/client-js"
-  version: "1.10.0-alpha.2"
+  version: "1.10.0-alpha.3"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.10.0-alpha.2",
+  "version": "1.10.0-alpha.3",
   "package": "@mastra/client-js",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -282,6 +282,7 @@ var BaseResource = class {
 async function executeToolCallAndRespond({
   response,
   params,
+  agentId,
   resourceId,
   threadId,
   requestContext,
@@ -299,6 +300,7 @@ async function executeToolCallAndRespond({
           requestContext,
           tracingContext: { currentSpan: void 0 },
           agent: {
+            agentId,
             messages: response.messages,
             toolCallId: toolCall?.payload.toolCallId,
             suspend: async () => {
@@ -447,6 +449,7 @@ var Agent = class extends BaseResource {
             requestContext,
             tracingContext: { currentSpan: void 0 },
             agent: {
+              agentId: this.agentId,
               messages: response.messages,
               toolCallId: toolCall?.toolCallId,
               suspend: async () => {
@@ -507,6 +510,7 @@ var Agent = class extends BaseResource {
       return executeToolCallAndRespond({
         response,
         params,
+        agentId: this.agentId,
         resourceId,
         threadId,
         requestContext,
@@ -1136,6 +1140,7 @@ var Agent = class extends BaseResource {
                   // TODO: Pass proper tracing context when client-js supports tracing
                   tracingContext: { currentSpan: void 0 },
                   agent: {
+                    agentId: this.agentId,
                     messages: response.messages,
                     toolCallId: toolCall2?.toolCallId,
                     suspend: async () => {
@@ -1437,6 +1442,7 @@ var Agent = class extends BaseResource {
                   // TODO: Pass proper tracing context when client-js supports tracing
                   tracingContext: { currentSpan: void 0 },
                   agent: {
+                    agentId: this.agentId,
                     messages: response.messages,
                     toolCallId: toolCall2?.toolCallId,
                     suspend: async () => {
@@ -3634,28 +3640,29 @@ var ProcessorProvider = class extends BaseResource {
 
 // src/resources/workspace.ts
 var WorkspaceSkillResource = class extends BaseResource {
-  constructor(options, workspaceId, skillName) {
+  constructor(options, workspaceId, skillName, skillPath) {
     super(options);
     this.workspaceId = workspaceId;
     this.skillName = skillName;
+    this.skillPath = skillPath;
+    this.basePath = `/workspaces/${encodeURIComponent(this.workspaceId)}/skills/${encodeURIComponent(this.skillName)}`;
+    this.pathQuery = this.skillPath ? `?path=${encodeURIComponent(this.skillPath)}` : "";
   }
+  basePath;
+  pathQuery;
   /**
    * Gets the full details of this skill including instructions
    * @returns Promise containing skill details
    */
   details() {
-    return this.request(
-      `/workspaces/${encodeURIComponent(this.workspaceId)}/skills/${encodeURIComponent(this.skillName)}`
-    );
+    return this.request(`${this.basePath}${this.pathQuery}`);
   }
   /**
    * Lists all reference file paths for this skill
    * @returns Promise containing list of reference paths
    */
   listReferences() {
-    return this.request(
-      `/workspaces/${encodeURIComponent(this.workspaceId)}/skills/${encodeURIComponent(this.skillName)}/references`
-    );
+    return this.request(`${this.basePath}/references${this.pathQuery}`);
   }
   /**
    * Gets the content of a specific reference file
@@ -3663,9 +3670,7 @@ var WorkspaceSkillResource = class extends BaseResource {
    * @returns Promise containing reference content
    */
   getReference(referencePath) {
-    return this.request(
-      `/workspaces/${encodeURIComponent(this.workspaceId)}/skills/${encodeURIComponent(this.skillName)}/references/${encodeURIComponent(referencePath)}`
-    );
+    return this.request(`${this.basePath}/references/${encodeURIComponent(referencePath)}${this.pathQuery}`);
   }
 };
 var Workspace = class extends BaseResource {
@@ -3848,10 +3853,11 @@ var Workspace = class extends BaseResource {
   /**
    * Gets a skill instance for further operations
    * @param skillName - Skill name identifier
+   * @param skillPath - Optional skill path for disambiguation when multiple skills share the same name
    * @returns WorkspaceSkillResource instance
    */
-  getSkill(skillName) {
-    return new WorkspaceSkillResource(this.options, this.workspaceId, skillName);
+  getSkill(skillName, skillPath) {
+    return new WorkspaceSkillResource(this.options, this.workspaceId, skillName, skillPath);
   }
 };