@mastra/client-js 1.20.0-alpha.2 → 1.20.0-alpha.4

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @mastra/client-js
 
+## 1.20.0-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`c272d50`](https://github.com/mastra-ai/mastra/commit/c272d50610a54496b6b6d92ccd4d37b333a2613a), [`d8692af`](https://github.com/mastra-ai/mastra/commit/d8692afa253028e39cdce2aafa0ac414071a762e), [`841a222`](https://github.com/mastra-ai/mastra/commit/841a222560d8c19238f8213713f30535cdd82284)]:
+  - @mastra/core@1.36.0-alpha.4
+
+## 1.20.0-alpha.3
+
+### Minor Changes
+
+- Added delta polling support for observability list endpoints. ([#16632](https://github.com/mastra-ai/mastra/pull/16632))
+
+  ```ts
+  const page = await client.observability.listTraces({
+    mode: 'page',
+    filters: { entityName: 'agent-1' },
+  });
+
+  const delta = await client.observability.listTraces({
+    mode: 'delta',
+    filters: { entityName: 'agent-1' },
+    after: page.deltaCursor,
+  });
+  ```
+
+  Use `mode: 'delta'` to fetch only new items after the last cursor.
+
+  Page-mode responses include `pagination` and `deltaCursor` when delta polling is supported. Delta-mode responses include `delta` and do not include `pagination`.
+
+  If you read these responses directly in typed code, note that `pagination` is only included in page mode.
+
+### Patch Changes
+
+- Updated dependencies [[`5556cc1`](https://github.com/mastra-ai/mastra/commit/5556cc1befec71518d84f826b3bfe3a079a9daf7), [`5499303`](https://github.com/mastra-ai/mastra/commit/54993032c1ebc09642625b78d2014e0cf84a3cae), [`e47bca7`](https://github.com/mastra-ai/mastra/commit/e47bca7b72866d3abd173b9f530ac4318113a8ff), [`0031d0f`](https://github.com/mastra-ai/mastra/commit/0031d0f13831d7843ac5d498734a7d92862e2ce3), [`3498b49`](https://github.com/mastra-ai/mastra/commit/3498b4946be94f4313cd817733589680dcda5278), [`359439b`](https://github.com/mastra-ai/mastra/commit/359439bb8c635e048176306828195f8297f50021)]:
+  - @mastra/core@1.36.0-alpha.3
+
 ## 1.20.0-alpha.2
 
 ### Minor 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.20.0-alpha.2"
+  version: "1.20.0-alpha.4"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.20.0-alpha.2",
+  "version": "1.20.0-alpha.4",
   "package": "@mastra/client-js",
   "exports": {
     "RequestContext": {

package/dist/docs/references/docs-agents-signals.md

@@ -1,6 +1,6 @@
 # Signals
 
-> **Experimental:** Agent signals are experimental. Breaking changes may occur without a major version bump until the API is stable.
+> **Experimental:** This feature is in alpha. Breaking changes may occur without a major version bump until the API is stable.
 
 Signals are a way to interact with an agent through a thread. Instead of starting every interaction with `agent.stream()`, subscribe to a thread and send signals. Mastra either wakes the agent when the thread is idle or drops the signal into the running agent loop.
 

package/dist/route-types.generated.d.ts

@@ -6851,10 +6851,10 @@ export type GetMemoryThreads_QueryParams = {
     metadata?: {
         [key: string]: any;
     } | undefined;
-    orderBy?: {
+    orderBy?: ({
         field?: ('createdAt' | 'updatedAt') | undefined;
         direction?: ('ASC' | 'DESC') | undefined;
-    } | undefined;
+    } | undefined) | undefined;
 };
 export type GetMemoryThreads_Response = {
     total: number;
@@ -6937,10 +6937,10 @@ export type GetMemoryThreadsThreadIdMessages_QueryParams = {
     perPage: number | undefined;
     agentId?: string | undefined;
     resourceId?: string | undefined;
-    orderBy?: {
+    orderBy?: ({
         field?: 'createdAt' | undefined;
         direction?: ('ASC' | 'DESC') | undefined;
-    } | undefined;
+    } | undefined) | undefined;
     include?: {
         id: string;
         threadId?: string | undefined;
@@ -7363,10 +7363,10 @@ export type GetMemoryNetworkThreads_QueryParams = {
     metadata?: {
         [key: string]: any;
     } | undefined;
-    orderBy?: {
+    orderBy?: ({
         field?: ('createdAt' | 'updatedAt') | undefined;
         direction?: ('ASC' | 'DESC') | undefined;
-    } | undefined;
+    } | undefined) | undefined;
 };
 export type GetMemoryNetworkThreads_Response = {
     total: number;
@@ -7449,10 +7449,10 @@ export type GetMemoryNetworkThreadsThreadIdMessages_QueryParams = {
     perPage: number | undefined;
     agentId?: string | undefined;
     resourceId?: string | undefined;
-    orderBy?: {
+    orderBy?: ({
         field?: 'createdAt' | undefined;
         direction?: ('ASC' | 'DESC') | undefined;
-    } | undefined;
+    } | undefined) | undefined;
     include?: {
         id: string;
         threadId?: string | undefined;
@@ -7905,7 +7905,7 @@ export type GetObservabilityTraces_QueryParams = {
     } | undefined) | undefined) | any;
     spanType?: (('agent_run' | 'scorer_run' | 'scorer_step' | 'generic' | 'model_generation' | 'model_step' | 'model_inference' | 'model_chunk' | 'mcp_tool_call' | 'processor_run' | 'tool_call' | 'workflow_run' | 'workflow_step' | 'workflow_conditional' | 'workflow_conditional_eval' | 'workflow_parallel' | 'workflow_loop' | 'workflow_sleep' | 'workflow_wait_event' | 'memory_operation' | 'workspace_action' | 'rag_ingestion' | 'rag_embedding' | 'rag_vector_operation' | 'rag_action' | 'graph_action' | 'mapping') | undefined) | undefined;
     traceId?: (string | undefined) | undefined;
-    entityType?: (string | undefined) | undefined;
+    entityType?: ((('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined) | undefined;
     entityId?: ((string | null) | undefined) | undefined;
     entityName?: ((string | null) | undefined) | undefined;
     parentEntityType?: ((('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined) | undefined;
@@ -7937,10 +7937,6 @@ export type GetObservabilityTraces_QueryParams = {
     tags?: (((string[] | null) | undefined) | undefined) | any;
     status?: (('success' | 'error' | 'running') | undefined) | undefined;
     hasChildError?: (boolean | undefined) | undefined;
-    page?: (number | undefined) | undefined;
-    perPage?: (number | undefined) | undefined;
-    field?: ('startedAt' | 'endedAt') | undefined;
-    direction?: ('ASC' | 'DESC') | undefined;
     dateRange?: (({
         /** Start of date range (inclusive by default) */
         start?: Date | undefined;
@@ -7952,9 +7948,16 @@ export type GetObservabilityTraces_QueryParams = {
         endExclusive?: boolean | undefined;
     } | undefined) | undefined) | any;
     name?: (string | undefined) | undefined;
+    page?: (number | undefined) | undefined;
+    perPage?: (number | undefined) | undefined;
+    field?: ('startedAt' | 'endedAt') | undefined;
+    direction?: ('ASC' | 'DESC') | undefined;
+    mode?: (('page' | 'delta') | undefined) | undefined;
+    after?: (string | undefined) | undefined;
+    limit?: (number | undefined) | undefined;
 };
 export type GetObservabilityTraces_Response = {
-    pagination: {
+    pagination?: {
         /** Total number of items available */
         total: number;
         /** Current page */
@@ -7963,7 +7966,14 @@ export type GetObservabilityTraces_Response = {
         perPage: number | false;
         /** True if more pages are available */
         hasMore: boolean;
-    };
+    } | undefined;
+    delta?: {
+        /** Maximum number of updates requested for this delta poll */
+        limit: number;
+        /** True when more matching updates remain after this response */
+        hasMore: boolean;
+    } | undefined;
+    deltaCursor?: string | undefined;
     spans: {
         /** Unique trace identifier */
         traceId: string;
@@ -8230,9 +8240,12 @@ export type GetObservabilityBranches_QueryParams = {
     perPage?: (number | undefined) | undefined;
     field?: ('startedAt' | 'endedAt') | undefined;
     direction?: ('ASC' | 'DESC') | undefined;
+    mode?: (('page' | 'delta') | undefined) | undefined;
+    after?: (string | undefined) | undefined;
+    limit?: (number | undefined) | undefined;
 };
 export type GetObservabilityBranches_Response = {
-    pagination: {
+    pagination?: {
         /** Total number of items available */
         total: number;
         /** Current page */
@@ -8241,7 +8254,14 @@ export type GetObservabilityBranches_Response = {
         perPage: number | false;
         /** True if more pages are available */
         hasMore: boolean;
-    };
+    } | undefined;
+    delta?: {
+        /** Maximum number of updates requested for this delta poll */
+        limit: number;
+        /** True when more matching updates remain after this response */
+        hasMore: boolean;
+    } | undefined;
+    deltaCursor?: string | undefined;
     branches: {
         /** Unique trace identifier */
         traceId: string;
@@ -8798,6 +8818,148 @@ export interface GetObservabilityTracesTraceIdSpanIdScores_RouteContract {
     response: GetObservabilityTracesTraceIdSpanIdScores_Response;
     responseType: 'json';
 }
+export type GetObservabilityMetrics_QueryParams = {
+    timestamp?: (({
+        /** Start of date range (inclusive by default) */
+        start?: Date | undefined;
+        /** End of date range (inclusive by default) */
+        end?: Date | undefined;
+        /** When true, excludes the start date from results (uses > instead of >=) */
+        startExclusive?: boolean | undefined;
+        /** When true, excludes the end date from results (uses < instead of <=) */
+        endExclusive?: boolean | undefined;
+    } | undefined) | undefined) | any;
+    traceId?: (string | undefined) | undefined;
+    spanId?: (string | undefined) | undefined;
+    entityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | undefined) | undefined;
+    entityName?: (string | undefined) | undefined;
+    entityVersionId?: (string | undefined) | undefined;
+    parentEntityVersionId?: (string | undefined) | undefined;
+    rootEntityVersionId?: (string | undefined) | undefined;
+    userId?: (string | undefined) | undefined;
+    organizationId?: (string | undefined) | undefined;
+    experimentId?: (string | undefined) | undefined;
+    serviceName?: (string | undefined) | undefined;
+    environment?: (string | undefined) | undefined;
+    parentEntityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | undefined) | undefined;
+    parentEntityName?: (string | undefined) | undefined;
+    rootEntityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | undefined) | undefined;
+    rootEntityName?: (string | undefined) | undefined;
+    resourceId?: (string | undefined) | undefined;
+    runId?: (string | undefined) | undefined;
+    sessionId?: (string | undefined) | undefined;
+    threadId?: (string | undefined) | undefined;
+    requestId?: (string | undefined) | undefined;
+    executionSource?: (string | undefined) | undefined;
+    tags?: ((string[] | undefined) | undefined) | any;
+    name?: ((string[] | undefined) | undefined) | any;
+    source?: (string | undefined) | undefined;
+    provider?: (string | undefined) | undefined;
+    model?: (string | undefined) | undefined;
+    costUnit?: (string | undefined) | undefined;
+    labels?: (({
+        [key: string]: string;
+    } | undefined) | undefined) | any;
+    page?: (number | undefined) | undefined;
+    perPage?: (number | undefined) | undefined;
+    field?: 'timestamp' | undefined;
+    direction?: ('ASC' | 'DESC') | undefined;
+    mode?: (('page' | 'delta') | undefined) | undefined;
+    after?: (string | undefined) | undefined;
+    limit?: (number | undefined) | undefined;
+};
+export type GetObservabilityMetrics_Response = {
+    pagination?: {
+        /** Total number of items available */
+        total: number;
+        /** Current page */
+        page: number;
+        /** Number of items per page, or false if pagination is disabled */
+        perPage: number | false;
+        /** True if more pages are available */
+        hasMore: boolean;
+    } | undefined;
+    delta?: {
+        /** Maximum number of updates requested for this delta poll */
+        limit: number;
+        /** True when more matching updates remain after this response */
+        hasMore: boolean;
+    } | undefined;
+    deltaCursor?: string | undefined;
+    metrics: {
+        /** Unique id for this metric event */
+        metricId?: (string | null) | undefined;
+        /** When the metric was recorded */
+        timestamp: Date;
+        /** Metric name (e.g., mastra_agent_duration_ms) */
+        name: string;
+        /** Metric value */
+        value: number;
+        traceId?: (string | null) | undefined;
+        spanId?: (string | null) | undefined;
+        entityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined;
+        entityId?: (string | null) | undefined;
+        entityName?: (string | null) | undefined;
+        parentEntityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined;
+        parentEntityId?: (string | null) | undefined;
+        parentEntityName?: (string | null) | undefined;
+        rootEntityType?: (('agent' | 'scorer' | 'rag_ingestion' | 'trajectory' | 'input_processor' | 'input_step_processor' | 'output_processor' | 'output_step_processor' | 'workflow_step' | 'tool' | 'workflow_run' | 'memory') | null) | undefined;
+        rootEntityId?: (string | null) | undefined;
+        rootEntityName?: (string | null) | undefined;
+        userId?: (string | null) | undefined;
+        organizationId?: (string | null) | undefined;
+        resourceId?: (string | null) | undefined;
+        runId?: (string | null) | undefined;
+        sessionId?: (string | null) | undefined;
+        threadId?: (string | null) | undefined;
+        requestId?: (string | null) | undefined;
+        environment?: (string | null) | undefined;
+        serviceName?: (string | null) | undefined;
+        scope?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+        entityVersionId?: (string | null) | undefined;
+        parentEntityVersionId?: (string | null) | undefined;
+        rootEntityVersionId?: (string | null) | undefined;
+        experimentId?: (string | null) | undefined;
+        executionSource?: (string | null) | undefined;
+        tags?: (string[] | null) | undefined;
+        /** Execution source */
+        source?: (string | null) | undefined;
+        provider?: (string | null) | undefined;
+        model?: (string | null) | undefined;
+        estimatedCost?: (number | null) | undefined;
+        costUnit?: (string | null) | undefined;
+        costMetadata?: ((({
+            [key: string]: unknown;
+        } | null) | undefined) | null) | undefined;
+        labels: {
+            [key: string]: string;
+        };
+        metadata?: ({
+            [key: string]: unknown;
+        } | null) | undefined;
+    }[];
+};
+export type GetObservabilityMetrics_Request = Simplify<(never extends never ? {} : {
+    params: never;
+}) & (GetObservabilityMetrics_QueryParams extends never ? {} : {} extends GetObservabilityMetrics_QueryParams ? {
+    query?: GetObservabilityMetrics_QueryParams;
+} : {
+    query: GetObservabilityMetrics_QueryParams;
+}) & (never extends never ? {} : {} extends never ? {
+    body?: never;
+} : {
+    body: never;
+})>;
+export interface GetObservabilityMetrics_RouteContract {
+    pathParams: never;
+    queryParams: GetObservabilityMetrics_QueryParams;
+    body: never;
+    request: GetObservabilityMetrics_Request;
+    response: GetObservabilityMetrics_Response;
+    responseType: 'json';
+}
 export type GetObservabilityLogs_QueryParams = {
     timestamp?: (({
         /** Start of date range (inclusive by default) */
@@ -8838,9 +9000,12 @@ export type GetObservabilityLogs_QueryParams = {
     perPage?: (number | undefined) | undefined;
     field?: 'timestamp' | undefined;
     direction?: ('ASC' | 'DESC') | undefined;
+    mode?: (('page' | 'delta') | undefined) | undefined;
+    after?: (string | undefined) | undefined;
+    limit?: (number | undefined) | undefined;
 };
 export type GetObservabilityLogs_Response = {
-    pagination: {
+    pagination?: {
         /** Total number of items available */
         total: number;
         /** Current page */
@@ -8849,7 +9014,14 @@ export type GetObservabilityLogs_Response = {
         perPage: number | false;
         /** True if more pages are available */
         hasMore: boolean;
-    };
+    } | undefined;
+    delta?: {
+        /** Maximum number of updates requested for this delta poll */
+        limit: number;
+        /** True when more matching updates remain after this response */
+        hasMore: boolean;
+    } | undefined;
+    deltaCursor?: string | undefined;
     logs: {
         /** Unique id for this log event */
         logId?: (string | null) | undefined;
@@ -8958,9 +9130,12 @@ export type GetObservabilityScores_QueryParams = {
     perPage?: (number | undefined) | undefined;
     field?: ('timestamp' | 'score') | undefined;
     direction?: ('ASC' | 'DESC') | undefined;
+    mode?: (('page' | 'delta') | undefined) | undefined;
+    after?: (string | undefined) | undefined;
+    limit?: (number | undefined) | undefined;
 };
 export type GetObservabilityScores_Response = {
-    pagination: {
+    pagination?: {
         /** Total number of items available */
         total: number;
         /** Current page */
@@ -8969,7 +9144,14 @@ export type GetObservabilityScores_Response = {
         perPage: number | false;
         /** True if more pages are available */
         hasMore: boolean;
-    };
+    } | undefined;
+    delta?: {
+        /** Maximum number of updates requested for this delta poll */
+        limit: number;
+        /** True when more matching updates remain after this response */
+        hasMore: boolean;
+    } | undefined;
+    deltaCursor?: string | undefined;
     scores: {
         /** Unique id for this score event */
         scoreId?: (string | null) | undefined;
@@ -9568,9 +9750,12 @@ export type GetObservabilityFeedback_QueryParams = {
     perPage?: (number | undefined) | undefined;
     field?: 'timestamp' | undefined;
     direction?: ('ASC' | 'DESC') | undefined;
+    mode?: (('page' | 'delta') | undefined) | undefined;
+    after?: (string | undefined) | undefined;
+    limit?: (number | undefined) | undefined;
 };
 export type GetObservabilityFeedback_Response = {
-    pagination: {
+    pagination?: {
         /** Total number of items available */
         total: number;
         /** Current page */
@@ -9579,7 +9764,14 @@ export type GetObservabilityFeedback_Response = {
         perPage: number | false;
         /** True if more pages are available */
         hasMore: boolean;
-    };
+    } | undefined;
+    delta?: {
+        /** Maximum number of updates requested for this delta poll */
+        limit: number;
+        /** True when more matching updates remain after this response */
+        hasMore: boolean;
+    } | undefined;
+    deltaCursor?: string | undefined;
     feedback: {
         /** Unique id for this feedback event */
         feedbackId?: (string | null) | undefined;
@@ -42726,6 +42918,7 @@ export interface RouteTypes {
     'GET /observability/traces/:traceId/trajectory': GetObservabilityTracesTraceIdTrajectory_RouteContract;
     'POST /observability/traces/score': PostObservabilityTracesScore_RouteContract;
     'GET /observability/traces/:traceId/:spanId/scores': GetObservabilityTracesTraceIdSpanIdScores_RouteContract;
+    'GET /observability/metrics': GetObservabilityMetrics_RouteContract;
     'GET /observability/logs': GetObservabilityLogs_RouteContract;
     'GET /observability/scores': GetObservabilityScores_RouteContract;
     'POST /observability/scores': PostObservabilityScores_RouteContract;
@@ -43331,6 +43524,9 @@ export interface Client {
     '/observability/logs': {
         GET: GetObservabilityLogs_RouteContract;
     };
+    '/observability/metrics': {
+        GET: GetObservabilityMetrics_RouteContract;
+    };
     '/observability/metrics/aggregate': {
         POST: PostObservabilityMetricsAggregate_RouteContract;
     };