@mastra/client-js 0.0.0-tsconfig-compile-20250703214351 → 0.0.0-unified-sidebar-20251010130811
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 +1400 -2
- package/LICENSE.md +11 -42
- package/README.md +6 -7
- package/dist/client.d.ts +278 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/example.d.ts +2 -0
- package/dist/example.d.ts.map +1 -0
- package/dist/index.cjs +1761 -674
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.ts +5 -1164
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +1759 -674
- package/dist/index.js.map +1 -0
- package/dist/resources/a2a.d.ts +41 -0
- package/dist/resources/a2a.d.ts.map +1 -0
- package/dist/resources/agent-builder.d.ts +160 -0
- package/dist/resources/agent-builder.d.ts.map +1 -0
- package/dist/resources/agent.d.ts +184 -0
- package/dist/resources/agent.d.ts.map +1 -0
- package/dist/resources/base.d.ts +13 -0
- package/dist/resources/base.d.ts.map +1 -0
- package/dist/resources/index.d.ts +11 -0
- package/dist/resources/index.d.ts.map +1 -0
- package/dist/resources/mcp-tool.d.ts +28 -0
- package/dist/resources/mcp-tool.d.ts.map +1 -0
- package/dist/resources/memory-thread.d.ts +53 -0
- package/dist/resources/memory-thread.d.ts.map +1 -0
- package/dist/resources/network-memory-thread.d.ts +47 -0
- package/dist/resources/network-memory-thread.d.ts.map +1 -0
- package/dist/resources/observability.d.ts +35 -0
- package/dist/resources/observability.d.ts.map +1 -0
- package/dist/resources/tool.d.ts +24 -0
- package/dist/resources/tool.d.ts.map +1 -0
- package/dist/resources/vector.d.ts +51 -0
- package/dist/resources/vector.d.ts.map +1 -0
- package/dist/resources/workflow.d.ts +269 -0
- package/dist/resources/workflow.d.ts.map +1 -0
- package/dist/tools.d.ts +22 -0
- package/dist/tools.d.ts.map +1 -0
- package/dist/types.d.ts +479 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/utils/index.d.ts +5 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/process-client-tools.d.ts +3 -0
- package/dist/utils/process-client-tools.d.ts.map +1 -0
- package/dist/utils/process-mastra-stream.d.ts +11 -0
- package/dist/utils/process-mastra-stream.d.ts.map +1 -0
- package/dist/utils/zod-to-json-schema.d.ts +3 -0
- package/dist/utils/zod-to-json-schema.d.ts.map +1 -0
- package/package.json +27 -15
- package/.turbo/turbo-build.log +0 -19
- package/dist/index.d.cts +0 -1164
- package/eslint.config.js +0 -6
- package/src/adapters/agui.test.ts +0 -180
- package/src/adapters/agui.ts +0 -239
- package/src/client.ts +0 -480
- package/src/example.ts +0 -67
- package/src/index.test.ts +0 -830
- package/src/index.ts +0 -2
- package/src/resources/a2a.ts +0 -88
- package/src/resources/agent.ts +0 -763
- package/src/resources/base.ts +0 -71
- package/src/resources/index.ts +0 -10
- package/src/resources/legacy-workflow.ts +0 -242
- package/src/resources/mcp-tool.ts +0 -48
- package/src/resources/memory-thread.ts +0 -63
- package/src/resources/network-memory-thread.ts +0 -63
- package/src/resources/network.ts +0 -85
- package/src/resources/tool.ts +0 -45
- package/src/resources/vNextNetwork.ts +0 -177
- package/src/resources/vector.ts +0 -83
- package/src/resources/workflow.ts +0 -396
- package/src/types.ts +0 -422
- package/src/utils/index.ts +0 -11
- package/src/utils/process-client-tools.ts +0 -32
- package/src/utils/zod-to-json-schema.ts +0 -10
- package/tsconfig.json +0 -5
- package/vitest.config.js +0 -8
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type { AgentCard, GetTaskResponse, MessageSendParams, SendMessageResponse, SendStreamingMessageResponse, Task, TaskQueryParams } from '@mastra/core/a2a';
|
|
2
|
+
import type { ClientOptions } from '../types.js';
|
|
3
|
+
import { BaseResource } from './base.js';
|
|
4
|
+
/**
|
|
5
|
+
* Class for interacting with an agent via the A2A protocol
|
|
6
|
+
*/
|
|
7
|
+
export declare class A2A extends BaseResource {
|
|
8
|
+
private agentId;
|
|
9
|
+
constructor(options: ClientOptions, agentId: string);
|
|
10
|
+
/**
|
|
11
|
+
* Get the agent card with metadata about the agent
|
|
12
|
+
* @returns Promise containing the agent card information
|
|
13
|
+
*/
|
|
14
|
+
getCard(): Promise<AgentCard>;
|
|
15
|
+
/**
|
|
16
|
+
* Send a message to the agent and gets a message or task response
|
|
17
|
+
* @param params - Parameters for the task
|
|
18
|
+
* @returns Promise containing the response
|
|
19
|
+
*/
|
|
20
|
+
sendMessage(params: MessageSendParams): Promise<SendMessageResponse>;
|
|
21
|
+
/**
|
|
22
|
+
* Sends a message to an agent to initiate/continue a task and subscribes
|
|
23
|
+
* the client to real-time updates for that task via Server-Sent Events (SSE).
|
|
24
|
+
* @param params - Parameters for the task
|
|
25
|
+
* @returns A stream of Server-Sent Events. Each SSE `data` field contains a `SendStreamingMessageResponse`
|
|
26
|
+
*/
|
|
27
|
+
sendStreamingMessage(params: MessageSendParams): Promise<AsyncIterable<SendStreamingMessageResponse>>;
|
|
28
|
+
/**
|
|
29
|
+
* Get the status and result of a task
|
|
30
|
+
* @param params - Parameters for querying the task
|
|
31
|
+
* @returns Promise containing the task response
|
|
32
|
+
*/
|
|
33
|
+
getTask(params: TaskQueryParams): Promise<GetTaskResponse>;
|
|
34
|
+
/**
|
|
35
|
+
* Cancel a running task
|
|
36
|
+
* @param params - Parameters identifying the task to cancel
|
|
37
|
+
* @returns Promise containing the task response
|
|
38
|
+
*/
|
|
39
|
+
cancelTask(params: TaskQueryParams): Promise<Task>;
|
|
40
|
+
}
|
|
41
|
+
//# sourceMappingURL=a2a.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"a2a.d.ts","sourceRoot":"","sources":["../../src/resources/a2a.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,IAAI,EACJ,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,qBAAa,GAAI,SAAQ,YAAY;IAGjC,OAAO,CAAC,OAAO;gBADf,OAAO,EAAE,aAAa,EACd,OAAO,EAAE,MAAM;IAKzB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;IAInC;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAY1E;;;;;OAKG;IACG,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAC;IAY3G;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAYhE;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CASzD"}
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
import type { RuntimeContext } from '@mastra/core/runtime-context';
|
|
2
|
+
import type { WorkflowInfo } from '@mastra/core/workflows';
|
|
3
|
+
import type { ClientOptions } from '../types.js';
|
|
4
|
+
import { BaseResource } from './base.js';
|
|
5
|
+
export interface AgentBuilderActionRequest {
|
|
6
|
+
/** Input data specific to the workflow type */
|
|
7
|
+
inputData: any;
|
|
8
|
+
/** Runtime context for the action execution */
|
|
9
|
+
runtimeContext?: RuntimeContext;
|
|
10
|
+
}
|
|
11
|
+
export interface AgentBuilderActionResult {
|
|
12
|
+
success: boolean;
|
|
13
|
+
applied: boolean;
|
|
14
|
+
branchName?: string;
|
|
15
|
+
message: string;
|
|
16
|
+
validationResults?: any;
|
|
17
|
+
error?: string;
|
|
18
|
+
errors?: string[];
|
|
19
|
+
stepResults?: any;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Agent Builder resource: operations related to agent-builder workflows via server endpoints.
|
|
23
|
+
*/
|
|
24
|
+
export declare class AgentBuilder extends BaseResource {
|
|
25
|
+
private actionId;
|
|
26
|
+
constructor(options: ClientOptions, actionId: string);
|
|
27
|
+
transformWorkflowResult(result: any): AgentBuilderActionResult;
|
|
28
|
+
/**
|
|
29
|
+
* @deprecated Use createRunAsync() instead.
|
|
30
|
+
* @throws {Error} Always throws an error directing users to use createRunAsync()
|
|
31
|
+
*/
|
|
32
|
+
createRun(_params?: {
|
|
33
|
+
runId?: string;
|
|
34
|
+
}): Promise<{
|
|
35
|
+
runId: string;
|
|
36
|
+
}>;
|
|
37
|
+
/**
|
|
38
|
+
* Creates a new agent builder action run and returns the runId.
|
|
39
|
+
* This calls `/api/agent-builder/:actionId/create-run`.
|
|
40
|
+
*/
|
|
41
|
+
createRunAsync(params?: {
|
|
42
|
+
runId?: string;
|
|
43
|
+
}): Promise<{
|
|
44
|
+
runId: string;
|
|
45
|
+
}>;
|
|
46
|
+
/**
|
|
47
|
+
* Starts agent builder action asynchronously and waits for completion.
|
|
48
|
+
* This calls `/api/agent-builder/:actionId/start-async`.
|
|
49
|
+
*/
|
|
50
|
+
startAsync(params: AgentBuilderActionRequest, runId?: string): Promise<AgentBuilderActionResult>;
|
|
51
|
+
/**
|
|
52
|
+
* Starts an existing agent builder action run.
|
|
53
|
+
* This calls `/api/agent-builder/:actionId/start`.
|
|
54
|
+
*/
|
|
55
|
+
startActionRun(params: AgentBuilderActionRequest, runId: string): Promise<{
|
|
56
|
+
message: string;
|
|
57
|
+
}>;
|
|
58
|
+
/**
|
|
59
|
+
* Resumes a suspended agent builder action step.
|
|
60
|
+
* This calls `/api/agent-builder/:actionId/resume`.
|
|
61
|
+
*/
|
|
62
|
+
resume(params: {
|
|
63
|
+
step: string | string[];
|
|
64
|
+
resumeData?: unknown;
|
|
65
|
+
runtimeContext?: RuntimeContext;
|
|
66
|
+
}, runId: string): Promise<{
|
|
67
|
+
message: string;
|
|
68
|
+
}>;
|
|
69
|
+
/**
|
|
70
|
+
* Resumes a suspended agent builder action step asynchronously.
|
|
71
|
+
* This calls `/api/agent-builder/:actionId/resume-async`.
|
|
72
|
+
*/
|
|
73
|
+
resumeAsync(params: {
|
|
74
|
+
step: string | string[];
|
|
75
|
+
resumeData?: unknown;
|
|
76
|
+
runtimeContext?: RuntimeContext;
|
|
77
|
+
}, runId: string): Promise<AgentBuilderActionResult>;
|
|
78
|
+
/**
|
|
79
|
+
* Creates an async generator that processes a readable stream and yields action records
|
|
80
|
+
* separated by the Record Separator character (\x1E)
|
|
81
|
+
*
|
|
82
|
+
* @param stream - The readable stream to process
|
|
83
|
+
* @returns An async generator that yields parsed records
|
|
84
|
+
*/
|
|
85
|
+
private streamProcessor;
|
|
86
|
+
/**
|
|
87
|
+
* Streams agent builder action progress in real-time.
|
|
88
|
+
* This calls `/api/agent-builder/:actionId/stream`.
|
|
89
|
+
*/
|
|
90
|
+
stream(params: AgentBuilderActionRequest, runId?: string): Promise<import("stream/web").ReadableStream<{
|
|
91
|
+
type: string;
|
|
92
|
+
payload: any;
|
|
93
|
+
}>>;
|
|
94
|
+
/**
|
|
95
|
+
* Streams agent builder action progress in real-time using VNext streaming.
|
|
96
|
+
* This calls `/api/agent-builder/:actionId/streamVNext`.
|
|
97
|
+
*/
|
|
98
|
+
streamVNext(params: AgentBuilderActionRequest, runId?: string): Promise<import("stream/web").ReadableStream<{
|
|
99
|
+
type: string;
|
|
100
|
+
payload: any;
|
|
101
|
+
}>>;
|
|
102
|
+
/**
|
|
103
|
+
* Watches an existing agent builder action run by runId.
|
|
104
|
+
* This is used for hot reload recovery - it loads the existing run state
|
|
105
|
+
* and streams any remaining progress.
|
|
106
|
+
* This calls `/api/agent-builder/:actionId/watch`.
|
|
107
|
+
*/
|
|
108
|
+
watch({ runId, eventType }: {
|
|
109
|
+
runId: string;
|
|
110
|
+
eventType?: 'watch' | 'watch-v2';
|
|
111
|
+
}, onRecord: (record: {
|
|
112
|
+
type: string;
|
|
113
|
+
payload: any;
|
|
114
|
+
}) => void): Promise<void>;
|
|
115
|
+
/**
|
|
116
|
+
* Gets a specific action run by its ID.
|
|
117
|
+
* This calls `/api/agent-builder/:actionId/runs/:runId`.
|
|
118
|
+
*/
|
|
119
|
+
runById(runId: string): Promise<unknown>;
|
|
120
|
+
/**
|
|
121
|
+
* Gets details about this agent builder action.
|
|
122
|
+
* This calls `/api/agent-builder/:actionId`.
|
|
123
|
+
*/
|
|
124
|
+
details(): Promise<WorkflowInfo>;
|
|
125
|
+
/**
|
|
126
|
+
* Gets all runs for this agent builder action.
|
|
127
|
+
* This calls `/api/agent-builder/:actionId/runs`.
|
|
128
|
+
*/
|
|
129
|
+
runs(params?: {
|
|
130
|
+
fromDate?: Date;
|
|
131
|
+
toDate?: Date;
|
|
132
|
+
limit?: number;
|
|
133
|
+
offset?: number;
|
|
134
|
+
resourceId?: string;
|
|
135
|
+
}): Promise<unknown>;
|
|
136
|
+
/**
|
|
137
|
+
* Gets the execution result of an agent builder action run.
|
|
138
|
+
* This calls `/api/agent-builder/:actionId/runs/:runId/execution-result`.
|
|
139
|
+
*/
|
|
140
|
+
runExecutionResult(runId: string): Promise<unknown>;
|
|
141
|
+
/**
|
|
142
|
+
* Cancels an agent builder action run.
|
|
143
|
+
* This calls `/api/agent-builder/:actionId/runs/:runId/cancel`.
|
|
144
|
+
*/
|
|
145
|
+
cancelRun(runId: string): Promise<{
|
|
146
|
+
message: string;
|
|
147
|
+
}>;
|
|
148
|
+
/**
|
|
149
|
+
* Sends an event to an agent builder action run.
|
|
150
|
+
* This calls `/api/agent-builder/:actionId/runs/:runId/send-event`.
|
|
151
|
+
*/
|
|
152
|
+
sendRunEvent(params: {
|
|
153
|
+
runId: string;
|
|
154
|
+
event: string;
|
|
155
|
+
data: unknown;
|
|
156
|
+
}): Promise<{
|
|
157
|
+
message: string;
|
|
158
|
+
}>;
|
|
159
|
+
}
|
|
160
|
+
//# sourceMappingURL=agent-builder.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent-builder.d.ts","sourceRoot":"","sources":["../../src/resources/agent-builder.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
import { processDataStream } from '@ai-sdk/ui-utils';
|
|
2
|
+
import type { MessageListInput } from '@mastra/core/agent/message-list';
|
|
3
|
+
import type { GenerateReturn } from '@mastra/core/llm';
|
|
4
|
+
import type { RuntimeContext } from '@mastra/core/runtime-context';
|
|
5
|
+
import type { OutputSchema, MastraModelOutput } from '@mastra/core/stream';
|
|
6
|
+
import type { JSONSchema7 } from 'json-schema';
|
|
7
|
+
import type { ZodType } from 'zod';
|
|
8
|
+
import type { GenerateLegacyParams, GetAgentResponse, GetEvalsByAgentIdResponse, GetToolResponse, ClientOptions, StreamParams, StreamLegacyParams, UpdateModelParams, UpdateModelInModelListParams, ReorderModelListParams, NetworkStreamParams } from '../types.js';
|
|
9
|
+
import { processMastraNetworkStream, processMastraStream } from '../utils/process-mastra-stream.js';
|
|
10
|
+
import { BaseResource } from './base.js';
|
|
11
|
+
export declare class AgentVoice extends BaseResource {
|
|
12
|
+
private agentId;
|
|
13
|
+
constructor(options: ClientOptions, agentId: string);
|
|
14
|
+
/**
|
|
15
|
+
* Convert text to speech using the agent's voice provider
|
|
16
|
+
* @param text - Text to convert to speech
|
|
17
|
+
* @param options - Optional provider-specific options for speech generation
|
|
18
|
+
* @returns Promise containing the audio data
|
|
19
|
+
*/
|
|
20
|
+
speak(text: string, options?: {
|
|
21
|
+
speaker?: string;
|
|
22
|
+
[key: string]: any;
|
|
23
|
+
}): Promise<Response>;
|
|
24
|
+
/**
|
|
25
|
+
* Convert speech to text using the agent's voice provider
|
|
26
|
+
* @param audio - Audio data to transcribe
|
|
27
|
+
* @param options - Optional provider-specific options
|
|
28
|
+
* @returns Promise containing the transcribed text
|
|
29
|
+
*/
|
|
30
|
+
listen(audio: Blob, options?: Record<string, any>): Promise<{
|
|
31
|
+
text: string;
|
|
32
|
+
}>;
|
|
33
|
+
/**
|
|
34
|
+
* Get available speakers for the agent's voice provider
|
|
35
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
36
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
37
|
+
* @returns Promise containing list of available speakers
|
|
38
|
+
*/
|
|
39
|
+
getSpeakers(runtimeContext?: RuntimeContext | Record<string, any>): Promise<Array<{
|
|
40
|
+
voiceId: string;
|
|
41
|
+
[key: string]: any;
|
|
42
|
+
}>>;
|
|
43
|
+
/**
|
|
44
|
+
* Get the listener configuration for the agent's voice provider
|
|
45
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
46
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
47
|
+
* @returns Promise containing a check if the agent has listening capabilities
|
|
48
|
+
*/
|
|
49
|
+
getListener(runtimeContext?: RuntimeContext | Record<string, any>): Promise<{
|
|
50
|
+
enabled: boolean;
|
|
51
|
+
}>;
|
|
52
|
+
}
|
|
53
|
+
export declare class Agent extends BaseResource {
|
|
54
|
+
private agentId;
|
|
55
|
+
readonly voice: AgentVoice;
|
|
56
|
+
constructor(options: ClientOptions, agentId: string);
|
|
57
|
+
/**
|
|
58
|
+
* Retrieves details about the agent
|
|
59
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
60
|
+
* @returns Promise containing agent details including model and instructions
|
|
61
|
+
*/
|
|
62
|
+
details(runtimeContext?: RuntimeContext | Record<string, any>): Promise<GetAgentResponse>;
|
|
63
|
+
/**
|
|
64
|
+
* Generates a response from the agent
|
|
65
|
+
* @param params - Generation parameters including prompt
|
|
66
|
+
* @returns Promise containing the generated response
|
|
67
|
+
*/
|
|
68
|
+
generateLegacy(params: GenerateLegacyParams<undefined> & {
|
|
69
|
+
output?: never;
|
|
70
|
+
experimental_output?: never;
|
|
71
|
+
}): Promise<GenerateReturn<any, undefined, undefined>>;
|
|
72
|
+
generateLegacy<Output extends JSONSchema7 | ZodType>(params: GenerateLegacyParams<Output> & {
|
|
73
|
+
output: Output;
|
|
74
|
+
experimental_output?: never;
|
|
75
|
+
}): Promise<GenerateReturn<any, Output, undefined>>;
|
|
76
|
+
generateLegacy<StructuredOutput extends JSONSchema7 | ZodType>(params: GenerateLegacyParams<StructuredOutput> & {
|
|
77
|
+
output?: never;
|
|
78
|
+
experimental_output: StructuredOutput;
|
|
79
|
+
}): Promise<GenerateReturn<any, undefined, StructuredOutput>>;
|
|
80
|
+
generate<OUTPUT extends OutputSchema = undefined>(messages: MessageListInput, options?: Omit<StreamParams<OUTPUT>, 'messages'>): Promise<ReturnType<MastraModelOutput<OUTPUT>['getFullOutput']>>;
|
|
81
|
+
generate<OUTPUT extends OutputSchema = undefined>(params: StreamParams<OUTPUT>): Promise<ReturnType<MastraModelOutput<OUTPUT>['getFullOutput']>>;
|
|
82
|
+
private processChatResponse;
|
|
83
|
+
/**
|
|
84
|
+
* Streams a response from the agent
|
|
85
|
+
* @param params - Stream parameters including prompt
|
|
86
|
+
* @returns Promise containing the enhanced Response object with processDataStream method
|
|
87
|
+
*/
|
|
88
|
+
streamLegacy<T extends JSONSchema7 | ZodType | undefined = undefined>(params: StreamLegacyParams<T>): Promise<Response & {
|
|
89
|
+
processDataStream: (options?: Omit<Parameters<typeof processDataStream>[0], 'stream'>) => Promise<void>;
|
|
90
|
+
}>;
|
|
91
|
+
private processChatResponse_vNext;
|
|
92
|
+
processStreamResponse(processedParams: any, writable: any): Promise<Response>;
|
|
93
|
+
network(params: NetworkStreamParams): Promise<Response & {
|
|
94
|
+
processDataStream: ({ onChunk, }: {
|
|
95
|
+
onChunk: Parameters<typeof processMastraNetworkStream>[0]['onChunk'];
|
|
96
|
+
}) => Promise<void>;
|
|
97
|
+
}>;
|
|
98
|
+
stream<OUTPUT extends OutputSchema = undefined>(messages: MessageListInput, options?: Omit<StreamParams<OUTPUT>, 'messages'>): Promise<Response & {
|
|
99
|
+
processDataStream: ({ onChunk, }: {
|
|
100
|
+
onChunk: Parameters<typeof processMastraStream>[0]['onChunk'];
|
|
101
|
+
}) => Promise<void>;
|
|
102
|
+
}>;
|
|
103
|
+
stream<OUTPUT extends OutputSchema = undefined>(params: StreamParams<OUTPUT>): Promise<Response & {
|
|
104
|
+
processDataStream: ({ onChunk, }: {
|
|
105
|
+
onChunk: Parameters<typeof processMastraStream>[0]['onChunk'];
|
|
106
|
+
}) => Promise<void>;
|
|
107
|
+
}>;
|
|
108
|
+
/**
|
|
109
|
+
* Processes the stream response and handles tool calls
|
|
110
|
+
*/
|
|
111
|
+
private processStreamResponseLegacy;
|
|
112
|
+
/**
|
|
113
|
+
* Gets details about a specific tool available to the agent
|
|
114
|
+
* @param toolId - ID of the tool to retrieve
|
|
115
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
116
|
+
* @returns Promise containing tool details
|
|
117
|
+
*/
|
|
118
|
+
getTool(toolId: string, runtimeContext?: RuntimeContext | Record<string, any>): Promise<GetToolResponse>;
|
|
119
|
+
/**
|
|
120
|
+
* Executes a tool for the agent
|
|
121
|
+
* @param toolId - ID of the tool to execute
|
|
122
|
+
* @param params - Parameters required for tool execution
|
|
123
|
+
* @returns Promise containing the tool execution results
|
|
124
|
+
*/
|
|
125
|
+
executeTool(toolId: string, params: {
|
|
126
|
+
data: any;
|
|
127
|
+
runtimeContext?: RuntimeContext | Record<string, any>;
|
|
128
|
+
}): Promise<any>;
|
|
129
|
+
/**
|
|
130
|
+
* Retrieves evaluation results for the agent
|
|
131
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
132
|
+
* @returns Promise containing agent evaluations
|
|
133
|
+
*/
|
|
134
|
+
evals(runtimeContext?: RuntimeContext | Record<string, any>): Promise<GetEvalsByAgentIdResponse>;
|
|
135
|
+
/**
|
|
136
|
+
* Retrieves live evaluation results for the agent
|
|
137
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
138
|
+
* @returns Promise containing live agent evaluations
|
|
139
|
+
*/
|
|
140
|
+
liveEvals(runtimeContext?: RuntimeContext | Record<string, any>): Promise<GetEvalsByAgentIdResponse>;
|
|
141
|
+
/**
|
|
142
|
+
* Updates the model for the agent
|
|
143
|
+
* @param params - Parameters for updating the model
|
|
144
|
+
* @returns Promise containing the updated model
|
|
145
|
+
*/
|
|
146
|
+
updateModel(params: UpdateModelParams): Promise<{
|
|
147
|
+
message: string;
|
|
148
|
+
}>;
|
|
149
|
+
/**
|
|
150
|
+
* Updates the model for the agent in the model list
|
|
151
|
+
* @param params - Parameters for updating the model
|
|
152
|
+
* @returns Promise containing the updated model
|
|
153
|
+
*/
|
|
154
|
+
updateModelInModelList({ modelConfigId, ...params }: UpdateModelInModelListParams): Promise<{
|
|
155
|
+
message: string;
|
|
156
|
+
}>;
|
|
157
|
+
/**
|
|
158
|
+
* Reorders the models for the agent
|
|
159
|
+
* @param params - Parameters for reordering the model list
|
|
160
|
+
* @returns Promise containing the updated model list
|
|
161
|
+
*/
|
|
162
|
+
reorderModelList(params: ReorderModelListParams): Promise<{
|
|
163
|
+
message: string;
|
|
164
|
+
}>;
|
|
165
|
+
/**
|
|
166
|
+
* @deprecated generateVNext has been renamed to generate. Please use generate instead.
|
|
167
|
+
*/
|
|
168
|
+
generateVNext<OUTPUT extends OutputSchema = undefined>(messages: MessageListInput, options?: Omit<StreamParams<OUTPUT>, 'messages'>): Promise<ReturnType<MastraModelOutput['getFullOutput']>>;
|
|
169
|
+
generateVNext<OUTPUT extends OutputSchema = undefined>(params: StreamParams<OUTPUT>): Promise<ReturnType<MastraModelOutput['getFullOutput']>>;
|
|
170
|
+
/**
|
|
171
|
+
* @deprecated streamVNext has been renamed to stream. Please use stream instead.
|
|
172
|
+
*/
|
|
173
|
+
streamVNext<OUTPUT extends OutputSchema = undefined>(messages: MessageListInput, options?: Omit<StreamParams<OUTPUT>, 'messages'>): Promise<Response & {
|
|
174
|
+
processDataStream: ({ onChunk, }: {
|
|
175
|
+
onChunk: Parameters<typeof processMastraStream>[0]['onChunk'];
|
|
176
|
+
}) => Promise<void>;
|
|
177
|
+
}>;
|
|
178
|
+
streamVNext<OUTPUT extends OutputSchema = undefined>(params: StreamParams<OUTPUT>): Promise<Response & {
|
|
179
|
+
processDataStream: ({ onChunk, }: {
|
|
180
|
+
onChunk: Parameters<typeof processMastraStream>[0]['onChunk'];
|
|
181
|
+
}) => Promise<void>;
|
|
182
|
+
}>;
|
|
183
|
+
}
|
|
184
|
+
//# sourceMappingURL=agent.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/resources/agent.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { RequestOptions, ClientOptions } from '../types.js';
|
|
2
|
+
export declare class BaseResource {
|
|
3
|
+
readonly options: ClientOptions;
|
|
4
|
+
constructor(options: ClientOptions);
|
|
5
|
+
/**
|
|
6
|
+
* Makes an HTTP request to the API with retries and exponential backoff
|
|
7
|
+
* @param path - The API endpoint path
|
|
8
|
+
* @param options - Optional request configuration
|
|
9
|
+
* @returns Promise containing the response data
|
|
10
|
+
*/
|
|
11
|
+
request<T>(path: string, options?: RequestOptions): Promise<T>;
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=base.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/resources/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9D,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,OAAO,EAAE,aAAa;IAIlC;;;;;OAKG;IACU,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;CA6DhF"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export * from './agent.js';
|
|
2
|
+
export * from './memory-thread.js';
|
|
3
|
+
export * from './vector.js';
|
|
4
|
+
export * from './tool.js';
|
|
5
|
+
export * from './base.js';
|
|
6
|
+
export * from './workflow.js';
|
|
7
|
+
export * from './a2a.js';
|
|
8
|
+
export * from './mcp-tool.js';
|
|
9
|
+
export * from './agent-builder.js';
|
|
10
|
+
export * from './observability.js';
|
|
11
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { RuntimeContext } from '@mastra/core/runtime-context';
|
|
2
|
+
import type { ClientOptions, McpToolInfo } from '../types.js';
|
|
3
|
+
import { BaseResource } from './base.js';
|
|
4
|
+
/**
|
|
5
|
+
* Represents a specific tool available on a specific MCP server.
|
|
6
|
+
* Provides methods to get details and execute the tool.
|
|
7
|
+
*/
|
|
8
|
+
export declare class MCPTool extends BaseResource {
|
|
9
|
+
private serverId;
|
|
10
|
+
private toolId;
|
|
11
|
+
constructor(options: ClientOptions, serverId: string, toolId: string);
|
|
12
|
+
/**
|
|
13
|
+
* Retrieves details about this specific tool from the MCP server.
|
|
14
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
15
|
+
* @returns Promise containing the tool's information (name, description, schema).
|
|
16
|
+
*/
|
|
17
|
+
details(runtimeContext?: RuntimeContext | Record<string, any>): Promise<McpToolInfo>;
|
|
18
|
+
/**
|
|
19
|
+
* Executes this specific tool on the MCP server.
|
|
20
|
+
* @param params - Parameters for tool execution, including data/args and optional runtimeContext.
|
|
21
|
+
* @returns Promise containing the result of the tool execution.
|
|
22
|
+
*/
|
|
23
|
+
execute(params: {
|
|
24
|
+
data?: any;
|
|
25
|
+
runtimeContext?: RuntimeContext;
|
|
26
|
+
}): Promise<any>;
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=mcp-tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp-tool.d.ts","sourceRoot":"","sources":["../../src/resources/mcp-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,YAAY;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMpE;;;;OAIG;IACH,OAAO,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAIpF;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CAgB/E"}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import type { StorageThreadType } from '@mastra/core/memory';
|
|
2
|
+
import type { GetMemoryThreadMessagesResponse, ClientOptions, UpdateMemoryThreadParams, GetMemoryThreadMessagesParams, GetMemoryThreadMessagesPaginatedParams, GetMemoryThreadMessagesPaginatedResponse } from '../types.js';
|
|
3
|
+
import { BaseResource } from './base.js';
|
|
4
|
+
export declare class MemoryThread extends BaseResource {
|
|
5
|
+
private threadId;
|
|
6
|
+
private agentId;
|
|
7
|
+
constructor(options: ClientOptions, threadId: string, agentId: string);
|
|
8
|
+
/**
|
|
9
|
+
* Retrieves the memory thread details
|
|
10
|
+
* @returns Promise containing thread details including title and metadata
|
|
11
|
+
*/
|
|
12
|
+
get(): Promise<StorageThreadType>;
|
|
13
|
+
/**
|
|
14
|
+
* Updates the memory thread properties
|
|
15
|
+
* @param params - Update parameters including title and metadata
|
|
16
|
+
* @returns Promise containing updated thread details
|
|
17
|
+
*/
|
|
18
|
+
update(params: UpdateMemoryThreadParams): Promise<StorageThreadType>;
|
|
19
|
+
/**
|
|
20
|
+
* Deletes the memory thread
|
|
21
|
+
* @returns Promise containing deletion result
|
|
22
|
+
*/
|
|
23
|
+
delete(): Promise<{
|
|
24
|
+
result: string;
|
|
25
|
+
}>;
|
|
26
|
+
/**
|
|
27
|
+
* Retrieves messages associated with the thread
|
|
28
|
+
* @param params - Optional parameters including limit for number of messages to retrieve
|
|
29
|
+
* @returns Promise containing thread messages and UI messages
|
|
30
|
+
*/
|
|
31
|
+
getMessages(params?: GetMemoryThreadMessagesParams): Promise<GetMemoryThreadMessagesResponse>;
|
|
32
|
+
/**
|
|
33
|
+
* Retrieves paginated messages associated with the thread with advanced filtering and selection options
|
|
34
|
+
* @param params - Pagination parameters including selectBy criteria, page, perPage, date ranges, and message inclusion options
|
|
35
|
+
* @returns Promise containing paginated thread messages with pagination metadata (total, page, perPage, hasMore)
|
|
36
|
+
*/
|
|
37
|
+
getMessagesPaginated({ selectBy, ...rest }: GetMemoryThreadMessagesPaginatedParams): Promise<GetMemoryThreadMessagesPaginatedResponse>;
|
|
38
|
+
/**
|
|
39
|
+
* Deletes one or more messages from the thread
|
|
40
|
+
* @param messageIds - Can be a single message ID (string), array of message IDs,
|
|
41
|
+
* message object with id property, or array of message objects
|
|
42
|
+
* @returns Promise containing deletion result
|
|
43
|
+
*/
|
|
44
|
+
deleteMessages(messageIds: string | string[] | {
|
|
45
|
+
id: string;
|
|
46
|
+
} | {
|
|
47
|
+
id: string;
|
|
48
|
+
}[]): Promise<{
|
|
49
|
+
success: boolean;
|
|
50
|
+
message: string;
|
|
51
|
+
}>;
|
|
52
|
+
}
|
|
53
|
+
//# sourceMappingURL=memory-thread.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memory-thread.d.ts","sourceRoot":"","sources":["../../src/resources/memory-thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EACV,+BAA+B,EAC/B,aAAa,EACb,wBAAwB,EACxB,6BAA6B,EAC7B,sCAAsC,EACtC,wCAAwC,EACzC,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,qBAAa,YAAa,SAAQ,YAAY;IAG1C,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;gBAFf,OAAO,EAAE,aAAa,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM;IAKzB;;;OAGG;IACH,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIjC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOpE;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAMrC;;;;OAIG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,6BAA6B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAQ7F;;;;OAIG;IACH,oBAAoB,CAAC,EACnB,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,sCAAsC,GAAG,OAAO,CAAC,wCAAwC,CAAC;IAQ7F;;;;;OAKG;IACH,cAAc,CACZ,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAChE,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CASlD"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import type { StorageThreadType } from '@mastra/core/memory';
|
|
2
|
+
import type { GetMemoryThreadMessagesResponse, ClientOptions, UpdateMemoryThreadParams, GetMemoryThreadMessagesParams } from '../types.js';
|
|
3
|
+
import { BaseResource } from './base.js';
|
|
4
|
+
export declare class NetworkMemoryThread extends BaseResource {
|
|
5
|
+
private threadId;
|
|
6
|
+
private networkId;
|
|
7
|
+
constructor(options: ClientOptions, threadId: string, networkId: string);
|
|
8
|
+
/**
|
|
9
|
+
* Retrieves the memory thread details
|
|
10
|
+
* @returns Promise containing thread details including title and metadata
|
|
11
|
+
*/
|
|
12
|
+
get(): Promise<StorageThreadType>;
|
|
13
|
+
/**
|
|
14
|
+
* Updates the memory thread properties
|
|
15
|
+
* @param params - Update parameters including title and metadata
|
|
16
|
+
* @returns Promise containing updated thread details
|
|
17
|
+
*/
|
|
18
|
+
update(params: UpdateMemoryThreadParams): Promise<StorageThreadType>;
|
|
19
|
+
/**
|
|
20
|
+
* Deletes the memory thread
|
|
21
|
+
* @returns Promise containing deletion result
|
|
22
|
+
*/
|
|
23
|
+
delete(): Promise<{
|
|
24
|
+
result: string;
|
|
25
|
+
}>;
|
|
26
|
+
/**
|
|
27
|
+
* Retrieves messages associated with the thread
|
|
28
|
+
* @param params - Optional parameters including limit for number of messages to retrieve
|
|
29
|
+
* @returns Promise containing thread messages and UI messages
|
|
30
|
+
*/
|
|
31
|
+
getMessages(params?: GetMemoryThreadMessagesParams): Promise<GetMemoryThreadMessagesResponse>;
|
|
32
|
+
/**
|
|
33
|
+
* Deletes one or more messages from the thread
|
|
34
|
+
* @param messageIds - Can be a single message ID (string), array of message IDs,
|
|
35
|
+
* message object with id property, or array of message objects
|
|
36
|
+
* @returns Promise containing deletion result
|
|
37
|
+
*/
|
|
38
|
+
deleteMessages(messageIds: string | string[] | {
|
|
39
|
+
id: string;
|
|
40
|
+
} | {
|
|
41
|
+
id: string;
|
|
42
|
+
}[]): Promise<{
|
|
43
|
+
success: boolean;
|
|
44
|
+
message: string;
|
|
45
|
+
}>;
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=network-memory-thread.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"network-memory-thread.d.ts","sourceRoot":"","sources":["../../src/resources/network-memory-thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EACV,+BAA+B,EAC/B,aAAa,EACb,wBAAwB,EACxB,6BAA6B,EAC9B,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,qBAAa,mBAAoB,SAAQ,YAAY;IAGjD,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;gBAFjB,OAAO,EAAE,aAAa,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM;IAK3B;;;OAGG;IACH,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIjC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOpE;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAMrC;;;;OAIG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,6BAA6B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAQ7F;;;;;OAKG;IACH,cAAc,CACZ,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAChE,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CASlD"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { AITraceRecord, AITracesPaginatedArg } from '@mastra/core/storage';
|
|
2
|
+
import type { ClientOptions, GetAITracesResponse, GetScoresBySpanParams, GetScoresResponse } from '../types.js';
|
|
3
|
+
import { BaseResource } from './base.js';
|
|
4
|
+
export declare class Observability extends BaseResource {
|
|
5
|
+
constructor(options: ClientOptions);
|
|
6
|
+
/**
|
|
7
|
+
* Retrieves a specific AI trace by ID
|
|
8
|
+
* @param traceId - ID of the trace to retrieve
|
|
9
|
+
* @returns Promise containing the AI trace with all its spans
|
|
10
|
+
*/
|
|
11
|
+
getTrace(traceId: string): Promise<AITraceRecord>;
|
|
12
|
+
/**
|
|
13
|
+
* Retrieves paginated list of AI traces with optional filtering
|
|
14
|
+
* @param params - Parameters for pagination and filtering
|
|
15
|
+
* @returns Promise containing paginated traces and pagination info
|
|
16
|
+
*/
|
|
17
|
+
getTraces(params: AITracesPaginatedArg): Promise<GetAITracesResponse>;
|
|
18
|
+
/**
|
|
19
|
+
* Retrieves scores by trace ID and span ID
|
|
20
|
+
* @param params - Parameters containing trace ID, span ID, and pagination options
|
|
21
|
+
* @returns Promise containing scores and pagination info
|
|
22
|
+
*/
|
|
23
|
+
getScoresBySpan(params: GetScoresBySpanParams): Promise<GetScoresResponse>;
|
|
24
|
+
score(params: {
|
|
25
|
+
scorerName: string;
|
|
26
|
+
targets: Array<{
|
|
27
|
+
traceId: string;
|
|
28
|
+
spanId?: string;
|
|
29
|
+
}>;
|
|
30
|
+
}): Promise<{
|
|
31
|
+
status: string;
|
|
32
|
+
message: string;
|
|
33
|
+
}>;
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=observability.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/resources/observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,aAAa;IAIlC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjD;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmCrE;;;;OAIG;IACI,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiBjF,KAAK,CAAC,MAAM,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACtD,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAMjD"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { RuntimeContext } from '@mastra/core/runtime-context';
|
|
2
|
+
import type { GetToolResponse, ClientOptions } from '../types.js';
|
|
3
|
+
import { BaseResource } from './base.js';
|
|
4
|
+
export declare class Tool extends BaseResource {
|
|
5
|
+
private toolId;
|
|
6
|
+
constructor(options: ClientOptions, toolId: string);
|
|
7
|
+
/**
|
|
8
|
+
* Retrieves details about the tool
|
|
9
|
+
* @param runtimeContext - Optional runtime context to pass as query parameter
|
|
10
|
+
* @returns Promise containing tool details including description and schemas
|
|
11
|
+
*/
|
|
12
|
+
details(runtimeContext?: RuntimeContext | Record<string, any>): Promise<GetToolResponse>;
|
|
13
|
+
/**
|
|
14
|
+
* Executes the tool with the provided parameters
|
|
15
|
+
* @param params - Parameters required for tool execution
|
|
16
|
+
* @returns Promise containing the tool execution results
|
|
17
|
+
*/
|
|
18
|
+
execute(params: {
|
|
19
|
+
data: any;
|
|
20
|
+
runId?: string;
|
|
21
|
+
runtimeContext?: RuntimeContext | Record<string, any>;
|
|
22
|
+
}): Promise<any>;
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=tool.d.ts.map
|