@mastra/client-js 0.1.0-alpha.9 → 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,16 @@
+
+
+> @mastra/client-js@0.1.0 build /Users/ward/projects/mastra/mastra/client-sdks/client-js
+> tsup-node src/index.ts --format esm --dts --clean --treeshake
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.3.6
+CLI Target: es2022
+CLI Cleaning output folder
+ESM Build start
+ESM dist/index.mjs 13.06 KB
+ESM ⚡️ Build success in 174ms
+DTS Build start
+DTS ⚡️ Build success in 1220ms
+DTS dist/index.d.mts 13.46 KB

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @mastra/client-js
+
+## 0.1.0
+
+### Patch Changes
+
+- b9ef5fd: Add workflow watch and resume to client sdk
+
+## 0.1.0-alpha.18
+
+### Patch Changes
+
+- b9ef5fd: Add workflow watch and resume to client sdk

package/README.md

@@ -15,20 +15,20 @@ import { MastraClient } from '@mastra/client';
 
 // Initialize the client
 const client = new MastraClient({
-    baseUrl: 'http://localhost:4111',  // Your Mastra API endpoint
+  baseUrl: 'http://localhost:4111', // Your Mastra API endpoint
 });
 
 // Example: Working with an Agent
 async function main() {
-    // Get an agent instance
-    const agent = client.getAgent('your-agent-id');
-    
-    // Generate a response
-    const response = await agent.generate({
-        messages: [{ role: 'user', content: "What's the weather like today?" }],
-    });
-    
-    console.log(response);
+  // Get an agent instance
+  const agent = client.getAgent('your-agent-id');
+
+  // Generate a response
+  const response = await agent.generate({
+    messages: [{ role: 'user', content: "What's the weather like today?" }],
+  });
+
+  console.log(response);
 }
 ```
 
@@ -49,6 +49,7 @@ const client = new MastraClient({
 ## Available Methods
 
 ### Agents
+
 - `getAgents()`: Get all available agents
 - `getAgent(agentId)`: Get a specific agent instance
   - `agent.details()`: Get agent details
@@ -59,6 +60,7 @@ const client = new MastraClient({
   - `agent.liveEvals()`: Get live evaluations
 
 ### Memory
+
 - `getMemoryThreads(params)`: Get memory threads
 - `createMemoryThread(params)`: Create a new memory thread
 - `getMemoryThread(threadId)`: Get a memory thread instance
@@ -66,18 +68,23 @@ const client = new MastraClient({
 - `getMemoryStatus()`: Get memory system status
 
 ### Tools
+
 - `getTools()`: Get all available tools
 - `getTool(toolId)`: Get a tool instance
   - `tool.details()`: Get tool details
   - `tool.execute(params)`: Execute the tool
 
 ### Workflows
+
 - `getWorkflows()`: Get all workflows
 - `getWorkflow(workflowId)`: Get a workflow instance
   - `workflow.details()`: Get workflow details
   - `workflow.execute(params)`: Execute the workflow
+  - `workflow.watch(params)`: Watch the workflow
+  - `workflow.resume(params)`: Resume the workflow
 
 ### Vectors
+
 - `getVector(vectorName)`: Get a vector instance
   - `vector.details(indexName)`: Get vector index details
   - `vector.delete(indexName)`: Delete a vector index
@@ -87,12 +94,18 @@ const client = new MastraClient({
   - `vector.query(params)`: Query vectors
 
 ### Logs
+
 - `getLogs(params)`: Get system logs
 - `getLog(params)`: Get specific log entry
 
+### Telemetry
+
+- `getTelemetry(params)`: Get telemetry data
+
 ## Error Handling
 
 The client includes built-in retry logic for failed requests:
+
 - Automatically retries failed requests with exponential backoff
 - Configurable retry count and backoff timing
 - Throws error after max retries reached
@@ -100,6 +113,7 @@ The client includes built-in retry logic for failed requests:
 ## Internal Implementation
 
 The client uses the native `fetch` API internally for making HTTP requests. All requests are automatically handled with:
+
 - JSON serialization/deserialization
 - Retry logic with exponential backoff
 - Custom header management

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { MessageType, OutputType, StorageThreadType, CoreMessage, AiMessageType, StepAction, StepGraph, QueryResult, BaseLogMessage, GenerateReturn } from '@mastra/core';
+import { CoreMessage, OutputType, StorageThreadType, AiMessageType, MessageType, StepAction, StepGraph, QueryResult, BaseLogMessage, GenerateReturn } from '@mastra/core';
 import { JSONSchema7 } from 'json-schema';
 import { ZodSchema } from 'zod';
 
@@ -22,18 +22,18 @@ interface RequestOptions {
 }
 interface GetAgentResponse {
     name: string;
-    model: string;
     instructions: string;
     tools: Record<string, GetToolResponse>;
+    provider: string;
 }
 interface GenerateParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> {
-    messages: MessageType[];
+    messages: string | string[] | CoreMessage[];
     threadId?: string;
     resourceid?: string;
     output?: OutputType | T;
 }
 interface StreamParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> {
-    messages: MessageType[];
+    messages: string | string[] | CoreMessage[];
     threadId?: string;
     resourceid?: string;
     output?: OutputType | T;
@@ -82,6 +82,7 @@ interface GetVectorIndexResponse {
 }
 interface SaveMessageToMemoryParams {
     messages: MessageType[];
+    agentId: string;
 }
 type SaveMessageToMemoryResponse = MessageType[];
 interface CreateMemoryThreadParams {
@@ -89,10 +90,12 @@ interface CreateMemoryThreadParams {
     metadata: Record<string, any>;
     resourceid: string;
     threadId: string;
+    agentId: string;
 }
 type CreateMemoryThreadResponse = StorageThreadType;
 interface GetMemoryThreadParams {
     resourceId: string;
+    agentId: string;
 }
 type GetMemoryThreadResponse = StorageThreadType[];
 interface UpdateMemoryThreadParams {
@@ -113,6 +116,16 @@ interface GetLogParams {
 }
 type GetLogsResponse = BaseLogMessage[];
 type RequestFunction = (path: string, options?: RequestOptions) => Promise<any>;
+interface GetTelemetryResponse {
+    traces: any[];
+}
+interface GetTelemetryParams {
+    name?: string;
+    scope?: string;
+    page?: number;
+    perPage?: number;
+    attribute?: Record<string, string>;
+}
 
 declare class BaseResource {
     readonly options: ClientOptions;
@@ -166,7 +179,8 @@ declare class Agent extends BaseResource {
 
 declare class MemoryThread extends BaseResource {
     private threadId;
-    constructor(options: ClientOptions, threadId: string);
+    private agentId;
+    constructor(options: ClientOptions, threadId: string, agentId: string);
     /**
      * Retrieves the memory thread details
      * @returns Promise containing thread details including title and metadata
@@ -252,6 +266,23 @@ declare class Workflow extends BaseResource {
      * @returns Promise containing the workflow execution results
      */
     execute(params: Record<string, any>): Promise<Record<string, any>>;
+    /**
+     * Resumes a suspended workflow step
+     * @param stepId - ID of the step to resume
+     * @param runId - ID of the workflow run
+     * @param context - Context to resume the workflow with
+     * @returns Promise containing the workflow resume results
+     */
+    resume({ stepId, runId, context, }: {
+        stepId: string;
+        runId: string;
+        context: Record<string, any>;
+    }): Promise<Record<string, any>>;
+    /**
+     * Watches workflow transitions in real-time
+     * @returns Promise containing the workflow watch stream
+     */
+    watch(): Promise<Response>;
 }
 
 declare class Tool extends BaseResource {
@@ -267,7 +298,9 @@ declare class Tool extends BaseResource {
      * @param params - Parameters required for tool execution
      * @returns Promise containing the tool execution results
      */
-    execute(params: Record<string, any>): Promise<Record<string, any>>;
+    execute(params: {
+        data: any;
+    }): Promise<any>;
 }
 
 declare class MastraClient extends BaseResource {
@@ -300,7 +333,7 @@ declare class MastraClient extends BaseResource {
      * @param threadId - ID of the memory thread to retrieve
      * @returns MemoryThread instance
      */
-    getMemoryThread(threadId: string): MemoryThread;
+    getMemoryThread(threadId: string, agentId: string): MemoryThread;
     /**
      * Saves messages to memory
      * @param params - Parameters containing messages to save
@@ -311,7 +344,7 @@ declare class MastraClient extends BaseResource {
      * Gets the status of the memory system
      * @returns Promise containing memory system status
      */
-    getMemoryStatus(): Promise<{
+    getMemoryStatus(agentId: string): Promise<{
         result: boolean;
     }>;
     /**
@@ -354,6 +387,12 @@ declare class MastraClient extends BaseResource {
      * @returns Promise containing array of log messages
      */
     getLogForRun(params: GetLogParams): Promise<GetLogsResponse>;
+    /**
+     * List of all traces (paged)
+     * @param params - Parameters for filtering traces
+     * @returns Promise containing telemetry data
+     */
+    getTelemetry(params?: GetTelemetryParams): Promise<GetTelemetryResponse>;
 }
 
-export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams };
+export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVectorIndexResponse, type GetWorkflowResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams };

package/dist/index.mjs

@@ -118,7 +118,7 @@ var Agent = class extends BaseResource {
    * @returns Promise containing agent evaluations
    */
   evals() {
-    return this.request(`/api/agents/${this.agentId}/evals`);
+    return this.request(`/api/agents/${this.agentId}/evals/ci`);
   }
   /**
    * Retrieves live evaluation results for the agent
@@ -131,16 +131,17 @@ var Agent = class extends BaseResource {
 
 // src/resources/memory-thread.ts
 var MemoryThread = class extends BaseResource {
-  constructor(options, threadId) {
+  constructor(options, threadId, agentId) {
     super(options);
     this.threadId = threadId;
+    this.agentId = agentId;
   }
   /**
    * Retrieves the memory thread details
    * @returns Promise containing thread details including title and metadata
    */
   get() {
-    return this.request(`/api/memory/threads/${this.threadId}`);
+    return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`);
   }
   /**
    * Updates the memory thread properties
@@ -148,7 +149,7 @@ var MemoryThread = class extends BaseResource {
    * @returns Promise containing updated thread details
    */
   update(params) {
-    return this.request(`/api/memory/threads/${this.threadId}`, {
+    return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`, {
       method: "PATCH",
       body: params
     });
@@ -158,7 +159,7 @@ var MemoryThread = class extends BaseResource {
    * @returns Promise containing deletion result
    */
   delete() {
-    return this.request(`/api/memory/threads/${this.threadId}`, {
+    return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`, {
       method: "DELETE"
     });
   }
@@ -167,7 +168,7 @@ var MemoryThread = class extends BaseResource {
    * @returns Promise containing thread messages and UI messages
    */
   getMessages() {
-    return this.request(`/api/memory/threads/${this.threadId}/messages`);
+    return this.request(`/api/memory/threads/${this.threadId}/messages?agentId=${this.agentId}`);
   }
 };
 
@@ -261,6 +262,36 @@ var Workflow = class extends BaseResource {
       body: params
     });
   }
+  /**
+   * Resumes a suspended workflow step
+   * @param stepId - ID of the step to resume
+   * @param runId - ID of the workflow run
+   * @param context - Context to resume the workflow with
+   * @returns Promise containing the workflow resume results
+   */
+  resume({
+    stepId,
+    runId,
+    context
+  }) {
+    return this.request(`/api/workflows/${this.workflowId}/resume`, {
+      method: "POST",
+      body: {
+        stepId,
+        runId,
+        context
+      }
+    });
+  }
+  /**
+   * Watches workflow transitions in real-time
+   * @returns Promise containing the workflow watch stream
+   */
+  watch() {
+    return this.request(`/api/workflows/${this.workflowId}/watch`, {
+      stream: true
+    });
+  }
 };
 
 // src/resources/tool.ts
@@ -315,7 +346,7 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing array of memory threads
    */
   getMemoryThreads(params) {
-    return this.request(`/api/memory/threads?resourceid=${params.resourceId}`);
+    return this.request(`/api/memory/threads?resourceid=${params.resourceId}&agentId=${params.agentId}`);
   }
   /**
    * Creates a new memory thread
@@ -323,15 +354,15 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing the created memory thread
    */
   createMemoryThread(params) {
-    return this.request("/api/memory/threads", { method: "POST", body: params });
+    return this.request(`/api/memory/threads?agentId=${params.agentId}`, { method: "POST", body: params });
   }
   /**
    * Gets a memory thread instance by ID
    * @param threadId - ID of the memory thread to retrieve
    * @returns MemoryThread instance
    */
-  getMemoryThread(threadId) {
-    return new MemoryThread(this.options, threadId);
+  getMemoryThread(threadId, agentId) {
+    return new MemoryThread(this.options, threadId, agentId);
   }
   /**
    * Saves messages to memory
@@ -339,7 +370,7 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing the saved messages
    */
   saveMessageToMemory(params) {
-    return this.request("/api/memory/save-messages", {
+    return this.request(`/api/memory/save-messages?agentId=${params.agentId}`, {
       method: "POST",
       body: params
     });
@@ -348,8 +379,8 @@ var MastraClient = class extends BaseResource {
    * Gets the status of the memory system
    * @returns Promise containing memory system status
    */
-  getMemoryStatus() {
-    return this.request("/api/memory/status");
+  getMemoryStatus(agentId) {
+    return this.request(`/api/memory/status?agentId=${agentId}`);
   }
   /**
    * Retrieves all available tools
@@ -405,6 +436,25 @@ var MastraClient = class extends BaseResource {
   getLogForRun(params) {
     return this.request(`/api/logs/${params.runId}?transportId=${params.transportId}`);
   }
+  /**
+   * List of all traces (paged)
+   * @param params - Parameters for filtering traces
+   * @returns Promise containing telemetry data
+   */
+  getTelemetry(params) {
+    const { name, scope, page, perPage, attribute } = params || {};
+    const _attribute = attribute ? Object.entries(attribute).map(([key, value]) => `${key}:${value}`) : [];
+    const queryObj = {
+      ...name ? { name } : {},
+      ...scope ? { scope } : {},
+      ...page ? { page: String(page) } : {},
+      ...perPage ? { perPage: String(perPage) } : {},
+      ..._attribute?.length ? { attribute: _attribute } : {}
+    };
+    const hasQueryParams = Object.keys(queryObj).length > 0;
+    const queryParams = hasQueryParams ? new URLSearchParams(queryObj) : "";
+    return this.request(`/api/telemetry?${queryParams}`);
+  }
 };
 
 export { MastraClient };

package/eslint.config.js

@@ -0,0 +1,6 @@
+import { createConfig } from '@internal/lint/eslint';
+
+const config = await createConfig();
+
+/** @type {import("eslint").Linter.Config[]} */
+export default [...config];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "0.1.0-alpha.9",
+  "version": "0.1.0",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "types": "dist/index.d.mts",
@@ -17,10 +17,10 @@
   "repository": "github:mastra-ai/client-js",
   "license": "ISC",
   "dependencies": {
-    "@mastra/core": "^0.2.0-alpha.83",
     "json-schema": "^0.4.0",
     "zod": "^3.24.1",
-    "zod-to-json-schema": "^3.24.1"
+    "zod-to-json-schema": "^3.24.1",
+    "@mastra/core": "^0.2.1"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.26.0",
@@ -30,7 +30,8 @@
     "@types/node": "^22.9.0",
     "tsup": "^8.0.1",
     "typescript": "^5.7.3",
-    "vitest": "^3.0.4"
+    "vitest": "^3.0.4",
+    "@internal/lint": "0.0.0"
   },
   "scripts": {
     "build": "tsup-node src/index.ts --format esm --dts --clean --treeshake",