@mastra/client-js 1.26.1-alpha.2 → 1.27.0-alpha.4

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export * from './types.js';
 export * from './tools.js';
 export type { ChannelPlatformInfo, ChannelInstallationInfo, ChannelConnectOAuth, ChannelConnectDeepLink, ChannelConnectImmediate, ChannelConnectResult, } from './resources/channels.js';
 export type { AgentCardSignatureKeyProviderInput, AgentCardVerificationKey, GetAgentCardOptions, VerifyAgentCardSignatureOptions, } from './resources/a2a.js';
+export { harnessMessageText } from './resources/harness.js';
+export type { HarnessInfo, HarnessMessage, HarnessMessageContent, HarnessEvent, KnownHarnessEvent, OtherHarnessEvent, CreateHarnessSessionResponse, SubscribeHarnessSessionOptions, HarnessSubscription, HarnessSessionState, HarnessModeInfo, HarnessThreadInfo, HarnessTaskSnapshot, HarnessAvailableModel, HarnessWorkspaceStatus, HarnessGoalRecord, SendNotificationInput, SendNotificationResult, PlanResume, PermissionPolicy, PermissionRules, ToolCategory, } from './resources/harness.js';
 export { RequestContext } from '@mastra/core/request-context';
 export type { ObservabilityCollector } from './observability/types.js';
 export type { UIMessageWithMetadata } from '@mastra/core/agent';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,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,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,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,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EACV,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,EAC5B,8BAA8B,EAC9B,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,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

@@ -6082,6 +6082,280 @@ var Channels = class extends BaseResource {
   }
 };
 
+// src/resources/harness.ts
+var HarnessSession = class extends BaseResource {
+  constructor(options, harnessId, resourceId) {
+    super(options);
+    this.harnessId = harnessId;
+    this.resourceId = resourceId;
+  }
+  harnessId;
+  resourceId;
+  base() {
+    return `/harness/${encodeURIComponent(this.harnessId)}/sessions/${encodeURIComponent(this.resourceId)}`;
+  }
+  /** Create or resume this session. */
+  create() {
+    return this.request(`/harness/${encodeURIComponent(this.harnessId)}/sessions`, {
+      method: "POST",
+      body: { resourceId: this.resourceId }
+    });
+  }
+  /**
+   * Subscribe to this session's event stream (SSE). The assistant's reply to a
+   * message arrives here as `message_*` events, not on the sendMessage call.
+   */
+  async subscribe(options) {
+    const response = await this.request(`${this.base()}/stream`, { stream: true });
+    if (!response.body) {
+      throw new Error("No response body for harness session stream");
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let cancelled = false;
+    let buffer = "";
+    const pump = async () => {
+      try {
+        while (!cancelled) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          buffer += decoder.decode(value, { stream: true });
+          let sep;
+          while ((sep = buffer.indexOf("\n\n")) !== -1) {
+            const frame = buffer.slice(0, sep);
+            buffer = buffer.slice(sep + 2);
+            for (const line of frame.split("\n")) {
+              if (!line.startsWith("data:")) continue;
+              const data = line.slice(5).trim();
+              if (!data) continue;
+              try {
+                options.onEvent(JSON.parse(data));
+              } catch {
+              }
+            }
+          }
+        }
+      } catch (error) {
+        if (!cancelled) options.onError?.(error);
+      }
+    };
+    void pump();
+    return {
+      unsubscribe: () => {
+        cancelled = true;
+        void reader.cancel().catch(() => {
+        });
+      }
+    };
+  }
+  /** Send a user message. The reply streams over `subscribe()`. */
+  async sendMessage(message) {
+    await this.request(`${this.base()}/messages`, { method: "POST", body: { message } });
+  }
+  /** Abort the in-flight run for this session. */
+  async abort() {
+    await this.request(`${this.base()}/abort`, { method: "POST" });
+  }
+  /** Approve or decline a pending tool call (`tool_approval_required`). */
+  async approveTool(toolCallId, approved) {
+    await this.request(`${this.base()}/tool-approval`, {
+      method: "POST",
+      body: { toolCallId, approved }
+    });
+  }
+  /**
+   * Resume a suspended interactive tool (`tool_suspended`). The resume shape
+   * depends on the tool: a string (or string[]) for `ask_user`, "Yes"/"No" for
+   * `request_access`, and a {@link PlanResume} for `submit_plan`.
+   */
+  async respondToToolSuspension(toolCallId, resumeData) {
+    await this.request(`${this.base()}/tool-suspension`, {
+      method: "POST",
+      body: { toolCallId, resumeData }
+    });
+  }
+  /** Inject a message into the in-flight run without starting a new turn. */
+  async steer(message) {
+    await this.request(`${this.base()}/steer`, { method: "POST", body: { message } });
+  }
+  /** Get the current mode, model, and thread (for initial UI hydration). */
+  state() {
+    return this.request(this.base());
+  }
+  /** Merge key-value pairs into the session state. Existing keys not in the payload are preserved. */
+  async setState(updates) {
+    await this.request(`${this.base()}/state`, { method: "PUT", body: { state: updates } });
+  }
+  /** Switch the active mode (e.g. `build`, `plan`). */
+  async switchMode(modeId) {
+    await this.request(`${this.base()}/mode`, { method: "POST", body: { modeId } });
+  }
+  /** Switch the model. Defaults to thread scope. */
+  async switchModel(modelId, options) {
+    await this.request(`${this.base()}/model`, {
+      method: "POST",
+      body: { modelId, scope: options?.scope, modeId: options?.modeId }
+    });
+  }
+  /** List the threads for this session's resource, most-recently-updated first. Pass `limit` for just the newest N. */
+  async listThreads(limit) {
+    const query = limit != null ? `?limit=${limit}` : "";
+    const body = await this.request(`${this.base()}/threads${query}`);
+    return body.threads;
+  }
+  /** Switch the session to an existing thread (rebinds stream + state). */
+  async switchThread(threadId) {
+    await this.request(`${this.base()}/thread`, { method: "POST", body: { threadId } });
+  }
+  /** Create a new thread (unbinds previous, binds the new one). */
+  async createThread(title) {
+    return this.request(`${this.base()}/threads`, {
+      method: "POST",
+      body: { title }
+    });
+  }
+  /** Delete a thread. If it's the active thread the session unbinds. */
+  async deleteThread(threadId) {
+    await this.request(`${this.base()}/threads/${encodeURIComponent(threadId)}`, {
+      method: "DELETE"
+    });
+  }
+  /** Rename a thread. */
+  async renameThread(threadId, title) {
+    await this.request(`${this.base()}/threads/${encodeURIComponent(threadId)}`, {
+      method: "PUT",
+      body: { title }
+    });
+  }
+  /** Clone a thread (and its messages). The session binds to the clone. */
+  async cloneThread(options) {
+    return this.request(`${this.base()}/threads/clone`, {
+      method: "POST",
+      body: options ?? {}
+    });
+  }
+  /** List messages for a specific thread. */
+  async listMessages(threadId, limit) {
+    const params = limit != null ? `?limit=${limit}` : "";
+    const body = await this.request(
+      `${this.base()}/threads/${encodeURIComponent(threadId)}/messages${params}`
+    );
+    return body.messages;
+  }
+  /**
+   * Queue a follow-up message. If the session is idle it sends immediately;
+   * if a run is active it queues for after completion.
+   */
+  async followUp(message) {
+    await this.request(`${this.base()}/follow-up`, { method: "POST", body: { message } });
+  }
+  /** Get the observational memory record for this session's thread. */
+  async getOMRecord() {
+    const body = await this.request(`${this.base()}/om`);
+    return body.record;
+  }
+  /** Change the session's resource identity. */
+  async setResourceId(newResourceId) {
+    await this.request(`${this.base()}/resource`, {
+      method: "POST",
+      body: { newResourceId }
+    });
+  }
+  /** Get known resource IDs for this session. */
+  async getResourceIds() {
+    const body = await this.request(`${this.base()}/resources`);
+    return body.resourceIds;
+  }
+  /** Get the current goal for this session's thread. */
+  async getGoal() {
+    const body = await this.request(`${this.base()}/goal`);
+    return body.goal;
+  }
+  /** Set a new goal objective. The agent's in-loop judge evaluates progress after each turn. */
+  async setGoal(objective, options) {
+    const body = await this.request(`${this.base()}/goal`, {
+      method: "POST",
+      body: { objective, ...options }
+    });
+    return body.goal;
+  }
+  /** Update goal options (judge model, max runs, status). */
+  async updateGoal(options) {
+    const body = await this.request(`${this.base()}/goal`, {
+      method: "PUT",
+      body: options
+    });
+    return body.goal;
+  }
+  /** Clear the current goal. */
+  async clearGoal() {
+    await this.request(`${this.base()}/goal`, { method: "DELETE" });
+  }
+  // ---------------------------------------------------------------------------
+  // Permissions
+  // ---------------------------------------------------------------------------
+  /** Get the current permission rules (per-category and per-tool policies). */
+  async getPermissions() {
+    return this.request(`${this.base()}/permissions`);
+  }
+  /** Set the approval policy for a tool category. */
+  async setPermissionForCategory(category, policy) {
+    await this.request(`${this.base()}/permissions/category`, {
+      method: "PUT",
+      body: { category, policy }
+    });
+  }
+  /** Set the approval policy for a specific tool. */
+  async setPermissionForTool(toolName, policy) {
+    await this.request(`${this.base()}/permissions/tool`, {
+      method: "PUT",
+      body: { toolName, policy }
+    });
+  }
+  /**
+   * Send a notification signal to this session. The agent's delivery policy
+   * determines whether the notification wakes an idle thread, is summarised,
+   * or is persisted for later.
+   */
+  async sendNotification(input) {
+    return this.request(`${this.base()}/notifications`, {
+      method: "POST",
+      body: input
+    });
+  }
+};
+var Harness = class extends BaseResource {
+  constructor(options, harnessId) {
+    super(options);
+    this.harnessId = harnessId;
+  }
+  harnessId;
+  basePath() {
+    return `/harness/${encodeURIComponent(this.harnessId)}`;
+  }
+  /** List the modes configured on this harness (e.g. build, plan). */
+  async listModes() {
+    const body = await this.request(`${this.basePath()}/modes`);
+    return body.modes;
+  }
+  /** List available models on this harness (with auth status and use counts). */
+  async listModels() {
+    const body = await this.request(`${this.basePath()}/models`);
+    return body.models;
+  }
+  /** Get workspace status for this harness. */
+  async workspaceStatus() {
+    return this.request(`${this.basePath()}/workspace`);
+  }
+  /** Scope to a session bound to `resourceId` (e.g. a user or conversation id). */
+  session(resourceId) {
+    return new HarnessSession(this.options, this.harnessId, resourceId);
+  }
+};
+function harnessMessageText(message) {
+  return message.content.filter((c) => c.type === "text" && typeof c.text === "string").map((c) => c.text).join("");
+}
+
 // src/client.ts
 var MastraClient = class extends BaseResource {
   observability;
@@ -6124,6 +6398,23 @@ var MastraClient = class extends BaseResource {
   getAgent(agentId, version) {
     return new Agent(this.options, agentId, version);
   }
+  /**
+   * Lists the harnesses hosted on the connected Mastra instance.
+   * @returns Promise containing an array of harness identifiers
+   */
+  async listHarnesses() {
+    const body = await this.request("/harness");
+    return body.harnesses;
+  }
+  /**
+   * Scopes to a harness hosted on the connected Mastra instance. Use
+   * `getHarness(id).session(resourceId)` to create/resume a session, stream its
+   * events, and send messages.
+   * @param harnessId - The id the harness is registered under on Mastra
+   */
+  getHarness(harnessId) {
+    return new Harness(this.options, harnessId);
+  }
   /**
    * Lists memory threads with optional filtering by resourceId and/or metadata
    * @param params - Parameters containing optional filters, pagination options, and request context
@@ -7753,6 +8044,6 @@ function createTool(opts) {
   return new ClientTool(opts);
 }
 
-export { ClientTool, MastraClient, MastraClientError, createTool };
+export { ClientTool, MastraClient, MastraClientError, createTool, harnessMessageText };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map