@mastra/client-js 1.22.0-alpha.9 → 1.23.0-alpha.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/CHANGELOG.md +202 -0
- package/dist/docs/SKILL.md +1 -1
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/dist/docs/references/docs-agents-signals.md +229 -9
- package/dist/docs/references/docs-editor-overview.md +11 -10
- package/dist/docs/references/reference-client-js-agents.md +41 -7
- package/dist/index.cjs +81 -50
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +81 -50
- package/dist/index.js.map +1 -1
- package/dist/resources/agent.d.ts +21 -1
- package/dist/resources/agent.d.ts.map +1 -1
- package/dist/resources/stored-agent.d.ts +8 -1
- package/dist/resources/stored-agent.d.ts.map +1 -1
- package/dist/route-types.generated.d.ts +36 -0
- package/dist/route-types.generated.d.ts.map +1 -1
- package/dist/types.d.ts +26 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +7 -7
package/dist/index.js
CHANGED
|
@@ -755,6 +755,53 @@ var Agent = class extends BaseResource {
|
|
|
755
755
|
const threadKey = this.getSignalRuntimeThreadKey({ resourceId, threadId });
|
|
756
756
|
if (threadKey) deleteSignalRuntimeOptionsEntry(latestSignalRuntimeOptionsByThread, threadKey);
|
|
757
757
|
}
|
|
758
|
+
prepareSignalRouteBody(params) {
|
|
759
|
+
const streamOptions = params.ifIdle?.streamOptions;
|
|
760
|
+
if (!streamOptions) return { body: params };
|
|
761
|
+
this.setSignalRuntimeOptions({
|
|
762
|
+
resourceId: params.resourceId,
|
|
763
|
+
threadId: params.threadId,
|
|
764
|
+
streamOptions
|
|
765
|
+
});
|
|
766
|
+
return {
|
|
767
|
+
body: {
|
|
768
|
+
...params,
|
|
769
|
+
ifIdle: {
|
|
770
|
+
...params.ifIdle,
|
|
771
|
+
streamOptions: {
|
|
772
|
+
...streamOptions,
|
|
773
|
+
requestContext: parseClientRequestContext(streamOptions.requestContext),
|
|
774
|
+
clientTools: processClientTools(streamOptions.clientTools)
|
|
775
|
+
}
|
|
776
|
+
}
|
|
777
|
+
},
|
|
778
|
+
streamOptions
|
|
779
|
+
};
|
|
780
|
+
}
|
|
781
|
+
async requestSignalRoute(path, params) {
|
|
782
|
+
const { body, streamOptions } = this.prepareSignalRouteBody(params);
|
|
783
|
+
let response;
|
|
784
|
+
try {
|
|
785
|
+
response = await this.request(path, {
|
|
786
|
+
method: "POST",
|
|
787
|
+
body
|
|
788
|
+
});
|
|
789
|
+
} catch (error) {
|
|
790
|
+
if (streamOptions) {
|
|
791
|
+
this.deleteLatestSignalRuntimeOptions({ resourceId: params.resourceId, threadId: params.threadId });
|
|
792
|
+
}
|
|
793
|
+
throw error;
|
|
794
|
+
}
|
|
795
|
+
if (streamOptions) {
|
|
796
|
+
this.setSignalRuntimeOptions({
|
|
797
|
+
runId: response.runId,
|
|
798
|
+
resourceId: params.resourceId,
|
|
799
|
+
threadId: params.threadId,
|
|
800
|
+
streamOptions
|
|
801
|
+
});
|
|
802
|
+
}
|
|
803
|
+
return response;
|
|
804
|
+
}
|
|
758
805
|
/**
|
|
759
806
|
* Retrieves details about the agent
|
|
760
807
|
* @param requestContext - Optional request context to pass as query parameter
|
|
@@ -797,50 +844,23 @@ var Agent = class extends BaseResource {
|
|
|
797
844
|
body: { instructions, comment }
|
|
798
845
|
});
|
|
799
846
|
}
|
|
847
|
+
/**
|
|
848
|
+
* @experimental Agent message APIs are experimental and may change in a future release.
|
|
849
|
+
*/
|
|
850
|
+
sendMessage(params) {
|
|
851
|
+
return this.requestSignalRoute(`/agents/${this.agentId}/send-message`, params);
|
|
852
|
+
}
|
|
853
|
+
/**
|
|
854
|
+
* @experimental Agent message APIs are experimental and may change in a future release.
|
|
855
|
+
*/
|
|
856
|
+
queueMessage(params) {
|
|
857
|
+
return this.requestSignalRoute(`/agents/${this.agentId}/queue-message`, params);
|
|
858
|
+
}
|
|
800
859
|
/**
|
|
801
860
|
* @experimental Agent signals are experimental and may change in a future release.
|
|
802
861
|
*/
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
if (streamOptions) {
|
|
806
|
-
this.setSignalRuntimeOptions({
|
|
807
|
-
resourceId: params.resourceId,
|
|
808
|
-
threadId: params.threadId,
|
|
809
|
-
streamOptions
|
|
810
|
-
});
|
|
811
|
-
}
|
|
812
|
-
const body = params.ifIdle?.streamOptions ? {
|
|
813
|
-
...params,
|
|
814
|
-
ifIdle: {
|
|
815
|
-
...params.ifIdle,
|
|
816
|
-
streamOptions: {
|
|
817
|
-
...params.ifIdle.streamOptions,
|
|
818
|
-
requestContext: parseClientRequestContext(params.ifIdle.streamOptions.requestContext),
|
|
819
|
-
clientTools: processClientTools(params.ifIdle.streamOptions.clientTools)
|
|
820
|
-
}
|
|
821
|
-
}
|
|
822
|
-
} : params;
|
|
823
|
-
let response;
|
|
824
|
-
try {
|
|
825
|
-
response = await this.request(`/agents/${this.agentId}/signals`, {
|
|
826
|
-
method: "POST",
|
|
827
|
-
body
|
|
828
|
-
});
|
|
829
|
-
} catch (error) {
|
|
830
|
-
if (streamOptions) {
|
|
831
|
-
this.deleteLatestSignalRuntimeOptions({ resourceId: params.resourceId, threadId: params.threadId });
|
|
832
|
-
}
|
|
833
|
-
throw error;
|
|
834
|
-
}
|
|
835
|
-
if (streamOptions) {
|
|
836
|
-
this.setSignalRuntimeOptions({
|
|
837
|
-
runId: response.runId,
|
|
838
|
-
resourceId: params.resourceId,
|
|
839
|
-
threadId: params.threadId,
|
|
840
|
-
streamOptions
|
|
841
|
-
});
|
|
842
|
-
}
|
|
843
|
-
return response;
|
|
862
|
+
sendSignal(params) {
|
|
863
|
+
return this.requestSignalRoute(`/agents/${this.agentId}/signals`, params);
|
|
844
864
|
}
|
|
845
865
|
/**
|
|
846
866
|
* @experimental Agent signals are experimental and may change in a future release.
|
|
@@ -973,20 +993,20 @@ var Agent = class extends BaseResource {
|
|
|
973
993
|
return;
|
|
974
994
|
}
|
|
975
995
|
try {
|
|
976
|
-
|
|
977
|
-
|
|
978
|
-
|
|
996
|
+
await agent.sendToolApproval({
|
|
997
|
+
resourceId: resourceId || agent.agentId,
|
|
998
|
+
threadId,
|
|
999
|
+
toolCallId: pendingToolCalls[0].toolCallId,
|
|
1000
|
+
approved: true,
|
|
1001
|
+
requestContext: processedRequestContext,
|
|
1002
|
+
messages: threadId ? toolResultMessages : [...finishPayload.payload?.messages?.nonUser ?? [], ...toolResultMessages],
|
|
1003
|
+
streamOptions: {
|
|
979
1004
|
...activeRuntimeOptions,
|
|
980
|
-
runId: v4(),
|
|
981
1005
|
requestContext: processedRequestContext,
|
|
982
1006
|
memory: threadId ? { thread: threadId, resource: resourceId } : void 0,
|
|
983
1007
|
clientTools: processedClientTools
|
|
984
1008
|
}
|
|
985
|
-
);
|
|
986
|
-
try {
|
|
987
|
-
void continuation.body?.cancel?.();
|
|
988
|
-
} catch {
|
|
989
|
-
}
|
|
1009
|
+
});
|
|
990
1010
|
} catch (error) {
|
|
991
1011
|
console.error("Error running client-tool continuation:", error);
|
|
992
1012
|
} finally {
|
|
@@ -4780,6 +4800,17 @@ var StoredAgent = class extends BaseResource {
|
|
|
4780
4800
|
}
|
|
4781
4801
|
);
|
|
4782
4802
|
}
|
|
4803
|
+
/**
|
|
4804
|
+
* Lists other stored agents that reference this agent as a sub-agent.
|
|
4805
|
+
* @param requestContext - Optional request context to pass as query parameter
|
|
4806
|
+
* @returns Promise containing the list of dependent agents and a hidden count
|
|
4807
|
+
* for cross-workspace private dependents (only non-zero when this agent is public).
|
|
4808
|
+
*/
|
|
4809
|
+
dependents(requestContext) {
|
|
4810
|
+
return this.request(
|
|
4811
|
+
`/stored/agents/${encodeURIComponent(this.storedAgentId)}/dependents${requestContextQueryString(requestContext)}`
|
|
4812
|
+
);
|
|
4813
|
+
}
|
|
4783
4814
|
// ==========================================================================
|
|
4784
4815
|
// Favorite Methods (EE feature)
|
|
4785
4816
|
// ==========================================================================
|