@mastra/client-js 1.60.0-alpha.1 → 1.60.0-alpha.11
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 +10 -3
- package/dist/client.d.ts.map +1 -1
- package/dist/docs/SKILL.md +1 -1
- package/dist/docs/assets/SOURCE_MAP.json +6 -6
- package/dist/docs/references/docs-harness-schedules.md +1 -1
- package/dist/docs/references/reference-client-js-observability.md +13 -5
- package/dist/docs/references/reference-observability-tracing-advanced-queries.md +2 -1
- package/dist/index.cjs +55 -30
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +55 -30
- package/dist/index.js.map +1 -1
- package/dist/resources/agent.d.ts +2 -2
- package/dist/resources/agent.d.ts.map +1 -1
- package/dist/resources/observability-route-types.d.ts +8 -10
- package/dist/resources/observability-route-types.d.ts.map +1 -1
- package/dist/resources/observability.d.ts +7 -1
- package/dist/resources/observability.d.ts.map +1 -1
- package/dist/route-types.generated.d.ts +125 -18
- package/dist/route-types.generated.d.ts.map +1 -1
- package/dist/types.d.ts +2 -2
- package/dist/types.d.ts.map +1 -1
- package/package.json +3 -3
package/dist/index.d.ts
CHANGED
|
@@ -16,5 +16,5 @@ export type { GetMetricTimeSeriesResponse } from './types.js';
|
|
|
16
16
|
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';
|
|
17
17
|
export type { Body, Client, ClientMethod, ClientPath, ClientRequest, ClientResponse, ClientResponseKind, ClientRoute, PathParams, QueryParams, RouteKey, RouteRequest, RouteResponse, RouteResponseType, RouteTypes, } from './route-types.generated.js';
|
|
18
18
|
export type { SignalWriteOptions } from './resources/signal-writes.js';
|
|
19
|
-
export type { CreateFeedbackBody, CreateFeedbackResponse, CreateScoreBody, CreateScoreResponse, ReplaceFeedbackBody, } from './resources/observability-route-types.js';
|
|
19
|
+
export type { CreateFeedbackBody, CreateFeedbackResponse, CreateScoreBody, CreateScoreResponse, DeleteFeedbackResponse, DeleteScoresResponse, DeleteTracesResponse, ReplaceFeedbackBody, } from './resources/observability-route-types.js';
|
|
20
20
|
//# sourceMappingURL=index.d.ts.map
|
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,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,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;AAEpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uCAAuC,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,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,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;AAEpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -1315,11 +1315,13 @@ async function executeClientToolWithObservability({ clientTool, args, toolName,
|
|
|
1315
1315
|
}
|
|
1316
1316
|
};
|
|
1317
1317
|
}
|
|
1318
|
-
async function executeToolCallAndRespond({ response, params, agentId, resourceId, threadId, requestContext, respondFn }) {
|
|
1318
|
+
async function executeToolCallAndRespond({ response, params, agentId, resourceId, threadId, requestContext, respondFn, abortSignal }) {
|
|
1319
1319
|
if (response.finishReason === "tool-calls") {
|
|
1320
1320
|
const toolCalls = response.toolCalls;
|
|
1321
1321
|
if (!toolCalls || !Array.isArray(toolCalls)) return response;
|
|
1322
|
+
const toolResults = [];
|
|
1322
1323
|
for (const toolCall of toolCalls) {
|
|
1324
|
+
if (abortSignal?.aborted) throw abortSignal.reason ?? new DOMException("This operation was aborted", "AbortError");
|
|
1323
1325
|
const clientTool = params.clientTools?.[toolCall.payload.toolName];
|
|
1324
1326
|
if (clientTool && clientTool.execute) {
|
|
1325
1327
|
const { result, observability } = await executeClientToolWithObservability({
|
|
@@ -1349,19 +1351,22 @@ async function executeToolCallAndRespond({ response, params, agentId, resourceId
|
|
|
1349
1351
|
...modelOutput != null ? { providerOptions: { mastra: { modelOutput } } } : {}
|
|
1350
1352
|
};
|
|
1351
1353
|
if (observability) toolResultContent.__mastraObservability = observability;
|
|
1352
|
-
|
|
1353
|
-
role: "tool",
|
|
1354
|
-
content: [toolResultContent]
|
|
1355
|
-
}];
|
|
1356
|
-
const updatedMessages = threadId ? newMessages : [...Array.isArray(params.messages) ? params.messages : [], ...newMessages];
|
|
1357
|
-
const respondOptions = {
|
|
1358
|
-
...params,
|
|
1359
|
-
clientTools: params.clientToolsResolver?.() ?? params.clientTools
|
|
1360
|
-
};
|
|
1361
|
-
delete respondOptions.messages;
|
|
1362
|
-
return respondFn(updatedMessages, respondOptions);
|
|
1354
|
+
toolResults.push(toolResultContent);
|
|
1363
1355
|
}
|
|
1364
1356
|
}
|
|
1357
|
+
if (toolResults.length > 0) {
|
|
1358
|
+
const newMessages = [...response.response.messages || [], {
|
|
1359
|
+
role: "tool",
|
|
1360
|
+
content: toolResults
|
|
1361
|
+
}];
|
|
1362
|
+
const updatedMessages = threadId ? newMessages : [...Array.isArray(params.messages) ? params.messages : [], ...newMessages];
|
|
1363
|
+
const respondOptions = {
|
|
1364
|
+
...params,
|
|
1365
|
+
clientTools: params.clientToolsResolver?.() ?? params.clientTools
|
|
1366
|
+
};
|
|
1367
|
+
delete respondOptions.messages;
|
|
1368
|
+
return respondFn(updatedMessages, respondOptions);
|
|
1369
|
+
}
|
|
1365
1370
|
}
|
|
1366
1371
|
return response;
|
|
1367
1372
|
}
|
|
@@ -2058,7 +2063,9 @@ var Agent = class extends BaseResource {
|
|
|
2058
2063
|
if (abortSignal?.aborted) throw abortSignal.reason ?? new DOMException("This operation was aborted", "AbortError");
|
|
2059
2064
|
const toolCalls = response.toolCalls;
|
|
2060
2065
|
if (!toolCalls || !Array.isArray(toolCalls)) return response;
|
|
2066
|
+
const toolResults = [];
|
|
2061
2067
|
for (const toolCall of toolCalls) {
|
|
2068
|
+
if (abortSignal?.aborted) throw abortSignal.reason ?? new DOMException("This operation was aborted", "AbortError");
|
|
2062
2069
|
const clientTool = processedParams.clientTools?.[toolCall.toolName];
|
|
2063
2070
|
if (clientTool && clientTool.execute) {
|
|
2064
2071
|
const { result, observability } = await executeClientToolWithObservability({
|
|
@@ -2079,22 +2086,25 @@ var Agent = class extends BaseResource {
|
|
|
2079
2086
|
}
|
|
2080
2087
|
}
|
|
2081
2088
|
});
|
|
2082
|
-
|
|
2083
|
-
|
|
2084
|
-
|
|
2085
|
-
|
|
2086
|
-
|
|
2087
|
-
|
|
2088
|
-
result,
|
|
2089
|
-
...observability ? { __mastraObservability: observability } : {}
|
|
2090
|
-
}]
|
|
2091
|
-
}];
|
|
2092
|
-
return this.generateLegacy({
|
|
2093
|
-
...params,
|
|
2094
|
-
messages: updatedMessages
|
|
2089
|
+
toolResults.push({
|
|
2090
|
+
type: "tool-result",
|
|
2091
|
+
toolCallId: toolCall.toolCallId,
|
|
2092
|
+
toolName: toolCall.toolName,
|
|
2093
|
+
result,
|
|
2094
|
+
...observability ? { __mastraObservability: observability } : {}
|
|
2095
2095
|
});
|
|
2096
2096
|
}
|
|
2097
2097
|
}
|
|
2098
|
+
if (toolResults.length > 0) {
|
|
2099
|
+
const updatedMessages = [...response.response.messages, {
|
|
2100
|
+
role: "tool",
|
|
2101
|
+
content: toolResults
|
|
2102
|
+
}];
|
|
2103
|
+
return this.generateLegacy({
|
|
2104
|
+
...params,
|
|
2105
|
+
messages: updatedMessages
|
|
2106
|
+
});
|
|
2107
|
+
}
|
|
2098
2108
|
}
|
|
2099
2109
|
return response;
|
|
2100
2110
|
}
|
|
@@ -2136,7 +2146,8 @@ var Agent = class extends BaseResource {
|
|
|
2136
2146
|
resourceId,
|
|
2137
2147
|
threadId,
|
|
2138
2148
|
requestContext,
|
|
2139
|
-
respondFn: this.generate.bind(this)
|
|
2149
|
+
respondFn: this.generate.bind(this),
|
|
2150
|
+
abortSignal
|
|
2140
2151
|
});
|
|
2141
2152
|
}
|
|
2142
2153
|
return response;
|
|
@@ -5629,7 +5640,9 @@ var Observability = class extends BaseResource {
|
|
|
5629
5640
|
* On ClickHouse-backed stores, reads may briefly return deleted rows until
|
|
5630
5641
|
* the lightweight delete is fully applied.
|
|
5631
5642
|
* @param params - IDs of the traces to delete
|
|
5632
|
-
* @returns
|
|
5643
|
+
* @returns `{ success: true }` after OSS deletion, or `{ accepted: true }`
|
|
5644
|
+
* when a supporting Platform backend queues cleanup. Acceptance does not
|
|
5645
|
+
* mean records have disappeared from reads.
|
|
5633
5646
|
*/
|
|
5634
5647
|
deleteTraces(params) {
|
|
5635
5648
|
return this.request(`/observability/traces/delete`, {
|
|
@@ -5682,6 +5695,8 @@ var Observability = class extends BaseResource {
|
|
|
5682
5695
|
* Deletes score records by scoreId, optionally scoped to a tenant.
|
|
5683
5696
|
* Idempotent: deleting missing ids succeeds. Depending on the storage
|
|
5684
5697
|
* backend (e.g. ClickHouse), deletion may be eventually consistent.
|
|
5698
|
+
* A supporting Platform backend returns `{ accepted: true }` after queueing
|
|
5699
|
+
* cleanup; OSS returns `{ success: boolean }` after deletion.
|
|
5685
5700
|
*/
|
|
5686
5701
|
deleteScores(params) {
|
|
5687
5702
|
return this.request(`/observability/scores`, {
|
|
@@ -5770,6 +5785,8 @@ var Observability = class extends BaseResource {
|
|
|
5770
5785
|
* Deletes feedback records by feedbackId, optionally scoped to a tenant.
|
|
5771
5786
|
* Idempotent: deleting missing ids succeeds. Depending on the storage
|
|
5772
5787
|
* backend (e.g. ClickHouse), deletion may be eventually consistent.
|
|
5788
|
+
* A supporting Platform backend returns `{ accepted: true }` after queueing
|
|
5789
|
+
* cleanup; OSS returns `{ success: boolean }` after deletion.
|
|
5773
5790
|
*/
|
|
5774
5791
|
deleteFeedback(params) {
|
|
5775
5792
|
return this.request(`/observability/feedback`, {
|
|
@@ -8503,7 +8520,8 @@ var MastraClient = class extends BaseResource {
|
|
|
8503
8520
|
* Deletes traces by ID, cascading to all associated spans and trace-linked
|
|
8504
8521
|
* signal events (scores, feedback, metrics, logs). Signals without a trace ID
|
|
8505
8522
|
* are untouched. On ClickHouse-backed stores, reads may briefly return
|
|
8506
|
-
* deleted rows until the delete is fully applied.
|
|
8523
|
+
* deleted rows until the delete is fully applied. A supporting Platform backend
|
|
8524
|
+
* returns `{ accepted: true }` after queueing cleanup, before records disappear.
|
|
8507
8525
|
*/
|
|
8508
8526
|
deleteTraces(params) {
|
|
8509
8527
|
return this.observability.deleteTraces(params);
|
|
@@ -8528,7 +8546,10 @@ var MastraClient = class extends BaseResource {
|
|
|
8528
8546
|
createScore(params, options) {
|
|
8529
8547
|
return this.observability.createScore(params, options);
|
|
8530
8548
|
}
|
|
8531
|
-
/**
|
|
8549
|
+
/**
|
|
8550
|
+
* Deletes score records by scoreId, optionally scoped to a tenant.
|
|
8551
|
+
* Returns OSS success or Platform acceptance; accepted cleanup is asynchronous.
|
|
8552
|
+
*/
|
|
8532
8553
|
deleteScores(params) {
|
|
8533
8554
|
return this.observability.deleteScores(params);
|
|
8534
8555
|
}
|
|
@@ -8564,7 +8585,10 @@ var MastraClient = class extends BaseResource {
|
|
|
8564
8585
|
replaceFeedback(params, options) {
|
|
8565
8586
|
return this.observability.replaceFeedback(params, options);
|
|
8566
8587
|
}
|
|
8567
|
-
/**
|
|
8588
|
+
/**
|
|
8589
|
+
* Deletes feedback records by feedbackId, optionally scoped to a tenant.
|
|
8590
|
+
* Returns OSS success or Platform acceptance; accepted cleanup is asynchronous.
|
|
8591
|
+
*/
|
|
8568
8592
|
deleteFeedback(params) {
|
|
8569
8593
|
return this.observability.deleteFeedback(params);
|
|
8570
8594
|
}
|
|
@@ -9339,6 +9363,7 @@ var MastraClient = class extends BaseResource {
|
|
|
9339
9363
|
if (options?.page !== void 0) searchParams.set("page", String(options.page));
|
|
9340
9364
|
if (options?.perPage !== void 0) searchParams.set("perPage", String(options.perPage));
|
|
9341
9365
|
for (const tag of options?.tags ?? []) searchParams.append("tags", tag);
|
|
9366
|
+
if (options?.status) searchParams.set("status", options.status);
|
|
9342
9367
|
if (options?.orderBy) {
|
|
9343
9368
|
searchParams.set("orderBy[field]", options.orderBy.field);
|
|
9344
9369
|
searchParams.set("orderBy[direction]", options.orderBy.direction);
|