@mastra/client-js 1.38.0 → 1.39.0-alpha.1

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export * from './types.js';
 export * from './tools.js';
 export type { ChannelPlatformInfo, ChannelInstallationInfo, ChannelConnectOAuth, ChannelConnectDeepLink, ChannelConnectImmediate, ChannelConnectResult, } from './resources/channels.js';
 export type { AgentCardSignatureKeyProviderInput, AgentCardVerificationKey, GetAgentCardOptions, VerifyAgentCardSignatureOptions, } from './resources/a2a.js';
-export { agentControllerMessageText } from './resources/agent-controller.js';
+export { agentControllerMessageText, isKnownAgentControllerEvent } from './resources/agent-controller.js';
 export type { AgentControllerInfo, MastraDBMessage, MastraMessageContentV2, MastraMessagePart, AgentControllerEvent, KnownAgentControllerEvent, OtherAgentControllerEvent, CreateAgentControllerSessionResponse, AgentControllerRequestOptions, SubscribeAgentControllerSessionOptions, AgentControllerSubscription, AgentControllerSessionState, AgentControllerSessionSettings, AgentControllerOMProgress, AgentControllerModeInfo, AgentControllerThreadInfo, AgentControllerTaskSnapshot, AgentControllerAvailableModel, AgentControllerWorkspaceStatus, AgentControllerGoalRecord, SendNotificationInput, SendNotificationResult, PlanResume, PermissionPolicy, PermissionRules, ToolCategory, } from './resources/agent-controller.js';
 export { RequestContext } from '@mastra/core/request-context';
 export type { ObservabilityCollector } from './observability/types.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,kCAAkC,EAClC,wBAAwB,EACxB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,oCAAoC,EACpC,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,GACb,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EACV,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,kCAAkC,EAClC,wBAAwB,EACxB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACvG,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,oCAAoC,EACpC,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,GACb,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EACV,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -4208,6 +4208,24 @@ var Observability = class extends BaseResource {
 		return this.request(`/observability/traces${queryString ? `?${queryString}` : ""}`);
 	}
 	/**
+	* Retrieves paginated list of traces carrying only the fields a trace list renders.
+	*
+	* Same filtering, ordering and delta-polling contract as {@link listTraces}, but rows
+	* omit the `attributes`/`input`/`output` blobs and carry a short `inputPreview`
+	* instead. Prefer this for list views and fetch the full record on selection.
+	*
+	* @param params - Parameters for pagination, filtering, and ordering
+	* @returns Promise containing paginated lightweight traces and pagination info
+	*/
+	listTracesLight(params = {}) {
+		const queryString = toQueryParams(params, [
+			"filters",
+			"pagination",
+			"orderBy"
+		]);
+		return this.request(`/observability/traces/light${queryString ? `?${queryString}` : ""}`);
+	}
+	/**
 	* Retrieves a paginated list of trace branches with optional filtering and sorting.
 	*
 	* Each row is a single branch-anchor span (e.g., AGENT_RUN, WORKFLOW_RUN, TOOL_CALL),
@@ -5528,6 +5546,58 @@ var Channels = class extends BaseResource {
 };
 //#endregion
 //#region src/resources/agent-controller.ts
+const KNOWN_AGENT_CONTROLLER_EVENT_TYPES = new Set(Object.keys({
+	agent_start: true,
+	agent_end: true,
+	message_start: true,
+	message_update: true,
+	message_end: true,
+	tool_input_start: true,
+	tool_input_delta: true,
+	tool_input_end: true,
+	tool_start: true,
+	tool_update: true,
+	shell_output: true,
+	tool_end: true,
+	tool_approval_required: true,
+	tool_suspended: true,
+	mode_changed: true,
+	model_changed: true,
+	thread_changed: true,
+	thread_created: true,
+	thread_deleted: true,
+	subagent_start: true,
+	subagent_end: true,
+	task_updated: true,
+	notification: true,
+	notification_summary: true,
+	usage_update: true,
+	display_state_changed: true,
+	goal_evaluation: true,
+	follow_up_queued: true,
+	om_observation_start: true,
+	om_observation_end: true,
+	om_observation_failed: true,
+	om_reflection_start: true,
+	om_reflection_end: true,
+	om_reflection_failed: true,
+	om_buffering_start: true,
+	om_buffering_end: true,
+	om_buffering_failed: true,
+	om_model_changed: true,
+	om_activation: true,
+	om_status: true,
+	om_thread_title_updated: true,
+	workspace_ready: true,
+	workspace_error: true,
+	workspace_status_changed: true,
+	info: true,
+	error: true
+}));
+/** Narrows to the explicitly typed events; see {@link AgentControllerEvent}. */
+function isKnownAgentControllerEvent(event) {
+	return KNOWN_AGENT_CONTROLLER_EVENT_TYPES.has(event.type);
+}
 function hydrateMessage(message) {
 	return {
 		...message,
@@ -6558,6 +6628,17 @@ var MastraClient = class extends BaseResource {
 		return this.observability.listTraces(params);
 	}
 	/**
+	* Retrieves paginated list of traces carrying only the fields a trace list renders.
+	* Same contract as {@link listTraces}, but rows omit the `attributes`/`input`/`output`
+	* blobs and carry a short `inputPreview` instead.
+	*
+	* @param params - Parameters for pagination, filtering, and ordering
+	* @returns Promise containing paginated lightweight traces and pagination info
+	*/
+	listTracesLight(params = {}) {
+		return this.observability.listTracesLight(params);
+	}
+	/**
 	* Retrieves a paginated list of trace branches with optional filtering and sorting.
 	* Each row is a branch-anchor span (AGENT_RUN, WORKFLOW_RUN, TOOL_CALL, etc.) including
 	* ones nested under a different root entity. Pairs with {@link getBranch} to expand
@@ -7243,10 +7324,14 @@ var MastraClient = class extends BaseResource {
 	/**
 	* Lists all experiments across all datasets
 	*/
-	listExperiments(pagination) {
+	listExperiments(params) {
 		const searchParams = new URLSearchParams();
-		if (pagination?.page !== void 0) searchParams.set("page", String(pagination.page));
-		if (pagination?.perPage !== void 0) searchParams.set("perPage", String(pagination.perPage));
+		if (params?.page !== void 0) searchParams.set("page", String(params.page));
+		if (params?.perPage !== void 0) searchParams.set("perPage", String(params.perPage));
+		if (params?.experimentSetId !== void 0) searchParams.set("experimentSetId", params.experimentSetId);
+		if (params?.comparisonId !== void 0) searchParams.set("comparisonId", params.comparisonId);
+		if (params?.variantId !== void 0) searchParams.set("variantId", params.variantId);
+		if (params?.trialIndex !== void 0) searchParams.set("trialIndex", String(params.trialIndex));
 		const qs = searchParams.toString();
 		return this.request(`/experiments${qs ? `?${qs}` : ""}`);
 	}
@@ -7259,10 +7344,14 @@ var MastraClient = class extends BaseResource {
 	/**
 	* Lists experiments for a dataset
 	*/
-	listDatasetExperiments(datasetId, pagination) {
+	listDatasetExperiments(datasetId, params) {
 		const searchParams = new URLSearchParams();
-		if (pagination?.page !== void 0) searchParams.set("page", String(pagination.page));
-		if (pagination?.perPage !== void 0) searchParams.set("perPage", String(pagination.perPage));
+		if (params?.page !== void 0) searchParams.set("page", String(params.page));
+		if (params?.perPage !== void 0) searchParams.set("perPage", String(params.perPage));
+		if (params?.experimentSetId !== void 0) searchParams.set("experimentSetId", params.experimentSetId);
+		if (params?.comparisonId !== void 0) searchParams.set("comparisonId", params.comparisonId);
+		if (params?.variantId !== void 0) searchParams.set("variantId", params.variantId);
+		if (params?.trialIndex !== void 0) searchParams.set("trialIndex", String(params.trialIndex));
 		const qs = searchParams.toString();
 		return this.request(`/datasets/${encodeURIComponent(datasetId)}/experiments${qs ? `?${qs}` : ""}`);
 	}
@@ -7479,6 +7568,6 @@ function createTool(opts) {
 	return new ClientTool(opts);
 }
 //#endregion
-export { ClientTool, MastraClient, MastraClientError, RequestContext, agentControllerMessageText, createTool };
+export { ClientTool, MastraClient, MastraClientError, RequestContext, agentControllerMessageText, createTool, isKnownAgentControllerEvent };
 
 //# sourceMappingURL=index.js.map