@mastra/client-js 1.57.1-alpha.1 → 1.58.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/client.d.ts +32 -0
- package/dist/client.d.ts.map +1 -1
- package/dist/docs/SKILL.md +2 -2
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/dist/docs/references/integrations-auth-workos.md +2 -0
- package/dist/docs/references/reference-client-js-observability.md +6 -23
- package/dist/docs/references/reference-observability-tracing-advanced-queries.md +226 -86
- package/dist/index.cjs +50 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +50 -1
- package/dist/index.js.map +1 -1
- package/dist/resources/observability.d.ts +1 -1
- package/dist/route-types.generated.d.ts +310 -122
- package/dist/route-types.generated.d.ts.map +1 -1
- package/dist/types.d.ts +12 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +6 -6
package/dist/index.d.ts
CHANGED
|
@@ -10,6 +10,7 @@ export { RequestContext } from '@mastra/core/request-context';
|
|
|
10
10
|
export type { ObservabilityCollector } from './observability/types.js';
|
|
11
11
|
export type { QuerySpansInput, QuerySpansResult, QueryTraceThreadsInput, QueryTraceThreadsResult, QueryTracesInput, QueryTracesDeltaInput, QueryTracesKeysetInput, QueryTracesPaginatedInput, } from './resources/observability.js';
|
|
12
12
|
export type { UIMessageWithMetadata } from '@mastra/core/agent';
|
|
13
|
+
export type { DashboardColumn, DashboardDefaults, DashboardDefinition, DashboardDefinitionEnvelope, DashboardDrilldown, DashboardDrilldownTarget, DashboardQuery, DashboardRow, DashboardWidget, DashboardBuiltInWidgetKind, DashboardWidgetView, NormalizedDashboardDefinition, NormalizedDashboardQuery, } from '@mastra/core/storage';
|
|
13
14
|
export type { GetMetricTimeSeriesResponse } from './types.js';
|
|
14
15
|
export type { AggregateTracesArgs, AggregateTracesResponse, AggregateSpansArgs, AggregateSpansResponse, TraceAggregateDiscovery, GetTraceQueryFieldsArgs, GetTraceQueryFieldsResponse, GetTraceQueryValuesArgs, GetTraceQueryValuesResponse, TraceQueryCanonicalFieldDescriptor, TraceQueryGroupResponse, TraceQueryKeysetTraceResponse, TraceQueryObservedFieldDescriptor, TraceQueryOperator, TraceQueryPredicateScope, TraceQueryResponse, TraceQueryTraceResponse, TraceQueryValueKind, } from './resources/observability-route-types.js';
|
|
15
16
|
export type { Body, Client, ClientMethod, ClientPath, ClientRequest, ClientResponse, ClientResponseKind, ClientRoute, PathParams, QueryParams, RouteKey, RouteRequest, RouteResponse, RouteResponseType, RouteTypes, } from './route-types.generated.js';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +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,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACvG,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,EACV,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC3D,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,kCAAkC,EAClC,uBAAuB,EACvB,6BAA6B,EAC7B,iCAAiC,EACjC,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC;AAC/C,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"}
|
|
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,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACvG,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,EACV,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC3D,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,kCAAkC,EAClC,uBAAuB,EACvB,6BAA6B,EAC7B,iCAAiC,EACjC,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC;AAC/C,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
CHANGED
|
@@ -5393,7 +5393,7 @@ var Observability = class extends BaseResource {
|
|
|
5393
5393
|
* Queries completed spans using a span predicate, returning one row per matching span.
|
|
5394
5394
|
*
|
|
5395
5395
|
* @param params - Span query, including its required time range
|
|
5396
|
-
* @returns Matching span rows with
|
|
5396
|
+
* @returns Matching span rows with model/provider fields and input/output/error previews
|
|
5397
5397
|
*/
|
|
5398
5398
|
querySpans(params) {
|
|
5399
5399
|
return this.request("/observability/spans/query", {
|
|
@@ -8047,6 +8047,55 @@ var MastraClient = class extends BaseResource {
|
|
|
8047
8047
|
});
|
|
8048
8048
|
}
|
|
8049
8049
|
/**
|
|
8050
|
+
* Lists which tools an MCP server runs as tasks, and its recent tasks across principals
|
|
8051
|
+
* (experimental). `unavailable` says why `tasks` is empty for a store that can't be listed
|
|
8052
|
+
* or a resource-scoped caller.
|
|
8053
|
+
* @param serverId - The ID of the MCP server.
|
|
8054
|
+
* @param params - Optional `limit`, `status`, `surface` and `client` (a listed `principalKey`)
|
|
8055
|
+
* filters, and the `cursor` from the previous page's `nextCursor`.
|
|
8056
|
+
*/
|
|
8057
|
+
getMcpServerTasks(serverId, params = {}) {
|
|
8058
|
+
const searchParams = new URLSearchParams();
|
|
8059
|
+
for (const [name, value] of Object.entries(params)) if (value !== void 0) searchParams.set(name, String(value));
|
|
8060
|
+
const query = searchParams.size ? `?${searchParams}` : "";
|
|
8061
|
+
return this.request(`/mcp/${encodeURIComponent(serverId)}/tasks${query}`);
|
|
8062
|
+
}
|
|
8063
|
+
/**
|
|
8064
|
+
* Finds an MCP server task by its MCP task id, as a client sees it (experimental). The server
|
|
8065
|
+
* hashes the id before the lookup; it is sent in the body so it stays out of URLs and logs.
|
|
8066
|
+
* Rejects with 404 for an unknown task.
|
|
8067
|
+
* @param serverId - The ID of the MCP server.
|
|
8068
|
+
* @param taskId - The MCP task id.
|
|
8069
|
+
*/
|
|
8070
|
+
findMcpServerTask(serverId, taskId) {
|
|
8071
|
+
return this.request(`/mcp/${encodeURIComponent(serverId)}/tasks/find`, {
|
|
8072
|
+
method: "POST",
|
|
8073
|
+
body: { taskId }
|
|
8074
|
+
});
|
|
8075
|
+
}
|
|
8076
|
+
/**
|
|
8077
|
+
* Cancels an MCP server task by key, like the `tasks/cancel` MCP request (experimental).
|
|
8078
|
+
* Rejects with 404 once the task is no longer running.
|
|
8079
|
+
* @param serverId - The ID of the MCP server.
|
|
8080
|
+
* @param taskKey - The task's `taskKey`, as listed.
|
|
8081
|
+
*/
|
|
8082
|
+
cancelMcpServerTask(serverId, taskKey) {
|
|
8083
|
+
return this.request(`/mcp/${encodeURIComponent(serverId)}/tasks/${encodeURIComponent(taskKey)}/cancel`, { method: "POST" });
|
|
8084
|
+
}
|
|
8085
|
+
/**
|
|
8086
|
+
* Answers an MCP server task's open input requests, like the `tasks/update` MCP request
|
|
8087
|
+
* (experimental). Rejects with 404 unless the task is waiting for one of them.
|
|
8088
|
+
* @param serverId - The ID of the MCP server.
|
|
8089
|
+
* @param taskKey - The task's `taskKey`, as listed.
|
|
8090
|
+
* @param inputResponses - Answers keyed by input request, e.g. `{ approve: { action: 'accept', content: {...} } }`.
|
|
8091
|
+
*/
|
|
8092
|
+
answerMcpServerTaskInput(serverId, taskKey, inputResponses) {
|
|
8093
|
+
return this.request(`/mcp/${encodeURIComponent(serverId)}/tasks/${encodeURIComponent(taskKey)}/input`, {
|
|
8094
|
+
method: "POST",
|
|
8095
|
+
body: { inputResponses }
|
|
8096
|
+
});
|
|
8097
|
+
}
|
|
8098
|
+
/**
|
|
8050
8099
|
* Gets an A2A client for interacting with an agent via the A2A protocol
|
|
8051
8100
|
* @param agentId - ID of the agent to interact with
|
|
8052
8101
|
* @returns A2A client instance
|