@mastra/client-js 1.56.0-alpha.7 → 1.56.0-alpha.9

package/dist/index.cjs

@@ -6800,48 +6800,40 @@ function hydrateEventTimestamps(event) {
 	return isKnownParsedEvent(event) ? hydrateKnownEvent(event) : event;
 }
 /**
-* A session bound to a `resourceId` within one agent controller. Sessions are
-* get-or-create on the server, so re-creating the same resourceId (and scope)
-* resumes the existing conversation rather than forking it.
-*
-* Pass a `scope` to address an independent session over the same resourceId:
-* two sessions with the same resourceId but different scopes have their own
-* run loop, thread binding, and mode/model/state (e.g. one session per git
-* worktree, with the worktree path as the scope). The scope travels on every
-* request as a `sessionScope` query param.
+* A session addressed by its `sessionId` within one agent controller. Sessions
+* are get-or-create on the server, so re-creating the same sessionId resumes
+* the existing conversation rather than forking it. Many sessions can work on
+* one `resourceId` (whose threads and memory they use); each has its own run
+* loop, thread binding, and mode/model/state.
 */
 var AgentControllerSession = class extends BaseResource {
 	controllerId;
-	resourceId;
-	scope;
-	constructor(options, controllerId, resourceId, scope) {
+	sessionId;
+	constructor(options, controllerId, sessionId) {
 		super(options);
 		this.controllerId = controllerId;
-		this.resourceId = resourceId;
-		this.scope = scope;
+		this.sessionId = sessionId;
 	}
 	base() {
-		return `/agent-controller/${encodeURIComponent(this.controllerId)}/sessions/${encodeURIComponent(this.resourceId)}`;
-	}
-	/** Append this session's scope (if any) as a `sessionScope` query param. */
-	url(path) {
-		if (this.scope === void 0) return path;
-		return `${path}${path.includes("?") ? "&" : "?"}sessionScope=${encodeURIComponent(this.scope)}`;
+		return `/agent-controller/${encodeURIComponent(this.controllerId)}/sessions/${encodeURIComponent(this.sessionId)}`;
 	}
 	/**
-	* Create or resume this session. Pass `tags` to scope initial thread
-	* selection — a thread is a resume candidate only when its metadata matches
-	* every tag. Pass `threadId` to bind the session to one exact thread,
-	* creating it with that id when it does not exist.
+	* Create or resume this session. `resourceId` names whose threads and memory
+	* the session works on. Without it the server resumes the session on the
+	* resource it already has (the live session's, or the resource of the thread
+	* with the session's id), falling back to the sessionId. Pass `tags` to scope
+	* initial thread selection — a thread is a resume candidate only when its
+	* metadata matches every tag. Pass `threadId` to bind the session to one
+	* exact thread, creating it with that id when it does not exist.
 	*/
 	create(options) {
 		return this.request(`/agent-controller/${encodeURIComponent(this.controllerId)}/sessions`, {
 			method: "POST",
 			body: {
-				resourceId: this.resourceId,
+				resourceId: options?.resourceId,
+				sessionId: this.sessionId,
 				tags: options?.tags,
-				threadId: options?.threadId,
-				sessionScope: this.scope
+				threadId: options?.threadId
 			}
 		});
 	}
@@ -6897,7 +6889,7 @@ var AgentControllerSession = class extends BaseResource {
 			const abort = new AbortController();
 			currentAbort = abort;
 			let openTimer;
-			const request = this.request(this.url(`${this.base()}/stream`), {
+			const request = this.request(`${this.base()}/stream`, {
 				stream: true,
 				signal: abort.signal
 			});
@@ -7107,7 +7099,7 @@ var AgentControllerSession = class extends BaseResource {
 			files: void 0
 		} : message;
 		const requestContext = parseClientRequestContext(options?.requestContext);
-		await this.request(this.url(`${this.base()}/messages`), {
+		await this.request(`${this.base()}/messages`, {
 			method: "POST",
 			body: {
 				message: content,
@@ -7118,7 +7110,7 @@ var AgentControllerSession = class extends BaseResource {
 	}
 	/** Abort the in-flight run for this session. */
 	async abort() {
-		await this.request(this.url(`${this.base()}/abort`), { method: "POST" });
+		await this.request(`${this.base()}/abort`, { method: "POST" });
 	}
 	/**
 	* Approve or decline a pending tool call (`tool_approval_required`). Resolves
@@ -7126,7 +7118,7 @@ var AgentControllerSession = class extends BaseResource {
 	*/
 	async approveTool(toolCallId, approved, options) {
 		const requestContext = parseClientRequestContext(options?.requestContext);
-		return this.request(this.url(`${this.base()}/tool-approval`), {
+		return this.request(`${this.base()}/tool-approval`, {
 			method: "POST",
 			retries: 0,
 			body: {
@@ -7144,7 +7136,7 @@ var AgentControllerSession = class extends BaseResource {
 	*/
 	async respondToToolSuspension(toolCallId, resumeData, options) {
 		const requestContext = parseClientRequestContext(options?.requestContext);
-		return this.request(this.url(`${this.base()}/tool-suspension`), {
+		return this.request(`${this.base()}/tool-suspension`, {
 			method: "POST",
 			retries: 0,
 			body: {
@@ -7164,7 +7156,7 @@ var AgentControllerSession = class extends BaseResource {
 			files: void 0
 		} : message;
 		const requestContext = parseClientRequestContext(options?.requestContext);
-		await this.request(this.url(`${this.base()}/steer`), {
+		await this.request(`${this.base()}/steer`, {
 			method: "POST",
 			body: {
 				message: content,
@@ -7176,18 +7168,18 @@ var AgentControllerSession = class extends BaseResource {
 	/** Get the current mode, model, and thread (for initial UI hydration). */
 	state(options) {
 		const path = options?.threadId ? `${this.base()}?threadId=${encodeURIComponent(options.threadId)}` : this.base();
-		return this.request(this.url(path));
+		return this.request(path);
 	}
 	/** Merge key-value pairs into the session state. Existing keys not in the payload are preserved. */
 	async setState(updates) {
-		await this.request(this.url(`${this.base()}/state`), {
+		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.url(`${this.base()}/mode`), {
+		await this.request(`${this.base()}/mode`, {
 			method: "POST",
 			body: { modeId }
 		});
@@ -7197,7 +7189,7 @@ var AgentControllerSession = class extends BaseResource {
 	* `thinkingLevel` is provided it is applied and persisted with the model.
 	*/
 	async switchModel(modelId, { thinkingLevel } = {}) {
-		await this.request(this.url(`${this.base()}/model`), {
+		await this.request(`${this.base()}/model`, {
 			method: "POST",
 			body: thinkingLevel !== void 0 ? {
 				modelId,
@@ -7218,36 +7210,36 @@ var AgentControllerSession = class extends BaseResource {
 		if (opts.limit != null) params.set("limit", String(opts.limit));
 		if (opts.tags && Object.keys(opts.tags).length > 0) params.set("tags", JSON.stringify(opts.tags));
 		const query = params.toString() ? `?${params.toString()}` : "";
-		return (await this.request(this.url(`${this.base()}/threads${query}`))).threads;
+		return (await this.request(`${this.base()}/threads${query}`)).threads;
 	}
 	/** Switch the session to an existing thread (rebinds stream + state). */
 	async switchThread(threadId) {
-		await this.request(this.url(`${this.base()}/thread`), {
+		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.url(`${this.base()}/threads`), {
+		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.url(`${this.base()}/threads/${encodeURIComponent(threadId)}`), { method: "DELETE" });
+		await this.request(`${this.base()}/threads/${encodeURIComponent(threadId)}`, { method: "DELETE" });
 	}
 	/** Rename a thread. */
 	async renameThread(threadId, title) {
-		await this.request(this.url(`${this.base()}/threads/${encodeURIComponent(threadId)}`), {
+		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.url(`${this.base()}/threads/clone`), {
+		return this.request(`${this.base()}/threads/clone`, {
 			method: "POST",
 			body: options ?? {}
 		});
@@ -7268,7 +7260,7 @@ var AgentControllerSession = class extends BaseResource {
 			if (include) queryParams.set("include", JSON.stringify(include));
 		}
 		const query = queryParams.toString();
-		const body = await this.request(this.url(`${this.base()}/threads/${encodeURIComponent(threadId)}/messages${query ? `?${query}` : ""}`));
+		const body = await this.request(`${this.base()}/threads/${encodeURIComponent(threadId)}/messages${query ? `?${query}` : ""}`);
 		const messages = body.messages.map(hydrateMessage);
 		if (legacy) return messages;
 		return {
@@ -7287,7 +7279,7 @@ var AgentControllerSession = class extends BaseResource {
 			files: void 0
 		} : message;
 		const requestContext = parseClientRequestContext(options?.requestContext);
-		await this.request(this.url(`${this.base()}/follow-up`), {
+		await this.request(`${this.base()}/follow-up`, {
 			method: "POST",
 			body: {
 				message: content,
@@ -7298,26 +7290,26 @@ var AgentControllerSession = class extends BaseResource {
 	}
 	/** Get the observational memory record for this session's thread. */
 	async getOMRecord() {
-		return (await this.request(this.url(`${this.base()}/om`))).record;
+		return (await this.request(`${this.base()}/om`)).record;
 	}
 	/** Change the session's resource identity. */
 	async setResourceId(newResourceId) {
-		await this.request(this.url(`${this.base()}/resource`), {
+		await this.request(`${this.base()}/resource`, {
 			method: "POST",
 			body: { newResourceId }
 		});
 	}
 	/** Get known resource IDs for this session. */
 	async getResourceIds() {
-		return (await this.request(this.url(`${this.base()}/resources`))).resourceIds;
+		return (await this.request(`${this.base()}/resources`)).resourceIds;
 	}
 	/** Get the current goal for this session's thread. */
 	async getGoal() {
-		return (await this.request(this.url(`${this.base()}/goal`))).goal;
+		return (await this.request(`${this.base()}/goal`)).goal;
 	}
 	/** Set a new goal objective. The agent's in-loop judge evaluates progress after each turn. */
 	async setGoal(objective, options) {
-		return (await this.request(this.url(`${this.base()}/goal`), {
+		return (await this.request(`${this.base()}/goal`, {
 			method: "POST",
 			body: {
 				objective,
@@ -7327,22 +7319,22 @@ var AgentControllerSession = class extends BaseResource {
 	}
 	/** Update goal options (judge model, max runs, status). */
 	async updateGoal(options) {
-		return (await this.request(this.url(`${this.base()}/goal`), {
+		return (await this.request(`${this.base()}/goal`, {
 			method: "PUT",
 			body: options
 		})).goal;
 	}
 	/** Clear the current goal. */
 	async clearGoal() {
-		await this.request(this.url(`${this.base()}/goal`), { method: "DELETE" });
+		await this.request(`${this.base()}/goal`, { method: "DELETE" });
 	}
 	/** Get the current permission rules (per-category and per-tool policies). */
 	async getPermissions() {
-		return this.request(this.url(`${this.base()}/permissions`));
+		return this.request(`${this.base()}/permissions`);
 	}
 	/** Set the approval policy for a tool category. */
 	async setPermissionForCategory(category, policy) {
-		await this.request(this.url(`${this.base()}/permissions/category`), {
+		await this.request(`${this.base()}/permissions/category`, {
 			method: "PUT",
 			body: {
 				category,
@@ -7352,7 +7344,7 @@ var AgentControllerSession = class extends BaseResource {
 	}
 	/** Set the approval policy for a specific tool. */
 	async setPermissionForTool(toolName, policy) {
-		await this.request(this.url(`${this.base()}/permissions/tool`), {
+		await this.request(`${this.base()}/permissions/tool`, {
 			method: "PUT",
 			body: {
 				toolName,
@@ -7366,7 +7358,7 @@ var AgentControllerSession = class extends BaseResource {
 	* or is persisted for later.
 	*/
 	async sendNotification(input) {
-		return this.request(this.url(`${this.base()}/notifications`), {
+		return this.request(`${this.base()}/notifications`, {
 			method: "POST",
 			body: input
 		});
@@ -7399,12 +7391,11 @@ var AgentController = class extends BaseResource {
 		return this.request(`${this.basePath()}/workspace`);
 	}
 	/**
-	* Scope to a session bound to `resourceId` (e.g. a user or conversation id).
-	* Pass `scope` to address an independent session over the same resourceId
-	* (e.g. one session per git worktree, with the worktree path as the scope).
+	* Address the session with this `sessionId`. Sessions created without an
+	* explicit id are addressed by their `resourceId`.
 	*/
-	session(resourceId, scope) {
-		return new AgentControllerSession(this.options, this.controllerId, resourceId, scope);
+	session(sessionId) {
+		return new AgentControllerSession(this.options, this.controllerId, sessionId);
 	}
 };
 /** Pull the plain text out of an assistant message's nested content parts. */
@@ -7478,7 +7469,7 @@ var MastraClient = class extends BaseResource {
 	}
 	/**
 	* Scopes to an agent controller hosted on the connected Mastra instance. Use
-	* `getAgentController(id).session(resourceId)` to create/resume a session,
+	* `getAgentController(id).session(sessionId)` to create/resume a session,
 	* stream its events, and send messages.
 	* @param controllerId - The id the agent controller is registered under on Mastra
 	*/