Method waitForWorkspaceIdle

src/node/services/workspaceService.ts:2770–2799

(
    workspaceId: string,
    options?: { signal?: AbortSignal; manualFollowUp?: boolean }
  )

  }

  async waitForWorkspaceIdle(
    workspaceId: string,
    options?: { signal?: AbortSignal; manualFollowUp?: boolean }
  ): Promise<void> {
    assert(typeof workspaceId === "string", "waitForWorkspaceIdle requires a workspaceId string");
    const trimmed = workspaceId.trim();
    assert(trimmed.length > 0, "waitForWorkspaceIdle requires a non-empty workspaceId");

    let releaseManualFollowUp: (() => void) | undefined;
    try {
      for (;;) {
        if (options?.signal?.aborted === true) {
          throw new Error(WORKSPACE_IDLE_WAIT_CANCELED_MESSAGE);
        }

        const session =
          this.sessions.get(trimmed) ?? this.transientStartupRecoverySessions.get(trimmed);
        if (session?.isBusy() !== true) {
          return;
        }

        if (options?.manualFollowUp === true && releaseManualFollowUp == null) {
          releaseManualFollowUp = session.registerExternalManualFollowUp(options.signal);
        }
        await waitForAgentSessionIdle(session, options?.signal);
      }
    } finally {
      releaseManualFollowUp?.();
    }
  }

  /**
   * Register an externally-created AgentSession so that WorkspaceService