@mastra/client-js 1.8.5-alpha.0 → 1.9.0-alpha.2

package/dist/resources/observability.d.ts

@@ -1,6 +1,6 @@
 import type { ListScoresResponse } from '@mastra/core/evals';
 import type { SpanType } from '@mastra/core/observability';
-import type { TraceRecord, ListTracesArgs, ListTracesResponse, SpanIds, PaginationArgs, SpanRecord, PaginationInfo, ScoreTracesRequest, ScoreTracesResponse } from '@mastra/core/storage';
+import type { TraceRecord, ListTracesArgs, ListTracesResponse, SpanIds, PaginationArgs, SpanRecord, PaginationInfo, ScoreTracesRequest, ScoreTracesResponse, ListLogsArgs, ListLogsResponse, ListScoresArgs, ListScoresResponse as ListScoresResponseNew, CreateScoreBody, CreateScoreResponse, ListFeedbackArgs, ListFeedbackResponse, CreateFeedbackBody, CreateFeedbackResponse, GetMetricAggregateArgs, GetMetricAggregateResponse, GetMetricBreakdownArgs, GetMetricBreakdownResponse, GetMetricTimeSeriesArgs, GetMetricTimeSeriesResponse, GetMetricPercentilesArgs, GetMetricPercentilesResponse, GetMetricNamesArgs, GetMetricNamesResponse, GetMetricLabelKeysArgs, GetMetricLabelKeysResponse, GetMetricLabelValuesArgs, GetMetricLabelValuesResponse, GetEntityTypesResponse, GetEntityNamesArgs, GetEntityNamesResponse, GetServiceNamesResponse, GetEnvironmentsResponse, GetTagsArgs, GetTagsResponse } from '@mastra/core/storage';
 import type { ClientOptions } from '../types.js';
 import { BaseResource } from './base.js';
 /**
@@ -37,6 +37,7 @@ export interface LegacyGetTracesResponse {
     pagination: PaginationInfo;
 }
 export type ListScoresBySpanParams = SpanIds & PaginationArgs;
+/** Client resource for interacting with the Mastra observability API (traces, logs, scores, feedback, and metrics). */
 export declare class Observability extends BaseResource {
     constructor(options: ClientOptions);
     /**
@@ -74,5 +75,75 @@ export declare class Observability extends BaseResource {
      * @returns Promise containing the scoring status
      */
     score(params: ScoreTracesRequest): Promise<ScoreTracesResponse>;
+    /**
+     * Retrieves a paginated list of logs with optional filtering and sorting.
+     */
+    listLogs(params?: ListLogsArgs): Promise<ListLogsResponse>;
+    /**
+     * Retrieves a paginated list of scores with optional filtering and sorting.
+     */
+    listScores(params?: ListScoresArgs): Promise<ListScoresResponseNew>;
+    /**
+     * Creates a single score record in the observability store.
+     * Timestamp is set server-side.
+     */
+    createScore(params: CreateScoreBody): Promise<CreateScoreResponse>;
+    /**
+     * Retrieves a paginated list of feedback with optional filtering and sorting.
+     */
+    listFeedback(params?: ListFeedbackArgs): Promise<ListFeedbackResponse>;
+    /**
+     * Creates a single feedback record in the observability store.
+     * Timestamp is set server-side.
+     */
+    createFeedback(params: CreateFeedbackBody): Promise<CreateFeedbackResponse>;
+    /**
+     * Returns an aggregated metric value with optional period-over-period comparison.
+     */
+    getMetricAggregate(params: GetMetricAggregateArgs): Promise<GetMetricAggregateResponse>;
+    /**
+     * Returns metric values grouped by specified dimensions.
+     */
+    getMetricBreakdown(params: GetMetricBreakdownArgs): Promise<GetMetricBreakdownResponse>;
+    /**
+     * Returns metric values bucketed by time interval with optional grouping.
+     */
+    getMetricTimeSeries(params: GetMetricTimeSeriesArgs): Promise<GetMetricTimeSeriesResponse>;
+    /**
+     * Returns percentile values for a metric bucketed by time interval.
+     */
+    getMetricPercentiles(params: GetMetricPercentilesArgs): Promise<GetMetricPercentilesResponse>;
+    /**
+     * Returns distinct metric names with optional prefix filtering.
+     */
+    getMetricNames(params?: GetMetricNamesArgs): Promise<GetMetricNamesResponse>;
+    /**
+     * Returns distinct label keys for a given metric.
+     */
+    getMetricLabelKeys(params: GetMetricLabelKeysArgs): Promise<GetMetricLabelKeysResponse>;
+    /**
+     * Returns distinct values for a given metric label key.
+     */
+    getMetricLabelValues(params: GetMetricLabelValuesArgs): Promise<GetMetricLabelValuesResponse>;
+    /**
+     * Returns distinct entity types from observability data.
+     */
+    getEntityTypes(): Promise<GetEntityTypesResponse>;
+    /**
+     * Returns distinct entity names with optional type filtering.
+     */
+    getEntityNames(params?: GetEntityNamesArgs): Promise<GetEntityNamesResponse>;
+    /**
+     * Returns distinct service names from observability data.
+     */
+    getServiceNames(): Promise<GetServiceNamesResponse>;
+    /**
+     * Returns distinct environments from observability data.
+     */
+    getEnvironments(): Promise<GetEnvironmentsResponse>;
+    /**
+     * Returns distinct tags with optional entity type filtering.
+     */
+    getTags(params?: GetTagsArgs): Promise<GetTagsResponse>;
 }
 //# sourceMappingURL=observability.d.ts.map

package/dist/resources/observability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/resources/observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,OAAO,EACP,cAAc,EACd,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,IAAI,CAAC;QACb,GAAG,CAAC,EAAE,IAAI,CAAC;KACZ,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;KACnC,CAAC;IACF,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,cAAc,CAAC;AAM9D,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,aAAa;IAIlC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/C;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmC7E;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAKpE;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQ7E;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAMhE"}
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/resources/observability.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "1.8.5-alpha.0",
+  "version": "1.9.0-alpha.2",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -37,7 +37,7 @@
     "@ai-sdk/ui-utils": "^1.2.11",
     "@lukeed/uuid": "^2.0.1",
     "json-schema": "^0.4.0",
-    "@mastra/core": "1.13.3-alpha.0",
+    "@mastra/core": "1.14.0-alpha.2",
     "@mastra/schema-compat": "1.2.5-alpha.0"
   },
   "peerDependencies": {
@@ -45,7 +45,7 @@
   },
   "devDependencies": {
     "@types/json-schema": "^7.0.15",
-    "@types/node": "22.19.13",
+    "@types/node": "22.19.15",
     "@vitest/coverage-v8": "4.0.18",
     "@vitest/ui": "4.0.18",
     "eslint": "^9.39.4",
@@ -53,10 +53,10 @@
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
     "zod": "^4.3.6",
-    "@internal/ai-sdk-v5": "0.0.18",
     "@internal/ai-sdk-v4": "0.0.18",
-    "@internal/lint": "0.0.71",
-    "@internal/types-builder": "0.0.46"
+    "@internal/ai-sdk-v5": "0.0.18",
+    "@internal/types-builder": "0.0.46",
+    "@internal/lint": "0.0.71"
   },
   "engines": {
     "node": ">=22.13.0"