Method stopBackgroundTask

packages/node-sdk/src/session.ts:346–361

* Request a running background task to stop. Sends SIGTERM with a * grace period (handled by the core BPM); subscribers receive a * `background.task.terminated` event when the kill settles. Calls * for unknown or already-terminal task ids are no-ops at the core * level — this method does

(
    taskId: string,
    options: { reason?: string } = {},
  )

   * level — this method does not throw in those cases.
   */
  async stopBackgroundTask(
    taskId: string,
    options: { reason?: string } = {},
  ): Promise<void> {
    this.ensureOpen();
    const trimmedTaskId = normalizeRequiredString(
      taskId,
      'Task id cannot be empty',
      ErrorCodes.BACKGROUND_TASK_ID_EMPTY,
    );
    await this.rpc.stopBackgroundTask({
      sessionId: this.id,
      taskId: trimmedTaskId,
      reason: options.reason,
    });
  }

  /**
   * Detach a running foreground task so the current tool call can return while